@onlyworlds/sdk 4.180.0 → 4.182.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +3 -3
- package/README.md +4 -3
- package/SCHEMA.md +1 -1
- package/dist/{chunk-XHCCTVG7.js → chunk-EFH2PAJN.js} +25 -0
- package/dist/index.d.ts +227 -61
- package/dist/index.js +417 -96
- package/dist/waymark.d.ts +2 -1
- package/dist/waymark.js +1 -1
- package/package.json +2 -2
package/dist/index.d.ts
CHANGED
|
@@ -2204,15 +2204,18 @@ declare function noteOf(narratives: readonly object[], characterId: string, memb
|
|
|
2204
2204
|
/** A reader of a lens: the rung decides what of the world it sees. */
|
|
2205
2205
|
interface OwLensReader {
|
|
2206
2206
|
/**
|
|
2207
|
-
* `owner` (the whole world), `
|
|
2207
|
+
* `owner` (the whole world), `co-builder` (the whole world as the owner reads it, hidden elements included, and
|
|
2208
|
+
* none of the owner's two counts: a keeper, as the charter profile names the role; serial 138), `contributor`
|
|
2209
|
+
* (the world less the hidden, plus the hidden elements it made, listed
|
|
2210
|
+
* in `whole`), `guest` (exactly the ids in
|
|
2208
2211
|
* `whole`, and those in `known_of` as stubs, less a hidden one: hidden beats `known_of`) or `public`
|
|
2209
2212
|
* (the world less the hidden and the room elements). A proposed element is in no reader's view, but below the public rung a served body keeps
|
|
2210
2213
|
* a link to one the rung sees, and a lens's note keyed to it.
|
|
2211
2214
|
*/
|
|
2212
|
-
rung: 'owner' | 'contributor' | 'guest' | 'public';
|
|
2215
|
+
rung: 'owner' | 'co-builder' | 'contributor' | 'guest' | 'public';
|
|
2213
2216
|
/** The reader's Character, for the mail rule; null or absent: no Character, no mail. */
|
|
2214
2217
|
character?: string | null;
|
|
2215
|
-
/** A guest's whole elements. */
|
|
2218
|
+
/** A guest's whole elements; a contributor's, the hidden elements it made. */
|
|
2216
2219
|
whole?: readonly string[] | null;
|
|
2217
2220
|
/** A guest's known-of elements, served as stubs (the base and public fields, every other field unset: no links, no date); one under the hidden mark is not in its view at all. */
|
|
2218
2221
|
known_of?: readonly string[] | null;
|
|
@@ -2445,7 +2448,7 @@ interface OwWorldMeta {
|
|
|
2445
2448
|
/** Whether the world can be read without its PIN. Read-only on the wire. */
|
|
2446
2449
|
public_read?: boolean;
|
|
2447
2450
|
/**
|
|
2448
|
-
* Whether a Narrative written through an
|
|
2451
|
+
* Whether a Narrative written through an AI seat is narrated by that seat's own Character,
|
|
2449
2452
|
* as a guest's is: set by the owner on the world page; read-only on the wire.
|
|
2450
2453
|
* With it on, an agent naming another narrator is a 422 (`param: narrator`), and a seat with no
|
|
2451
2454
|
* Character a 403 `guest_not_supported`.
|
|
@@ -2466,7 +2469,7 @@ interface OwWorldMeta {
|
|
|
2466
2469
|
*/
|
|
2467
2470
|
public_page?: OwWorldPublicPage;
|
|
2468
2471
|
/**
|
|
2469
|
-
* Whether an
|
|
2472
|
+
* Whether an AI seat's writes land as proposals: on, a seat's PATCH, PUT, link
|
|
2470
2473
|
* edit or /bulk item on an existing element answers 202 with the proposal (this client throws
|
|
2471
2474
|
* an OwProposedError; a /bulk slot carries `status: 202` and `proposal`) and the element does
|
|
2472
2475
|
* not change until the owner or a co-builder accepts it; its new elements carry
|
|
@@ -2639,12 +2642,12 @@ interface OwHiddenRow {
|
|
|
2639
2642
|
}
|
|
2640
2643
|
/**
|
|
2641
2644
|
* The door a write came through, as keel records it on every element (`changed_via`) and on a
|
|
2642
|
-
* delete (`deleted_via`): `seat` (an
|
|
2645
|
+
* delete (`deleted_via`): `seat` (an AI seat), `mcp` (the MCP server),
|
|
2643
2646
|
* `declared` (a client that sent `X-OW-Agent`; see {@link OwClientConfig.agent}), then the
|
|
2644
2647
|
* surface for everything else: `api`, `v1`, `sync`, and `server` for keel's own writes.
|
|
2645
2648
|
*/
|
|
2646
2649
|
type OwWriteDoor = NonNullable<OwElementBase['changed_via']>;
|
|
2647
|
-
/** The doors that mean agent-made: an
|
|
2650
|
+
/** The doors that mean agent-made: an AI seat, the MCP server, or a client that declared itself. */
|
|
2648
2651
|
declare const AGENT_DOORS: readonly OwWriteDoor[];
|
|
2649
2652
|
/** Whether a write came through an agent's door (`changed_via` or `deleted_via`); false for null. */
|
|
2650
2653
|
declare function isAgentDoor(door: OwWriteDoor | null | undefined): boolean;
|
|
@@ -2725,8 +2728,8 @@ interface OwBulkItem {
|
|
|
2725
2728
|
* After an `atomic: true` request with `errors` true NOTHING was written, yet the slots of
|
|
2726
2729
|
* the items that would have succeeded still say 201 (keel's "counterfactual 201s"): do not
|
|
2727
2730
|
* record their ids as created.
|
|
2728
|
-
* On a world that takes an
|
|
2729
|
-
* an
|
|
2731
|
+
* On a world that takes an AI seat's writes as proposals (`agent_writes_proposed`),
|
|
2732
|
+
* an AI seat's item on an existing element answers `{status: 202, id, proposal}`: the element
|
|
2730
2733
|
* did not change, and `proposal` is the row a keeper accepts or declines.
|
|
2731
2734
|
*/
|
|
2732
2735
|
interface OwBulkItemResult {
|
|
@@ -2824,7 +2827,7 @@ interface OwProposal {
|
|
|
2824
2827
|
evidence: string;
|
|
2825
2828
|
/** When it lapses if nobody decides (UTC). */
|
|
2826
2829
|
expires: string;
|
|
2827
|
-
/** Who proposed it: the membership id (a person, an
|
|
2830
|
+
/** Who proposed it: the membership id (a person, an AI seat or a player seat, as `members()` lists them), or `owner`. */
|
|
2828
2831
|
by: string;
|
|
2829
2832
|
/** The door it came through, as an element's changed_via. */
|
|
2830
2833
|
via: string;
|
|
@@ -2846,7 +2849,7 @@ interface OwProposalList {
|
|
|
2846
2849
|
}
|
|
2847
2850
|
/**
|
|
2848
2851
|
* A row of the world's queue for a new element written as proposed (the document's
|
|
2849
|
-
* `ProposedNewElement`): an element carrying `x_review_proposed` (an
|
|
2852
|
+
* `ProposedNewElement`): an element carrying `x_review_proposed` (an AI seat's new element on a
|
|
2850
2853
|
* world that takes its writes as proposals, or any writer's mark). The element itself is the
|
|
2851
2854
|
* record, so the row has no id of its own. A keeper settles it with `reviewNewElement`. `by`,
|
|
2852
2855
|
* `evidence` and `expires` are the mark's own words, null when it lacks one; `evidence` is quoted
|
|
@@ -3165,7 +3168,7 @@ interface OwFrontDoor {
|
|
|
3165
3168
|
/** Your own Character (the owner's: the world's `owner_character`), or null. */
|
|
3166
3169
|
my_character: string | null;
|
|
3167
3170
|
/**
|
|
3168
|
-
* The live AI and player seats you answer for,
|
|
3171
|
+
* The live AI and player seats you answer for, AI seats first (since keel's front door of
|
|
3169
3172
|
* 2026-10-26). Empty for an AI or a player seat's own key and for anyone who answers for none.
|
|
3170
3173
|
* A seat made from a link for an email address is listed for the link's maker (since 2026-11-15).
|
|
3171
3174
|
*/
|
|
@@ -3552,7 +3555,7 @@ interface OwSignedIn {
|
|
|
3552
3555
|
/** Its last four characters, as the account's tokens page shows them. */
|
|
3553
3556
|
last4: string;
|
|
3554
3557
|
}
|
|
3555
|
-
/** One live
|
|
3558
|
+
/** One live AI seat, as GET /account/worlds/{id}/seats lists it. No key or secret. */
|
|
3556
3559
|
/**
|
|
3557
3560
|
* One world of the account, from GET /account/worlds: owned (`role: 'owner'`) or shared
|
|
3558
3561
|
* (`'collaborator'`, with `member_role` the membership's role). Keys by name and last four only,
|
|
@@ -4062,7 +4065,7 @@ interface OwFileAddedBy {
|
|
|
4062
4065
|
name: string;
|
|
4063
4066
|
/** Their membership id; null for the owner's files and for a file whose membership no longer exists (`owner` tells the two apart). */
|
|
4064
4067
|
membership: string | null;
|
|
4065
|
-
/** True when an agent added it: an
|
|
4068
|
+
/** True when an agent added it: an AI seat, the MCP surface, or a key that declared an agent. */
|
|
4066
4069
|
agent: boolean;
|
|
4067
4070
|
/**
|
|
4068
4071
|
* True when the world's current owner added the file, through any door (the site, the API, or an agent with the
|
|
@@ -4188,7 +4191,7 @@ interface ListParams {
|
|
|
4188
4191
|
filter?: Record<string, string | number | boolean>;
|
|
4189
4192
|
/**
|
|
4190
4193
|
* View as, sent as `as`: read as another reader of this world would. A membership
|
|
4191
|
-
* id (a person, an
|
|
4194
|
+
* id (a person, an AI seat or a player seat) reads as that member's own key; a Character id
|
|
4192
4195
|
* reads as a guest of that Character with no membership; `'public'` reads everything not
|
|
4193
4196
|
* hidden. The owner's keys only (a key with no member): a member key gets 403
|
|
4194
4197
|
* `view_as_owner_only` (`err.isViewAsOwnerOnly`). An element hidden from that reader is 404,
|
|
@@ -4212,7 +4215,7 @@ interface OwClientConfig {
|
|
|
4212
4215
|
*/
|
|
4213
4216
|
apiKey?: string;
|
|
4214
4217
|
/**
|
|
4215
|
-
* The PIN (or an
|
|
4218
|
+
* The PIN (or an AI seat's `ow_s_` secret), needed for writes when the world has one, and for
|
|
4216
4219
|
* legacy-key reads of a world with a PIN. Sent as `API-Pin` only where keel checks it: on every
|
|
4217
4220
|
* write (any method but GET), on GET /me (me(), the connection test), and on every request of a
|
|
4218
4221
|
* 10-digit legacy key. A prefixed key's other reads go without it, and an account token never
|
|
@@ -4238,7 +4241,7 @@ interface OwClientConfig {
|
|
|
4238
4241
|
* editLinks, bulk) carries `X-OW-Agent`, the operations the API document declares it on, and onlyworlds.com
|
|
4239
4242
|
* records its writes as agent-made (`changed_via: 'declared'`; the server stores that the header
|
|
4240
4243
|
* was there, never its value). Off by default, and it must stay off in a tool people use:
|
|
4241
|
-
* it describes the caller, so only the caller can set it. An
|
|
4244
|
+
* it describes the caller, so only the caller can set it. An AI seat's key is recorded
|
|
4242
4245
|
* as an agent without it.
|
|
4243
4246
|
*/
|
|
4244
4247
|
agent?: boolean;
|
|
@@ -4525,7 +4528,7 @@ declare class OwApiError extends Error {
|
|
|
4525
4528
|
/** ask: the model gave no answer (502 `ask_failed`). Not counted; try again in a moment. */
|
|
4526
4529
|
get isAskFailed(): boolean;
|
|
4527
4530
|
/**
|
|
4528
|
-
* patch, upsert or editLinks became a proposal (202): the world takes an
|
|
4531
|
+
* patch, upsert or editLinks became a proposal (202): the world takes an AI seat's
|
|
4529
4532
|
* writes as proposals (`agent_writes_proposed`), so the element did not change. The error is an
|
|
4530
4533
|
* OwProposedError; its `proposal` is the row a keeper accepts or declines. Not a failure to retry:
|
|
4531
4534
|
* the write is waiting for a person.
|
|
@@ -4552,7 +4555,7 @@ declare class OwApiError extends Error {
|
|
|
4552
4555
|
*/
|
|
4553
4556
|
get isStaleProposal(): boolean;
|
|
4554
4557
|
/**
|
|
4555
|
-
* While the world takes
|
|
4558
|
+
* While the world takes AI seats' writes as proposals, an AI seat's key tried
|
|
4556
4559
|
* what it may not: delete an element it did not create, or accept or decline a proposal (403
|
|
4557
4560
|
* `proposed_only`). On any world, reviewNewElement by the member the mark names is the same 403.
|
|
4558
4561
|
* Retrying will not help; a person decides.
|
|
@@ -4600,7 +4603,7 @@ declare class OwStaleProposalError extends OwApiError {
|
|
|
4600
4603
|
constructor(status: number, code: string | null, message: string, docUrl: string | null, detail: unknown, type?: string | null, param?: string | null, retryAfter?: number | null);
|
|
4601
4604
|
}
|
|
4602
4605
|
/**
|
|
4603
|
-
* 202 on patch, upsert or editLinks: the world takes an
|
|
4606
|
+
* 202 on patch, upsert or editLinks: the world takes an AI seat's writes as
|
|
4604
4607
|
* proposals (`agent_writes_proposed`, set by its owner), so the write became a proposal and the
|
|
4605
4608
|
* element did not change. The answer is `{proposal}`, never an element, so this client throws
|
|
4606
4609
|
* rather than hand it back as one. `proposal` is the row; a keeper (the owner or a co-builder)
|
|
@@ -4879,7 +4882,7 @@ declare class OwV2Client {
|
|
|
4879
4882
|
* A person member's write key with its PIN; answers GET /me's body. 422 for a hidden
|
|
4880
4883
|
* Character (`character_hidden`, `err.isCharacterHidden`), a guest's pick it did not make, or a
|
|
4881
4884
|
* taken Character (`invalid_request`, `param` character); 404 for one this key cannot see; 403 for
|
|
4882
|
-
* an
|
|
4885
|
+
* an AI seat, a player, the owner (whose own is the world's `owner_character`, set with
|
|
4883
4886
|
* patchWorld) or a read key. A guest's view resets once.
|
|
4884
4887
|
*/
|
|
4885
4888
|
setMyCharacter(character: string | null): Promise<OwMe>;
|
|
@@ -4889,7 +4892,7 @@ declare class OwV2Client {
|
|
|
4889
4892
|
* a seat off its Titles' lenses. `null` goes back to never chosen: a seat playing a Character then
|
|
4890
4893
|
* starts with its Titles' lenses (`lenses_from` says where a list comes from); on the owner's own
|
|
4891
4894
|
* keys `null` is the empty list. Any write
|
|
4892
|
-
* key of the world, with its PIN, sets its own holder's list: a person member's, an
|
|
4895
|
+
* key of the world, with its PIN, sets its own holder's list: a person member's, an AI seat's, or
|
|
4893
4896
|
* on the owner's keys the owner's own; answers GET /me's body. The draught reads the list whenever it
|
|
4894
4897
|
* is given no lens and no policy. 404 for a lens this key cannot see; 422 `not_a_lens`,
|
|
4895
4898
|
* `lens_is_template` or `lens_hidden` (`param` lenses); 403 for a read key. A lens only narrows what
|
|
@@ -5019,7 +5022,7 @@ declare class OwV2Client {
|
|
|
5019
5022
|
* PUT /{type}/{id}/ -- upsert-by-client-id. The local-first write primitive. A known-of
|
|
5020
5023
|
* stub (`known_of: true`, see isKnownOf) is a TypeError before sending, here and on every
|
|
5021
5024
|
* element write: a PUT of one would blank every field it does not keep.
|
|
5022
|
-
* An
|
|
5025
|
+
* An AI seat's PUT on an existing element, in a world that takes its writes as proposals,
|
|
5023
5026
|
* answers 202 and is thrown as an OwProposedError: the element did not change.
|
|
5024
5027
|
*/
|
|
5025
5028
|
upsert(type: ElementType | string, id: string, element: OwElement | Record<string, unknown>): Promise<OwElement>;
|
|
@@ -5033,7 +5036,7 @@ declare class OwV2Client {
|
|
|
5033
5036
|
* an OwPreconditionFailedError (412) whose `current` is the element as it is now. Omit
|
|
5034
5037
|
* it for today's unconditional write.
|
|
5035
5038
|
*
|
|
5036
|
-
* In a world that takes an
|
|
5039
|
+
* In a world that takes an AI seat's writes as proposals (the world's
|
|
5037
5040
|
* `agent_writes_proposed`), a seat's patch answers 202 with `{proposal}`, never an element:
|
|
5038
5041
|
* this throws an OwProposedError (`err.isProposed`, the row under `err.proposal`) and the
|
|
5039
5042
|
* element did not change. If-Match is checked first: a stale one is still a 412.
|
|
@@ -5059,7 +5062,7 @@ declare class OwV2Client {
|
|
|
5059
5062
|
* Dedupes, tolerates already-present/already-absent ids. Returns the FULL
|
|
5060
5063
|
* updated element (fixture P5). Use this for all relationship editing; it
|
|
5061
5064
|
* retires the read-merge-PATCH dance. `ifMatch` works as on patch(): a link write
|
|
5062
|
-
* moves the element too. A 202 (an
|
|
5065
|
+
* moves the element too. A 202 (an AI seat's link edit that became a proposal)
|
|
5063
5066
|
* is thrown as an OwProposedError, as on patch().
|
|
5064
5067
|
*/
|
|
5065
5068
|
editLinks(type: ElementType | string, id: string, field: string, edit: OwLinkEdit, opts?: {
|
|
@@ -5089,7 +5092,7 @@ declare class OwV2Client {
|
|
|
5089
5092
|
* After an atomic:true request with errors:true NOTHING was written, yet the slots of
|
|
5090
5093
|
* the items that would have succeeded still say 201 with the ids and timestamps they
|
|
5091
5094
|
* would have had (keel's "counterfactual 201s"): do not record those ids as created.
|
|
5092
|
-
* An
|
|
5095
|
+
* An AI seat's item on an existing element, in a world that takes its writes as
|
|
5093
5096
|
* proposals, answers a slot `{status: 202, id, proposal}`: never thrown, the
|
|
5094
5097
|
* element unchanged, the slot's `proposal` the row a keeper decides.
|
|
5095
5098
|
* An element without an id gets one, as `create` mints it, by its position in `items`: with an
|
|
@@ -5206,7 +5209,7 @@ declare class OwV2Client {
|
|
|
5206
5209
|
/**
|
|
5207
5210
|
* POST /media/remove-ticket -- permission to remove ONE image (a write key and its
|
|
5208
5211
|
* PIN). The image's uploader may remove it, and so may the world's owner key; an
|
|
5209
|
-
*
|
|
5212
|
+
* AI seat answers as its sponsor. Only images uploaded with a ticket qualify.
|
|
5210
5213
|
* `key` is the object key, or the whole image_url (the part after the host is taken).
|
|
5211
5214
|
* The reply's `referenced` counts the world's elements still showing the image.
|
|
5212
5215
|
* Refusals: 403 `permission_error` (neither uploader nor owner), 404 `not_found`
|
|
@@ -5321,7 +5324,7 @@ declare class OwV2Client {
|
|
|
5321
5324
|
/**
|
|
5322
5325
|
* DELETE /{type}/{id}/files/{fileId} -- remove a file for real: it leaves the lists and
|
|
5323
5326
|
* the world's total at once, and its bytes are deleted from the store. The world's owner
|
|
5324
|
-
* key may, and so may the key of whoever added it (an
|
|
5327
|
+
* key may, and so may the key of whoever added it (an AI seat answers as its sponsor);
|
|
5325
5328
|
* any other key is 403 `permission_error`. A file that is not there is 404 `not_found`.
|
|
5326
5329
|
* Deleting an element removes its files too.
|
|
5327
5330
|
*/
|
|
@@ -5465,7 +5468,7 @@ declare class OwV2Client {
|
|
|
5465
5468
|
character?: 'new' | 'none' | 'mine';
|
|
5466
5469
|
}): Promise<OwSeatCreated>;
|
|
5467
5470
|
/**
|
|
5468
|
-
* GET /account/worlds/{worldId}/seats -- the live
|
|
5471
|
+
* GET /account/worlds/{worldId}/seats -- the live AI seats you can see: your own AI's, or,
|
|
5469
5472
|
* as the world's owner, every seat. No keys or secrets. Needs the client's `ow_a_` token.
|
|
5470
5473
|
*/
|
|
5471
5474
|
listSeats(worldId: string): Promise<OwSeat[]>;
|
|
@@ -5478,7 +5481,7 @@ declare class OwV2Client {
|
|
|
5478
5481
|
*/
|
|
5479
5482
|
rekeySeat(worldId: string, seatId: string): Promise<OwSeatCreated>;
|
|
5480
5483
|
/**
|
|
5481
|
-
* DELETE /account/worlds/{worldId}/seats/{seatId} -- remove an
|
|
5484
|
+
* DELETE /account/worlds/{worldId}/seats/{seatId} -- remove an AI seat: its sponsor or the
|
|
5482
5485
|
* world's owner may. Its key and secret stop at once; the Character it plays goes with it only
|
|
5483
5486
|
* while it is as the join left one (made by the join, named as the seat, supertype `Agent` alone,
|
|
5484
5487
|
* last written by the join, linked from nothing, played by no one else); any other stays, one
|
|
@@ -5522,7 +5525,7 @@ declare class OwV2Client {
|
|
|
5522
5525
|
/**
|
|
5523
5526
|
* POST /{type}/{id}/proposals -- propose a change to an element without making it. Any member
|
|
5524
5527
|
* who reads the element proposes (the owner with its write key and PIN; a co-builder, a
|
|
5525
|
-
* contributor, a guest, an
|
|
5528
|
+
* contributor, a guest, an AI seat or a player seat, whose read key is enough). `fields` is
|
|
5526
5529
|
* cleaned as patch() cleans a body (a read body's server keys stripped; a known-of stub is a
|
|
5527
5530
|
* TypeError before sending) and names only fields this key's view of the element holds;
|
|
5528
5531
|
* `evidence` is 1 to 2,000 characters; `expires` 1 to 365 days out (keel's default 30). keel
|
|
@@ -5560,7 +5563,7 @@ declare class OwV2Client {
|
|
|
5560
5563
|
* POST /{type}/{id}/proposals/{pid}/accept -- write the proposal's fields to the element as one
|
|
5561
5564
|
* ordinary write by this key (`changed_by` is the keeper, a new change_seq, a /changes row), and
|
|
5562
5565
|
* the row turns accepted. The world's owner key or a co-builder's, with its PIN; never the
|
|
5563
|
-
* proposer's own (403 `own_proposal`, `err.isOwnProposal`), never an
|
|
5566
|
+
* proposer's own (403 `own_proposal`, `err.isOwnProposal`), never an AI seat's while the
|
|
5564
5567
|
* world holds them (403 `proposed_only`, `err.isProposedOnly`). Refused with nothing written when
|
|
5565
5568
|
* a proposed field moved since (409 `stale_proposal`: an OwStaleProposalError carrying
|
|
5566
5569
|
* `conflicts` and `current`; the row stays open) or a proposed link names an element deleted
|
|
@@ -5590,7 +5593,7 @@ declare class OwV2Client {
|
|
|
5590
5593
|
* deletes the element (a tombstone, the links to it scrubbed, its open proposals dropped) and
|
|
5591
5594
|
* answers `{ deleted }`, its id; the reason is answered back and kept nowhere. Refusals: 422
|
|
5592
5595
|
* `not_proposed` (`err.isNotProposed`: the element carries no mark), 403 `proposed_only`
|
|
5593
|
-
* (`err.isProposedOnly`: the seat the mark names, or an
|
|
5596
|
+
* (`err.isProposedOnly`: the seat the mark names, or an AI seat under the world's switch), 403
|
|
5594
5597
|
* for any key but a keeper's. A proposed change to an existing element is decided with
|
|
5595
5598
|
* acceptProposal or declineProposal instead.
|
|
5596
5599
|
*/
|
|
@@ -6045,6 +6048,24 @@ declare function isRoomElement(el: {
|
|
|
6045
6048
|
supertype?: string | null;
|
|
6046
6049
|
x_room_of?: unknown;
|
|
6047
6050
|
}): boolean;
|
|
6051
|
+
/** One talk on an element (room.md, serial 135): an Object named in a line's `objects`, or a Construct named in its `constructs`, by its id as written. */
|
|
6052
|
+
interface OwTalk {
|
|
6053
|
+
type: 'object' | 'construct';
|
|
6054
|
+
id: string;
|
|
6055
|
+
}
|
|
6056
|
+
/**
|
|
6057
|
+
* The talks on an element that `element` is in as a line (schema-dist profiles/room.md, serial 135): `{type: 'object', id}`
|
|
6058
|
+
* for each id in its `objects` and `{type: 'construct', id}` for each in its `constructs`. Only a line in the room is in a
|
|
6059
|
+
* talk: a room element (`isRoomElement`, the pair and the mark x_room_of) whose pair is `narrative` + `Message`; any other
|
|
6060
|
+
* element, a Message without the mark, a board entry or a report included, answers `[]`.
|
|
6061
|
+
*
|
|
6062
|
+
* An entry that is not a string, or is empty once trimmed of White_Space (the room profile's set), names nothing, and a
|
|
6063
|
+
* field that is not a list names nothing; every other entry is an id read as written, a space left on it and its case
|
|
6064
|
+
* included, so `ABC` and `abc` are two talks. A line's `characters` are its recipients and make no talk, nor does any other
|
|
6065
|
+
* field. Each `{type, id}` comes once, in the place it is first named, objects before constructs (the page rules no order:
|
|
6066
|
+
* compare as a set when the order does not matter). Pure.
|
|
6067
|
+
*/
|
|
6068
|
+
declare function talksOf(element: unknown): OwTalk[];
|
|
6048
6069
|
/**
|
|
6049
6070
|
* True when the element is a reading aid (schema-dist profiles/room.md, profiles/lens.md rule 4): the
|
|
6050
6071
|
* world's charter (`law`, supertype `Charter`), its guide (`construct`, supertype `Guide`) or one of its
|
|
@@ -6104,6 +6125,27 @@ interface OwCharterWorld extends OwLensWorld {
|
|
|
6104
6125
|
declare function charterOf(world: OwCharterWorld, reader: OwLensReader): OwReadingAids;
|
|
6105
6126
|
/** The marked Domains alone, as `charterOf` lists them for the same reader. */
|
|
6106
6127
|
declare function domainsOf(world: OwCharterWorld, reader: OwLensReader): OwReadingAidsDomain[];
|
|
6128
|
+
/** A design part (charter.md, serial 135): an Object or a Construct whose `subtype` is a design state, and that state. */
|
|
6129
|
+
interface OwDesignPart {
|
|
6130
|
+
/** The type as the packet writes one, whatever spelling the element's type is stored in. */
|
|
6131
|
+
type: 'object' | 'construct';
|
|
6132
|
+
id: string;
|
|
6133
|
+
/** The design state: the subtype trimmed and folded, whatever spelling it is stored in (`In Design ` is `in design`). */
|
|
6134
|
+
state: 'in design' | 'locked';
|
|
6135
|
+
}
|
|
6136
|
+
/**
|
|
6137
|
+
* The design parts `reader` reads in a world (schema-dist profiles/charter.md, serial 135): each Object or Construct the
|
|
6138
|
+
* reader is served whole whose `subtype`, trimmed and compared without regard to case as the room profile defines it, is
|
|
6139
|
+
* `in design` or `locked`, as `{type, id, state}`, in the world's order (the page orders no parts: compare as a set).
|
|
6140
|
+
*
|
|
6141
|
+
* Only where `charterOf` finds a Charter for the same reader: with none (no Charter, only one without the mark, only a
|
|
6142
|
+
* proposed one, or one the hidden mark keeps from the reader), no element has a design state and the answer is `[]`,
|
|
6143
|
+
* even where another reader of the same world reads parts. The state alone makes a part, whatever the supertype; no
|
|
6144
|
+
* other subtype and no other type has one. A known-of stub has none, though it is served its subtype; what the reader
|
|
6145
|
+
* sees (hidden and proposed elements, the rungs) is `charterOf`'s own view. Takes the same world and reader as
|
|
6146
|
+
* `charterOf`. Pure.
|
|
6147
|
+
*/
|
|
6148
|
+
declare function designPartsOf(world: OwCharterWorld, reader: OwLensReader): OwDesignPart[];
|
|
6107
6149
|
|
|
6108
6150
|
/** The Event's field that carries the record's mark. */
|
|
6109
6151
|
declare const RECORD_FIELD = "x_record";
|
|
@@ -6333,6 +6375,18 @@ interface OwReportThreads {
|
|
|
6333
6375
|
* A thread takes nothing away from where a report hangs: its `relations` and `events` still hold it. Pure.
|
|
6334
6376
|
*/
|
|
6335
6377
|
declare function reportThreadsOf(narratives: readonly object[]): OwReportThreads;
|
|
6378
|
+
/**
|
|
6379
|
+
* The talks a reader shows a report with (schema-dist profiles/report.md, serial 135): `{type: 'object', id}` for each id in
|
|
6380
|
+
* the report's `objects` and `{type: 'construct', id}` for each in its `constructs`, its entries read as the room profile reads
|
|
6381
|
+
* a line's (`talksOf`): an entry that is not a string, or is empty once trimmed of White_Space, names nothing, a field that is
|
|
6382
|
+
* not a list names nothing, and every other entry is an id as written, untrimmed and with its case; each once, in first
|
|
6383
|
+
* place, objects before constructs. A report is a Narrative with supertype `Report` and the room's mark `x_room_of`, both;
|
|
6384
|
+
* any other Narrative (a Report without the mark, a line in the room, a board entry) answers `[]`.
|
|
6385
|
+
*
|
|
6386
|
+
* These fields hold every Object and Construct the report touched or changed, so the answer is every talk it is shown with,
|
|
6387
|
+
* old reports included; none of them is named as the talk the report closed, which the report alone cannot tell. Pure.
|
|
6388
|
+
*/
|
|
6389
|
+
declare function reportTalksOf(narrative: unknown): OwTalk[];
|
|
6336
6390
|
/** What `readReportLine` answers for one line of a report's `consequences`. */
|
|
6337
6391
|
interface OwReportLine {
|
|
6338
6392
|
/** The line as read. */
|
|
@@ -6382,6 +6436,97 @@ declare function readReportLine(line: string, options?: OwReportLineOptions): Ow
|
|
|
6382
6436
|
*/
|
|
6383
6437
|
declare function readReportLines(text: string, options?: OwReportLineOptions): OwReportLine[];
|
|
6384
6438
|
|
|
6439
|
+
/** A work item's state (rule 5): one of the four words, as the fold writes them. */
|
|
6440
|
+
type OwWorkState = 'open' | 'taken' | 'done' | 'standing';
|
|
6441
|
+
/** One entry of a work item's `x_packet_elements` (rule 1): the element's type slug, its id as written, and why it is in the packet. */
|
|
6442
|
+
interface OwWorkElement {
|
|
6443
|
+
type: string;
|
|
6444
|
+
id: string;
|
|
6445
|
+
reason: string;
|
|
6446
|
+
}
|
|
6447
|
+
/** A world as `workOf` reads it: its Characters' ids and the ids of every other element of it the reader holds, each as written. */
|
|
6448
|
+
interface OwWorkWorld {
|
|
6449
|
+
id?: string | null;
|
|
6450
|
+
/** The ids of the world's Characters the reader holds. */
|
|
6451
|
+
characters?: readonly string[] | null;
|
|
6452
|
+
/** The ids of every other element of the world the reader holds. */
|
|
6453
|
+
others?: readonly string[] | null;
|
|
6454
|
+
}
|
|
6455
|
+
/** A lint `workOf` reports: `asker` on a work item whose `x_packet_from` is no one id, or names an element the reader holds that is no Character of the world (rule 8). */
|
|
6456
|
+
interface OwWorkLint {
|
|
6457
|
+
kind: 'asker';
|
|
6458
|
+
item: string;
|
|
6459
|
+
}
|
|
6460
|
+
/** `workOf`'s answer. Every map is keyed by an id as written; no list of work items is in a rule order (compare them as sets) except `elements`. */
|
|
6461
|
+
interface OwWork {
|
|
6462
|
+
/** For each work item, its state, or null for no state (rule 5). */
|
|
6463
|
+
states: Record<string, OwWorkState | null>;
|
|
6464
|
+
/** Every work item, in the order given: no item is hidden for its state. */
|
|
6465
|
+
shown: string[];
|
|
6466
|
+
/** For each element any work item names in `x_packet_elements`, the open work that names it (state `open` or `taken`). */
|
|
6467
|
+
openWork: Record<string, string[]>;
|
|
6468
|
+
/** For each work item, its elements in `x_packet_elements`' order (rule 1), each `{type, id, reason}`. */
|
|
6469
|
+
elements: Record<string, OwWorkElement[]>;
|
|
6470
|
+
/** For each work item, the Character of the world that asked for it, or null (rule 8). */
|
|
6471
|
+
askers: Record<string, string | null>;
|
|
6472
|
+
/** One `asker` lint per work item whose key is no one id or names an element the reader holds that is no Character of the world. */
|
|
6473
|
+
lints: OwWorkLint[];
|
|
6474
|
+
/** For each Character of the world, the open work it asked for: what it is waiting on. */
|
|
6475
|
+
waitingOn: Record<string, string[]>;
|
|
6476
|
+
}
|
|
6477
|
+
/**
|
|
6478
|
+
* A work item's state (schema-dist profiles/packet.md, rule 5): its `subtype`, trimmed of White_Space and compared without
|
|
6479
|
+
* regard to case as the room profile defines it, when that is `open`, `taken`, `done` or `standing`; else null, no state
|
|
6480
|
+
* (a subtype that is missing, null, not a string, empty, White_Space alone or any other word). ` Standing` is `standing`,
|
|
6481
|
+
* `OPEN` is `open`; `open` after a byte order mark is no state, since U+FEFF is no White_Space.
|
|
6482
|
+
*
|
|
6483
|
+
* A work item is a Relation with supertype `Work item`, the type and supertype trimmed and folded the same way; the room
|
|
6484
|
+
* mark is not needed. Anything else answers null: its subtype is no work state. Pure.
|
|
6485
|
+
*/
|
|
6486
|
+
declare function workStateOf(item: unknown): OwWorkState | null;
|
|
6487
|
+
/**
|
|
6488
|
+
* True when the work item is open work (packet.md, rules 5 and 7): its state is `open` or `taken`. A `done` item, a
|
|
6489
|
+
* `standing` one (never done, a kept list) and one with no state are never open work, and anything that is no work item
|
|
6490
|
+
* is none. A reader offers to take a work item, or to set it done, only when this is true. Pure.
|
|
6491
|
+
*/
|
|
6492
|
+
declare function isOpenWork(item: unknown): boolean;
|
|
6493
|
+
/**
|
|
6494
|
+
* Who asked for a work item (schema-dist profiles/packet.md, rule 8): the id its `x_packet_from` writes, as written (never
|
|
6495
|
+
* trimmed, never folded), or null. Absent or null names no one; a value that is not a string, or a string empty once
|
|
6496
|
+
* trimmed of White_Space, is no id and names no one. The asker is never the maker (`created_by`, or the tool
|
|
6497
|
+
* `x_packet_producer` names) and never `actor`.
|
|
6498
|
+
*
|
|
6499
|
+
* With `world` (`{characters, others}`, as `workOf` takes it), the id counts only when it is, written exactly so, one of
|
|
6500
|
+
* the world's Characters; any other id is null (`workOf` says which of them is a lint). Without `world`, the answer is the
|
|
6501
|
+
* key's id unchecked: whether it names a Character the reader holds is the caller's to read. Anything that is no work item
|
|
6502
|
+
* answers null. Pure.
|
|
6503
|
+
*/
|
|
6504
|
+
declare function askerOf(item: unknown, world?: OwWorkWorld): string | null;
|
|
6505
|
+
/**
|
|
6506
|
+
* The work items one reader is given, read together (schema-dist profiles/packet.md, rules 1, 5, 7 and 8; the fixture's
|
|
6507
|
+
* parts). `items` are the work items in the order given; anything that is no work item (a Relation with supertype
|
|
6508
|
+
* `Work item`, trimmed and folded) or carries no non-empty string `id` is in no part of the answer, and of two with one
|
|
6509
|
+
* id the first is read. `world` is the world they sit in, `{id, characters, others}`: its Characters' ids and the ids of
|
|
6510
|
+
* every other element of it the reader holds, each as written. `sourceWorld`, in the same shape, is the world packets
|
|
6511
|
+
* about another world name, whose elements the reader holds too; its Characters are no Characters of `world`.
|
|
6512
|
+
*
|
|
6513
|
+
* - `states`: each item's state (`workStateOf`). `shown`: every item, whatever its state.
|
|
6514
|
+
* - `elements`: each item's `x_packet_elements`, in their order, each `{type, id, reason}`; an entry without the three
|
|
6515
|
+
* (strings, the id not blank) is ignored.
|
|
6516
|
+
* - `openWork`: for each element id any item names, the ids of the open work (`isOpenWork`) that names it; a standing
|
|
6517
|
+
* item is counted on none.
|
|
6518
|
+
* - `askers`: each item's asker, the Character of `world` its `x_packet_from` names written exactly so, else null.
|
|
6519
|
+
* - `lints`: `{kind: 'asker', item}` for a key that is no one id (not a string, or empty once trimmed of White_Space), or
|
|
6520
|
+
* that names, written exactly so, an element the reader holds that is no Character of `world` (an id in `others`, in
|
|
6521
|
+
* `sourceWorld`, or one of the items given). A key absent or null, and an id that names no element the reader holds in
|
|
6522
|
+
* any spelling, are no lint.
|
|
6523
|
+
* - `waitingOn`: for each Character of `world`, the open work whose asker it is.
|
|
6524
|
+
*
|
|
6525
|
+
* Only `elements` holds lists in a rule order; `shown`, every list in `openWork` and `waitingOn`, and `lints` are in the
|
|
6526
|
+
* order the items are given, and the page rules none: compare them as sets. Pure.
|
|
6527
|
+
*/
|
|
6528
|
+
declare function workOf(items: readonly object[], world: OwWorkWorld, sourceWorld?: OwWorkWorld | null): OwWork;
|
|
6529
|
+
|
|
6385
6530
|
/**
|
|
6386
6531
|
* The review profile's proposed mark (schema-dist profiles/review.md): an element whose
|
|
6387
6532
|
* `x_review_proposed` is an object was written as proposed (an AI seat's new element on a world
|
|
@@ -6907,10 +7052,10 @@ declare function unplacedAround(graph: OwLayoutGraph, focus: string, placed: Ite
|
|
|
6907
7052
|
/**
|
|
6908
7053
|
* A 3D layout method for a world nobody laid out, read from its graph and its Maps and Pins: `by-links-3d`.
|
|
6909
7054
|
*
|
|
6910
|
-
* The parts live in src/layout3d/, one file a step, and the directions table is baked into
|
|
6911
|
-
* (layout-directions.generated.ts). The method is exact where it can be: everything but the cosine and
|
|
6912
|
-
* place what hangs off the body and the
|
|
6913
|
-
* floor, which every runtime rounds alike.
|
|
7055
|
+
* The parts live in src/layout3d/, one file a step (pieces.ts joins the runs), and the directions table is baked into
|
|
7056
|
+
* the package (layout-directions.generated.ts). The method is exact where it can be: everything but the cosine and
|
|
7057
|
+
* sine that place what hangs off the body, and the arcsine, cosine and sine that set the pieces on their ring, is
|
|
7058
|
+
* addition, subtraction, multiplication, division, square root and floor, which every runtime rounds alike.
|
|
6914
7059
|
*/
|
|
6915
7060
|
|
|
6916
7061
|
/** The rest length of the by-links-3d layout: a link's length at rest, and the unit of its answer's points. */
|
|
@@ -6921,7 +7066,7 @@ declare const BY_LINKS_3D_REST = 60;
|
|
|
6921
7066
|
* a picture to hand back as `held` stores it beside the points and reads another value as no picture kept, so a
|
|
6922
7067
|
* change to the method lays the world out fresh instead of holding points the method no longer gives.
|
|
6923
7068
|
*/
|
|
6924
|
-
declare const BY_LINKS_3D_VERSION =
|
|
7069
|
+
declare const BY_LINKS_3D_VERSION = 2;
|
|
6925
7070
|
/** `layoutByLinks3d`'s options. */
|
|
6926
7071
|
interface OwLayoutByLinks3dOptions {
|
|
6927
7072
|
/**
|
|
@@ -6929,8 +7074,10 @@ interface OwLayoutByLinks3dOptions {
|
|
|
6929
7074
|
* Array or a typed array of exactly three finite numbers; a slice of an earlier answer's `points` will do), as a
|
|
6930
7075
|
* Map or a plain object. A held element that is still a node and is not pinned stands at its held point, and the
|
|
6931
7076
|
* rest is laid out round the held ones: a group with held members starts from them, and when held elements on the
|
|
6932
|
-
* world's first map agree on where that map stood, the map is put back there. A
|
|
6933
|
-
* whatever is held for it. An id that is no node is
|
|
7077
|
+
* world's first map agree on where that map stood, the map is put back there. A piece with a held element is laid
|
|
7078
|
+
* out round it and not moved. A pinned element stands at its Pin whatever is held for it. An id that is no node is
|
|
7079
|
+
* passed over, and so is an element with no link that is not pinned: it is not placed. Absent, null or empty: the
|
|
7080
|
+
* method as it is.
|
|
6934
7081
|
*/
|
|
6935
7082
|
held?: ReadonlyMap<string, ArrayLike<number>> | Readonly<Record<string, ArrayLike<number>>> | null;
|
|
6936
7083
|
/**
|
|
@@ -6943,16 +7090,20 @@ interface OwLayoutByLinks3dOptions {
|
|
|
6943
7090
|
/**
|
|
6944
7091
|
* How `layoutByLinks3d` placed an element: `centre` (a group's centre), `with` (in a centre's group), `arm` (hanging
|
|
6945
7092
|
* off the body, more than one link out or with links of its own), `link` (an element whose only link is to the body),
|
|
6946
|
-
* `
|
|
7093
|
+
* `map` (at its Pin on the world's map). An element of a piece other than the main one takes the word its own piece's
|
|
7094
|
+
* layout gives it.
|
|
7095
|
+
*/
|
|
7096
|
+
type OwLayout3dHow = 'centre' | 'with' | 'arm' | 'link' | 'map';
|
|
7097
|
+
/** The part an element with no centre stands in: `map` (pinned) or `one-link` (`arm` or `link`). */
|
|
7098
|
+
type OwLayout3dPart = 'map' | 'one-link';
|
|
7099
|
+
/**
|
|
7100
|
+
* What `layoutByLinks3d` answers: one row per placed node, in the order the nodes were handed in, and the ids of the
|
|
7101
|
+
* nodes it does not place.
|
|
6947
7102
|
*/
|
|
6948
|
-
type OwLayout3dHow = 'centre' | 'with' | 'arm' | 'link' | 'shelf' | 'map';
|
|
6949
|
-
/** The part an element with no centre stands in: `map` (pinned), `one-link` (`arm` or `link`) or `no-link` (`shelf`). */
|
|
6950
|
-
type OwLayout3dPart = 'map' | 'one-link' | 'no-link';
|
|
6951
|
-
/** What `layoutByLinks3d` answers: one row per node, in the order the nodes were handed in. */
|
|
6952
7103
|
interface OwLayoutByLinks3d {
|
|
6953
|
-
/** The method's word
|
|
7104
|
+
/** The method's word, `by-links-3d`, as the layout profile's page names it. */
|
|
6954
7105
|
method: 'by-links-3d';
|
|
6955
|
-
/** The nodes' ids, in the order handed in. */
|
|
7106
|
+
/** The placed nodes' ids, in the order handed in (a node in `unplaced` is left out). */
|
|
6956
7107
|
ids: string[];
|
|
6957
7108
|
/** x, y, z of `ids[i]` at `3 * i`, in units where a link at rest is `BY_LINKS_3D_REST` long. */
|
|
6958
7109
|
points: Float64Array;
|
|
@@ -6962,13 +7113,21 @@ interface OwLayoutByLinks3d {
|
|
|
6962
7113
|
group: Array<string | null>;
|
|
6963
7114
|
/** Null where `group` is an id; else the part the element stands in. */
|
|
6964
7115
|
part: Array<OwLayout3dPart | null>;
|
|
6965
|
-
/**
|
|
7116
|
+
/**
|
|
7117
|
+
* The centres' ids: the main shape's in rank order, then each other piece's in its own rank order, the pieces by
|
|
7118
|
+
* size (most nodes first; among equals, the one holding the lowest id first).
|
|
7119
|
+
*/
|
|
6966
7120
|
centres: string[];
|
|
6967
7121
|
/**
|
|
6968
7122
|
* True where the point answered is the element's held point; false everywhere when nothing is held. A pinned element
|
|
6969
7123
|
* stands at its Pin and is never held, so false does not mean new: what is new is every id that was not handed in.
|
|
6970
7124
|
*/
|
|
6971
7125
|
held: boolean[];
|
|
7126
|
+
/**
|
|
7127
|
+
* The ids of the nodes not placed, by id in code point order: every node linked to no other node and pinned on no
|
|
7128
|
+
* map, a held one too. `unplacedByLinks3d` gives the same list for the Map this answer makes.
|
|
7129
|
+
*/
|
|
7130
|
+
unplaced: string[];
|
|
6972
7131
|
}
|
|
6973
7132
|
/**
|
|
6974
7133
|
* Lay out a whole graph in three dimensions by its links.
|
|
@@ -6976,38 +7135,44 @@ interface OwLayoutByLinks3d {
|
|
|
6976
7135
|
* The body of the graph (its largest piece that no single element's removal parts) is cut into groups round its
|
|
6977
7136
|
* centres, the elements with most links (twelve at most, more when a group that holds over half the body is split); the groups are packed apart in directions read from a table baked
|
|
6978
7137
|
* into the package, and for 300 seeded force steps links pull, near elements push apart and every element is held
|
|
6979
|
-
* to its group's point. What hangs off the body by one element is fanned out from it
|
|
6980
|
-
* main piece stands on a shelf under the picture. When the world has a Map that holds three or more elements of the
|
|
7138
|
+
* to its group's point. What hangs off the body by one element is fanned out from it. When the world has a Map that holds three or more elements of the
|
|
6981
7139
|
* graph by a Pin, the Map that holds the most (a tie to the greater id) is a flat plate, each of its pinned elements
|
|
6982
7140
|
* at its Pin, the groups whose centre is pinned standing over it; a Map over a place on that plate is a small plate
|
|
6983
7141
|
* a little above it. A Map whose width or height is not over 0 is no plate, and when it is the Map that holds the
|
|
6984
7142
|
* most, the world is laid out by its links alone. A Pin's z is not read: the plate is flat. A layout map (a Map whose `x_layout` names a method,
|
|
6985
7143
|
* the map-space profile's mark) is never the plate: a saved layout never stands in for the world's own space.
|
|
6986
7144
|
*
|
|
7145
|
+
* Every other piece of linked elements (elements joined by a path of links) is laid out the same way on its own. A
|
|
7146
|
+
* piece with a pinned or held element stands where those points put it; every other one stands on a ring round the
|
|
7147
|
+
* main shape, in the plane of its middle, the largest pieces first, a ring holding as many as fit before the next
|
|
7148
|
+
* opens further out. An element linked to no other and pinned on no map is not placed: it is left out of the rows and
|
|
7149
|
+
* listed, by id, in `unplaced`.
|
|
7150
|
+
*
|
|
6987
7151
|
* `graph` is `worldGraph`'s answer, or any graph of the same shape; `elements` the world's elements as served (only
|
|
6988
7152
|
* Map and Pin elements are read, by `mapSpace` and `layoutOf`), or null or absent for none. The graph is first put in
|
|
6989
7153
|
* one order (nodes by id in code point order; links by source, field, index, then target), so the order the nodes and
|
|
6990
7154
|
* links are handed in moves no point. The same input gives the same points in every runtime: to the last bit for
|
|
6991
|
-
* every element placed `centre`, `with` or `map
|
|
6992
|
-
* with the runtime's own cosine and sine.
|
|
7155
|
+
* every element placed `centre`, `with` or `map` off the ring, and within a billionth of a rest for the rest, which
|
|
7156
|
+
* are placed with the runtime's own cosine and sine (and, on the ring, its arcsine).
|
|
6993
7157
|
*
|
|
6994
7158
|
* `options.held` hands back points an earlier answer gave, so the picture keeps still as the world changes; with
|
|
6995
7159
|
* `options.heldUnit` when they were rounded. A held element that is still a node and is not pinned stands at its held
|
|
6996
7160
|
* point, and the answer's `held` says which. Refused before any step of the layout runs, each an error with a `code`: `held` that
|
|
6997
7161
|
* is not a Map or a plain object, TypeError `held-not-object`; a held value that is not three finite numbers,
|
|
6998
|
-
* TypeError `held-not-point`;
|
|
6999
|
-
*
|
|
7000
|
-
*
|
|
7001
|
-
* with
|
|
7162
|
+
* TypeError `held-not-point`; a `heldUnit` that is not null and not a finite number from 0 to an eighth of a rest,
|
|
7163
|
+
* RangeError `held-unit`; then, as each piece is laid out (the main one first, then the others by size), the held
|
|
7164
|
+
* points that piece holds (a pinned element's Pin among them in a piece other than the main one) spread wider than
|
|
7165
|
+
* 768 rests on any axis, RangeError `held-box`. An unknown option key is refused first, by name, with a TypeError.
|
|
7166
|
+
* Two nodes with one id throw.
|
|
7002
7167
|
*
|
|
7003
|
-
* The method's word, `by-links-3d`, is the
|
|
7004
|
-
*
|
|
7168
|
+
* The method's word, `by-links-3d`, is the layout profile's: a change that moves any point is a new method with a
|
|
7169
|
+
* new word, and `BY_LINKS_3D_VERSION` is raised when a release moves an answer.
|
|
7005
7170
|
*/
|
|
7006
7171
|
declare function layoutByLinks3d(graph: OwLayoutGraph, elements?: readonly unknown[] | null, options?: OwLayoutByLinks3dOptions): OwLayoutByLinks3d;
|
|
7007
7172
|
/**
|
|
7008
7173
|
* What a saved `by-links-3d` layout map does not place: the ids of the graph's nodes that are not in `placed`, by id
|
|
7009
|
-
* in code point order.
|
|
7010
|
-
*
|
|
7174
|
+
* in code point order. Every node counts, of any type, also one the method would not place (linked to no other and
|
|
7175
|
+
* pinned on no map), so for the Map an answer makes this is that answer's own `unplaced`. `placed` is the ids of the elements the Map's Pins stand for, a list or a Set: from `mapSpace`,
|
|
7011
7176
|
* the `element_id` of each pin whose `map` is this Map. A member that is not a non-empty string (a Pin that stands
|
|
7012
7177
|
* for no element) is passed over, and an id that is no node of the graph is no part of the answer. The answer's
|
|
7013
7178
|
* length is the count a tool shows; reading or drawing a layout map never changes it. Throws a TypeError on a graph
|
|
@@ -8372,4 +8537,5 @@ declare class TokenResource {
|
|
|
8372
8537
|
getEncryptionInfo(): Promise<EncryptionInfo>;
|
|
8373
8538
|
}
|
|
8374
8539
|
|
|
8375
|
-
export { AGENT_DOORS, ASK_LIMITS,
|
|
8540
|
+
export { AGENT_DOORS, ASK_LIMITS, BY_LINKS_3D_REST, BY_LINKS_3D_VERSION, CALENDAR_FIELD, CALENDAR_SUPERTYPE, CHARTER_PAIRS, DATE_FIELD, DECLARED_LINKS, ELEMENT_FAMILIES, ELEMENT_GROUPS, ELEMENT_ICONS, ELEMENT_LABELS, ELEMENT_SECTIONS, ELEMENT_TYPES, FAMILY_COLORS, FAMILY_ORDER, FIELD_ACRONYMS, FIELD_SCHEMA, FILE_EXTENSIONS, GROUP_COLORS, GROUP_ORDER, GameTier, MESSAGE_PAIR, NOTE_PAIR, ONLYWORLDS_VERSION, OwAddressError, OwApiError, OwNetworkError, OwPreconditionFailedError, OwProposedError, OwSignInError, OwStaleProposalError, OwV2Client, OwWorldFileError, PHOTO_MAX_BYTES, PHOTO_TYPES, PROPOSED_MARK, PUBLIC_FIELDS, RECORD_FIELD, REVIEW_PROPOSED_LABEL, ROOM_PAIRS, SPATIAL_TYPES, STRAND_FIELD, TOOLS, TRAIL_TIERS, TokenResource, VIEWS, WORLD_FILE_MAX_BYTES, WORLD_FILE_MAX_ENTRIES, WORLD_FILE_MEDIA_TYPE, absYearForEraYear, absoluteYear, approxYearLength, askerOf, base64url, breakdownStep, buildAskContext, buildWorldIndex, byCodePoint, charterOf, compareInstants, dateOf, degreeOf, designPartsOf, detectKeyKind, displayYear, domainsOf, doorWhere, doorsOf, dragField, draughtText, editedBy, elementAddress, elementColor, eraForStep, errorFromResponse, familyOf, fieldLabel, fileKindOf, findOwLinks, floorDiv, floorMod, formatDuration, formatMidLabel, formatStep, formatYearLabel, getElementIcon, getElementLabel, groupOf, handsOnAsProposed, hasUnseenRecipients, instantOf, intercalaryInYear, isAddressedTo, isAgentDoor, isCharterElement, isDemoKey, isKnownOf, isLeapYear, isLens, isMessage, isNote, isOpenWork, isParseError, isRoomElement, isSentBy, isTemplate, isToEveryone, kindCanWrite, landingOf, layoutAround, layoutByKind, layoutByLinks3d, layoutOf, lensesInUse, lookupWorld, mapSpace, monthStartSteps, nfc, noteOf, openersFor, outDegreeOf, parseDate, parseErrorEnvelope, parseOwLink, pinExpectation, pkceChallenge, planPhoto, preparePhoto, proposedMarkOf, readCalendarConfig, readCalendarValue, readMarkOf, readOwLinkAt, readReportLine, readReportLines, readWorldFile, readingAidOf, recipientsOf, recordMarkOf, recordsOf, renderElement, reportTalksOf, reportThreadsOf, resolveCalendar, resolveCalendarLens, resolveEraDomains, resolveLens, roundHalfEven, senderStatus, simpleCaseFold, strandOf, talksOf, threadOf, trailByPlace, trimAndFold, typeWord, unplacedAround, unplacedByKind, unplacedByLinks3d, unreadFor, validateCalendarConfig, viewOf, weekdayForStep, workOf, workStateOf, worldCalendars, worldGraph, writeWorldFile, yearLength, yearStartStep };
|
|
8541
|
+
export type { AccessKeyResponse, CalendarConfig, CalendarEra, CalendarIntercalary, CalendarMonths, CalendarWeek, ElementFamily, ElementGroup, ElementType, EncryptionInfo, EraDomain, FieldInfo, FieldType, ListParams, OwAccountToken, OwAccountWorld, OwAddress, OwAddressAt, OwAddressForm, OwAddressFound, OwAddressReading, OwAddressReason, OwAddressingOptions, OwAgentJoined, OwAiAskAnswer, OwAiAskBody, OwAiMeter, OwAiRefusal, OwAiSortAnswer, OwAiSortBody, OwAiToken, OwAiUse, OwAllowance, OwAskAnswer, OwAskContext, OwAskContextOptions, OwAskLeftOut, OwAuthErrorCode, OwBulkItem, OwBulkItemResult, OwBulkResponse, OwCalendarElement, OwChange, OwChangeDelete, OwChangeUpsert, OwChangesPage, OwCharterWorld, OwClientConfig, OwCreateAccountWorldInput, OwCreatedAccountWorld, OwCreatedWorldLink, OwDeleteReason, OwDesignPart, OwDoor, OwDragField, OwDraught, OwDraughtCompact, OwDraughtComponent, OwDraughtItem, OwDraughtLens, OwDraughtPolicy, OwEdited, OwElement, OwElementBase, OwElementMark, OwErrorBody, OwFieldsRefusal, OwFileAddedBy, OwFileDownload, OwFileKind, OwFileRow, OwFileTicket, OwFrontDoor, OwFrontDoorCharter, OwFrontDoorSkill, OwGraphCutReason, OwGraphEdge, OwGraphMark, OwGraphNode, OwGraphOptions, OwHiddenRow, OwInstant, OwJoinPreview, OwJoined, OwJoinedMembership, OwKeyKind, OwLanding, OwLandingCluster, OwLandingGap, OwLandingGapKind, OwLandingMember, OwLandingMode, OwLandingOptions, OwLayout3dHow, OwLayout3dPart, OwLayoutAround, OwLayoutAroundOptions, OwLayoutAroundPoint, OwLayoutByKind, OwLayoutByLinks3d, OwLayoutByLinks3dOptions, OwLayoutGraph, OwLayoutOf, OwLayoutPoint, OwLensCutReason, OwLensMail, OwLensOptions, OwLensReader, OwLensReading, OwLensWorld, OwLinkEdit, OwLookupElement, OwLookupHit, OwLookupLink, OwLookupOptions, OwLookupReason, OwMapSpace, OwMapSpaceMap, OwMapSpaceOutReason, OwMapSpaceOutline, OwMapSpacePin, OwMapSpacePoint, OwMe, OwMediaTicket, OwMember, OwMemberLenses, OwMemberRole, OwMessageMember, OwMintedAiToken, OwMintedKey, OwMySeat, OwNamesMap, OwOpener, OwOpenerKind, OwOpenerState, OwOpenerSurface, OwOpenersOptions, OwPage, OwPaidBy, OwPhotoOptions, OwPhotoPlan, OwPlayerJoined, OwPreparedPhoto, OwProposal, OwProposalAccepted, OwProposalConflict, OwProposalList, OwProposalQuery, OwProposalState, OwProposeInput, OwProposed, OwProposedMark, OwProposedNewElement, OwReadWorldFile, OwReadWorldFileOptions, OwReadingAids, OwReadingAidsCharter, OwReadingAidsDomain, OwReadingAidsGuide, OwReadingAidsHub, OwRecord, OwRecordMark, OwRecordStory, OwRemovalTicket, OwRemovedImage, OwRenderOptions, OwReportGroup, OwReportLine, OwReportLineOptions, OwReportLint, OwReportParentKind, OwReportThreads, OwResyncReason, OwReviewInput, OwReviewed, OwSearchResult, OwSearchResults, OwSeat, OwSeatCreated, OwSender, OwSenderStatus, OwServedReadingAids, OwSignInBegin, OwSignInBegun, OwSignInComplete, OwSignInReason, OwSignInResult, OwSignInStorage, OwSignedIn, OwSortAddToRow, OwSortAnswer, OwSortAskRow, OwSortLinkRow, OwSortMakeRow, OwSortNote, OwSortRef, OwSortRow, OwStrand, OwStrandSlot, OwStrandWorld, OwTalk, OwTool, OwToolNeeds, OwToolOpen, OwTrailGround, OwTrailHanger, OwTrailInput, OwTrailLayout, OwTrailPin, OwTrailPlace, OwTrailSettings, OwTrailSpiral, OwTrailTier, OwUploadedFile, OwUploadedImage, OwView, OwViewRow, OwViewsTable, OwWordPair, OwWork, OwWorkElement, OwWorkLint, OwWorkState, OwWorkWorld, OwWorldFileEntry, OwWorldFileReason, OwWorldFileRow, OwWorldFiles, OwWorldGraph, OwWorldIndex, OwWorldKeyMember, OwWorldKeyRow, OwWorldLens, OwWorldLensReading, OwWorldLenses, OwWorldLink, OwWorldMeta, OwWorldOrigin, OwWorldProducer, OwWorldProposalList, OwWorldProposalQuery, OwWorldProposalRow, OwWorldPublicPage, OwWorldSource, OwWriteDoor, OwWriteWorldFileOptions, OwWriteWorldFileReport, ParseError, ParseOptions, ParseResult, RevokeAllSessionsResponse, RevokeSessionResponse, SectionInfo, StepBreakdown, TokenConsumeParams, TokenConsumeResponse, TokenStatus, TokenTransport, WorldCalendar };
|