foldkit-entity 0.14.0 → 0.15.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/README.md +139 -5
- package/dist/collation.d.ts +33 -2
- package/dist/collation.d.ts.map +1 -0
- package/dist/conformance/index.d.ts +4 -4
- package/dist/conformance/index.d.ts.map +1 -1
- package/dist/conformance/index.js +5 -7
- package/dist/conformance/index.js.map +1 -1
- package/dist/conformance/operator.d.ts +1 -2
- package/dist/conformance/operator.d.ts.map +1 -1
- package/dist/conformance/operator.js +2 -6
- package/dist/conformance/operator.js.map +1 -1
- package/dist/conformance/relational.d.ts +17 -17
- package/dist/conformance/relational.d.ts.map +1 -1
- package/dist/conformance/relational.js +1 -3
- package/dist/conformance/relational.js.map +1 -1
- package/dist/conformance/variants.d.ts +47 -0
- package/dist/conformance/variants.d.ts.map +1 -0
- package/dist/conformance/variants.js +126 -0
- package/dist/conformance/variants.js.map +1 -0
- package/dist/context.d.ts +60 -2
- package/dist/context.d.ts.map +1 -0
- package/dist/descriptor.d.ts +33 -0
- package/dist/descriptor.d.ts.map +1 -0
- package/dist/descriptor.js +137 -0
- package/dist/descriptor.js.map +1 -0
- package/dist/entity.d.ts +231 -0
- package/dist/entity.d.ts.map +1 -0
- package/dist/entity.js +435 -0
- package/dist/entity.js.map +1 -0
- package/dist/evaluate.d.ts +204 -2
- package/dist/evaluate.d.ts.map +1 -0
- package/dist/evaluate.js +51 -7
- package/dist/evaluate.js.map +1 -1
- package/dist/expr.d.ts +915 -2
- package/dist/expr.d.ts.map +1 -0
- package/dist/expr.js +50 -10
- package/dist/expr.js.map +1 -1
- package/dist/held.d.ts +112 -2
- package/dist/held.d.ts.map +1 -0
- package/dist/held.js +13 -2
- package/dist/held.js.map +1 -1
- package/dist/ids.d.ts +8 -0
- package/dist/ids.d.ts.map +1 -0
- package/dist/ids.js +8 -0
- package/dist/ids.js.map +1 -0
- package/dist/index.d.ts +380 -6
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +108 -12
- package/dist/index.js.map +1 -0
- package/dist/invariant.d.ts +123 -2
- package/dist/invariant.d.ts.map +1 -0
- package/dist/invariant.js +236 -1
- package/dist/invariant.js.map +1 -0
- package/dist/law.d.ts +264 -2
- package/dist/law.d.ts.map +1 -0
- package/dist/law.js +1 -1
- package/dist/operators.d.ts +170 -2
- package/dist/operators.d.ts.map +1 -0
- package/dist/operators.js +3 -3
- package/dist/readFilter.d.ts +8 -2
- package/dist/readFilter.d.ts.map +1 -0
- package/dist/sets.d.ts +18 -2
- package/dist/sets.d.ts.map +1 -0
- package/dist/sets.js +1 -1
- package/dist/shape.d.ts +23 -2
- package/dist/shape.d.ts.map +1 -0
- package/dist/tested.d.ts +8 -2
- package/dist/tested.d.ts.map +1 -0
- package/dist/text.d.ts +27 -2
- package/dist/text.d.ts.map +1 -0
- package/dist/text.js +1 -1
- package/dist/variants.d.ts +72 -0
- package/dist/variants.d.ts.map +1 -0
- package/dist/variants.js +76 -0
- package/dist/variants.js.map +1 -0
- package/dist/words.d.ts +17 -2
- package/dist/words.d.ts.map +1 -0
- package/dist/write.d.ts +312 -2
- package/dist/write.d.ts.map +1 -0
- package/dist/write.js +3 -3
- package/package.json +3 -3
- package/dist/collation-BB4YTIbY.d.ts +0 -34
- package/dist/collation-BB4YTIbY.d.ts.map +0 -1
- package/dist/index-48JeXG0A.d.ts +0 -2585
- package/dist/index-48JeXG0A.d.ts.map +0 -1
- package/dist/readFilter-CWMnFRVw.d.ts +0 -9
- package/dist/readFilter-CWMnFRVw.d.ts.map +0 -1
- package/dist/shape-LAowRf9f.d.ts +0 -23
- package/dist/shape-LAowRf9f.d.ts.map +0 -1
- package/dist/src-DKhUqLoC.js +0 -731
- package/dist/src-DKhUqLoC.js.map +0 -1
- package/dist/words-a4e9o-TK.d.ts +0 -18
- package/dist/words-a4e9o-TK.d.ts.map +0 -1
package/dist/src-DKhUqLoC.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"src-DKhUqLoC.js","names":["fail"],"sources":["../src/invariant.ts","../src/index.ts"],"sourcesContent":["/**\n * Invariants: what every stored row of an Entity must hold, and what every\n * change of one must, declared once on the Entity through its metadata and read\n * from there by each interpreter: the reference judge here, a Schema check, a\n * form, a server's writer.\n *\n * One is built over the row before a write (`before`, each field as `Expr.field`) and\n * the row after it (`after`, each field as `Expr.next`). What it reads decides\n * when it is judged:\n *\n * ```text\n * reads `after` only -> a state invariant: every create and update, a CHECK constraint\n * reads `before` too -> a transition invariant: every update, which has a row before\n * ```\n *\n * It reads no input and no principal. Who may write is a guard's; whether a\n * write applies now is its `when`'s.\n */\nimport { Metadata } from 'foldkit-metadata'\nimport { Option, Schema, type SchemaAST } from 'effect'\nimport { OperatorMissingError, truthOver, type Row } from './evaluate.js'\nimport { Operators, type MemoryOperators } from './operators.js'\nimport { put } from './record.js'\nimport {\n Expr,\n Query,\n dependenciesOf,\n type FieldExpr,\n type NextExpr,\n type Predicate,\n type Reads,\n} from './expr.js'\n// A cycle with `index.ts`, safe because `Entity` is read only when an invariant is attached.\nimport {\n Entity,\n type AnyEntity,\n type EntityField,\n type EntityInput,\n type InputMember,\n} from './index.js'\n\ntype AnyField = EntityField<string, string, Schema.Constraint>\n\n/** One invariant of an Entity, as its interpreters read it. */\nexport interface Invariant {\n /** Stable, unique within its Entity: what a refusal names, and forms and logs key on. */\n readonly id: string\n /** The Entity it is declared on: ids are unique only within one, so a refusal names both. */\n readonly entity: string\n readonly predicate: Predicate\n /** What someone the rules let write is told when a write would break it. */\n readonly message: string\n /** The fields a form shows the failure beside. */\n readonly path: ReadonlyArray<string>\n /** The fields it reads of the row before a write; none for a state invariant. */\n readonly before: ReadonlyArray<string>\n /** The fields it reads of the row after. */\n readonly after: ReadonlyArray<string>\n}\n\n/**\n * Each field as the row before a write holds it: what an invariant reads as\n * `before`. Encoded, as the store holds it and the judge reads it, so a\n * literal is written so too (a date as its ISO text).\n */\nexport type BeforeRow<E extends AnyEntity> = {\n readonly [K in keyof E['fields'] & string]: FieldExpr<\n Schema.Codec.Encoded<E['fields'][K]['schema']>\n > &\n Reads<E['name']>\n}\n\n/** Each field as the row after a write holds it, encoded: what an invariant reads as `after`. */\nexport type AfterRow<E extends AnyEntity> = {\n readonly [K in keyof E['fields'] & string]: NextExpr<\n Schema.Codec.Encoded<E['fields'][K]['schema']>\n > &\n Reads<E['name']>\n}\n\n/** A row, or a change from one row to another, as an invariant is judged over it. */\nexport interface Change {\n readonly after: Row\n /** The row before an update; none for a create, which judges no transition invariant. */\n readonly before?: Row\n}\n\nconst Invariants = Metadata.key<Invariant>('foldkit-entity/invariants', {\n // The same invariant reached twice (two annotated copies combined) is one.\n merge: values => [...new Set(values)],\n summarize: invariant => invariant.id,\n})\n\n/** What a row, or a change, comes to under an Entity's invariants. */\nexport type Judgement =\n | { readonly _tag: 'Valid' }\n | { readonly _tag: 'Invalid'; readonly failures: ReadonlyArray<Invariant> }\n /**\n * Validity is not known: some invariant reads a field the row does not have\n * (`fields`), or calls an operator the table does not run (`operators`, by name).\n */\n | {\n readonly _tag: 'Undecided'\n readonly fields: ReadonlyArray<string>\n readonly operators: ReadonlyArray<string>\n }\n\n/** Whether an invariant reads the row before, and so is judged only where there is one. */\nexport const readsBefore = (held: Invariant): boolean => held.before.length > 0\n\n/**\n * An invariant as declared: the step that attaches it to its Entity, carrying\n * its id and, once attached, that Entity's name, so a refusal is matched\n * against the declaration rather than a string spelled again\n * (`Refusal.isInvalidBy(refusal, reservedWithinQuantity)`). An id is unique\n * only within an Entity, so the name is part of what a refusal names; reading\n * it before the declaration is attached throws.\n */\nexport interface DeclaredInvariant<E extends AnyEntity> {\n (entity: E): E\n readonly id: string\n readonly entity: string\n}\n\nconst fail = (entity: AnyEntity, message: string): never => {\n throw new Error(`[foldkit-entity] Entity.invariant on ${entity.name}: ${message}`)\n}\n\nexport const invariant = <E extends AnyEntity>(\n id: string,\n build: (rows: {\n readonly before: BeforeRow<E>\n readonly after: AfterRow<E>\n }) => Predicate & Reads<E['name']>,\n options: {\n readonly message: string\n readonly path?: ReadonlyArray<keyof E['fields'] & string>\n },\n): DeclaredInvariant<E> => {\n let attached: string | undefined\n const declared = (entity: E): E => {\n if (id.length === 0) fail(entity, 'an invariant needs an id')\n if (attached !== undefined && attached !== entity.name)\n fail(entity, `\"${id}\" is declared on ${attached} already: declare it again for this Entity`)\n if (invariantsOf(entity).some(held => held.id === id)) fail(entity, `\"${id}\" is declared twice`)\n const fields = entity.fields as Readonly<Record<string, E['fields'][string]>>\n const after = Object.fromEntries(\n Object.entries(fields).map(([key, field]) => [key, Expr.next(field)]),\n ) as unknown as AfterRow<E>\n const before = Object.fromEntries(\n Object.entries(fields).map(([key, field]) => [key, Expr.field(field)]),\n ) as unknown as BeforeRow<E>\n const predicate = build({ before, after }) as Predicate\n // `where` refuses a predicate over another Entity, which the type allows when it is unmarked.\n const body = Query.from(entity).pipe(Query.where(predicate))\n const dependencies = Query.dependencies(body)\n if (dependencies.inputs.length > 0) {\n fail(\n entity,\n `\"${id}\" reads the input ${dependencies.inputs.join(', ')}; it judges stored rows`,\n )\n }\n const beforeReads = dependencies.predicate.map(field => field.key)\n const afterReads = dependencies.next.map(field => field.key)\n // Reading the row before alone, it says which rows a write may start from: a write's `when`.\n // Judged as an invariant, a create would skip it and a repair would be refused by it.\n if (afterReads.length === 0) {\n fail(\n entity,\n `\"${id}\" reads no field of \\`after\\`; what a write may start from is its \\`when\\``,\n )\n }\n const path = options.path ?? [...new Set([...afterReads, ...beforeReads])]\n for (const key of path) {\n if (!Object.hasOwn(fields, key)) fail(entity, `\"${id}\"'s path names \"${key}\", not a field`)\n }\n attached = entity.name\n return entity.pipe(\n Entity.annotate(\n Invariants.of(\n Object.freeze({\n id,\n entity: entity.name,\n predicate,\n message: options.message,\n path: Object.freeze([...path]),\n before: Object.freeze(beforeReads),\n after: Object.freeze(afterReads),\n }),\n ),\n ),\n ) as E\n }\n return Object.defineProperties(declared, {\n id: { value: id, enumerable: true },\n entity: {\n enumerable: true,\n get: () => {\n if (attached === undefined) {\n throw new Error(\n `[foldkit-entity] Entity.invariant \"${id}\" names no Entity until it is attached to one`,\n )\n }\n return attached\n },\n },\n }) as DeclaredInvariant<E>\n}\n\nexport const invariantsOf = (entity: AnyEntity): ReadonlyArray<Invariant> =>\n Invariants.get(entity.metadata)\n\n/** `judge` with the invariants given, as a binding that keeps them holds them. */\nexport const judgeAgainst = (\n invariants: ReadonlyArray<Invariant>,\n change: Change,\n operators: MemoryOperators = Operators.kernel,\n): Judgement => {\n const missing = new Set<string>()\n const unrun = new Set<string>()\n const failures: Array<Invariant> = []\n const { after, before } = change\n for (const held of invariants) {\n // A create has no row before, so a transition invariant has nothing to judge.\n if (readsBefore(held) && before === undefined) continue\n const absent = [\n ...held.after.filter(key => !Object.hasOwn(after, key)),\n ...held.before.filter(key => !Object.hasOwn(before ?? {}, key)),\n ]\n if (absent.length > 0) absent.forEach(key => missing.add(key))\n else {\n try {\n if (truthOver(held.predicate, before ?? {}, {}, after, operators) !== true) {\n failures.push(held)\n }\n } catch (error) {\n // An operator this table does not run is a judgement it cannot make, as a\n // field the row lacks is: a form passes it, and a server's checks refuse to\n // start without the operator (expr-operations-DESIGN §5.6).\n if (!(error instanceof OperatorMissingError)) throw error\n unrun.add(error.named)\n }\n }\n }\n if (failures.length > 0) return { _tag: 'Invalid', failures }\n if (missing.size > 0 || unrun.size > 0) {\n return { _tag: 'Undecided', fields: [...missing], operators: [...unrun] }\n }\n return { _tag: 'Valid' }\n}\n\n/**\n * A row, or a change, under every invariant (each row as the store holds it,\n * encoded): valid only when each is true. SQL's unknown, from a null, fails\n * one, as a `WHERE` drops the row; a field a row does not have leaves it\n * undecided, never valid. Without `before` (a create), transition invariants\n * are not judged.\n */\nexport const judge = (\n entity: AnyEntity,\n change: Change,\n operators: MemoryOperators = Operators.kernel,\n): Judgement => judgeAgainst(invariantsOf(entity), change, operators)\n\n/**\n * The row an input's value describes, judged under its Entity's state\n * invariants: each key mapped to a field, encoded as the store holds it. An\n * invariant over a field the input does not set (an `Option` holding nothing, a\n * key left out) is undecided, so a partial input is never called valid on its\n * account. It has no row before, so it judges no transition.\n */\nexport const judgeInput = (\n input: EntityInput<AnyEntity, any, any>,\n value: Readonly<Record<string, unknown>>,\n operators: MemoryOperators = Operators.kernel,\n): Judgement => {\n const invariants = invariantsOf(input.entity)\n if (invariants.length === 0) return { _tag: 'Valid' }\n const members = input.members as Readonly<Record<string, InputMember>>\n const row: Record<string, unknown> = {}\n for (const [key, member] of Object.entries(members)) {\n if (member._tag !== 'Field' || !Object.hasOwn(value, key)) continue\n const encode = Schema.encodeUnknownOption(\n member.schema as unknown as Schema.Codec<unknown, unknown>,\n )\n const given = value[key]\n const held = Option.isOption(given) ? given : Option.fromUndefinedOr(given)\n // The value as the field holds it: itself for a field typed `Option`, else what it holds.\n // One the field cannot hold is no row the store would keep, so it decides nothing here.\n const stored = Option.orElse(encode(given), () => Option.flatMap(held, encode))\n Option.map(\n Option.flatMap(held, () => stored),\n encoded => put(row, member.key, encoded),\n )\n }\n return judgeAgainst(invariants, { after: row }, operators)\n}\n\n/**\n * The Entity's state invariants as an Effect Schema check over its row type:\n * each failure at its path, with its message. The value is encoded first,\n * field by field, so it is judged as the store would hold it. Refused where it\n * is made when an invariant calls an operator `operators` does not run: such a\n * check would pass every value.\n */\nexport const check = <E extends AnyEntity>(\n entity: E,\n options: { readonly operators?: MemoryOperators | undefined } = {},\n): SchemaAST.Filter<Schema.Schema.Type<E['schema']>> => {\n const predicates = invariantsOf(entity).map(held => held.predicate)\n // The judge runs every operation an invariant reads; an operator alone can be missing.\n const missing = Expr.unsupported(predicates, {\n operations: dependenciesOf(...predicates).operations,\n operators: options.operators ?? Operators.kernel,\n })\n if (missing.length > 0) {\n throw new Error(\n `[foldkit-entity] Entity.check of ${entity.name}: its invariants call ${missing.join(', ')}, which the operator table does not run; pass one that does as \\`operators\\``,\n )\n }\n return Schema.makeFilter(value => {\n const fields = entity.fields as Readonly<Record<string, AnyField>>\n const decoded = value as Readonly<Record<string, unknown>>\n const row: Record<string, unknown> = {}\n for (const [key, field] of Object.entries(fields)) {\n if (!Object.hasOwn(decoded, key)) continue\n put(\n row,\n key,\n Schema.encodeUnknownSync(field.schema as unknown as Schema.Codec<unknown, unknown>)(\n decoded[key],\n ),\n )\n }\n const judged = judge(entity, { after: row }, options.operators)\n if (judged._tag !== 'Invalid') return undefined\n return judged.failures.flatMap((failure): ReadonlyArray<Schema.FilterIssue> =>\n failure.path.length === 0\n ? [failure.message]\n : failure.path.map(key => ({ path: [key], issue: failure.message })),\n )\n })\n}\n","/**\n * `foldkit-entity` — domain structure as typed values.\n *\n * An Entity names its intrinsic Fields (one `Schema.Struct`), its Relations\n * (navigation edges to other Entities, declared with `Entity.relate`), and its Derived members (readable\n * values an interpreter supplies). It describes; it fetches, stores, and\n * renders nothing. Remote, Drizzle, and form packages interpret it and attach\n * what they need as `foldkit-metadata`.\n */\nimport { Data, Option, Pipeable, Schema } from 'effect'\nimport { Metadata } from 'foldkit-metadata'\nimport {\n check,\n invariant,\n invariantsOf,\n judge,\n judgeAgainst,\n judgeInput,\n readsBefore,\n} from './invariant.js'\nimport { SchemaShape } from './shape.js'\nimport type { ExprContext, NowExpr, ViewerExpr, ViewerPathExpr } from './context.js'\nimport type { HeldRow, HeldRows } from './held.js'\nimport { own, put } from './record.js'\nimport { checkedSet, type EntitySet, type SetOn } from './sets.js'\n\nexport const EntityTypeId: unique symbol = Symbol.for('foldkit-entity/Entity')\nexport type EntityTypeId = typeof EntityTypeId\n\n/**\n * What makes two descriptors the same Entity. A pipe step returns a new\n * descriptor with the same identity, so compare `identity`, never the objects.\n */\nexport interface EntityIdentity<Name extends string> {\n readonly name: Name\n /** Distinguishes two Entities that were defined with the same name. */\n readonly token: symbol\n}\n\n/** An intrinsic value of the Entity: one property of `entity.schema`. */\nexport interface EntityField<Name extends string, Key extends string, S extends Schema.Constraint> {\n readonly _tag: 'Field'\n readonly owner: EntityIdentity<Name>\n readonly key: Key\n readonly schema: S\n readonly metadata: Metadata\n}\n\nexport type Cardinality = 'one' | 'many'\n\n/** What `Relation.one` / `Relation.many` return, before `Entity.relate` binds it to an owner. */\nexport interface RelationSpec<\n Target extends AnyEntity,\n C extends Cardinality,\n Optional extends boolean,\n> {\n readonly target: Target\n readonly cardinality: C\n readonly optional: Optional\n}\n\n/**\n * A navigation edge as its owner sees it: one or many of `target`. How the edge\n * is stored (a foreign key, a join table, a nested document) is the\n * interpreter's concern.\n */\nexport interface EntityRelation<\n Name extends string,\n Key extends string,\n Target extends AnyEntity,\n C extends Cardinality,\n Optional extends boolean,\n> {\n readonly _tag: 'Relation'\n readonly owner: EntityIdentity<Name>\n readonly key: Key\n /** The target as `Entity.relate` returned it, so its own relations can be followed. */\n readonly target: () => Target\n readonly cardinality: C\n readonly optional: Optional\n readonly metadata: Metadata\n}\n\ntype OneRelation = EntityRelation<string, string, AnyEntity, 'one', boolean>\n\n/**\n * What a derived member is. `Supplied` (`Derived.make`): an interpreter\n * supplies it, and nothing else can say what it is. `Count`\n * (`Derived.count`): how many rows point at this one through `relation`, a\n * `one` relation of the counted Entity. `Exists` (`Derived.exists`): the id of\n * a row pointing here through `relation` whose `viewer` relation points at\n * whoever reads it, or none. A client predicts both from the rows it writes,\n * and a server compiles both from the relations' storage.\n */\nexport type Derivation = Data.TaggedEnum<{\n /**\n * `predict`: how a client foresees it for a row it writes; none, it waits\n * for the server. `forbids`: which write to the row its value refuses, so a\n * client holding it refuses that write where it is made.\n */\n Supplied: { readonly predict: Option.Option<Predict>; readonly forbids: Option.Option<Forbids> }\n Count: { readonly relation: OneRelation }\n Exists: { readonly relation: OneRelation; readonly viewer: OneRelation }\n}>\nexport const Derivation = Data.taggedEnum<Derivation>()\n\n/** What a supplied member's prediction is given: the row a write leaves, as its holder has it. */\nexport interface Predicting {\n /** The Entity written, as the write declared it. */\n readonly entity: AnyEntity\n readonly row: HeldRow\n /** The holder's other rows, where a rule's path reads. */\n readonly rows: HeldRows\n /** The operation's context: who asks, and the write's time. */\n readonly context: ExprContext\n}\n\n/**\n * A supplied member foreseen: its value **encoded**, as the store holds it, or\n * none where the holder cannot know it, so nothing is shown before the answer.\n */\nexport type Predict = (predicting: Predicting) => Option.Option<unknown>\n\n/**\n * What a write does to a row it finds, as a supplied member's `forbids` is\n * asked: an update's members and the relations it points, or a delete.\n */\nexport interface WriteSurface {\n readonly kind: 'Update' | 'Delete'\n /** The members it sets, moves or computes, relations not among them. */\n readonly members: ReadonlyArray<string>\n /** Each relation it points: at a row (`Link`), or at none (`Unlink`). */\n readonly relations: ReadonlyArray<{\n readonly relation: string\n readonly interaction: 'Link' | 'Unlink'\n }>\n}\n\n/**\n * Whether a supplied member's value, **encoded** as the store holds it,\n * refuses `surface`, with the reader's words for why when there are any; none\n * where it does not say so for certain. Only a definite refusal: a client\n * refuses the write unseen, and its server would refuse it too.\n */\nexport type Forbids = (\n value: unknown,\n surface: WriteSurface,\n) => Option.Option<{ readonly reason: Option.Option<string> }>\n\n/** What `Derived.make`, `Derived.count` or `Derived.exists` returns, before an Entity owns it. */\nexport interface DerivedSpec<S extends Schema.Constraint, D extends Derivation = Derivation> {\n readonly schema: S\n readonly derives: D\n}\n\n/** A value consumers may read that is not part of `entity.schema`, and what it derives. */\nexport interface EntityDerived<\n Name extends string,\n Key extends string,\n S extends Schema.Constraint,\n D extends Derivation = Derivation,\n> {\n readonly _tag: 'Derived'\n readonly owner: EntityIdentity<Name>\n readonly key: Key\n readonly schema: S\n readonly derives: D\n readonly metadata: Metadata\n}\n\nexport type EntityMember =\n | EntityField<string, string, Schema.Constraint>\n | EntityRelation<string, string, AnyEntity, Cardinality, boolean>\n | EntityDerived<string, string, Schema.Constraint>\n\nexport type RelationSpecs = Readonly<Record<string, RelationSpec<AnyEntity, Cardinality, boolean>>>\nexport type DerivedSpecs = Readonly<Record<string, DerivedSpec<Schema.Constraint>>>\n\ntype FieldsOf<Name extends string, Fields extends Schema.Struct.Fields> = {\n readonly [K in keyof Fields & string]: EntityField<Name, K, Fields[K]>\n}\ntype RelationsOf<Name extends string, Relations extends RelationSpecs> = {\n readonly [K in keyof Relations & string]: Relations[K] extends RelationSpec<\n infer Target,\n infer C,\n infer Optional\n >\n ? EntityRelation<Name, K, Target, C, Optional>\n : never\n}\ntype DerivedOf<Name extends string, Derived extends DerivedSpecs> = {\n readonly [K in keyof Derived & string]: EntityDerived<\n Name,\n K,\n Derived[K]['schema'],\n Derived[K]['derives']\n >\n}\n\nexport interface Entity<\n Name extends string,\n Fields extends Schema.Struct.Fields,\n Relations extends RelationSpecs = {},\n Derived extends DerivedSpecs = {},\n>\n extends Pipeable.Pipeable {\n readonly [EntityTypeId]: EntityTypeId\n readonly identity: EntityIdentity<Name>\n readonly name: Name\n /** The intrinsic value only: no relations, no derived members. */\n readonly schema: Schema.Struct<Fields>\n readonly fields: FieldsOf<Name, Fields>\n readonly relations: RelationsOf<Name, Relations>\n readonly derived: DerivedOf<Name, Derived>\n /** Every readable member under one namespace; keys never collide. */\n readonly members: FieldsOf<Name, Fields> & RelationsOf<Name, Relations> & DerivedOf<Name, Derived>\n /** The members whose value is the write's context, never its input (`Entity.sets`), by key. */\n readonly sets: Readonly<Record<string, EntitySet>>\n readonly metadata: Metadata\n}\n\nexport type AnyEntity = Entity<string, any, any, any>\n\n/** The keys of an Entity's `one` relations. */\ntype OneRelationKeys<E extends AnyEntity> = {\n [K in keyof E['relations'] & string]: E['relations'][K]['cardinality'] extends 'one' ? K : never\n}[keyof E['relations'] & string]\n\n/**\n * What a field holding `T` may be set to: the time where it holds a number,\n * the viewer's id where text, and what a path from the viewer reads where it\n * holds that.\n */\ntype ContextValueFor<T> =\n | (number extends T ? NowExpr<number> : never)\n | (T extends string ? ViewerExpr<T> : never)\n | ViewerPathExpr<T | null>\n\n/** The name of the Entity the `one` relation `K` points at. */\ntype TargetName<E extends AnyEntity, K extends keyof E['relations']> = ReturnType<\n E['relations'][K]['target']\n>['name']\n\n/**\n * What `Entity.sets` takes, by member: a field the value of the write's\n * context it can hold, a `one` relation `Expr.viewer` of its target.\n */\nexport type EntitySets<E extends AnyEntity> = {\n readonly [K in Exclude<keyof E['fields'] & string, 'id'>]?: ContextValueFor<\n Schema.Schema.Type<E['fields'][K]['schema']>\n >\n} & {\n readonly [K in OneRelationKeys<E>]?: ViewerExpr<unknown, TargetName<E, K>>\n}\n\n/** Unsatisfiable when a new key is already a member, so the pipe step is the error site. */\ntype Free<E extends AnyEntity, New> = keyof New & keyof E['members'] extends never\n ? unknown\n : { readonly alreadyAMember: keyof New & keyof E['members'] }\n\n/** Unsatisfiable when a `Derived.count` or `Derived.exists` names a relation pointing at another Entity. */\ntype PointsHere<E extends AnyEntity, New extends DerivedSpecs> = {\n [K in keyof New]: New[K]['derives'] extends {\n readonly _tag: 'Count' | 'Exists'\n readonly relation: EntityRelation<any, any, infer Target, any, any>\n }\n ? [Target['name']] extends [E['name']]\n ? never\n : K\n : never\n}[keyof New] extends infer Wrong\n ? [Wrong] extends [never]\n ? unknown\n : { readonly countsRowsPointingAtAnotherEntity: Wrong }\n : never\n\ntype WithDerived<E, New extends DerivedSpecs> =\n E extends Entity<infer Name, infer Fields, infer R, infer D>\n ? Entity<Name, Fields, R, D & New>\n : never\n\nexport type Entities = Readonly<Record<string, AnyEntity>>\nexport type RelationMap<Es extends Entities> = { readonly [K in keyof Es]?: RelationSpecs }\n\n/** The key in `Es` of the Entity a spec targets, matched by name. */\nexport type TargetKey<Es extends Entities, Target extends AnyEntity> = {\n [K in keyof Es]: [Es[K]['name'], Target['name']] extends [Target['name'], Es[K]['name']]\n ? K\n : never\n}[keyof Es]\n\nexport type RelatedSpecs<Es extends Entities, Rs extends RelationMap<Es>, K extends keyof Es> = {\n readonly [R in keyof Rs[K]]: Rs[K][R] extends RelationSpec<infer Target, infer C, infer Optional>\n ? RelationSpec<Related<Es, Rs, TargetKey<Es, Target>>, C, Optional>\n : never\n}\n\n/**\n * One Entity of an `Entity.relate` result. A relation's target is again a\n * `Related`, so relations can be followed through a cycle; the recursion goes\n * through type arguments, which TypeScript resolves only when asked.\n */\nexport type Related<Es extends Entities, Rs extends RelationMap<Es>, K extends keyof Es> =\n Es[K] extends Entity<infer Name, infer Fields, infer R, infer D>\n ? Entity<Name, Fields, R & RelatedSpecs<Es, Rs, K>, D>\n : never\n\n/** Marks a relation key that is already a member of its owner, or an owner that is not listed. */\ntype CheckRelations<Es extends Entities, Rs> = {\n readonly [K in keyof Rs]: K extends keyof Es\n ? {\n readonly [R in keyof Rs[K]]: R extends keyof Es[K]['members']\n ? `\"${R & string}\" is already a member of ${Es[K]['name']}`\n : Rs[K][R]\n }\n : 'not one of the entities being related'\n}\n\nexport const SelectionTypeId: unique symbol = Symbol.for('foldkit-entity/Selection')\nexport type SelectionTypeId = typeof SelectionTypeId\n\n/**\n * The schema that identifies one of an Entity: its `id` field when that is text\n * (a plain string, a brand, a pattern), and plain text otherwise. An id is text\n * because a ref travels and is stored as text; an Entity keyed by a number still\n * has refs, and their ids are the number as text.\n */\nexport type IdSchemaOf<E> = E extends {\n readonly fields: { readonly id: { readonly schema: infer S } }\n}\n ? S extends Schema.Constraint\n ? [S['Type']] extends [string]\n ? S\n : Schema.String\n : Schema.String\n : Schema.String\n\n/** What identifies one of an Entity: `IdOf<typeof Blog.Post>` is `PostId` when its `id` field is one. */\nexport type IdOf<E> = IdSchemaOf<E>['Type']\n\n/**\n * What a relation selected with `true` yields: which Entity, and which one. `Id`\n * is the target's own id type, so a ref to an Author cannot be used as a Post's.\n */\nexport interface EntityRef<Name extends string = string, Id extends string = string> {\n readonly entity: Name\n readonly id: Id\n}\n\ntype RefSchema<Target extends AnyEntity> = Schema.Struct<{\n readonly entity: Schema.Literal<Target['name']>\n readonly id: IdSchemaOf<Target>\n}>\n\n/**\n * A view of the Entity graph: which members to read, and the schema of the\n * value that results. It says nothing about where the value comes from.\n */\nexport interface Selection<\n Name extends string,\n Members,\n S extends Schema.Constraint,\n Id extends string = string,\n> {\n readonly [SelectionTypeId]: SelectionTypeId\n /** Type-only: the id type of the Entity selected, so a reader can ask for the right one. Never set. */\n readonly Id?: Id\n readonly entity: Entity<Name, any, any, any>\n /** What was selected, by member key: `true`, or a relation's nested Selection. */\n readonly members: Members\n readonly schema: S\n}\n\ntype AnySelection<Name extends string = string> = Selection<Name, any, any>\n\n/** The value a Selection reads: `Selected<typeof PostCard>` is one card's fields. */\nexport type Selected<S extends Selection<string, unknown, Schema.Constraint>> = S['schema']['Type']\n\n/** `true` for any member; a relation also takes a Selection of its target. */\n/**\n * Which part of a `many` relation to read: the first or last so many, from a\n * cursor or from the end. A cursor is whatever the interpreter handed out with an\n * earlier page; nothing here looks inside it.\n */\nexport interface PageWindow {\n readonly first?: number | undefined\n readonly last?: number | undefined\n readonly after?: string | undefined\n readonly before?: string | undefined\n}\n\nexport const SelectionPageTypeId: unique symbol = Symbol.for('foldkit-entity/SelectionPage')\nexport type SelectionPageTypeId = typeof SelectionPageTypeId\n\n/** A Selection of a `many` relation's target, read a page at a time. */\nexport interface SelectionPage<Name extends string, S extends Schema.Constraint> {\n readonly [SelectionPageTypeId]: SelectionPageTypeId\n readonly selection: Selection<Name, any, S>\n readonly window: PageWindow\n}\n\ntype PageSchema<S extends Schema.Constraint> = Schema.Struct<{\n readonly items: Schema.$Array<S>\n readonly hasNext: Schema.Boolean\n readonly hasPrevious: Schema.Boolean\n}>\n\ntype SelectionSpec<E extends AnyEntity, Spec> = {\n readonly [K in keyof Spec]: K extends keyof E['relations']\n ? E['relations'][K] extends EntityRelation<any, any, infer Target, infer C, any>\n ?\n | true\n | AnySelection<Target['name']>\n // Only a `many` relation has pages.\n | (C extends 'many' ? SelectionPage<Target['name'], any> : never)\n : never\n : K extends keyof E['members']\n ? true\n : `\"${K & string}\" is not a member of ${E['name']}`\n}\n\ntype RelationShape<\n C extends Cardinality,\n Optional extends boolean,\n S extends Schema.Constraint,\n> = C extends 'many' ? Schema.$Array<S> : Optional extends true ? Schema.NullOr<S> : S\n\ntype SelectedSchema<Member, Selected> = Member extends\n | EntityField<any, any, infer S>\n | EntityDerived<any, any, infer S>\n ? S\n : Member extends EntityRelation<any, any, infer Target, infer C, infer Optional>\n ? Selected extends SelectionPage<any, infer S>\n ? PageSchema<S>\n : RelationShape<\n C,\n Optional,\n Selected extends Selection<any, any, infer S> ? S : RefSchema<Target>\n >\n : never\n\ntype SelectionSchema<E extends AnyEntity, Spec> = Schema.Struct<{\n readonly [K in keyof Spec & keyof E['members']]: SelectedSchema<E['members'][K], Spec[K]>\n}>\n\n/** The `id` field's schema when it is text, so a ref's id keeps its brand and its checks; else text. */\nconst idSchemaOf = (entity: AnyEntity): Schema.Top => {\n const fields: Readonly<Record<string, EntityMember | undefined>> = entity.fields\n const id = fields.id\n if (id === undefined || id._tag !== 'Field') return Schema.String\n const type = Schema.toType(id.schema as Schema.Top)\n return SchemaShape.isText(type.ast) ? type : Schema.String\n}\n\nconst isSelectionPage = (value: unknown): value is SelectionPage<string, Schema.Constraint> =>\n typeof value === 'object' && value !== null && SelectionPageTypeId in value\n\nconst isSelection = (value: unknown): value is AnySelection =>\n typeof value === 'object' && value !== null && SelectionTypeId in value\n\n/** An input key that carries a relation's target: the id of a `one`, the ids of a `many`. */\nexport interface RelationInput<R extends EntityRelation<any, any, any, any, any>> {\n readonly _tag: 'RelationInput'\n readonly relation: R\n}\n\n/**\n * An input key that carries the relation's target itself, written through an\n * input of its own: a post created with a new author, an order with its lines.\n * A `one` holds that input's value, a `many` a list of them.\n */\nexport interface NestedInput<\n R extends EntityRelation<any, any, any, any, any>,\n I extends EntityInput<any, any, any>,\n> {\n readonly _tag: 'NestedInput'\n readonly relation: R\n readonly input: I\n}\n\n/** An input key that is about the operation, not the Entity: a reason, a flag, a confirmation. */\nexport interface Unmapped {\n readonly _tag: 'Unmapped'\n}\n\n/** What one key of an operation's input means in terms of the Entity. */\nexport type InputMember =\n | EntityField<string, string, Schema.Constraint>\n | RelationInput<EntityRelation<string, string, AnyEntity, Cardinality, boolean>>\n | NestedInput<\n EntityRelation<string, string, AnyEntity, Cardinality, boolean>,\n EntityInput<AnyEntity, any, any>\n >\n | Unmapped\n\n/** The ids a relation takes as input: one id, a nullable id, or a list of ids. */\ntype RelationIds<R> =\n R extends EntityRelation<any, any, infer Target, infer C, infer Optional>\n ? C extends 'many'\n ? ReadonlyArray<IdOf<Target>>\n : Optional extends true\n ? IdOf<Target> | null\n : IdOf<Target>\n : never\n\n/** What a nested input takes: the value of the target's input, or a list of them for a `many`. */\ntype NestedValues<R, I> =\n I extends EntityInput<any, infer Fields, any>\n ? R extends EntityRelation<any, any, any, 'many', any>\n ? ReadonlyArray<Schema.Struct.Type<Fields>>\n : Schema.Struct.Type<Fields>\n : never\n\ntype Present<T> = Exclude<T, null | undefined>\n/** What an `Option` holds, else the value itself. */\ntype Held<T> =\n T extends Option.Some<infer A> ? Present<A> : T extends Option.None<any> ? never : Present<T>\n/**\n * Whether an input value fits a field. Only the value that is present has to\n * fit: an input may leave a key out (a partial update), send `null` to clear\n * it, or hold an `Option` (an id absent for something new), whose value fits as\n * it is (an `Option` field) or as what it holds. Whether it may is the input\n * schema's rule; the fit only guards against mapping the wrong member.\n */\ntype Fits<Input, Field> = [Present<Input>] extends [Field]\n ? true\n : [Held<Input>] extends [Field]\n ? true\n : false\n\ntype MappingFor<Name extends string, Input, M> = M extends Unmapped\n ? M\n : M extends\n | EntityField<infer Owner, any, any>\n | RelationInput<EntityRelation<infer Owner, any, any, any, any>>\n | NestedInput<EntityRelation<infer Owner, any, any, any, any>, any>\n ? [Owner] extends [Name]\n ? M extends EntityField<any, any, infer S>\n ? Fits<Input, Schema.Schema.Type<S>> extends true\n ? M\n : 'the input value does not fit this field'\n : M extends RelationInput<infer R>\n ? Present<Input> extends RelationIds<R>\n ? M\n : 'the input value is not the id shape of this relation'\n : M extends NestedInput<infer R, infer I>\n ? R extends EntityRelation<any, any, infer Target, any, any>\n ? I extends EntityInput<infer Of, any, any>\n ? [Of['name']] extends [Target['name']]\n ? Present<Input> extends NestedValues<R, I>\n ? M\n : 'the input value is not the value of the nested input'\n : `the nested input is of ${Of['name']}, not ${Target['name']}`\n : never\n : never\n : never\n : `this member belongs to ${Owner}`\n : 'map an input key to a Field, Relation.input(relation), Relation.nested(relation, input), or Entity.unmapped'\n\n/** A key that names a field whose value it fits maps itself; every other key needs an entry. */\ntype SelfMapped<E extends AnyEntity, Fields extends Schema.Struct.Fields> = {\n [K in keyof Fields]: K extends keyof E['fields']\n ? Fits<Schema.Schema.Type<Fields[K]>, Schema.Schema.Type<E['fields'][K]['schema']>> extends true\n ? K\n : never\n : never\n}[keyof Fields]\n\n/**\n * A mapping written as a member's key: `'title'` is that Field, and `'author'` is\n * `Relation.input` of that relation. Nothing is inferred from the input key's own\n * name; the member is still named, only more briefly.\n */\ntype Named<E extends AnyEntity, M> = M extends string\n ? M extends keyof E['fields']\n ? E['fields'][M]\n : M extends keyof E['relations']\n ? RelationInput<E['relations'][M]>\n : `\"${M}\" names no field or relation of ${E['name']}`\n : M\n\ntype InputMapping<E extends AnyEntity, Fields extends Schema.Struct.Fields, Mapping> = {\n readonly [K in Exclude<keyof Fields, SelfMapped<E, Fields>>]: unknown\n} & {\n readonly [K in keyof Mapping]: K extends keyof Fields\n ? Named<E, Mapping[K]> extends infer Member\n ? Member extends string\n ? Member\n : MappingFor<E['name'], Schema.Schema.Type<Fields[K]>, Member> extends Member\n ? Mapping[K]\n : MappingFor<E['name'], Schema.Schema.Type<Fields[K]>, Member>\n : never\n : `\"${K & string}\" is not a key of the input`\n}\n\n/** The member each key of an input writes, as `Entity.input` reads it from a mapping. */\nexport type InputMembers<E extends AnyEntity, Fields extends Schema.Struct.Fields, Mapping> = {\n readonly [K in keyof Fields]: K extends keyof Mapping\n ? Named<E, Mapping[K]>\n : K extends keyof E['fields']\n ? E['fields'][K]\n : never\n}\n\n/**\n * An operation's input read against an Entity: which member each input key\n * writes. The operation decides what may be submitted; the Entity only says\n * what each submitted key means.\n */\nexport interface EntityInput<E extends AnyEntity, Fields extends Schema.Struct.Fields, Members> {\n readonly entity: E\n readonly schema: Schema.Struct<Fields>\n readonly members: Members\n}\n\n/** The Entity member an input key writes, by its key; nothing for an unmapped key. */\nexport type WrittenKey<M> =\n M extends EntityField<any, infer Key, any>\n ? Key\n : M extends\n | RelationInput<EntityRelation<any, infer Key, any, any, any>>\n | NestedInput<EntityRelation<any, infer Key, any, any, any>, any>\n ? Key\n : never\n\n/** A nested input reads what it writes of the target; every other member reads as it is. */\nexport type WrittenAs<M> =\n M extends NestedInput<any, EntityInput<infer Of, any, infer Members>>\n ? Selection<Of['name'], WrittenSpec<Members>, SelectionSchema<Of, WrittenSpec<Members>>>\n : true\n\n/** Every member the input writes: what to read to show the input's current values. */\nexport type WrittenSpec<Members> = {\n readonly [K in keyof Members as WrittenKey<Members[K]>]: WrittenAs<Members[K]>\n}\n\nconst unmapped: Unmapped = Object.freeze({ _tag: 'Unmapped' })\n\n/**\n * What every descriptor of one Entity shares: the members `Entity.relate`,\n * `Entity.derived` and `Entity.sets` add. It belongs to the identity, so a\n * member added through one descriptor is a member of every other, the one a\n * relation's `target()` returns and the one declared before `relate` alike.\n */\ninterface Shape {\n readonly relations: Record<string, EntityMember>\n readonly derived: Record<string, EntityMember>\n readonly sets: Record<string, EntitySet>\n /** Moves with every addition, so a descriptor knows when its view is stale. */\n revision: number\n}\n\nconst shapes = new WeakMap<EntityIdentity<string>, Shape>()\n\nconst shapeOf = (identity: EntityIdentity<string>): Shape => {\n const known = shapes.get(identity)\n if (known !== undefined) return known\n const shape: Shape = { relations: {}, derived: {}, sets: {}, revision: 0 }\n shapes.set(identity, shape)\n return shape\n}\n\n/** What one descriptor holds of its own: its fields, and the metadata annotated on it. */\ninterface Parts {\n readonly identity: EntityIdentity<string>\n readonly schema: Schema.Struct<Schema.Struct.Fields>\n readonly fields: Readonly<Record<string, EntityMember>>\n /** Metadata `annotateMembers` gave this descriptor's relations and derived members, by key. */\n readonly annotated: Readonly<Record<string, Metadata>>\n readonly metadata: Metadata\n}\n\nconst partsOf = new WeakMap<AnyEntity, Parts>()\n\nconst EntityProto = {\n [EntityTypeId]: EntityTypeId,\n pipe() {\n return Pipeable.pipeArguments(this, arguments)\n },\n}\n\nconst make = (parts: Parts): AnyEntity => {\n const shape = shapeOf(parts.identity)\n const fields = Object.freeze(parts.fields)\n // A shared member annotated here is a copy, made once, so it keeps its identity across reads.\n const copies = new WeakMap<EntityMember, EntityMember>()\n const annotate = (members: Readonly<Record<string, EntityMember>>) =>\n Object.freeze(\n mapValues(members, (member, key) => {\n const extra = own(parts.annotated, key)\n if (extra === undefined) return member\n const copied = copies.get(member)\n if (copied !== undefined) return copied\n const copy = Object.freeze({\n ...member,\n metadata: Metadata.combine([member.metadata, extra]),\n })\n copies.set(member, copy)\n return copy\n }),\n )\n let seen = -1\n let view: {\n readonly relations: Readonly<Record<string, EntityMember>>\n readonly derived: Readonly<Record<string, EntityMember>>\n readonly sets: Readonly<Record<string, EntitySet>>\n readonly members: Readonly<Record<string, EntityMember>>\n }\n const current = () => {\n if (seen !== shape.revision) {\n const relations = annotate(shape.relations)\n const derived = annotate(shape.derived)\n view = {\n relations,\n derived,\n sets: Object.freeze({ ...shape.sets }),\n members: Object.freeze({ ...fields, ...relations, ...derived }),\n }\n seen = shape.revision\n }\n return view\n }\n const entity = Object.create(EntityProto)\n Object.defineProperties(entity, {\n identity: { value: parts.identity, enumerable: true },\n name: { value: parts.identity.name, enumerable: true },\n schema: { value: parts.schema, enumerable: true },\n fields: { value: fields, enumerable: true },\n relations: { get: () => current().relations, enumerable: true },\n derived: { get: () => current().derived, enumerable: true },\n members: { get: () => current().members, enumerable: true },\n sets: { get: () => current().sets, enumerable: true },\n metadata: { value: parts.metadata, enumerable: true },\n })\n partsOf.set(entity, parts)\n return Object.freeze(entity)\n}\n\n/** A new descriptor of the same Entity, with some of its own parts changed. */\nconst remake = (entity: AnyEntity, changed: Partial<Parts>): AnyEntity =>\n make({ ...partsOf.get(entity)!, ...changed })\n\n/** Adds to the Entity's shared members, which every descriptor of it then reads. */\nconst extend = (\n entity: AnyEntity,\n added: {\n readonly relations?: Readonly<Record<string, EntityMember>>\n readonly derived?: Readonly<Record<string, EntityMember>>\n readonly sets?: Readonly<Record<string, EntitySet>>\n },\n): void => {\n const shape = shapeOf(entity.identity)\n for (const [key, member] of Object.entries(added.relations ?? {}))\n put(shape.relations, key, member)\n for (const [key, member] of Object.entries(added.derived ?? {})) put(shape.derived, key, member)\n for (const [key, set] of Object.entries(added.sets ?? {})) put(shape.sets, key, set)\n shape.revision += 1\n}\n\nconst isSameEntity = (left: AnyEntity, right: AnyEntity): boolean =>\n left.identity.token === right.identity.token\n\nconst fail = (entity: AnyEntity, message: string): never => {\n throw new Error(`Entity \"${entity.name}\": ${message}`)\n}\n\nconst isEntity = (value: unknown): value is AnyEntity =>\n typeof value === 'object' && value !== null && EntityTypeId in value\n\nconst kindName = { Field: 'field', Relation: 'relation', Derived: 'derived member' } as const\n\nconst kindOf = (entity: AnyEntity, key: string): string | undefined => {\n const member = (entity.members as Readonly<Record<string, EntityMember>>)[key]\n return member && kindName[member._tag]\n}\n\nconst assertFree = (entity: AnyEntity, keys: ReadonlyArray<string>, adding: string): void => {\n for (const key of keys) {\n const kind = kindOf(entity, key)\n if (kind !== undefined)\n throw new Error(\n `Entity \"${entity.name}\": cannot add ${adding} \"${key}\", it is already a ${kind}`,\n )\n }\n}\n\nconst mapValues = <A, B>(\n record: Readonly<Record<string, A>>,\n f: (value: A, key: string) => B,\n): Record<string, B> =>\n Object.fromEntries(Object.entries(record).map(([key, value]) => [key, f(value, key)]))\n\nexport const Entity = {\n /** Declares an Entity from its intrinsic fields. Each call is a new identity. */\n define: <const Name extends string, Fields extends Schema.Struct.Fields>(\n name: Name,\n schema: Schema.Struct<Fields>,\n ): Entity<Name, Fields> => {\n const identity: EntityIdentity<Name> = Object.freeze({ name, token: Symbol(name) })\n return make({\n identity,\n schema,\n fields: mapValues(schema.fields, (fieldSchema, key) =>\n Object.freeze({\n _tag: 'Field',\n owner: identity,\n key,\n schema: fieldSchema,\n metadata: Metadata.empty,\n }),\n ),\n annotated: {},\n metadata: Metadata.empty,\n }) as Entity<Name, Fields>\n },\n\n /**\n * Declares the relations between a set of Entities in one step, and returns\n * them related. One step, because Entities that point at each other cannot\n * each be declared in terms of the other.\n */\n relate: <const Es extends Entities, const Rs extends RelationMap<Es>>(\n entities: Es,\n relations: Rs & CheckRelations<Es, Rs>,\n ): { readonly [K in keyof Es]: Related<Es, Rs, K> } => {\n const keyByToken = new Map<symbol, string>()\n for (const [key, entity] of Object.entries(entities)) {\n if (!isEntity(entity)) throw new Error(`Entity.relate: \"${key}\" is not an Entity`)\n const earlier = keyByToken.get(entity.identity.token)\n if (earlier !== undefined)\n throw new Error(`Entity.relate: \"${earlier}\" and \"${key}\" are the same Entity`)\n keyByToken.set(entity.identity.token, key)\n }\n const given: Readonly<Record<string, RelationSpecs | undefined>> = relations\n for (const owner of Object.keys(given))\n if (!Object.hasOwn(entities, owner))\n throw new Error(`Entity.relate: relations given for \"${owner}\", which is not being related`)\n\n const related: Record<string, AnyEntity> = {}\n // Every relation is checked before any is added, so a refused call adds none.\n const additions: Array<readonly [AnyEntity, Readonly<Record<string, EntityMember>>]> = []\n for (const [ownerKey, entity] of Object.entries(entities)) {\n const specs = own(given, ownerKey) ?? {}\n assertFree(entity, Object.keys(specs), 'relation')\n const added = mapValues<RelationSpec<AnyEntity, Cardinality, boolean>, EntityMember>(\n specs,\n (spec, key) => {\n const targetKey = isEntity(spec.target)\n ? keyByToken.get(spec.target.identity.token)\n : undefined\n if (targetKey === undefined)\n throw new Error(\n `Entity \"${entity.name}\": relation \"${key}\" targets an Entity that is not being related`,\n )\n return Object.freeze({\n _tag: 'Relation',\n owner: entity.identity,\n key,\n // Read on call: the target may come later in `entities` than its owner.\n target: () => related[targetKey]!,\n cardinality: spec.cardinality,\n optional: spec.optional,\n metadata: Metadata.empty,\n })\n },\n )\n additions.push([entity, added])\n put(related, ownerKey, entity)\n }\n for (const [entity, added] of additions) extend(entity, { relations: added })\n return Object.freeze(related) as never\n },\n\n /**\n * Selects members of an Entity and assembles the schema of the result. A\n * relation selected with `true` yields an `EntityRef`; with a Selection of its\n * target, that Selection's value. `many` yields an array, an optional `one`\n * is nullable.\n */\n select: <E extends AnyEntity, const Spec>(\n entity: E,\n spec: Spec & SelectionSpec<E, Spec>,\n ): Selection<E['name'], Spec, SelectionSchema<E, Spec>, IdOf<E>> => {\n const members: Readonly<Record<string, EntityMember>> = entity.members\n const fields = mapValues<unknown, Schema.Constraint>(spec, (selected, key) => {\n const member = own(members, key)\n if (member === undefined)\n throw new Error(`Entity \"${entity.name}\": cannot select \"${key}\", it is not a member`)\n if (member._tag !== 'Relation') {\n if (selected !== true)\n throw new Error(\n `Entity \"${entity.name}\": \"${key}\" is a ${kindName[member._tag]}, select it with true`,\n )\n return member.schema\n }\n const target = member.target()\n if (isSelectionPage(selected)) {\n if (member.cardinality !== 'many')\n throw new Error(\n `Entity \"${entity.name}\": \"${key}\" is one ${target.name}, so it has no pages`,\n )\n if (!isSameEntity(selected.selection.entity, target))\n throw new Error(`Entity \"${entity.name}\": \"${key}\" pages a Selection of ${target.name}`)\n return Schema.Struct({\n items: Schema.Array(selected.selection.schema as Schema.Top),\n hasNext: Schema.Boolean,\n hasPrevious: Schema.Boolean,\n })\n }\n let item: Schema.Top\n if (selected === true)\n item = Schema.Struct({ entity: Schema.Literal(target.name), id: idSchemaOf(target) })\n else if (isSelection(selected) && isSameEntity(selected.entity, target))\n item = selected.schema\n else\n throw new Error(\n `Entity \"${entity.name}\": \"${key}\" takes true or a Selection of ${target.name}`,\n )\n return member.cardinality === 'many'\n ? Schema.Array(item)\n : member.optional\n ? Schema.NullOr(item)\n : item\n })\n return Object.freeze({\n [SelectionTypeId]: SelectionTypeId,\n entity,\n members: spec,\n schema: Schema.Struct(fields),\n }) as never\n },\n\n /**\n * A `many` relation read a page at a time, in place of its Selection:\n * `comments: Entity.page(CommentSummary, { first: 10 })`. The value is a page\n * of the Selection's values: `items`, `hasNext`, `hasPrevious`. Reading on from a cursor is another window.\n */\n page: <Name extends string, S extends Schema.Constraint>(\n selection: Selection<Name, any, S>,\n window: PageWindow,\n ): SelectionPage<Name, S> => {\n const sides = [window.first, window.last].filter(size => size !== undefined)\n if (sides.length !== 1 || !sides.every(size => Number.isInteger(size) && size >= 0))\n throw new Error(\n `Entity.page: a window of ${selection.entity.name} takes first or last, a non-negative integer`,\n )\n if (\n (window.first !== undefined && window.before !== undefined) ||\n (window.last !== undefined && window.after !== undefined)\n )\n throw new Error(\n `Entity.page: a window of ${selection.entity.name} reads first after a cursor, or last before one`,\n )\n const page: SelectionPage<Name, S> = {\n [SelectionPageTypeId]: SelectionPageTypeId,\n selection,\n window,\n }\n return Object.freeze(page)\n },\n\n /**\n * Adds readable members that are not part of `entity.schema`. A\n * `Derived.count` or `Derived.exists` must read rows pointing at this\n * Entity: one over a relation to another is refused here, as is an exists\n * whose viewer is not another `one` relation of the same pointing Entity.\n */\n derived:\n <const New extends DerivedSpecs>(specs: New) =>\n <E extends AnyEntity>(entity: E & Free<E, New> & PointsHere<E, New>): WithDerived<E, New> => {\n const members: Readonly<Record<string, EntityMember>> = entity.members\n // The very spec added again (`Guards.may` on a second view of the Entity) is the member it added.\n const fresh: DerivedSpecs = Object.fromEntries(\n Object.entries(specs).filter(([key, spec]) => {\n const taken = own(members, key)\n return !(\n taken?._tag === 'Derived' &&\n taken.schema === spec.schema &&\n taken.derives === spec.derives\n )\n }),\n )\n assertFree(entity, Object.keys(fresh), 'derived member')\n const added = mapValues<DerivedSpec<Schema.Constraint>, EntityMember>(fresh, (spec, key) => {\n const pointingHere = (relation: OneRelation, verb: string): void => {\n if (relation.cardinality !== 'one')\n fail(\n entity,\n `\"${key}\" ${verb} \"${relation.key}\", a many relation; name a one relation that points here`,\n )\n if (!isSameEntity(relation.target(), entity))\n fail(\n entity,\n `\"${key}\" ${verb} \"${relation.owner.name}.${relation.key}\", which points at ${relation.target().name}`,\n )\n }\n Derivation.$match(spec.derives, {\n Supplied: () => undefined,\n Count: ({ relation }) => pointingHere(relation, 'counts'),\n Exists: ({ relation, viewer }) => {\n pointingHere(relation, 'reads')\n if (viewer.owner.token !== relation.owner.token || viewer.key === relation.key)\n fail(\n entity,\n `\"${key}\"'s viewer \"${viewer.owner.name}.${viewer.key}\" must be another one relation of ${relation.owner.name}`,\n )\n },\n })\n return Object.freeze({\n _tag: 'Derived',\n owner: entity.identity,\n key,\n schema: spec.schema,\n derives: spec.derives,\n metadata: Metadata.empty,\n })\n })\n extend(entity, { derived: added })\n return entity as never\n },\n\n /**\n * Says which members take their value from the write's context, never its\n * input: `Expr.viewer(User)`, whoever asks (a `one` relation to a User, or a\n * field holding their id), and `Expr.now`, when (a field stored as a\n * number). `on` says which writes set them: `'create'`, every insert, or\n * `'write'`, every insert and every update.\n *\n * ```ts\n * const Post = Blog.Post.pipe(\n * Entity.sets({ author: Expr.viewer(User), createdAt: Expr.now }, { on: 'create' }),\n * Entity.sets({ editedAt: Expr.now }, { on: 'write' }),\n * )\n * ```\n *\n * Every write of the Entity follows from it: a server writes the values and\n * a client predicts them, and a write whose input sets one is refused where\n * it is declared. Refused here: the id, a member set already, a `many`\n * relation, a relation set to anything but the viewer of its target, and a\n * field that cannot hold its value. Added after `Entity.relate` to set a\n * relation.\n */\n sets:\n <E extends AnyEntity>(values: EntitySets<E>, options: { readonly on: SetOn }) =>\n (entity: E): E => {\n const given: Readonly<Record<string, unknown>> = values\n const added: Record<string, EntitySet> = {}\n for (const [key, value] of Object.entries(given)) {\n if (value === undefined) continue\n put(added, key, checkedSet(entity, key, value, options.on))\n }\n extend(entity, { sets: added })\n return entity\n },\n\n /** Attaches an interpreter's metadata to the Entity itself. */\n annotate:\n (metadata: Metadata) =>\n <E extends AnyEntity>(entity: E): E =>\n remake(entity, { metadata: Metadata.combine([entity.metadata, metadata]) }) as E,\n\n /**\n * Declares what every stored row, or every change of one, must hold:\n * `Entity.invariant('reservedWithinQuantity', ({ after }) =>\n * Expr.lte(after.reserved, after.quantity), { message })` over the row a\n * write leaves, or with `before` too over the change an update makes.\n * Refused where it is declared: an id declared twice, a predicate over another\n * Entity, one reading an input or nothing of `after` (that is a `when`), a path\n * naming no field.\n */\n invariant,\n\n /** The Entity's invariants, in the order they were declared. */\n invariants: invariantsOf,\n\n /**\n * A row (`{ after }`, a create's) or a change (`{ before, after }`, an\n * update's) under the Entity's invariants: `Valid`, `Invalid` with the ones\n * that fail (a null fails, as SQL's unknown), or `Undecided` with the fields\n * one reads that a row lacks.\n */\n judge,\n\n /** Whether an invariant reads the row before a write: judged on updates only, and no CHECK. */\n readsBefore,\n\n /** `Entity.judge` against invariants already read, such as those a database binding keeps. */\n judgeAgainst,\n\n /**\n * The row an `Entity.input`'s value describes, judged: what a form can say\n * before the server does. Undecided for an invariant over a field it leaves unset.\n */\n judgeInput,\n\n /** The state invariants as a Schema check over the row type, each failure at its path. */\n check,\n\n /** Attaches an interpreter's metadata to members, by key. */\n annotateMembers:\n <E extends AnyEntity>(metadata: { readonly [K in keyof E['members']]?: Metadata }) =>\n (entity: E): E => {\n const given = metadata as Readonly<Record<string, Metadata | undefined>>\n for (const key of Object.keys(given))\n if (kindOf(entity, key) === undefined)\n throw new Error(`Entity \"${entity.name}\": cannot annotate \"${key}\", it is not a member`)\n const parts = partsOf.get(entity)!\n const fields = mapValues(entity.fields, (member: EntityMember, key) => {\n const extra = own(given, key)\n return extra === undefined\n ? member\n : Object.freeze({ ...member, metadata: Metadata.combine([member.metadata, extra]) })\n })\n // A relation or derived member is the Entity's own, so its metadata here is this descriptor's.\n const annotated: Record<string, Metadata> = { ...parts.annotated }\n for (const [key, extra] of Object.entries(given)) {\n if (extra === undefined || Object.hasOwn(entity.fields, key)) continue\n const earlier = own(parts.annotated, key)\n put(annotated, key, earlier === undefined ? extra : Metadata.combine([earlier, extra]))\n }\n return remake(entity, { fields, annotated }) as E\n },\n\n /**\n * Reads an operation's input schema against an Entity. A key that names a\n * field maps to it; any other key is mapped explicitly, to a Field, to\n * `Relation.input(relation)`, or to `Entity.unmapped`. Nothing is inferred\n * from a naming convention such as `authorId`.\n */\n input: <\n E extends AnyEntity,\n Fields extends Schema.Struct.Fields,\n // `{}` when every key maps itself, so the argument can be omitted.\n const Mapping = {},\n >(\n entity: E,\n schema: Schema.Struct<Fields>,\n ...mapping: keyof InputMapping<E, Fields, Mapping> extends never\n ? [mapping?: Mapping & InputMapping<E, Fields, Mapping>]\n : [mapping: Mapping & InputMapping<E, Fields, Mapping>]\n ): EntityInput<E, Fields, InputMembers<E, Fields, Mapping>> => {\n const written: Readonly<Record<string, InputMember | string | undefined>> = mapping[0] ?? {}\n for (const key of Object.keys(written))\n if (!Object.hasOwn(schema.fields, key))\n throw new Error(`Entity \"${entity.name}\": \"${key}\" is mapped but is not a key of the input`)\n // A member named by its key: a Field as it is, a relation as its ids.\n const named = (key: string, name: string): InputMember => {\n const member = (entity.members as Readonly<Record<string, EntityMember | undefined>>)[name]\n switch (member?._tag) {\n case 'Field':\n return member\n case 'Relation':\n return Object.freeze({ _tag: 'RelationInput', relation: member })\n case 'Derived':\n case undefined:\n return fail(\n entity,\n `input key \"${key}\" is mapped to \"${name}\", which names no field or relation`,\n )\n }\n }\n const given: Readonly<Record<string, InputMember | undefined>> = mapValues(\n written,\n (member, key) => (typeof member === 'string' ? named(key, member) : member),\n )\n const fields: Readonly<Record<string, InputMember | undefined>> = entity.fields\n const members = mapValues(schema.fields, (_, key) => {\n const member =\n own(given, key) ??\n own(fields, key) ??\n fail(entity, `input key \"${key}\" names no field; map it to a member or Entity.unmapped`)\n const owned =\n member._tag === 'Field'\n ? member\n : member._tag === 'RelationInput' || member._tag === 'NestedInput'\n ? member.relation\n : member._tag === 'Unmapped'\n ? undefined\n : fail(\n entity,\n `input key \"${key}\" maps to a Field, Relation.input(relation), Relation.nested(relation, input), or Entity.unmapped`,\n )\n if (owned !== undefined && owned.owner.token !== entity.identity.token)\n fail(entity, `input key \"${key}\" is mapped to a member of \"${owned.owner.name}\"`)\n if (\n member._tag === 'NestedInput' &&\n !isSameEntity(member.input.entity, member.relation.target())\n )\n fail(\n entity,\n `input key \"${key}\" nests an input of \"${member.input.entity.name}\", but \"${member.relation.key}\" is of \"${member.relation.target().name}\"`,\n )\n return member\n })\n return Object.freeze({ entity, schema, members: Object.freeze(members) }) as never\n },\n\n /** For an input key that is about the operation rather than the Entity. */\n unmapped,\n\n /**\n * The schemas of some of an Entity's fields, by key, to spread into an input's\n * struct: `Schema.Struct({ ...Entity.fields(Post, 'id', 'title'), editorId: ... })`.\n * The input then keeps the field's own rules, and its keys map themselves.\n */\n fields: <E extends AnyEntity, const Keys extends ReadonlyArray<keyof E['fields'] & string>>(\n entity: E,\n ...keys: Keys\n ): { readonly [K in Keys[number]]: E['fields'][K]['schema'] } =>\n Object.fromEntries(\n keys.map(key => [\n key,\n (\n own(\n entity.fields as Readonly<\n Record<string, EntityField<string, string, Schema.Constraint>>\n >,\n key,\n ) ?? fail(entity, `\"${key}\" is not a field`)\n ).schema,\n ]),\n ) as never,\n\n /**\n * The Selection of every member an input writes, with each relation as refs:\n * what an edit screen loads before it shows the input's current values.\n */\n selectFor: <E extends AnyEntity, Fields extends Schema.Struct.Fields, Members>(\n input: EntityInput<E, Fields, Members>,\n ): Selection<\n E['name'],\n WrittenSpec<Members>,\n SelectionSchema<E, WrittenSpec<Members>>,\n IdOf<E>\n > => {\n const members: Readonly<Record<string, InputMember>> = input.members as never\n const spec = Object.fromEntries(\n Object.values(members).flatMap((member): ReadonlyArray<readonly [string, unknown]> =>\n member._tag === 'Field'\n ? [[member.key, true]]\n : member._tag === 'RelationInput'\n ? [[member.relation.key, true]]\n : member._tag === 'NestedInput'\n ? // What the nested input writes of the target, so its keys can be shown too.\n [[member.relation.key, Entity.selectFor(member.input)]]\n : [],\n ),\n )\n return Entity.select(input.entity, spec as never) as never\n },\n\n /**\n * The input values that reproduce `value`, a value read through `selectFor`\n * (or any Selection with those members): a field as it is, a relation as the\n * id or ids of its refs. A key whose member `value` lacks is left out, as is\n * an unmapped key, which the Entity knows nothing about.\n */\n valuesFor: <E extends AnyEntity, Fields extends Schema.Struct.Fields, Members>(\n input: EntityInput<E, Fields, Members>,\n value: Readonly<Record<string, unknown>>,\n ): Partial<Schema.Struct.Type<Fields>> => {\n const members: Readonly<Record<string, InputMember>> = input.members as never\n // The id of a ref or of a nested Selection's value; `undefined` when it has none.\n const idOf = (held: unknown): unknown =>\n held === null\n ? null\n : typeof held === 'object' && 'id' in held\n ? held.id\n : typeof held === 'string'\n ? held\n : undefined\n const entries = Object.entries(members).flatMap(([key, member]) => {\n if (member._tag === 'Unmapped') return []\n const written = member._tag === 'Field' ? member.key : member.relation.key\n if (!(written in value)) return []\n const read = value[written]\n switch (member._tag) {\n case 'Field':\n return [[key, read] as const]\n case 'NestedInput': {\n const nested = (held: unknown): unknown =>\n typeof held === 'object' && held !== null\n ? Entity.valuesFor(member.input, held as Readonly<Record<string, unknown>>)\n : null\n return [[key, Array.isArray(read) ? read.map(nested) : nested(read)] as const]\n }\n case 'RelationInput': {\n const ids = Array.isArray(read) ? read.map(idOf) : idOf(read)\n // A relation read without its ids (a nested Selection that left `id` out) fills nothing.\n const known = Array.isArray(ids) ? !ids.includes(undefined) : ids !== undefined\n return known ? [[key, ids] as const] : []\n }\n }\n })\n return Object.fromEntries(entries) as Partial<Schema.Struct.Type<Fields>>\n },\n\n is: isEntity,\n\n /** True when both descriptors are versions of one Entity. */\n same: isSameEntity,\n}\n\nfunction one<Target extends AnyEntity>(target: Target): RelationSpec<Target, 'one', false>\nfunction one<Target extends AnyEntity, const Optional extends boolean>(\n target: Target,\n options: { readonly optional: Optional },\n): RelationSpec<Target, 'one', Optional>\nfunction one(\n target: AnyEntity,\n options?: { readonly optional: boolean },\n): RelationSpec<AnyEntity, 'one', boolean> {\n return { target, cardinality: 'one', optional: options?.optional ?? false }\n}\n\n/** What the owner sees: one or many of `target`. Used inside `Entity.relate`. */\nexport const Relation = {\n one,\n\n /** For `Entity.input`: the input key holds this relation's target id, or ids for a `many`. */\n input: <R extends EntityRelation<any, any, any, any, any>>(relation: R): RelationInput<R> =>\n Object.freeze({ _tag: 'RelationInput', relation }),\n\n /**\n * For `Entity.input`: the input key holds the relation's target itself, written\n * through `input`, an `Entity.input` of the target. A `many` holds a list.\n */\n nested: <R extends EntityRelation<any, any, any, any, any>, I extends EntityInput<any, any, any>>(\n relation: R,\n input: I,\n ): NestedInput<R, I> => Object.freeze({ _tag: 'NestedInput', relation, input }),\n\n many: <Target extends AnyEntity>(target: Target): RelationSpec<Target, 'many', false> => ({\n target,\n cardinality: 'many',\n optional: false,\n }),\n}\n\n/** A count: never negative, never a fraction. */\nconst CountSchema = Schema.Number.check(Schema.isInt(), Schema.isGreaterThanOrEqualTo(0))\n\n/** The id of the row an exists found, as every Remote id is held: text, or none. */\nconst WitnessSchema = Schema.OptionFromNullOr(Schema.String)\n\ntype OwnerName<R> = R extends EntityRelation<infer Name, any, any, any, any> ? Name : never\n\nexport const Derived = {\n /**\n * A member only an interpreter can compute, of type `schema`: it supplies the\n * value. `predict` says how a client foresees it for a row it writes (Guard's\n * `may`); without it the row reads as missing the member until the answer.\n * `forbids` says which write to the row its value refuses (Guard's `may`\n * again), so a client holding it refuses that write where it is made.\n */\n make: <S extends Schema.Constraint>(\n schema: S,\n options: {\n readonly predict?: Predict | undefined\n readonly forbids?: Forbids | undefined\n } = {},\n ): DerivedSpec<S, Extract<Derivation, { readonly _tag: 'Supplied' }>> => ({\n schema,\n derives: Derivation.Supplied({\n predict: Option.fromUndefinedOr(options.predict),\n forbids: Option.fromUndefinedOr(options.forbids),\n }),\n }),\n\n /**\n * How many rows point at this one through `relation`, a `one` relation of\n * the counted Entity: `likeCount: Derived.count(Like.relations.post)` on\n * Post. Added after `Entity.relate`, which makes the relation. A server\n * compiles it from the relation's storage, and a client predicts it from\n * the rows a pending write inserts, deletes or points elsewhere.\n */\n count: <R extends EntityRelation<string, string, AnyEntity, 'one', boolean>>(\n relation: R,\n ): DerivedSpec<typeof CountSchema, { readonly _tag: 'Count'; readonly relation: R }> => ({\n schema: CountSchema,\n derives: Derivation.Count({ relation }) as { readonly _tag: 'Count'; readonly relation: R },\n }),\n\n /**\n * Whether a row points at this one through `relation` and at whoever reads\n * it through `viewer`, another `one` relation of the same pointing Entity:\n * `liked: Derived.exists(Like.relations.post, { viewer: Like.relations.user })`\n * on Post. Its value is that row's id as the store holds it, or none, so the\n * reader can take it back (`Write.delete` by that id). It depends on who\n * reads it: a server answers it for the principal it reads as, and a client\n * predicts it for the viewer it is told of.\n */\n exists: <\n R extends OneRelation,\n V extends EntityRelation<OwnerName<R>, string, AnyEntity, 'one', boolean>,\n >(\n relation: R,\n options: { readonly viewer: V },\n ): DerivedSpec<\n typeof WitnessSchema,\n { readonly _tag: 'Exists'; readonly relation: R; readonly viewer: V }\n > => ({\n schema: WitnessSchema,\n derives: Derivation.Exists({ relation, viewer: options.viewer }) as {\n readonly _tag: 'Exists'\n readonly relation: R\n readonly viewer: V\n },\n }),\n}\n\nexport * from './expr.js'\nexport {\n contextValue,\n viewerIdOf,\n type ExprContext,\n type NowExpr,\n type ViewerExpr,\n type ViewerPathExpr,\n} from './context.js'\nexport * from './collation.js'\nexport * from './operators.js'\nexport * from './law.js'\nexport * from './text.js'\nexport * from './readFilter.js'\nexport * from './words.js'\nexport * from './shape.js'\n// The reference semantics of the IR above. The conformance suite that proves\n// an interpreter agrees with it is `foldkit-entity/conformance`, kept out of\n// this entry because it is fixture data every form and admin screen would\n// otherwise carry.\nexport * from './evaluate.js'\nexport * from './held.js'\nexport type {\n AfterRow,\n BeforeRow,\n Change,\n DeclaredInvariant,\n Invariant,\n Judgement,\n} from './invariant.js'\nexport type { ContextValue, EntitySet, SetOn } from './sets.js'\nexport {\n Write,\n type AnyWrite,\n type BoundWrite,\n type ConditionedWrite,\n Computation,\n type WriteAssignment,\n type WriteComputations,\n type WriteCondition,\n type WriteIncrement,\n type WriteKind,\n type WriteLink,\n type WriteSet,\n type ContextSet,\n type ContextRead,\n type ContextValues,\n} from './write.js'\n"],"mappings":"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"}
|
package/dist/words-a4e9o-TK.d.ts
DELETED
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
import { Option, Schema } from "effect";
|
|
2
|
-
/** What a schema says of itself to a person: its `title` and `description`. */
|
|
3
|
-
interface SchemaWords {
|
|
4
|
-
readonly title: Option.Option<string>;
|
|
5
|
-
readonly description: Option.Option<string>;
|
|
6
|
-
}
|
|
7
|
-
declare const Words: {
|
|
8
|
-
/**
|
|
9
|
-
* A schema's words, as a label and its help text. Under Effect 4 a checked
|
|
10
|
-
* schema resolves to its last check's annotations, which say what the check
|
|
11
|
-
* expects and carry no `title`, so a title given before the check is read from
|
|
12
|
-
* the schema's own annotations. Read words through this, never through
|
|
13
|
-
* `Schema.resolveAnnotations` directly.
|
|
14
|
-
*/
|
|
15
|
-
of: (schema: Schema.Top) => SchemaWords;
|
|
16
|
-
};
|
|
17
|
-
export { Words as n, SchemaWords as t };
|
|
18
|
-
//# sourceMappingURL=words-a4e9o-TK.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"words-a4e9o-TK.d.ts","names":[],"sources":["../src/words.ts"],"mappings":";;UAGiB;WACN,OAAO,OAAO;WACd,aAAa,OAAO;;cAMlB;;;;;;;;EAQX,KAAE,QAAW,OAAO,QAAM"}
|