Better formatting for dataverse' docs
This commit is contained in:
parent
c8430050a8
commit
6ac3b74309
9 changed files with 75 additions and 365 deletions
|
@ -52,21 +52,6 @@ explanation of pointers.
|
||||||
|
|
||||||
Atom
|
Atom
|
||||||
|
|
||||||
**`Remarks`**
|
|
||||||
|
|
||||||
The Pointer type is quite tricky because it doesn't play well with `any` and other inexact types.
|
|
||||||
Here is an example that one would expect to work, but currently doesn't:
|
|
||||||
```ts
|
|
||||||
declare function expectAnyPointer(pointer: Pointer<any>): void
|
|
||||||
|
|
||||||
expectAnyPointer(null as Pointer<{}>) // this shows as a type error because Pointer<{}> is not assignable to Pointer<any>, even though it should
|
|
||||||
```
|
|
||||||
|
|
||||||
The current solution is to just avoid using `any` with pointer-related code (or type-test it well).
|
|
||||||
But if you enjoy solving typescript puzzles, consider fixing this :)
|
|
||||||
Potentially, [TypeScript variance annotations in 4.7+](https://devblogs.microsoft.com/typescript/announcing-typescript-4-7-beta/#optional-variance-annotations-for-type-parameters)
|
|
||||||
might be able to help us.
|
|
||||||
|
|
||||||
#### Type parameters
|
#### Type parameters
|
||||||
|
|
||||||
| Name |
|
| Name |
|
||||||
|
@ -75,7 +60,7 @@ might be able to help us.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[pointer.ts:64](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/pointer.ts#L64)
|
[pointer.ts:64](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/pointer.ts#L64)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -92,7 +77,7 @@ ___
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[pointer.ts:5](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/pointer.ts#L5)
|
[pointer.ts:5](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/pointer.ts#L5)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -116,7 +101,7 @@ A wrapper type for the type a `Pointer` points to.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[pointer.ts:35](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/pointer.ts#L35)
|
[pointer.ts:35](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/pointer.ts#L35)
|
||||||
|
|
||||||
## Functions
|
## Functions
|
||||||
|
|
||||||
|
@ -157,7 +142,7 @@ const {root, path} = getPointerParts(pointer)
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[pointer.ts:136](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/pointer.ts#L136)
|
[pointer.ts:136](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/pointer.ts#L136)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -179,7 +164,7 @@ p is Pointer<unknown\>
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[pointer.ts:187](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/pointer.ts#L187)
|
[pointer.ts:187](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/pointer.ts#L187)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -201,7 +186,7 @@ d is Prism<unknown\>
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/Interface.ts:66](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/Interface.ts#L66)
|
[prism/Interface.ts:66](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/Interface.ts#L66)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -227,7 +212,7 @@ ___
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/iterateAndCountTicks.ts:7](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/iterateAndCountTicks.ts#L7)
|
[prism/iterateAndCountTicks.ts:7](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/iterateAndCountTicks.ts#L7)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -253,7 +238,7 @@ ___
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/iterateOver.ts:8](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/iterateOver.ts#L8)
|
[prism/iterateOver.ts:8](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/iterateOver.ts#L8)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -281,15 +266,6 @@ Creates a pointer to a (nested) property of an [Atom](classes/Atom.md).
|
||||||
|
|
||||||
[`Pointer`](README.md#pointer)<`O`\>
|
[`Pointer`](README.md#pointer)<`O`\>
|
||||||
|
|
||||||
**`Remarks`**
|
|
||||||
|
|
||||||
Pointers are used to make prisms of properties or nested properties of
|
|
||||||
Atom|Atoms.
|
|
||||||
|
|
||||||
Pointers also allow easy construction of new pointers pointing to nested members
|
|
||||||
of the root object, by simply using property chaining. E.g. `somePointer.a.b` will
|
|
||||||
create a new pointer that has `'a'` and `'b'` added to the path of `somePointer`.
|
|
||||||
|
|
||||||
**`Example`**
|
**`Example`**
|
||||||
|
|
||||||
```ts
|
```ts
|
||||||
|
@ -307,7 +283,7 @@ const sum = prism(() => {
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[pointer.ts:172](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/pointer.ts#L172)
|
[pointer.ts:172](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/pointer.ts#L172)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -336,7 +312,7 @@ cached per pointer.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[pointerToPrism.ts:41](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/pointerToPrism.ts#L41)
|
[pointerToPrism.ts:41](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/pointerToPrism.ts#L41)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -365,7 +341,7 @@ in it as dependencies, and reruns the function when these change.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/prism.ts:817](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/prism.ts#L817)
|
[prism/prism.ts:817](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/prism.ts#L817)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -392,11 +368,6 @@ is a pointer, a prism or a plain value itself.
|
||||||
|
|
||||||
`P` extends [`PointerType`](README.md#pointertype)<`T`\> ? `T` : `P` extends [`Prism`](interfaces/Prism-1.md)<`T`\> ? `T` : `P` extends `undefined` \| ``null`` ? `P` : `unknown`
|
`P` extends [`PointerType`](README.md#pointertype)<`T`\> ? `T` : `P` extends [`Prism`](interfaces/Prism-1.md)<`T`\> ? `T` : `P` extends `undefined` \| ``null`` ? `P` : `unknown`
|
||||||
|
|
||||||
**`Remarks`**
|
|
||||||
|
|
||||||
For pointers, the value is returned by first creating a prism, so it is
|
|
||||||
reactive e.g. when used in a `prism`.
|
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[val.ts:19](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/val.ts#L19)
|
[val.ts:19](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/val.ts#L19)
|
||||||
|
|
|
@ -22,17 +22,11 @@ Wraps an object whose (sub)properties can be individually tracked.
|
||||||
|
|
||||||
### Properties
|
### Properties
|
||||||
|
|
||||||
- [\_currentState](Atom.md#_currentstate)
|
|
||||||
- [\_rootScope](Atom.md#_rootscope)
|
|
||||||
- [pointer](Atom.md#pointer)
|
- [pointer](Atom.md#pointer)
|
||||||
- [prism](Atom.md#prism)
|
- [prism](Atom.md#prism)
|
||||||
|
|
||||||
### Methods
|
### Methods
|
||||||
|
|
||||||
- [\_checkUpdates](Atom.md#_checkupdates)
|
|
||||||
- [\_getIn](Atom.md#_getin)
|
|
||||||
- [\_getOrCreateScopeForPath](Atom.md#_getorcreatescopeforpath)
|
|
||||||
- [\_onPointerValueChange](Atom.md#_onpointervaluechange)
|
|
||||||
- [get](Atom.md#get)
|
- [get](Atom.md#get)
|
||||||
- [getByPointer](Atom.md#getbypointer)
|
- [getByPointer](Atom.md#getbypointer)
|
||||||
- [pointerToPrism](Atom.md#pointertoprism)
|
- [pointerToPrism](Atom.md#pointertoprism)
|
||||||
|
@ -61,43 +55,19 @@ Wraps an object whose (sub)properties can be individually tracked.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Atom.ts:119](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L119)
|
[Atom.ts:119](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Atom.ts#L119)
|
||||||
|
|
||||||
## Properties
|
## Properties
|
||||||
|
|
||||||
### \_currentState
|
|
||||||
|
|
||||||
• `Private` **\_currentState**: `State`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Atom.ts:101](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L101)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_rootScope
|
|
||||||
|
|
||||||
• `Private` `Readonly` **\_rootScope**: `Scope`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Atom.ts:106](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L106)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### pointer
|
### pointer
|
||||||
|
|
||||||
• `Readonly` **pointer**: [`Pointer`](../README.md#pointer)<`State`\>
|
• `Readonly` **pointer**: [`Pointer`](../README.md#pointer)<`State`\>
|
||||||
|
|
||||||
Convenience property that gives you a pointer to the root of the atom.
|
Convenience property that gives you a pointer to the root of the atom.
|
||||||
|
|
||||||
**`Remarks`**
|
|
||||||
|
|
||||||
Equivalent to `pointer({ root: thisAtom, path: [] })`.
|
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Atom.ts:113](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L113)
|
[Atom.ts:113](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Atom.ts#L113)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -107,107 +77,10 @@ ___
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Atom.ts:115](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L115)
|
[Atom.ts:115](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Atom.ts#L115)
|
||||||
|
|
||||||
## Methods
|
## Methods
|
||||||
|
|
||||||
### \_checkUpdates
|
|
||||||
|
|
||||||
▸ `Private` **_checkUpdates**(`scope`, `oldState`, `newState`): `void`
|
|
||||||
|
|
||||||
#### Parameters
|
|
||||||
|
|
||||||
| Name | Type |
|
|
||||||
| :------ | :------ |
|
|
||||||
| `scope` | `Scope` |
|
|
||||||
| `oldState` | `unknown` |
|
|
||||||
| `newState` | `unknown` |
|
|
||||||
|
|
||||||
#### Returns
|
|
||||||
|
|
||||||
`void`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Atom.ts:218](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L218)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_getIn
|
|
||||||
|
|
||||||
▸ `Private` **_getIn**(`path`): `unknown`
|
|
||||||
|
|
||||||
Gets the state of the atom at `path`.
|
|
||||||
|
|
||||||
#### Parameters
|
|
||||||
|
|
||||||
| Name | Type |
|
|
||||||
| :------ | :------ |
|
|
||||||
| `path` | (`string` \| `number`)[] |
|
|
||||||
|
|
||||||
#### Returns
|
|
||||||
|
|
||||||
`unknown`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Atom.ts:166](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L166)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_getOrCreateScopeForPath
|
|
||||||
|
|
||||||
▸ `Private` **_getOrCreateScopeForPath**(`path`): `Scope`
|
|
||||||
|
|
||||||
#### Parameters
|
|
||||||
|
|
||||||
| Name | Type |
|
|
||||||
| :------ | :------ |
|
|
||||||
| `path` | (`string` \| `number`)[] |
|
|
||||||
|
|
||||||
#### Returns
|
|
||||||
|
|
||||||
`Scope`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Atom.ts:240](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L240)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_onPointerValueChange
|
|
||||||
|
|
||||||
▸ `Private` **_onPointerValueChange**<`P`\>(`pointer`, `cb`): () => `void`
|
|
||||||
|
|
||||||
#### Type parameters
|
|
||||||
|
|
||||||
| Name |
|
|
||||||
| :------ |
|
|
||||||
| `P` |
|
|
||||||
|
|
||||||
#### Parameters
|
|
||||||
|
|
||||||
| Name | Type |
|
|
||||||
| :------ | :------ |
|
|
||||||
| `pointer` | [`Pointer`](../README.md#pointer)<`P`\> |
|
|
||||||
| `cb` | (`v`: `P`) => `void` |
|
|
||||||
|
|
||||||
#### Returns
|
|
||||||
|
|
||||||
`fn`
|
|
||||||
|
|
||||||
▸ (): `void`
|
|
||||||
|
|
||||||
##### Returns
|
|
||||||
|
|
||||||
`void`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Atom.ts:248](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L248)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### get
|
### get
|
||||||
|
|
||||||
▸ **get**(): `State`
|
▸ **get**(): `State`
|
||||||
|
@ -218,7 +91,7 @@ ___
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Atom.ts:136](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L136)
|
[Atom.ts:136](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Atom.ts#L136)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -246,7 +119,7 @@ Returns the value at the given pointer
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Atom.ts:152](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L152)
|
[Atom.ts:152](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Atom.ts#L152)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -278,7 +151,7 @@ Returns a new prism of the value at the provided path.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Atom.ts:271](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L271)
|
[Atom.ts:271](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Atom.ts#L271)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -298,7 +171,7 @@ ___
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Atom.ts:170](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L170)
|
[Atom.ts:170](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Atom.ts#L170)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -327,7 +200,7 @@ Reduces the value at the given pointer
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Atom.ts:186](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L186)
|
[Atom.ts:186](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Atom.ts#L186)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -349,7 +222,7 @@ Sets the state of the atom.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Atom.ts:129](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L129)
|
[Atom.ts:129](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Atom.ts#L129)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -378,4 +251,4 @@ Sets the value at the given pointer
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Atom.ts:211](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Atom.ts#L211)
|
[Atom.ts:211](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Atom.ts#L211)
|
||||||
|
|
|
@ -4,11 +4,6 @@
|
||||||
|
|
||||||
Allows creating pointer-prisms where the pointer can be switched out.
|
Allows creating pointer-prisms where the pointer can be switched out.
|
||||||
|
|
||||||
**`Remarks`**
|
|
||||||
|
|
||||||
This allows reacting not just to value changes at a certain pointer, but changes
|
|
||||||
to the proxied pointer too.
|
|
||||||
|
|
||||||
## Type parameters
|
## Type parameters
|
||||||
|
|
||||||
| Name | Type |
|
| Name | Type |
|
||||||
|
@ -27,7 +22,6 @@ to the proxied pointer too.
|
||||||
|
|
||||||
### Properties
|
### Properties
|
||||||
|
|
||||||
- [\_currentPointerBox](PointerProxy.md#_currentpointerbox)
|
|
||||||
- [pointer](PointerProxy.md#pointer)
|
- [pointer](PointerProxy.md#pointer)
|
||||||
|
|
||||||
### Methods
|
### Methods
|
||||||
|
@ -55,33 +49,19 @@ to the proxied pointer too.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[PointerProxy.ts:34](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/PointerProxy.ts#L34)
|
[PointerProxy.ts:34](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/PointerProxy.ts#L34)
|
||||||
|
|
||||||
## Properties
|
## Properties
|
||||||
|
|
||||||
### \_currentPointerBox
|
|
||||||
|
|
||||||
• `Private` `Readonly` **\_currentPointerBox**: [`Atom`](Atom.md)<[`Pointer`](../README.md#pointer)<`O`\>\>
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[PointerProxy.ts:25](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/PointerProxy.ts#L25)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### pointer
|
### pointer
|
||||||
|
|
||||||
• `Readonly` **pointer**: [`Pointer`](../README.md#pointer)<`O`\>
|
• `Readonly` **pointer**: [`Pointer`](../README.md#pointer)<`O`\>
|
||||||
|
|
||||||
Convenience pointer pointing to the root of this PointerProxy.
|
Convenience pointer pointing to the root of this PointerProxy.
|
||||||
|
|
||||||
**`Remarks`**
|
|
||||||
|
|
||||||
Allows convenient use of [pointerToPrism](PointerProxy.md#pointertoprism) and [val](../README.md#val).
|
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[PointerProxy.ts:32](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/PointerProxy.ts#L32)
|
[PointerProxy.ts:32](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/PointerProxy.ts#L32)
|
||||||
|
|
||||||
## Methods
|
## Methods
|
||||||
|
|
||||||
|
@ -113,7 +93,7 @@ Returns a prism of the value at the provided sub-path of the proxied pointer.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[PointerProxy.ts:52](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/PointerProxy.ts#L52)
|
[PointerProxy.ts:52](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/PointerProxy.ts#L52)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -135,4 +115,4 @@ Sets the underlying pointer.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[PointerProxy.ts:43](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/PointerProxy.ts#L43)
|
[PointerProxy.ts:43](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/PointerProxy.ts#L43)
|
||||||
|
|
|
@ -14,13 +14,6 @@ external scheduling strategy, e.g. a raf.
|
||||||
### Properties
|
### Properties
|
||||||
|
|
||||||
- [\_\_ticks](Ticker.md#__ticks)
|
- [\_\_ticks](Ticker.md#__ticks)
|
||||||
- [\_conf](Ticker.md#_conf)
|
|
||||||
- [\_dormant](Ticker.md#_dormant)
|
|
||||||
- [\_numberOfDormantTicks](Ticker.md#_numberofdormantticks)
|
|
||||||
- [\_scheduledForNextTick](Ticker.md#_scheduledfornexttick)
|
|
||||||
- [\_scheduledForThisOrNextTick](Ticker.md#_scheduledforthisornexttick)
|
|
||||||
- [\_ticking](Ticker.md#_ticking)
|
|
||||||
- [\_timeAtCurrentTick](Ticker.md#_timeatcurrenttick)
|
|
||||||
|
|
||||||
### Accessors
|
### Accessors
|
||||||
|
|
||||||
|
@ -29,9 +22,6 @@ external scheduling strategy, e.g. a raf.
|
||||||
|
|
||||||
### Methods
|
### Methods
|
||||||
|
|
||||||
- [\_goActive](Ticker.md#_goactive)
|
|
||||||
- [\_goDormant](Ticker.md#_godormant)
|
|
||||||
- [\_tick](Ticker.md#_tick)
|
|
||||||
- [offNextTick](Ticker.md#offnexttick)
|
- [offNextTick](Ticker.md#offnexttick)
|
||||||
- [offThisOrNextTick](Ticker.md#offthisornexttick)
|
- [offThisOrNextTick](Ticker.md#offthisornexttick)
|
||||||
- [onNextTick](Ticker.md#onnexttick)
|
- [onNextTick](Ticker.md#onnexttick)
|
||||||
|
@ -54,7 +44,7 @@ external scheduling strategy, e.g. a raf.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Ticker.ts:43](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L43)
|
[Ticker.ts:43](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Ticker.ts#L43)
|
||||||
|
|
||||||
## Properties
|
## Properties
|
||||||
|
|
||||||
|
@ -70,86 +60,7 @@ Consider this as experimental, and do not rely on it always being here in future
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Ticker.ts:41](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L41)
|
[Ticker.ts:41](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Ticker.ts#L41)
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_conf
|
|
||||||
|
|
||||||
• `Private` `Optional` **\_conf**: `Object`
|
|
||||||
|
|
||||||
#### Type declaration
|
|
||||||
|
|
||||||
| Name | Type |
|
|
||||||
| :------ | :------ |
|
|
||||||
| `onActive?` | () => `void` |
|
|
||||||
| `onDormant?` | () => `void` |
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Ticker.ts:44](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L44)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_dormant
|
|
||||||
|
|
||||||
• `Private` **\_dormant**: `boolean` = `true`
|
|
||||||
|
|
||||||
Whether the Ticker is dormant
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Ticker.ts:24](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L24)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_numberOfDormantTicks
|
|
||||||
|
|
||||||
• `Private` **\_numberOfDormantTicks**: `number` = `0`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Ticker.ts:26](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L26)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_scheduledForNextTick
|
|
||||||
|
|
||||||
• `Private` **\_scheduledForNextTick**: `Set`<`ICallback`\>
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Ticker.ts:17](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L17)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_scheduledForThisOrNextTick
|
|
||||||
|
|
||||||
• `Private` **\_scheduledForThisOrNextTick**: `Set`<`ICallback`\>
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Ticker.ts:16](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L16)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_ticking
|
|
||||||
|
|
||||||
• `Private` **\_ticking**: `boolean` = `false`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Ticker.ts:19](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L19)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_timeAtCurrentTick
|
|
||||||
|
|
||||||
• `Private` **\_timeAtCurrentTick**: `number`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Ticker.ts:18](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L18)
|
|
||||||
|
|
||||||
## Accessors
|
## Accessors
|
||||||
|
|
||||||
|
@ -165,7 +76,7 @@ Whether the Ticker is dormant
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Ticker.ts:31](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L31)
|
[Ticker.ts:31](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Ticker.ts#L31)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -182,58 +93,10 @@ The time at the start of the current tick if there is a tick in progress, otherw
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Ticker.ts:122](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L122)
|
[Ticker.ts:122](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Ticker.ts#L122)
|
||||||
|
|
||||||
## Methods
|
## Methods
|
||||||
|
|
||||||
### \_goActive
|
|
||||||
|
|
||||||
▸ `Private` **_goActive**(): `void`
|
|
||||||
|
|
||||||
#### Returns
|
|
||||||
|
|
||||||
`void`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Ticker.ts:128](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L128)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_goDormant
|
|
||||||
|
|
||||||
▸ `Private` **_goDormant**(): `void`
|
|
||||||
|
|
||||||
#### Returns
|
|
||||||
|
|
||||||
`void`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Ticker.ts:134](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L134)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### \_tick
|
|
||||||
|
|
||||||
▸ `Private` **_tick**(`iterationNumber`): `void`
|
|
||||||
|
|
||||||
#### Parameters
|
|
||||||
|
|
||||||
| Name | Type |
|
|
||||||
| :------ | :------ |
|
|
||||||
| `iterationNumber` | `number` |
|
|
||||||
|
|
||||||
#### Returns
|
|
||||||
|
|
||||||
`void`
|
|
||||||
|
|
||||||
#### Defined in
|
|
||||||
|
|
||||||
[Ticker.ts:184](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L184)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### offNextTick
|
### offNextTick
|
||||||
|
|
||||||
▸ **offNextTick**(`fn`): `void`
|
▸ **offNextTick**(`fn`): `void`
|
||||||
|
@ -256,7 +119,7 @@ onNextTick
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Ticker.ts:114](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L114)
|
[Ticker.ts:114](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Ticker.ts#L114)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -282,7 +145,7 @@ onThisOrNextTick
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Ticker.ts:103](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L103)
|
[Ticker.ts:103](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Ticker.ts#L103)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -309,7 +172,7 @@ Registers a side effect to be called on the next tick.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Ticker.ts:89](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L89)
|
[Ticker.ts:89](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Ticker.ts#L89)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -342,7 +205,7 @@ offThisOrNextTick
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Ticker.ts:74](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L74)
|
[Ticker.ts:74](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Ticker.ts#L74)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -369,4 +232,4 @@ Triggers a tick which starts executing the callbacks scheduled for this tick.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[Ticker.ts:149](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/Ticker.ts#L149)
|
[Ticker.ts:149](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/Ticker.ts#L149)
|
||||||
|
|
|
@ -41,4 +41,4 @@ Returns a prism of the value at the provided pointer.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[pointerToPrism.ts:21](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/pointerToPrism.ts#L21)
|
[pointerToPrism.ts:21](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/pointerToPrism.ts#L21)
|
||||||
|
|
|
@ -34,7 +34,7 @@ Whether the prism is hot.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/Interface.ts:18](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/Interface.ts#L18)
|
[prism/Interface.ts:18](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/Interface.ts#L18)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -46,7 +46,7 @@ Whether the object is a prism.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/Interface.ts:13](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/Interface.ts#L13)
|
[prism/Interface.ts:13](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/Interface.ts#L13)
|
||||||
|
|
||||||
## Methods
|
## Methods
|
||||||
|
|
||||||
|
@ -62,7 +62,7 @@ Gets the current value of the prism. If the value is stale, it causes the prism
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/Interface.ts:60](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/Interface.ts#L60)
|
[prism/Interface.ts:60](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/Interface.ts#L60)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -78,7 +78,7 @@ Keep the prism hot, even if there are no tappers (subscribers).
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/Interface.ts:34](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/Interface.ts#L34)
|
[prism/Interface.ts:34](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/Interface.ts#L34)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -102,7 +102,7 @@ Calls `listener` with a fresh value every time the prism _has_ a new value, thro
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/Interface.ts:23](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/Interface.ts#L23)
|
[prism/Interface.ts:23](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/Interface.ts#L23)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -122,4 +122,4 @@ ___
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/Interface.ts:29](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/Interface.ts#L29)
|
[prism/Interface.ts:29](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/Interface.ts#L29)
|
||||||
|
|
|
@ -49,7 +49,7 @@ An effect hook, similar to React's `useEffect()`, but is not sensitive to call o
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/prism.ts:885](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/prism.ts#L885)
|
[prism/prism.ts:885](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/prism.ts#L885)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -88,7 +88,7 @@ setTimeout(() => {
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/prism.ts:887](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/prism.ts#L887)
|
[prism/prism.ts:887](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/prism.ts#L887)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -108,7 +108,7 @@ true if the current function is running inside a `prism()` call.
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/prism.ts:891](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/prism.ts#L891)
|
[prism/prism.ts:891](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/prism.ts#L891)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -154,7 +154,7 @@ const pr = prism(() => {
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/prism.ts:886](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/prism.ts#L886)
|
[prism/prism.ts:886](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/prism.ts#L886)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -204,7 +204,7 @@ const pr = prism(() => {
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/prism.ts:884](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/prism.ts#L884)
|
[prism/prism.ts:884](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/prism.ts#L884)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -235,7 +235,7 @@ ___
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/prism.ts:889](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/prism.ts#L889)
|
[prism/prism.ts:889](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/prism.ts#L889)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -291,7 +291,7 @@ function prismFromInputElement(input: HTMLInputElement): Prism<string> {
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/prism.ts:892](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/prism.ts#L892)
|
[prism/prism.ts:892](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/prism.ts#L892)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -354,7 +354,7 @@ const mousePositionD = prism(() => {
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/prism.ts:888](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/prism.ts#L888)
|
[prism/prism.ts:888](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/prism.ts#L888)
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -392,4 +392,4 @@ The value of the inner prism
|
||||||
|
|
||||||
#### Defined in
|
#### Defined in
|
||||||
|
|
||||||
[prism/prism.ts:890](https://github.com/theatre-js/theatre/blob/327b859ed/packages/dataverse/src/prism/prism.ts#L890)
|
[prism/prism.ts:890](https://github.com/theatre-js/theatre/blob/main/packages/dataverse/src/prism/prism.ts#L890)
|
||||||
|
|
23
packages/dataverse/typedoc.json
Normal file
23
packages/dataverse/typedoc.json
Normal file
|
@ -0,0 +1,23 @@
|
||||||
|
{
|
||||||
|
"visibilityFilters": {
|
||||||
|
"protected": false,
|
||||||
|
"private": false,
|
||||||
|
"inherited": true,
|
||||||
|
"external": false,
|
||||||
|
"@alpha": false,
|
||||||
|
"@beta": false
|
||||||
|
},
|
||||||
|
"excludeTags": [
|
||||||
|
"@override",
|
||||||
|
"@virtual",
|
||||||
|
"@privateRemarks",
|
||||||
|
"@satisfies",
|
||||||
|
"@overload",
|
||||||
|
"@remarks"
|
||||||
|
],
|
||||||
|
"categorizeByGroup": false,
|
||||||
|
"excludeInternal": true,
|
||||||
|
"excludeProtected": true,
|
||||||
|
"excludePrivate": true,
|
||||||
|
"sourceLinkTemplate": "https://github.com/theatre-js/theatre/blob/main/{path}#L{line}"
|
||||||
|
}
|
Loading…
Reference in a new issue