foldkit-surface 0.4.1 → 0.5.1

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 CHANGED
@@ -38,7 +38,7 @@ pnpm add foldkit-surface
38
38
  ## Quick start
39
39
 
40
40
  ```ts
41
- import { Schema } from 'effect'
41
+ import { Option, Schema } from 'effect'
42
42
  import { defineMessageUnion } from 'foldkit/message'
43
43
  import { Projection, Surface } from 'foldkit-surface'
44
44
 
@@ -46,7 +46,7 @@ const Todo = Schema.Struct({ id: Schema.String, title: Schema.String, done: Sche
46
46
  const Model = Schema.Struct({
47
47
  todos: Schema.Array(Todo),
48
48
  todosById: Schema.Record(Schema.String, Todo),
49
- selectedTodoId: Schema.NullOr(Schema.String),
49
+ selectedTodoId: Schema.Option(Schema.String),
50
50
  })
51
51
  const Message = defineMessageUnion({
52
52
  CreatedTodo: { id: Schema.String, title: Schema.String },
@@ -64,10 +64,10 @@ const TodoList = App.surface('TodoList', {
64
64
  const model: typeof Model.Type = {
65
65
  todos: [{ id: 't1', title: 'Read the guide', done: false }],
66
66
  todosById: {},
67
- selectedTodoId: 't1',
67
+ selectedTodoId: Option.some('t1'),
68
68
  }
69
69
  Surface.read(TodoList, model)
70
- // { todos: [{ id: 't1', title: 'Read the guide', done: false }], selectedTodoId: 't1' }
70
+ // { todos: [{ id: 't1', title: 'Read the guide', done: false }], selectedTodoId: Option.some('t1') }
71
71
  ```
72
72
 
73
73
  `TodoList` is a named contract: the projection a feature reads (here the two
@@ -89,7 +89,7 @@ without a parallel field registry.
89
89
 
90
90
  ```ts
91
91
  App.model.todos // FieldRef<Model, Todo[], 'todos'>
92
- App.model.selectedTodoId // FieldRef<Model, string | null, 'selectedTodoId'>
92
+ App.model.selectedTodoId // FieldRef<Model, Option<string>, 'selectedTodoId'>
93
93
  App.model.todosById.at('t1') // OptionalRef<Model, Option<Todo>> (dynamic key)
94
94
  App.model.todos.index(0) // OptionalRef<Model, Option<Todo>> (dynamic index)
95
95
  ```
@@ -111,6 +111,12 @@ const Shared = Projection.pick(App.model.todos, App.model.selectedTodoId)
111
111
  // { schema, dependencies, get, set }
112
112
  ```
113
113
 
114
+ Each picked field is named by its last key, so `App.model.post.id` is `id`.
115
+ Two fields with the same name at different paths, such as `post.id` and
116
+ `viewer.id`, would be one field, and are refused when the projection is
117
+ built; pick them in separate projections. `Projection.compose` refuses the
118
+ same collision between its parts.
119
+
114
120
  A reference from a different application is rejected by a per-application owner
115
121
  token, so two structurally identical Models cannot be mixed. Duplicate members
116
122
  deduplicate; a conflicting definition throws.
@@ -192,6 +198,30 @@ application, a duplicate tag, or a subset from another application throws.
192
198
  Surface does not label a subset durable, agent-visible, or presence; `Sync` and
193
199
  `Agent` attach those policies to the same value.
194
200
 
201
+ ## Actions
202
+
203
+ An Action is a capability a consumer may invoke by name with data: an agent's
204
+ tool, a page Block's button. It ends in one of the application's own Messages,
205
+ so `update` stays the only place a Message has effects:
206
+
207
+ ```ts
208
+ import { Action } from 'foldkit-surface'
209
+
210
+ const AddToCart = Action.define({
211
+ name: 'addToCart',
212
+ description: 'Add a product to the cart',
213
+ input: Schema.Struct({ productId: ProductId }),
214
+ toMessage: input => Message.AddedToCart(input),
215
+ })
216
+
217
+ Action.run(AddToCart, { productId: 'p1' }) // Result: the Message, or why the input was refused
218
+ ```
219
+
220
+ `Action.run` decodes the data as the Action's input before `toMessage` sees it,
221
+ so data from a Document or a tool call never executes. The Action is declared
222
+ once: `Agent.action(AddToCart)` exposes it to an agent, and a page's Catalog
223
+ lists it for Blocks to reference by name.
224
+
195
225
  ## Surfaces
196
226
 
197
227
  A Surface binds a projection and the Messages a feature may use into a named,
@@ -224,10 +254,10 @@ constructor from another application is a compile error at the constructor.
224
254
  A parameterized Surface's projection is not evaluated until it has params.
225
255
 
226
256
  `Surface.at(surface, params)` is the Surface as the Model activates it: `params`
227
- is the value, or a function of the Model returning it (`undefined` while the
228
- Surface is inactive, on another route say). Its `projectionOf(model)` is the
229
- projection for those params, or `undefined`, and it carries the Surface's
230
- `owner`; a Subscription derives what to fetch from a list of them
257
+ is the value, or a function of the Model returning it as an `Option` (none while
258
+ the Surface is inactive, on another route say). Its `projectionOf(model)` is the
259
+ projection for those params, an `Option` too, and it carries the Surface's
260
+ `owner` and `messages`, the tags of the Messages the Surface lists; a Subscription derives what to fetch from a list of them
231
261
  (`foldkit-remote`'s `Data.subscriptions`).
232
262
 
233
263
  ### `Surface.make`, the explicit form
@@ -283,7 +313,7 @@ intentional. They operate at different levels:
283
313
  A useful shorthand is:
284
314
 
285
315
  ```text
286
- evo = evolve application data inside update
316
+ modifyFields = modify application data inside update
287
317
  Optic / ModelRef = locate a value structurally
288
318
  Projection = describe/read/write a known Model slice
289
319
  Surface = observation + capability contract
@@ -295,7 +325,7 @@ application with a `filter` field and an already-decoded `restoredFilter`:
295
325
 
296
326
  ```ts
297
327
  // application transition
298
- evo(model, { filter: () => 'active' })
328
+ modifyFields(model, { filter: () => 'active' })
299
329
 
300
330
  // structural addressing
301
331
  App.model.filter.get(model)
@@ -461,6 +491,7 @@ that may observe across those runtime boundaries without creating another one.
461
491
  interpreter metadata (`Metadata.key`).
462
492
  - Application scopes (`Surface.application`) and their identity token.
463
493
  - Typed Message subsets (`MessageSet.make`, `MessageSet.union`).
494
+ - Actions (`Action.define`, `Action.run`): a named capability ending in a Message.
464
495
  - Named Surfaces and their renderer binding.
465
496
 
466
497
  ## Limits
package/dist/index.d.mts CHANGED
@@ -1,4 +1,4 @@
1
- import { Optic, Option, Schema } from "effect";
1
+ import { Optic, Option, Result, Schema } from "effect";
2
2
  import { Metadata, Metadata as Metadata$1, MetadataKey, MetadataSummary, MetadataSummary as MetadataSummary$1, MetadataTypeId } from "foldkit-metadata";
3
3
  import { Html, HtmlBuilder } from "foldkit/html";
4
4
  import { MessageUnion } from "foldkit/message";
@@ -195,8 +195,10 @@ export interface ActiveSurface<Root> {
195
195
  readonly name: string;
196
196
  /** Identity token of the application the Surface belongs to. */
197
197
  readonly owner: object;
198
- /** The projection for the params the Model gives, or `undefined` while inactive. */
199
- readonly projectionOf: (model: Root) => Projection<Root, unknown> | undefined;
198
+ /** The projection for the params the Model gives; none while the Surface is inactive. */
199
+ readonly projectionOf: (model: Root) => Option.Option<Projection<Root, unknown>>;
200
+ /** The tags of the Messages the Surface lists in `messages`: what it may send. */
201
+ readonly messages: ReadonlyArray<string>;
200
202
  /** Present when the Surface was placed with `Surface.when`; absent for `Surface.at`. */
201
203
  readonly activation?: Activation | undefined;
202
204
  }
@@ -342,14 +344,45 @@ export declare const MessageSet: {
342
344
  */
343
345
  union: <const Subs extends readonly MessageSet<any, any, any, any, any>[]>(...subsets: Subs) => MessageSet<RootOfSubset<Subs[number]>, MessageOfSubset<Subs[number]>, ValueOfSubset<Subs[number]>, MergeConstructors<Subs>, CasesOfSubset<Subs[number]>, SubsetEncoded<MergeConstructors<Subs>>>;
344
346
  };
347
+ /**
348
+ * A capability a consumer may invoke by name with data, such as an agent's
349
+ * tool or a page Block's button. It ends in one of the application's own
350
+ * Messages, so `update` stays the only place a Message has effects, and its
351
+ * input is decoded by its Schema before `toMessage` sees it: stored or
352
+ * untrusted data never executes.
353
+ */
354
+ export interface Action<Name extends string = string, Input = never, Encoded = unknown, Message = unknown> {
355
+ readonly _tag: 'Action';
356
+ readonly name: Name;
357
+ /** What it does, for a person choosing it or an agent deciding to. */
358
+ readonly description: string;
359
+ readonly input: Schema.Codec<Input, Encoded, never, never>;
360
+ readonly toMessage: (input: Input) => Message;
361
+ }
362
+ export declare const Action: {
363
+ /** An Action: `Action.define({ name: 'addToCart', description, input, toMessage })`. */
364
+ define: <const Name extends string, Input, Encoded, Message>(config: {
365
+ readonly name: Name;
366
+ readonly description: string;
367
+ readonly input: Schema.Codec<Input, Encoded, never, never>;
368
+ readonly toMessage: (input: Input) => Message;
369
+ }) => Action<Name, Input, Encoded, Message>;
370
+ /** Whether a value is an Action. */
371
+ is: (value: unknown) => value is Action;
372
+ /**
373
+ * The Message an Action makes of `data`, decoded as its input first; a
374
+ * failure says why the input was refused and makes no Message.
375
+ */
376
+ run: <Input, Encoded, Message>(action: Action<string, Input, Encoded, Message>, data: unknown) => Result.Result<Message, Schema.SchemaError>;
377
+ };
345
378
  export declare const Surface: {
346
379
  application: typeof application;
347
380
  /**
348
381
  * A Surface as the Model activates it. `params` is the value, or a function
349
- * of the Model returning it (`undefined` while the Surface is inactive, e.g.
350
- * on another route); the Surface's requirements then follow the Model.
382
+ * of the Model returning it (none while the Surface is inactive, e.g. on
383
+ * another route); the Surface's requirements then follow the Model.
351
384
  */
352
- at: <Root, Model, Message, Params>(surface: Surface<Root, Model, Message, Params>, params: Params | ((model: Root) => Params | undefined)) => ActiveSurface<Root>;
385
+ at: <Root, Model, Message, Params>(surface: Surface<Root, Model, Message, Params>, params: Params | ((model: Root) => Option.Option<Params>)) => ActiveSurface<Root>;
353
386
  /**
354
387
  * A Surface active while a tagged value at a known place has a given tag.
355
388
  *
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":"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"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":"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"}
package/dist/index.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { Optic, Option, Result, Schema } from "effect";
1
+ import { Optic, Option, Predicate, Result, Schema } from "effect";
2
2
  import { Metadata, Metadata as Metadata$1, MetadataTypeId } from "foldkit-metadata";
3
3
  //#region src/index.ts
4
4
  /**
@@ -56,6 +56,10 @@ const messageTag = (constructor) => {
56
56
  const literal = constructor.fields?._tag?.ast?.literal;
57
57
  return typeof literal === "string" ? literal : void 0;
58
58
  };
59
+ /** Whether a Message, of an application this cannot name, has one of `tags`. */
60
+ const hasTagIn = (tags, message) => Predicate.hasProperty(message, "_tag") && typeof message._tag === "string" && tags.has(message._tag);
61
+ /** The tags of the Messages a Surface lists in `messages`. */
62
+ const messageTags = (surface) => surface.messages.map(messageTag).filter((tag) => tag !== void 0);
59
63
  function makeTree(schema, path, optic, get, optional = false, set, owner) {
60
64
  const erasedOptic = optic;
61
65
  const setFocus = set ?? ((root, value) => optic.replace(value, root));
@@ -217,12 +221,18 @@ const Projection = {
217
221
  const owner = selected[0]?.owner;
218
222
  for (const ref of selected) if (ref.owner !== owner) throw new Error("Projection.pick: references from different applications");
219
223
  const fields = {};
220
- for (const ref of selected) {
221
- const existing = fields[ref.key];
224
+ const paths = {};
225
+ for (const ref of [...selected]) {
226
+ const path = ref.dependency.join(".");
227
+ const existing = paths[ref.key];
222
228
  if (existing !== void 0) {
223
- if (existing === ref.Schema) continue;
224
- throw new Error(`Projection.pick: conflicting definitions for "${ref.key}"`);
229
+ if (existing === path) {
230
+ selected.splice(selected.indexOf(ref), 1);
231
+ continue;
232
+ }
233
+ throw new Error(`Projection.pick: "${existing}" and "${path}" would both be read as "${ref.key}". Pick them in separate projections.`);
225
234
  }
235
+ paths[ref.key] = path;
226
236
  fields[ref.key] = ref.Schema;
227
237
  }
228
238
  return {
@@ -249,13 +259,19 @@ const Projection = {
249
259
  compose: (...projections) => {
250
260
  const parts = [...projections];
251
261
  const fields = {};
262
+ const paths = {};
263
+ const pathOf = (part, key) => part.dependencies.find((dependency) => dependency.at(-1) === key)?.join(".");
252
264
  for (const part of parts) for (const [key, codec] of Object.entries(part.schema.fields)) {
253
265
  const existing = fields[key];
266
+ const path = pathOf(part, key);
254
267
  if (existing !== void 0) {
268
+ const previous = paths[key];
269
+ if (previous !== void 0 && path !== void 0 && previous !== path) throw new Error(`Projection.compose: "${previous}" and "${path}" would both be read as "${key}"`);
255
270
  if (existing === codec) continue;
256
271
  throw new Error(`Projection.compose: conflicting definitions for "${key}"`);
257
272
  }
258
273
  fields[key] = codec;
274
+ if (path !== void 0) paths[key] = path;
259
275
  }
260
276
  return {
261
277
  schema: objectSchema(fields),
@@ -323,7 +339,7 @@ const MessageSet = {
323
339
  constructors: messages,
324
340
  schema: Schema.Union([...messages]),
325
341
  tags,
326
- includes: (message) => tags.has(message._tag ?? "")
342
+ includes: (message) => hasTagIn(tags, message)
327
343
  };
328
344
  },
329
345
  /**
@@ -351,24 +367,39 @@ const MessageSet = {
351
367
  constructors,
352
368
  schema: Schema.Union(constructors),
353
369
  tags,
354
- includes: (message) => tags.has(message._tag ?? "")
370
+ includes: (message) => hasTagIn(tags, message)
355
371
  };
356
372
  }
357
373
  };
374
+ const Action = {
375
+ /** An Action: `Action.define({ name: 'addToCart', description, input, toMessage })`. */
376
+ define: (config) => {
377
+ if (config.name.length === 0) throw new Error("Action.define: an Action needs a name");
378
+ return Object.freeze({
379
+ _tag: "Action",
380
+ ...config
381
+ });
382
+ },
383
+ /** Whether a value is an Action. */
384
+ is: (value) => typeof value === "object" && Predicate.isTagged(value, "Action"),
385
+ /**
386
+ * The Message an Action makes of `data`, decoded as its input first; a
387
+ * failure says why the input was refused and makes no Message.
388
+ */
389
+ run: (action, data) => Result.map(Schema.decodeUnknownResult(action.input)(data), action.toMessage)
390
+ };
358
391
  const Surface = {
359
392
  application,
360
393
  /**
361
394
  * A Surface as the Model activates it. `params` is the value, or a function
362
- * of the Model returning it (`undefined` while the Surface is inactive, e.g.
363
- * on another route); the Surface's requirements then follow the Model.
395
+ * of the Model returning it (none while the Surface is inactive, e.g. on
396
+ * another route); the Surface's requirements then follow the Model.
364
397
  */
365
398
  at: (surface, params) => ({
366
399
  name: surface.name,
367
400
  owner: surface.owner,
368
- projectionOf: (model) => {
369
- const resolved = typeof params === "function" ? params(model) : params;
370
- return resolved === void 0 && surface.Params !== void 0 ? void 0 : surface.projection(resolved);
371
- }
401
+ messages: messageTags(surface),
402
+ projectionOf: (model) => Option.map(typeof params === "function" ? params(model) : Option.some(params), surface.projection)
372
403
  }),
373
404
  /**
374
405
  * A Surface active while a tagged value at a known place has a given tag.
@@ -397,13 +428,14 @@ const Surface = {
397
428
  return {
398
429
  name: surface.name,
399
430
  owner: surface.owner,
431
+ messages: messageTags(surface),
400
432
  activation: {
401
433
  path: place.dependency,
402
434
  tag
403
435
  },
404
436
  projectionOf: (model) => {
405
437
  const value = place.get(model);
406
- return value?._tag === tag ? surface.projection(params(value)) : void 0;
438
+ return Predicate.isTagged(value, tag) ? Option.some(surface.projection(params(value))) : Option.none();
407
439
  }
408
440
  };
409
441
  },
@@ -455,7 +487,7 @@ const Surface = {
455
487
  owner: surface.owner,
456
488
  owns: [],
457
489
  observes: projection.dependencies,
458
- messages: surface.messages.map(messageTag).filter((tag) => tag !== void 0),
490
+ messages: messageTags(surface),
459
491
  metadata: Metadata$1.summarize(projection.metadata)
460
492
  };
461
493
  },
@@ -643,6 +675,6 @@ const Module = {
643
675
  }
644
676
  };
645
677
  //#endregion
646
- export { MessageSet, Metadata, MetadataTypeId, ModelRef, Module, Projection, Surface };
678
+ export { Action, MessageSet, Metadata, MetadataTypeId, ModelRef, Module, Projection, Surface };
647
679
 
648
680
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":["Metadata"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `foldkit-surface` — the observation boundary for a Foldkit application.\n *\n * A Surface is a pure projection of the Model: it declares which fields a\n * feature reads and which Messages it may construct, from the application's\n * own Schema rather than a second hand-written interface. `foldkit-remote`,\n * `foldkit-sync`, `foldkit-agent`, and `foldkit-mirror` all read this boundary,\n * and `Module` validates that each Model path has one owner.\n *\n * Nothing here runs: the deliverable is the type surface, pinned by\n * `test/inference.test-d.ts`.\n */\nimport { Optic, Option, Result, Schema } from 'effect'\nimport type { Html, HtmlBuilder } from 'foldkit/html'\nimport type { MessageUnion } from 'foldkit/message'\nimport type { Entry as ManagedResourceEntry } from 'foldkit/managedResource'\nimport type { Subscriptions } from 'foldkit/subscription'\nimport type * as Update from 'foldkit/update'\nimport type { Url } from 'foldkit/url'\nimport { Metadata, type MetadataSummary } from 'foldkit-metadata'\n\nexport { Metadata, MetadataTypeId, type MetadataKey, type MetadataSummary } from 'foldkit-metadata'\n\n// ===========================================================================\n// ModelRef and the typed Model tree (Phase 0 cases 1)\n// ===========================================================================\n\nexport interface ModelRef<Root, Value, Encoded = unknown> {\n /** A pure codec: Foldkit Model fields carry no decoding or encoding services. */\n readonly Schema: Schema.Codec<Value, Encoded, never, never>\n readonly optic: Optic.Optional<Root, Value>\n readonly dependency: readonly string[]\n readonly get: (root: Root) => Value\n readonly set: (root: Root, value: Value) => Root\n /**\n * Focused structural replacement: `set` of `fn` applied to `get`. This\n * delegates through the ref's own `set`, so container-aware setters\n * (`.at`/`.index` insertion and removal) keep working — never `optic`\n * calls directly. Infrastructure seam, not an application transition.\n */\n readonly modify: (root: Root, fn: (value: Value) => Value) => Root\n}\n\n/**\n * A `ModelRef` generated for a named Model field. `key` is the literal field\n * name, so a reference-based selection can infer its output keys without a\n * parallel field registry or string paths.\n */\nexport interface FieldRef<\n Root,\n Value,\n Key extends string = string,\n Encoded = unknown,\n> extends ModelRef<Root, Value, Encoded> {\n readonly key: Key\n /** The application definition this field was generated from. */\n readonly owner: object\n}\n\n/**\n * Low-level escape hatch for a focus with no Model path of its own. Prefer the\n * `App.model` tree; use this for an optic that is not part of the Model.\n */\nexport const ModelRef = {\n fromOptic: <Root, Value>(\n Schema: Schema.Schema<Value>,\n optic: Optic.Optional<Root, Value>,\n dependency: readonly string[] = [],\n ): ModelRef<Root, Value> => {\n const get: (root: Root) => Value = root => Result.getOrThrow(optic.getResult(root))\n const set = (root: Root, value: Value): Root => optic.replace(value, root)\n return {\n Schema: Schema as unknown as ModelRef<Root, Value>['Schema'],\n optic,\n dependency,\n get,\n set,\n modify: (root, fn) => set(root, fn(get(root))),\n }\n },\n}\n\nexport type RefTree<Root, F extends Schema.Struct.Fields> = {\n readonly [K in keyof F & string]: RefNode<Root, F[K], K>\n}\n\n// Tuple-wrapped so the conditional is *non-distributive*: without it,\n// `Value = Option<V>` distributes over `None | Some<V>` and `.at()` would return\n// a union of two unrelated `ModelRef`s.\ntype Selectable<Root, Value, Key extends string, Encoded = unknown> = [Value] extends [\n Option.Option<infer Inner>,\n]\n ? FieldRef<Root, Value, Key, Encoded> & {\n readonly select: <P>(projection: Projection<Inner, P>) => Projection<Root, Option.Option<P>>\n }\n : FieldRef<Root, Value, Key, Encoded> & {\n readonly select: <P>(projection: Projection<Value, P>) => Projection<Root, P>\n }\n\n/**\n * A dynamic focus from `.at`/`.index`. Deliberately not a `FieldRef`: its key is\n * a record key or index, not a Model field, so a static `Projection.pick` cannot\n * infer a field name from it.\n */\ntype OptionalRef<Root, Value> = [Value] extends [Option.Option<infer Inner>]\n ? ModelRef<Root, Value> & {\n readonly select: <P>(projection: Projection<Inner, P>) => Projection<Root, Option.Option<P>>\n }\n : ModelRef<Root, Value> & {\n readonly select: <P>(projection: Projection<Value, P>) => Projection<Root, P>\n }\n\ntype RefNode<Root, S, Key extends string> =\n S extends Schema.Codec<infer A, infer Encoded, any, any>\n ? S extends Schema.Struct<infer F>\n ? Selectable<Root, A, Key, Encoded> & RefTree<Root, F>\n : A extends ReadonlyArray<infer E>\n ? Selectable<Root, A, Key, Encoded> & {\n readonly index: (index: number) => OptionalRef<Root, Option.Option<E>>\n }\n : A extends Readonly<Record<infer K extends string, infer V>>\n ? Selectable<Root, A, Key, Encoded> & {\n readonly at: (key: K) => OptionalRef<Root, Option.Option<V>>\n }\n : Selectable<Root, A, Key, Encoded>\n : never\n\ntype AnySchema = Schema.Codec<unknown, unknown>\n\n/**\n * Names that belong to the ModelRef surface. A Struct field with one of these\n * names would silently shadow a method, so building the tree rejects it.\n */\nconst RESERVED_REF_NAMES = new Set([\n 'Schema',\n 'optic',\n 'dependency',\n 'key',\n 'read',\n 'get',\n 'set',\n 'at',\n 'index',\n 'select',\n])\n\nfunction propertyReader(root: unknown, key: string): unknown {\n return root === null || root === undefined ? undefined : (root as Record<string, unknown>)[key]\n}\n\nfunction optionalReader(value: unknown): Option.Option<unknown> {\n return value === undefined ? Option.none() : Option.some(value)\n}\n\n/** Reads the tag off a Foldkit Message constructor without constructing one. */\nconst messageTag = (constructor: unknown): string | undefined => {\n const literal = (constructor as { fields?: { _tag?: { ast?: { literal?: unknown } } } }).fields\n ?._tag?.ast?.literal\n return typeof literal === 'string' ? literal : undefined\n}\n\nfunction makeTree(\n schema: AnySchema,\n path: readonly string[],\n optic: Optic.Optional<unknown, unknown>,\n get: (root: unknown) => unknown,\n optional = false,\n set: ((root: unknown, value: unknown) => unknown) | undefined,\n owner: object,\n): Record<string, unknown> {\n const erasedOptic = optic as {\n key(key: string): Optic.Optional<unknown, unknown>\n at(key: string): Optic.Optional<unknown, unknown>\n }\n // `Optic.at` cannot *insert* or *remove* an absent key (`replace` is a no-op\n // when the prism fails), so optional foci get container-aware setters below.\n const setFocus = set ?? ((root: unknown, value: unknown): unknown => optic.replace(value, root))\n const node: Record<string, unknown> = {\n Schema: schema,\n optic,\n dependency: path,\n key: path[path.length - 1] ?? '',\n owner,\n get,\n set: setFocus,\n modify: (root: unknown, fn: (value: unknown) => unknown) => setFocus(root, fn(get(root))),\n }\n\n const fields = (schema as { readonly fields?: Schema.Struct.Fields }).fields\n if (fields !== undefined) {\n for (const key of Object.keys(fields)) {\n if (RESERVED_REF_NAMES.has(key)) {\n throw new Error(`Model field \"${key}\" is reserved by ModelRef`)\n }\n node[key] = makeTree(\n fields[key] as AnySchema,\n [...path, key],\n erasedOptic.key(key),\n root => propertyReader(get(root), key),\n false,\n undefined,\n owner,\n )\n }\n }\n\n node.at = (key: string) =>\n makeTree(\n schema,\n [...path, key],\n erasedOptic.at(key),\n root => optionalReader(propertyReader(get(root), key)),\n true,\n (root, value) => {\n const container = get(root) as Record<string, unknown>\n const option = value as Option.Option<unknown>\n if (Option.isSome(option)) {\n return setFocus(root, { ...container, [key]: option.value })\n }\n const { [key]: _removed, ...rest } = container\n return setFocus(root, rest)\n },\n owner,\n )\n node.index = (index: number) =>\n makeTree(\n schema,\n [...path, String(index)],\n optic,\n root =>\n optionalReader(\n Array.isArray(get(root)) ? (get(root) as ReadonlyArray<unknown>)[index] : undefined,\n ),\n true,\n (root, value) => {\n const array = (Array.isArray(get(root)) ? get(root) : []) as ReadonlyArray<unknown>\n const option = value as Option.Option<unknown>\n const next = Option.isSome(option)\n ? array.map((item, i) => (i === index ? option.value : item))\n : array.filter((_, i) => i !== index)\n return setFocus(root, next)\n },\n owner,\n )\n node.select = (projection: Projection<unknown, unknown>) => {\n const dependencies = mergeDependencies([path, ...projection.dependencies])\n return optional\n ? makeProjection(\n Schema.Option(projection.Model),\n dependencies,\n root => Option.map(get(root) as Option.Option<unknown>, value => projection.read(value)),\n projection.metadata,\n )\n : makeProjection(\n projection.Model,\n dependencies,\n root => projection.read(get(root)),\n projection.metadata,\n )\n }\n return node\n}\n\n// ===========================================================================\n// Projection (Phase 0 case 2)\n// ===========================================================================\n\nexport type DependencyTree = readonly (readonly string[])[]\n\n/** Unions dependency trees, dropping duplicates; the result is a set. */\nfunction mergeDependencies(dependencies: DependencyTree): DependencyTree {\n const seen = new Set<string>()\n const merged: (readonly string[])[] = []\n for (const dependency of dependencies) {\n const key = dependency.join('\\u0000')\n if (seen.has(key)) continue\n seen.add(key)\n merged.push(dependency)\n }\n return merged\n}\n\nexport interface Projection<Root, Value> {\n readonly Model: Schema.Codec<Value, unknown>\n readonly dependencies: DependencyTree\n /** Interpreter-owned facts about this node and everything it composes. */\n readonly metadata: Metadata\n readonly read: (root: Root) => Value\n}\n\n/**\n * A projection Surface can install back into a Model. Public reads use the\n * read-only `Projection`; only a writable selection carries installation.\n * `set` writes exactly the declared fields, so an excess field in an untrusted\n * value cannot reach local state.\n */\nexport interface WritableProjection<Model, Fields extends Schema.Struct.Fields> {\n readonly schema: Schema.Struct<Fields>\n readonly dependencies: DependencyTree\n readonly get: (model: Model) => Schema.Struct.Type<Fields>\n readonly set: (model: Model, shared: Schema.Struct.Type<Fields>) => Model\n}\n\nfunction makeProjection<Value>(\n Model: Schema.Codec<Value, unknown>,\n dependencies: DependencyTree,\n read: (root: unknown) => Value,\n metadata: Metadata = Metadata.empty,\n): Projection<unknown, Value> {\n return { Model, dependencies, metadata, read }\n}\n\n/**\n * `Schema.Struct({})` is not an empty-object schema: it accepts `{foo:1}`, `[]`,\n * and `\"str\"` even with `onExcessProperty: 'error'`. A genuinely empty selection\n * needs a `never`-valued record.\n */\nfunction objectSchema(fields: Record<string, AnySchema>): AnySchema {\n return Object.keys(fields).length === 0\n ? Schema.Record(Schema.String, Schema.Never)\n : Schema.Struct(fields)\n}\n\ntype OfSelection<F extends Schema.Struct.Fields> = {\n readonly [K in keyof F]?: true | Projection<Schema.Schema.Type<F[K]>, unknown>\n}\n\ntype OfValue<F extends Schema.Struct.Fields, Sel> = {\n readonly [K in keyof Sel & keyof F]: Sel[K] extends true\n ? Schema.Schema.Type<F[K]>\n : Sel[K] extends Projection<any, infer V>\n ? V\n : never\n}\n\ntype EntryValue<E> =\n E extends Projection<any, infer V> ? V : E extends ModelRef<any, infer V> ? V : never\n\ntype EntryRoot<E> =\n E extends Projection<infer R, any> ? R : E extends ModelRef<infer R, any> ? R : never\n\ntype EntryRoots<Entries> = { readonly [K in keyof Entries]: EntryRoot<Entries[K]> }\n\n/** `true` when the union has more than one member. Used to reject mixed roots. */\ntype IsUnion<T, U = T> = [T] extends [never]\n ? false\n : T extends unknown\n ? [U] extends [T]\n ? false\n : true\n : never\n\ntype StructValue<Entries> = {\n readonly [K in keyof Entries]: EntryValue<Entries[K]>\n} extends infer Value\n ? { readonly [K in keyof Value]: Value[K] }\n : never\n\nexport const Projection = {\n of:\n <F extends Schema.Struct.Fields>(schema: Schema.Struct<F>) =>\n <const Sel extends OfSelection<F>>(\n selection: Sel,\n ): Projection<Schema.Struct.Type<F>, OfValue<F, Sel>> => {\n const picked: Record<string, AnySchema> = {}\n const dependencies: (readonly string[])[] = []\n const metadata: Metadata[] = []\n const readers: (readonly [string, (root: unknown) => unknown])[] = []\n\n for (const key of Object.keys(selection)) {\n const choice = (selection as Record<string, unknown>)[key]\n if (choice === true) {\n picked[key] = schema.fields[key] as AnySchema\n readers.push([key, root => propertyReader(root, key)])\n } else {\n const nested = choice as Projection<unknown, unknown>\n picked[key] = nested.Model\n dependencies.push(...nested.dependencies)\n metadata.push(nested.metadata)\n readers.push([key, root => nested.read(propertyReader(root, key))])\n }\n }\n\n const read = (root: unknown): unknown => {\n const out: Record<string, unknown> = {}\n for (const [key, reader] of readers) out[key] = reader(root)\n return out\n }\n return makeProjection(\n objectSchema(picked),\n mergeDependencies(dependencies),\n read,\n Metadata.combine(metadata),\n ) as unknown as Projection<Schema.Struct.Type<F>, OfValue<F, Sel>>\n },\n\n struct: <const Entries extends Record<string, Projection<any, any> | ModelRef<any, any>>>(\n entries: Entries & (IsUnion<EntryRoots<Entries>[keyof Entries]> extends true ? never : unknown),\n ): Projection<EntryRoot<Entries[keyof Entries]>, StructValue<Entries>> => {\n const picked: Record<string, AnySchema> = {}\n const dependencies: (readonly string[])[] = []\n const metadata: Metadata[] = []\n const readers: (readonly [string, (root: unknown) => unknown])[] = []\n\n for (const key of Object.keys(entries)) {\n const entry = entries[key] as Projection<unknown, unknown> | ModelRef<unknown, unknown>\n if ('dependencies' in entry) {\n picked[key] = entry.Model\n dependencies.push(...entry.dependencies)\n metadata.push(entry.metadata)\n readers.push([key, entry.read])\n } else {\n picked[key] = entry.Schema\n dependencies.push(entry.dependency)\n readers.push([key, entry.get])\n }\n }\n\n const read = (root: unknown): unknown => {\n const out: Record<string, unknown> = {}\n for (const [key, reader] of readers) out[key] = reader(root)\n return out\n }\n return makeProjection(\n objectSchema(picked),\n mergeDependencies(dependencies),\n read,\n Metadata.combine(metadata),\n ) as unknown as Projection<EntryRoot<Entries[keyof Entries]>, StructValue<Entries>>\n },\n\n /**\n * Maps a Projection over an array: `array(p): Projection<ReadonlyArray<Root>,\n * ReadonlyArray<Value>>`. Nesting is explicit (an array of arrays stays an\n * array of arrays); there is no flatten or double-wrap.\n */\n array: <Root, Value>(\n projection: Projection<Root, Value>,\n ): Projection<ReadonlyArray<Root>, ReadonlyArray<Value>> => ({\n Model: Schema.Array(projection.Model),\n dependencies: projection.dependencies,\n metadata: projection.metadata,\n read: root => root.map(value => projection.read(value)),\n }),\n\n /** Maps a Projection inside an Option, preserving absence. */\n option: <Root, Value>(\n projection: Projection<Root, Value>,\n ): Projection<Option.Option<Root>, Option.Option<Value>> => ({\n Model: Schema.Option(projection.Model),\n dependencies: projection.dependencies,\n metadata: projection.metadata,\n read: root => Option.map(root, value => projection.read(value)),\n }),\n\n read: <Root, Value>(projection: Projection<Root, Value>, root: Root): Value =>\n projection.read(root),\n\n /**\n * Low-level escape hatch: a Projection from a Schema and a reader, for\n * projections not derived from ModelRefs (agent context, adapters). Prefer\n * `of`/`struct`/`select`; dependencies default to empty.\n */\n fromReader: <Root, Value>(\n Model: Schema.Codec<Value, unknown>,\n read: (root: Root) => Value,\n options?: {\n readonly dependencies?: DependencyTree\n readonly metadata?: Metadata\n },\n ): Projection<Root, Value> => ({\n Model,\n dependencies: options?.dependencies ?? [],\n metadata: options?.metadata ?? Metadata.empty,\n read,\n }),\n\n /**\n * Derives a writable projection from generated Model field references:\n * `Projection.pick(App.model.todos, App.model.selectedTodoId)` infers\n * `{ todos, selectedTodoId }` and its codec. Every reference must share one\n * Root; a raw optic or an unrelated application is rejected. Repeated\n * identical members deduplicate; a conflicting definition throws.\n */\n pick: <const Refs extends readonly FieldRef<any, any, string>[]>(\n ...refs: Refs & (IsUnion<RefRoots<Refs>[number]> extends true ? never : unknown)\n ): WritableProjection<RefRoots<Refs>[number], PickFields<Refs>> => {\n const selected = [...refs]\n // Two applications can have structurally identical Models, so the root type\n // check cannot separate them; the owner token can.\n const owner = selected[0]?.owner\n for (const ref of selected) {\n if (ref.owner !== owner) {\n throw new Error('Projection.pick: references from different applications')\n }\n }\n const fields: Record<string, AnySchema> = {}\n for (const ref of selected) {\n const existing = fields[ref.key]\n if (existing !== undefined) {\n if (existing === ref.Schema) continue\n throw new Error(`Projection.pick: conflicting definitions for \"${ref.key}\"`)\n }\n fields[ref.key] = ref.Schema\n }\n return {\n schema: objectSchema(fields) as never,\n dependencies: mergeDependencies(selected.map(ref => ref.dependency)),\n get: model => {\n const out: Record<string, unknown> = {}\n for (const ref of selected) out[ref.key] = ref.get(model as never)\n return out as never\n },\n set: (model, shared) => {\n let next = model\n for (const ref of selected)\n next = ref.set(next as never, (shared as Record<string, unknown>)[ref.key] as never)\n return next\n },\n }\n },\n\n /**\n * Merges disjoint writable projections into one: `Projection.compose(Todos,\n * Selection)`. Every projection must own the same Model; a field defined twice\n * with a different codec throws, while an identical definition deduplicates.\n * `set` installs each part, so composed fields keep their own write behaviour.\n */\n compose: <const Ps extends readonly WritableProjection<any, any>[]>(\n ...projections: Ps & (IsUnion<ProjectionModel<Ps[number]>> extends true ? never : unknown)\n ): WritableProjection<ProjectionModel<Ps[number]>, MergeFields<Ps>> => {\n const parts = [...projections]\n const fields: Record<string, AnySchema> = {}\n for (const part of parts) {\n for (const [key, codec] of Object.entries(part.schema.fields)) {\n const existing = fields[key]\n if (existing !== undefined) {\n if (existing === codec) continue\n throw new Error(`Projection.compose: conflicting definitions for \"${key}\"`)\n }\n fields[key] = codec as AnySchema\n }\n }\n return {\n schema: objectSchema(fields) as never,\n dependencies: mergeDependencies(parts.flatMap(part => [...part.dependencies])),\n get: model => {\n const out: Record<string, unknown> = {}\n for (const part of parts) Object.assign(out, part.get(model as never))\n return out as never\n },\n set: (model, shared) => {\n let next = model\n // Each part reads only its own fields from the merged value.\n for (const part of parts) next = part.set(next as never, shared as never)\n return next\n },\n }\n },\n}\n\n// ===========================================================================\n// Surface (Phase 0 case 3)\n// ===========================================================================\n\nexport interface AppScope<\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n> {\n readonly Model: Schema.Struct<F>\n readonly Message: MessageUnion<Cases>\n readonly model: RefTree<Root, F>\n /** Identity token shared by this application's references and subsets. */\n readonly owner: object\n}\n\nexport interface SurfaceInspection {\n readonly name: string\n readonly dependencies: DependencyTree\n readonly metadata: readonly MetadataSummary[]\n readonly emits: readonly unknown[]\n}\n\n/**\n * A Surface's params codec: present when the Surface declares params, absent\n * when `Params` is `void`, and possibly either when `Params` is `any`/`unknown`\n * so a params Surface still fits a `Surface<…, any>` position.\n */\nexport type ParamsSchema<Params> = unknown extends Params\n ? Schema.Codec<Params, unknown> | undefined\n : [Params] extends [void]\n ? [void] extends [Params]\n ? // Exactly `void`: no params, no schema.\n undefined\n : // `undefined` also extends `void`, but a Surface may still declare its schema.\n Schema.Codec<Params, unknown> | undefined\n : [void] extends [Params]\n ? // `void | X`: the schema is optional.\n Schema.Codec<Params, unknown> | undefined\n : Schema.Codec<Params, unknown>\n\nexport interface Surface<Root, Model, Message, Params> {\n readonly name: string\n /** Identity token of the application this Surface belongs to. */\n readonly owner: object\n readonly Params: ParamsSchema<Params>\n readonly Message: Schema.Schema<Message>\n readonly messages: readonly unknown[]\n readonly projection: (params: Params) => Projection<Root, Model>\n}\n\n/**\n * A Surface as the Model activates it: its params are a function of the Model\n * (`undefined` while inactive), so its requirements are too. `Surface.at`\n * builds one; a Subscription derives what to fetch, subscribe, and retain\n * from a list of them.\n */\n/**\n * Why a Surface is active, when that is something other than a callback.\n *\n * `Surface.at` takes an arbitrary function of the Model, which is correct and\n * opaque: nothing can say *why* the Surface is on without running it. When\n * activation is a tagged value at a known place — a route, a mode, a\n * selection — `Surface.when` records the place and the tag, and a manifest can\n * be built without evaluating anything.\n */\n/**\n * What `Surface.when` needs of a place in the Model: where it is, and how to\n * read it.\n *\n * The read half of a `ModelRef`, and deliberately not the whole thing.\n * Activation **observes** — it never installs a value — so asking for a\n * writable reference would claim an authority it does not use. It also makes\n * the common case work: a field holding a tagged union is a *union of*\n * `FieldRef`s, one per case, which no single `ModelRef<Root, Value>` accepts.\n */\nexport interface ModelPlace<Root> {\n /** Where the value lives, as `ModelRef.dependency` gives it. */\n readonly dependency: readonly string[]\n readonly get: (root: Root) => unknown\n}\n\nexport interface Activation {\n /** The Model path the tagged value lives at, as `ModelRef.dependency` gives it. */\n readonly path: readonly string[]\n /** The tag that makes the Surface active. */\n readonly tag: string\n}\n\nexport interface ActiveSurface<Root> {\n readonly name: string\n /** Identity token of the application the Surface belongs to. */\n readonly owner: object\n /** The projection for the params the Model gives, or `undefined` while inactive. */\n readonly projectionOf: (model: Root) => Projection<Root, unknown> | undefined\n /** Present when the Surface was placed with `Surface.when`; absent for `Surface.at`. */\n readonly activation?: Activation | undefined\n}\n\ndeclare const invalid: unique symbol\n\n/**\n * A compile-time failure that names its cause. Intersected onto a parameter\n * type when a type-level check fails, so the error reads as one line\n * (`Property '[invalid]' is missing … required in type 'Invalid<\"…\">'`)\n * naming the descriptor, instead of a wall of structural mismatch.\n */\nexport interface Invalid<Message extends string> {\n readonly [invalid]: Message\n}\n\n/** The fields of a `Schema.Struct`, or a schema, where params are declared. */\ntype ParamsShape = Schema.Struct.Fields | Schema.Top\n\ntype ParamsOf<P> = P extends Schema.Top\n ? Schema.Schema.Type<P>\n : P extends Schema.Struct.Fields\n ? Schema.Struct.Type<P>\n : void\n\n/** What a Surface's `model` may return: a Projection, or an object of Projections and refs to lift. */\ntype ModelShape<Root> =\n Projection<Root, unknown> | Record<string, Projection<Root, any> | ModelRef<Root, any>>\n\ntype ModelOf<Root, R> = R extends Projection<Root, infer M> ? M : StructValue<R>\n\nconst isProjection = (value: unknown): value is Projection<unknown, unknown> =>\n typeof value === 'object' &&\n value !== null &&\n typeof (value as { read?: unknown }).read === 'function' &&\n Metadata.is((value as { metadata?: unknown }).metadata)\n\ntype MsgOf<Ms extends readonly unknown[]> = {\n readonly [K in keyof Ms]: Ms[K] extends (...args: never[]) => infer M ? M : never\n}[number]\n\n/** The union of Messages a tuple of constructors produces. */\ntype SubsetOf<Ms extends readonly unknown[]> = Ms[number] extends (...args: never[]) => infer M\n ? M\n : never\n\ntype AppMessage<Cases extends Record<string, Schema.Struct.Fields>> = Schema.Schema.Type<\n MessageUnion<Cases>\n>\n\n/** A Message constructor whose produced Message belongs to the App's universe. */\ntype MessageConstructor<Cases extends Record<string, Schema.Struct.Fields>> = (\n ...args: never[]\n) => AppMessage<Cases>\n\n/**\n * The renderer's builder: the real `HtmlBuilder` with its private\n * `MessageUniverse` phantom removed, so the renderer's `OnClick` accepts only\n * the Surface's Message subset. `HtmlBuilder<M>` stays invariant even without\n * the phantom (`OnClick` returns `{ message: M }`), so a superset builder is\n * not assignable to this; `Surface.view` casts, which is sound because the\n * renderer can only construct subset Messages and the real builder accepts the\n * superset.\n */\ntype ViewBuilder<Message> = Omit<HtmlBuilder<Message>, keyof HtmlBuilder<never> & symbol>\n\n/** A renderer for a Surface's projected Model, with its Message set narrowed. */\nexport type Renderer<Model, Message> = (model: Model, h: ViewBuilder<Message>) => Html\n\n/** `unknown` when `Sub` is a subtype of `Super`, `never` otherwise. */\ntype Subset<Sub, Super> = [Sub] extends [Super] ? unknown : never\n\ntype RefRoot<R> = R extends ModelRef<infer Root, any> ? Root : never\n\ntype RefRoots<Refs extends readonly unknown[]> = {\n readonly [K in keyof Refs]: RefRoot<Refs[K]>\n}\n\n/** The struct fields a reference selection produces, keyed by each ref's field. */\ntype PickFields<Refs extends readonly FieldRef<any, any, string>[]> = {\n readonly [R in Refs[number] as R['key']]: R['Schema']\n}\n\ntype ProjectionModel<P> = P extends WritableProjection<infer M, any> ? M : never\n\ntype ProjectionFields<P> = P extends WritableProjection<any, infer F> ? F : never\n\ntype Merge2<A, B> = {\n readonly [K in keyof A | keyof B]: K extends keyof A ? A[K] : K extends keyof B ? B[K] : never\n}\n\n/** Merges the fields of several projections; an overlapping key is rejected at runtime. */\nexport type MergeFields<Ps extends readonly WritableProjection<any, any>[]> = Ps extends readonly [\n infer Head extends WritableProjection<any, any>,\n ...infer Tail extends readonly WritableProjection<any, any>[],\n]\n ? Merge2<ProjectionFields<Head>, MergeFields<Tail>>\n : {}\n\n/**\n * An application definition: the Model and Message schemas and the generated\n * field references. It is data, not a running instance, so it can be inspected\n * without mounting anything. Context, replication, and validation all read the\n * same `App.model` references.\n */\nexport interface Application<\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n> extends AppScope<Root, F, Cases> {\n /**\n * @deprecated Use `App.model`, the same references under the name the rest\n * of the API uses: `App.surface` hands a Surface `{ model }`, and\n * `Remote.make` and `Editor.at` take `model: App.model.…`. Removed in a\n * later minor.\n */\n readonly fields: RefTree<Root, F>\n /**\n * `Surface.make` with the mechanical wrappers lifted: `params` are the\n * fields of a `Schema.Struct` (or a schema), and `model` may return an\n * object of Projections and refs, which becomes `Projection.struct`.\n */\n readonly surface: <\n const Params extends ParamsShape | undefined = undefined,\n Shape extends ModelShape<Root> = Projection<Root, unknown>,\n const Ms extends readonly MessageConstructor<Cases>[] = readonly [],\n >(\n name: string,\n config: {\n readonly params?: Params\n readonly model: (context: {\n readonly model: RefTree<Root, F>\n readonly params: ParamsOf<Params>\n }) => Shape\n readonly messages?: Ms\n },\n ) => Surface<Root, ModelOf<Root, Shape>, MsgOf<Ms>, ParamsOf<Params>>\n}\n\n/**\n * An `Application` that also carries the initial Model and the transition\n * function, so a replicator can derive the initial shared value and replay.\n * `Resources` is whatever `update`'s Commands need.\n */\nexport interface RunnableApplication<\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n Resources = never,\n> extends Application<Root, F, Cases> {\n readonly initial: Root\n readonly update: (\n model: Root,\n message: Schema.Schema.Type<MessageUnion<Cases>>,\n ) => Update.Return<Root, Schema.Schema.Type<MessageUnion<Cases>>, Resources>\n}\n\ndeclare const messageSubsetRoot: unique symbol\n\n/**\n * A typed subset of one application's Messages: the selected constructors, a\n * codec for exactly those variants, and a runtime membership test. Surface does\n * not label a subset agent-visible, durable, or presence; `Agent` and `Sync`\n * attach their own policy to the same value.\n */\n/** The union of encoded types a tuple of constructor schemas produces. */\ntype SubsetEncoded<Ms extends readonly unknown[]> =\n Ms[number] extends Schema.Codec<any, infer Encoded, any, any> ? Encoded : never\n\nexport interface MessageSet<\n Root,\n Message,\n Subset extends Message,\n Ms extends readonly ((...args: never[]) => Message)[],\n Cases extends Record<string, Schema.Struct.Fields> = Record<string, Schema.Struct.Fields>,\n Encoded = unknown,\n> {\n /** Phantom owner, so a subset cannot be crossed between applications. */\n readonly [messageSubsetRoot]?: Root\n /** The application identity token, checked when subsets compose. */\n readonly owner: object\n readonly constructors: Ms\n /** A pure codec for exactly the selected variants. */\n readonly schema: Schema.Codec<Subset, Encoded, never, never>\n readonly tags: ReadonlySet<string>\n readonly includes: (message: Message) => message is Subset\n}\n\nconst makeScope = <\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n>(config: {\n readonly Model: Schema.Struct<F>\n readonly Message: MessageUnion<Cases>\n}): AppScope<Schema.Struct.Type<F>, F, Cases> => {\n // One token per application, so a selection cannot silently mix two\n // applications whose Models happen to be structurally identical.\n const owner: object = {}\n return {\n Model: config.Model,\n Message: config.Message,\n owner,\n model: makeTree(\n // A generic `F` hides the Struct's services; a Foldkit Model is pure.\n config.Model as unknown as AnySchema,\n [],\n Optic.id(),\n root => root,\n false,\n undefined,\n owner,\n ) as unknown as RefTree<Schema.Struct.Type<F>, F>,\n }\n}\n\n/**\n * Captures an application's pure references once. `initial` and `update` are\n * optional: an agent needs only the Model, Message, and field references, while\n * a replicator needs them to derive the initial shared value and replay. A\n * `RunnableApplication` is returned when both are supplied.\n */\nfunction application<\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n Resources = never,\n ManagedResourceServices = never,\n>(config: {\n readonly Model: Schema.Struct<F>\n readonly Message: MessageUnion<Cases>\n readonly initial: Schema.Struct.Type<F>\n readonly update: (\n model: Schema.Struct.Type<F>,\n message: Schema.Schema.Type<MessageUnion<Cases>>,\n ) => Update.Return<\n Schema.Struct.Type<F>,\n Schema.Schema.Type<MessageUnion<Cases>>,\n Resources | ManagedResourceServices\n >\n}): RunnableApplication<Schema.Struct.Type<F>, F, Cases, Resources | ManagedResourceServices>\nfunction application<\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n>(config: {\n readonly Model: Schema.Struct<F>\n readonly Message: MessageUnion<Cases>\n}): Application<Schema.Struct.Type<F>, F, Cases>\nfunction application(config: any): any {\n const scope = makeScope(config)\n const surface = (\n name: string,\n surfaceConfig: {\n readonly params?: ParamsShape | undefined\n readonly model: (context: { readonly model: unknown; readonly params: unknown }) => unknown\n readonly messages?: readonly unknown[]\n },\n ) =>\n Surface.make(scope, name, {\n ...(surfaceConfig.params === undefined\n ? {}\n : {\n Params: Schema.isSchema(surfaceConfig.params)\n ? surfaceConfig.params\n : Schema.Struct(surfaceConfig.params),\n }),\n model: (context: { readonly model: unknown; readonly params: unknown }) => {\n const shape = surfaceConfig.model(context)\n return isProjection(shape) ? shape : Projection.struct(shape as never)\n },\n messages: surfaceConfig.messages,\n } as never)\n return { ...scope, initial: config.initial, fields: scope.model, update: config.update, surface }\n}\n\ntype ConstructorOfSubset<S> = S extends MessageSet<any, any, any, infer Ms, any> ? Ms : never\ntype ValueOfSubset<S> = S extends MessageSet<any, any, infer V, any, any> ? V : never\ntype RootOfSubset<S> = S extends MessageSet<infer R, any, any, any, any> ? R : never\ntype MessageOfSubset<S> = S extends MessageSet<any, infer M, any, any, any> ? M : never\ntype CasesOfSubset<S> = S extends MessageSet<any, any, any, any, infer C> ? C : never\n\ntype Concat<A extends readonly unknown[], B extends readonly unknown[]> = [...A, ...B]\n\n/** Concatenates the constructor tuples of several subsets, preserving each. */\nexport type MergeConstructors<Subs extends readonly MessageSet<any, any, any, any, any>[]> =\n Subs extends readonly [\n infer Head extends MessageSet<any, any, any, any, any>,\n ...infer Tail extends readonly MessageSet<any, any, any, any, any>[],\n ]\n ? Concat<ConstructorOfSubset<Head>, MergeConstructors<Tail>>\n : []\n\n/** Typed Message subsets of one application, by constructor reference. */\nexport const MessageSet = {\n /**\n * Selects a typed Message subset by constructor reference:\n * `MessageSet.make(App, [Message.CreatedTodo, Message.RenamedTodo])`. Each\n * constructor must be this application's own variant; a duplicate or a variant\n * from another union throws.\n */\n make: <\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n const Ms extends readonly MessageConstructor<Cases>[],\n >(\n app: AppScope<Root, F, Cases>,\n messages: Ms,\n ): MessageSet<\n Root,\n Schema.Schema.Type<MessageUnion<Cases>>,\n SubsetOf<Ms> & Schema.Schema.Type<MessageUnion<Cases>>,\n Ms,\n Cases,\n SubsetEncoded<Ms>\n > => {\n const tags = new Set<string>()\n for (const constructor of messages) {\n const tag = messageTag(constructor)\n if (tag === undefined) {\n throw new Error('MessageSet.make: expected Message constructors')\n }\n if ((app.Message as unknown as Record<string, unknown>)[tag] !== constructor) {\n throw new Error(\n `MessageSet.make: \"${tag}\" is not a variant of this application's Message union`,\n )\n }\n if (tags.has(tag)) throw new Error(`MessageSet.make: duplicate \"${tag}\"`)\n tags.add(tag)\n }\n return {\n owner: app.owner,\n constructors: messages,\n schema: Schema.Union([...messages] as unknown as ReadonlyArray<\n Schema.Schema<unknown>\n >) as unknown as Schema.Codec<\n SubsetOf<Ms> & Schema.Schema.Type<MessageUnion<Cases>>,\n SubsetEncoded<Ms>,\n never,\n never\n >,\n tags,\n includes: (message): message is SubsetOf<Ms> & Schema.Schema.Type<MessageUnion<Cases>> =>\n tags.has((message as { readonly _tag?: string })._tag ?? ''),\n }\n },\n\n /**\n * Unions several Message subsets into one. Every subset must belong to the\n * same application; a tag declared twice throws. Disjoint feature modules can\n * each declare their own subset and compose them here.\n */\n union: <const Subs extends readonly MessageSet<any, any, any, any, any>[]>(\n ...subsets: Subs\n ): MessageSet<\n RootOfSubset<Subs[number]>,\n MessageOfSubset<Subs[number]>,\n ValueOfSubset<Subs[number]>,\n MergeConstructors<Subs>,\n CasesOfSubset<Subs[number]>,\n SubsetEncoded<MergeConstructors<Subs>>\n > => {\n const parts = [...subsets]\n const owner = parts[0]?.owner\n const tags = new Set<string>()\n const constructors: Array<Schema.Schema<unknown>> = []\n for (const part of parts) {\n if (part.owner !== owner) {\n throw new Error('MessageSet.union: subsets from different applications')\n }\n for (const constructor of part.constructors) {\n const tag = messageTag(constructor)\n if (tag === undefined) continue\n if (tags.has(tag)) throw new Error(`MessageSet.union: duplicate \"${tag}\"`)\n tags.add(tag)\n constructors.push(constructor as Schema.Schema<unknown>)\n }\n }\n return {\n owner: owner as object,\n constructors: constructors as never,\n schema: Schema.Union(constructors) as unknown as Schema.Codec<\n ValueOfSubset<Subs[number]>,\n SubsetEncoded<MergeConstructors<Subs>>,\n never,\n never\n >,\n tags,\n includes: (message): message is ValueOfSubset<Subs[number]> =>\n tags.has((message as { readonly _tag?: string })._tag ?? ''),\n }\n },\n}\n\nexport const Surface = {\n application,\n\n /**\n * A Surface as the Model activates it. `params` is the value, or a function\n * of the Model returning it (`undefined` while the Surface is inactive, e.g.\n * on another route); the Surface's requirements then follow the Model.\n */\n at: <Root, Model, Message, Params>(\n surface: Surface<Root, Model, Message, Params>,\n params: Params | ((model: Root) => Params | undefined),\n ): ActiveSurface<Root> => ({\n name: surface.name,\n owner: surface.owner,\n projectionOf: model => {\n const resolved =\n typeof params === 'function'\n ? (params as (model: Root) => Params | undefined)(model)\n : params\n return resolved === undefined && surface.Params !== undefined\n ? undefined\n : surface.projection(resolved as Params)\n },\n }),\n\n /**\n * A Surface active while a tagged value at a known place has a given tag.\n *\n * ```ts\n * Surface.when(ProjectPage, App.model.route, AppRoute.Project, route => ({\n * projectId: route.projectId,\n * }))\n * ```\n *\n * The same thing `Surface.at` does with a callback, and one fact more: the\n * place and the tag are **values**, so what activates the Surface can be read\n * without running anything. That is what a route-to-Surface manifest, a\n * prefetch analysis, or an explanation of why a read is happening needs.\n *\n * Deliberately **not router-specific.** A route is one kind of tagged Model\n * state; a mode, a wizard step and a selected tab are others, and none of\n * them should need their own helper.\n *\n * `Surface.at` stays, and is still the answer when activation is a genuine\n * computation rather than a tag.\n */\n when: <Root, Model, Message, Params, Case extends Schema.Top>(\n surface: Surface<Root, Model, Message, Params>,\n place: ModelPlace<Root>,\n tagged: Case,\n params: (value: Schema.Schema.Type<Case>) => Params,\n ): ActiveSurface<Root> => {\n const tag = messageTag(tagged)\n if (tag === undefined) {\n throw new Error(\n `Surface.when: expected a tagged constructor for \"${surface.name}\", which is what names the case that activates it`,\n )\n }\n return {\n name: surface.name,\n owner: surface.owner,\n activation: { path: place.dependency, tag },\n projectionOf: model => {\n const value = place.get(model) as { readonly _tag: string } | undefined\n return value?._tag === tag\n ? surface.projection(params(value as Schema.Schema.Type<Case>))\n : undefined\n },\n }\n },\n\n make: <\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n Params = void,\n Model = unknown,\n const Ms extends readonly MessageConstructor<Cases>[] = readonly [],\n >(\n app: AppScope<Root, F, Cases>,\n name: string,\n config: {\n readonly Params?: Schema.Codec<Params, unknown>\n readonly model: (context: {\n readonly model: RefTree<Root, F>\n readonly params: Params\n }) => Projection<Root, Model>\n readonly messages?: Ms\n },\n ): Surface<Root, Model, MsgOf<Ms>, Params> => {\n // Deliberately no eager `projection(undefined)`: a parameterized Surface's\n // projection may read `params`.\n const projection = (params: Params): Projection<Root, Model> =>\n config.model({ model: app.model, params })\n return {\n name,\n owner: app.owner,\n // Absent only when `Params` is exactly `void`; `ParamsSchema` keeps it optional otherwise.\n Params: config.Params as ParamsSchema<Params>,\n Message: Schema.Never as unknown as Schema.Schema<MsgOf<Ms>>,\n messages: config.messages ?? [],\n projection,\n }\n },\n\n read: <Root, Model, Message, Params>(\n surface: Surface<Root, Model, Message, Params>,\n root: Root,\n params?: Params,\n ): Model => surface.projection(params as Params).read(root),\n\n /**\n * Binds a renderer to a Surface's projected Model and Message set. A\n * type-level binder: the renderer already has this shape, but `Model` and\n * `Message` are derived from the Surface instead of written by hand.\n */\n view: <Root, Model, Message, Params>(\n _surface: Surface<Root, Model, Message, Params>,\n render: Renderer<Model, Message>,\n ): Renderer<Model, Message> => render,\n\n /**\n * The application boundary: consume the Root Model, project it, and hand the\n * projected Model to the renderer. `Subset` rejects a Surface whose Messages\n * the application builder cannot route.\n */\n rootView: <Root, Model, Message, Params>(\n surface: Surface<Root, Model, Message, Params>,\n params: Params,\n render: Renderer<Model, Message>,\n ): (<AppMessage>(\n root: Root,\n h: HtmlBuilder<AppMessage> & Subset<Message, AppMessage>,\n ) => Html) => {\n const projection = surface.projection(params)\n // Sound narrowing: the renderer can only construct this Surface's Messages,\n // and `Subset` guarantees the application builder accepts them.\n return <AppMessage>(\n root: Root,\n h: HtmlBuilder<AppMessage> & Subset<Message, AppMessage>,\n ): Html => render(projection.read(root), h as unknown as ViewBuilder<Message>)\n },\n\n /**\n * Embeds a child renderer in a parent view. `ParentModel extends ChildModel`\n * enforces \"child Model requirement ⊆ parent projected Model\"; `Subset`\n * enforces \"child Message set ⊆ parent Message set\".\n */\n embed:\n <ChildModel, ChildMessage>(child: Renderer<ChildModel, ChildMessage>) =>\n <ParentModel extends ChildModel, ParentMessage>(\n model: ParentModel,\n h: ViewBuilder<ParentMessage> & Subset<ChildMessage, ParentMessage>,\n ): Html =>\n child(model, h as unknown as ViewBuilder<ChildMessage>),\n\n /**\n * A Surface as a `Contract` for `Module`: what it observes, requires, and may\n * emit. A parameterized Surface needs its `params` to build the projection.\n */\n contract: <Root, Model, Message, Params>(\n surface: Surface<Root, Model, Message, Params>,\n params: Params,\n ): Contract => {\n const projection = surface.projection(params)\n return {\n kind: 'surface',\n name: surface.name,\n owner: surface.owner,\n owns: [],\n observes: projection.dependencies,\n messages: surface.messages.map(messageTag).filter((tag): tag is string => tag !== undefined),\n metadata: Metadata.summarize(projection.metadata),\n }\n },\n\n /**\n * Pure introspection for DevTools: what a Surface observes (dependencies,\n * requirements) and what it may emit. No behavior change, no I/O.\n */\n inspect: <Root, Model, Message, Params>(\n surface: Surface<Root, Model, Message, Params>,\n params: Params,\n ): SurfaceInspection => {\n const projection = surface.projection(params)\n return {\n name: surface.name,\n dependencies: projection.dependencies,\n metadata: Metadata.summarize(projection.metadata),\n emits: surface.messages,\n }\n },\n}\n\n// ===========================================================================\n// Entity, Selection, Remote moved to `foldkit-remote` (Phase 3).\n// ===========================================================================\n\n// ===========================================================================\n// Module: the pure composition root\n// ===========================================================================\n\n/**\n * What one contract claims about an application, as data. Sync, Remote, and\n * Agent attach one to the values they produce; `Surface.contract` derives one\n * from a Surface. `owns` are the Model paths the contract is the authority for\n * (a replicated projection, a remote store); `observes` are the paths it reads.\n */\nexport interface Contract {\n readonly kind: string\n readonly name: string\n /** The application's identity token; absent when the value cannot know it. */\n readonly owner?: object | undefined\n readonly owns: DependencyTree\n readonly observes: DependencyTree\n /** Message tags the contract may cause, expose, or record. */\n readonly messages: readonly string[]\n /** What interpreters attached to the contract's reads, as text. */\n readonly metadata: readonly MetadataSummary[]\n}\n\n/**\n * How one integration joins an application, as data and pure functions: the\n * Messages it routes, what it runs at startup and on a URL change, its\n * Subscriptions and Managed Resources, and its contract. Remote, Mirror, Sync,\n * and Agent produce one; `foldkit-bundle`'s assembly derives the application's\n * `update`, initial state, runtime config, and Module from a list of them.\n * `R` is the services its Commands and Subscriptions need.\n */\nexport interface Wiring<Model, Message, R = never> {\n /** Names the integration in errors and the Module: `remote:Board`, `mirror:filters`. */\n readonly key: string\n /** Message tags `route` handles. Two integrations handling one tag is an error unless it is `shared`. */\n readonly handles: readonly string[]\n /** Tags several integrations may handle, each for its own values (Mirror's `MirrorRestored`, by name). */\n readonly shared?: readonly string[] | undefined\n /**\n * Folds a Message this integration handles; `None` for any other. A method, so\n * a wiring that routes only its own variants fits an assembly over the whole\n * application union.\n */\n route?(model: Model, message: Message): Option.Option<Update.Return<Model, Message, R>>\n /** Runs once when the application starts, after placements: a restore Command, a warm-up. */\n readonly init?: Update.Step<Model, Message, R> | undefined\n /** Applies the URL to the Model, at startup and whenever the URL changes. */\n readonly onUrl?: ((model: Model, url: Url) => Model) | undefined\n readonly subscriptions?: Subscriptions<Model, Message, R> | undefined\n readonly resources?:\n Readonly<Record<string, ManagedResourceEntry<Model, Message, any, any, any>>> | undefined\n /** Its Module contract; absent for wiring that owns and observes nothing. */\n readonly contract?: Contract | undefined\n}\n\n/** Contracts of one application, in declaration order. Data, not a runtime. */\nexport interface Module<\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n> {\n readonly app: AppScope<Root, F, Cases>\n readonly contracts: readonly Contract[]\n}\n\nexport interface Finding {\n readonly rule:\n | 'foreign-contract'\n | 'duplicate-name'\n | 'ownership-overlap'\n | 'message-claimed-twice'\n | 'unknown-path'\n | 'unknown-message'\n /** `kind:name` of each contract involved. */\n readonly contracts: readonly string[]\n readonly message: string\n}\n\n/** Who owns a Model path; `undefined` is local state. */\nexport interface Ownership {\n readonly path: readonly string[]\n readonly owner: { readonly kind: string; readonly name: string } | undefined\n}\n\nexport interface ModuleManifest {\n readonly fields: readonly string[]\n readonly messages: readonly string[]\n readonly ownership: readonly Ownership[]\n readonly contracts: readonly Omit<Contract, 'owner'>[]\n readonly findings: readonly Finding[]\n}\n\n/** A value `Module.make` accepts: a contract, a value carrying one, or a Surface without params. */\nexport type ModuleItem<Root> =\n Contract | { readonly contract: Contract } | Surface<Root, any, any, void>\n\nconst label = (contract: Contract): string => `${contract.kind}:${contract.name}`\n/** Metadata summaries are application data (a query's input), so they cannot break the table. */\nconst tableCell = (text: string): string =>\n text\n .replace(/\\\\/g, '\\\\\\\\')\n .replace(/\\|/g, '\\\\|')\n .replace(/\\r\\n?|\\n/g, ' ')\nconst pathKey = (path: readonly string[]): string => path.join('.')\nconst isPrefix = (prefix: readonly string[], path: readonly string[]): boolean =>\n prefix.length <= path.length && prefix.every((segment, index) => segment === path[index])\n\n// A carried contract wins: a sync contract also has a `projection` (writable, not a function).\nconst toContract = <Root>(item: ModuleItem<Root>): Contract =>\n 'contract' in item\n ? item.contract\n : 'projection' in item\n ? Surface.contract(item, undefined)\n : item\n\nconst applicationTags = (app: AppScope<any, any, any>): readonly string[] =>\n Object.entries(app.Message as unknown as Record<string, unknown>)\n .filter(([key, value]) => messageTag(value) === key)\n .map(([key]) => key)\n\n/** Contracts that own at least one path, with a stable label. */\nconst owners = (module: Module<any, any, any>) =>\n module.contracts.filter(contract => contract.owns.length > 0)\n\n/**\n * Collects an application's contracts as pure data so their relationships can\n * be validated and inspected without starting a runtime.\n *\n * ```ts\n * const Project = Module.make(App, [BoardSurface, ProjectSync, ProjectRemote, ProjectAgent])\n * Module.validate(Project) // findings, or []\n * Module.toMarkdown(Project)\n * ```\n */\nexport const Module = {\n make: <Root, F extends Schema.Struct.Fields, Cases extends Record<string, Schema.Struct.Fields>>(\n app: AppScope<Root, F, Cases>,\n items: readonly ModuleItem<Root>[] = [],\n ): Module<Root, F, Cases> => ({ app, contracts: items.map(toContract) }),\n\n /** A new Module with more contracts; the input is unchanged. */\n add: <Root, F extends Schema.Struct.Fields, Cases extends Record<string, Schema.Struct.Fields>>(\n module: Module<Root, F, Cases>,\n ...items: readonly ModuleItem<Root>[]\n ): Module<Root, F, Cases> => ({\n app: module.app,\n contracts: [...module.contracts, ...items.map(toContract)],\n }),\n\n /**\n * Cross-contract invariants the types cannot express: a contract from another\n * application, a duplicate `kind:name`, two owners of overlapping Model paths,\n * a Message recorded by two replication contracts, and a path or Message the\n * application does not declare.\n */\n validate: (module: Module<any, any, any>): readonly Finding[] => {\n const findings: Finding[] = []\n const fields = new Set(Object.keys(module.app.Model.fields))\n const tags = new Set(applicationTags(module.app))\n const seen = new Map<string, Contract>()\n\n for (const contract of module.contracts) {\n const name = label(contract)\n if (contract.owner !== undefined && contract.owner !== module.app.owner)\n findings.push({\n rule: 'foreign-contract',\n contracts: [name],\n message: `${name} belongs to a different application`,\n })\n const duplicate = seen.get(name)\n if (duplicate !== undefined && duplicate !== contract)\n findings.push({\n rule: 'duplicate-name',\n contracts: [name],\n message: `${name} is declared twice`,\n })\n seen.set(name, contract)\n for (const path of [...contract.owns, ...contract.observes]) {\n const head = path[0]\n if (head === undefined || !fields.has(head))\n findings.push({\n rule: 'unknown-path',\n contracts: [name],\n message: `${name} references \"${pathKey(path)}\", which is not a Model field`,\n })\n }\n for (const tag of contract.messages)\n if (!tags.has(tag))\n findings.push({\n rule: 'unknown-message',\n contracts: [name],\n message: `${name} names \"${tag}\", which is not a Message of this application`,\n })\n }\n\n // The same value listed twice is one owner, as `duplicate-name` treats it.\n const owning = [...new Set(owners(module))]\n for (let i = 0; i < owning.length; i += 1)\n for (let j = i + 1; j < owning.length; j += 1) {\n const a = owning[i]!\n const b = owning[j]!\n for (const pa of a.owns)\n for (const pb of b.owns)\n // An empty path is reported as `unknown-path`, not as owning everything.\n if (pa.length > 0 && pb.length > 0 && (isPrefix(pa, pb) || isPrefix(pb, pa)))\n findings.push({\n rule: 'ownership-overlap',\n contracts: [label(a), label(b)],\n message: `${label(a)} owns \"${pathKey(pa)}\" and ${label(b)} owns \"${pathKey(pb)}\"`,\n })\n }\n\n const recorded = new Map<string, Contract>()\n for (const contract of module.contracts.filter(contract => contract.kind === 'sync'))\n for (const tag of contract.messages) {\n const other = recorded.get(tag)\n if (other !== undefined && other !== contract)\n findings.push({\n rule: 'message-claimed-twice',\n contracts: [label(other), label(contract)],\n message: `\"${tag}\" is durable in both ${label(other)} and ${label(contract)}`,\n })\n else recorded.set(tag, contract)\n }\n\n return findings\n },\n\n /**\n * The application's fields and Messages, who owns each Model path (local when\n * no contract does), every contract, and the findings. Reproducible for a\n * given Module, so it can be committed and diffed.\n */\n manifest: (module: Module<any, any, any>): ModuleManifest => {\n const ownership: Ownership[] = []\n const owning = owners(module)\n for (const field of Object.keys(module.app.Model.fields)) {\n const claims = owning.flatMap(contract =>\n contract.owns\n .filter(path => path[0] === field)\n .map(path => ({ path, owner: { kind: contract.kind, name: contract.name } })),\n )\n const whole = claims.find(claim => claim.path.length === 1)\n if (whole !== undefined) ownership.push(whole)\n else {\n ownership.push({ path: [field], owner: undefined })\n ownership.push(...claims.sort((a, b) => pathKey(a.path).localeCompare(pathKey(b.path))))\n }\n }\n return {\n fields: Object.keys(module.app.Model.fields),\n messages: applicationTags(module.app),\n ownership,\n contracts: module.contracts.map(({ owner: _owner, ...rest }) => rest),\n findings: Module.validate(module),\n }\n },\n\n /** The manifest as Markdown: the ownership tree, a table of contracts, and findings. */\n toMarkdown: (module: Module<any, any, any>): string => {\n const manifest = Module.manifest(module)\n const lines: string[] = ['```text', 'Model']\n const width = Math.max(0, ...manifest.ownership.map(row => pathKey(row.path).length))\n manifest.ownership.forEach((row, index) => {\n const last = index === manifest.ownership.length - 1\n const owner =\n row.owner === undefined ? 'LOCAL' : `${row.owner.kind.toUpperCase()} ${row.owner.name}`\n lines.push(`${last ? '└── ' : '├── '}${pathKey(row.path).padEnd(width)} ${owner}`)\n })\n lines.push(\n '```',\n '',\n '| Contract | Owns | Observes | Messages | Metadata |',\n '| --- | --- | --- | --- | --- |',\n )\n for (const contract of manifest.contracts)\n lines.push(\n `| ${contract.kind}:${contract.name} | ${contract.owns.map(pathKey).join(', ')} | ${contract.observes.map(pathKey).join(', ')} | ${contract.messages.join(', ')} | ${tableCell(contract.metadata.map(summary => `${summary.name}: ${summary.entries.join(', ')}`).join('; '))} |`,\n )\n if (manifest.findings.length > 0) {\n lines.push('', '## Findings', '')\n for (const finding of manifest.findings)\n lines.push(`- **${finding.rule}** ${finding.message}`)\n }\n return lines.join('\\n')\n },\n\n /**\n * The manifest as a Mermaid flowchart: Model fields in a subgraph, one node\n * per contract, a solid edge for ownership and a dotted edge for observation.\n */\n toMermaid: (module: Module<any, any, any>): string => {\n const manifest = Module.manifest(module)\n const lines = ['flowchart LR', ' subgraph Model']\n manifest.fields.forEach((field, index) => lines.push(` f${index}[\"${field}\"]`))\n lines.push(' end')\n // A path outside the Model (reported by `validate`) draws no edge.\n const fieldId = (path: readonly string[]): string | undefined => {\n const index = path.length === 0 ? -1 : manifest.fields.indexOf(path[0]!)\n return index < 0 ? undefined : `f${index}`\n }\n manifest.contracts.forEach((contract, index) => {\n lines.push(` c${index}[\"${contract.kind}:${contract.name}\"]`)\n for (const path of contract.owns) {\n const field = fieldId(path)\n if (field !== undefined) lines.push(` c${index} -->|owns| ${field}`)\n }\n for (const path of contract.observes) {\n const field = fieldId(path)\n if (field !== undefined && !contract.owns.some(owned => pathKey(owned) === pathKey(path)))\n lines.push(` c${index} -.-> ${field}`)\n }\n })\n return lines.join('\\n')\n },\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":["Metadata"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `foldkit-surface` — the observation boundary for a Foldkit application.\n *\n * A Surface is a pure projection of the Model: it declares which fields a\n * feature reads and which Messages it may construct, from the application's\n * own Schema rather than a second hand-written interface. `foldkit-remote`,\n * `foldkit-sync`, `foldkit-agent`, and `foldkit-mirror` all read this boundary,\n * and `Module` validates that each Model path has one owner.\n *\n * Nothing here runs: the deliverable is the type surface, pinned by\n * `test/inference.test-d.ts`.\n */\nimport { Optic, Option, Predicate, Result, Schema } from 'effect'\nimport type { Html, HtmlBuilder } from 'foldkit/html'\nimport type { MessageUnion } from 'foldkit/message'\nimport type { Entry as ManagedResourceEntry } from 'foldkit/managedResource'\nimport type { Subscriptions } from 'foldkit/subscription'\nimport type * as Update from 'foldkit/update'\nimport type { Url } from 'foldkit/url'\nimport { Metadata, type MetadataSummary } from 'foldkit-metadata'\n\nexport { Metadata, MetadataTypeId, type MetadataKey, type MetadataSummary } from 'foldkit-metadata'\n\n// ===========================================================================\n// ModelRef and the typed Model tree (Phase 0 cases 1)\n// ===========================================================================\n\nexport interface ModelRef<Root, Value, Encoded = unknown> {\n /** A pure codec: Foldkit Model fields carry no decoding or encoding services. */\n readonly Schema: Schema.Codec<Value, Encoded, never, never>\n readonly optic: Optic.Optional<Root, Value>\n readonly dependency: readonly string[]\n readonly get: (root: Root) => Value\n readonly set: (root: Root, value: Value) => Root\n /**\n * Focused structural replacement: `set` of `fn` applied to `get`. This\n * delegates through the ref's own `set`, so container-aware setters\n * (`.at`/`.index` insertion and removal) keep working — never `optic`\n * calls directly. Infrastructure seam, not an application transition.\n */\n readonly modify: (root: Root, fn: (value: Value) => Value) => Root\n}\n\n/**\n * A `ModelRef` generated for a named Model field. `key` is the literal field\n * name, so a reference-based selection can infer its output keys without a\n * parallel field registry or string paths.\n */\nexport interface FieldRef<\n Root,\n Value,\n Key extends string = string,\n Encoded = unknown,\n> extends ModelRef<Root, Value, Encoded> {\n readonly key: Key\n /** The application definition this field was generated from. */\n readonly owner: object\n}\n\n/**\n * Low-level escape hatch for a focus with no Model path of its own. Prefer the\n * `App.model` tree; use this for an optic that is not part of the Model.\n */\nexport const ModelRef = {\n fromOptic: <Root, Value>(\n Schema: Schema.Schema<Value>,\n optic: Optic.Optional<Root, Value>,\n dependency: readonly string[] = [],\n ): ModelRef<Root, Value> => {\n const get: (root: Root) => Value = root => Result.getOrThrow(optic.getResult(root))\n const set = (root: Root, value: Value): Root => optic.replace(value, root)\n return {\n Schema: Schema as unknown as ModelRef<Root, Value>['Schema'],\n optic,\n dependency,\n get,\n set,\n modify: (root, fn) => set(root, fn(get(root))),\n }\n },\n}\n\nexport type RefTree<Root, F extends Schema.Struct.Fields> = {\n readonly [K in keyof F & string]: RefNode<Root, F[K], K>\n}\n\n// Tuple-wrapped so the conditional is *non-distributive*: without it,\n// `Value = Option<V>` distributes over `None | Some<V>` and `.at()` would return\n// a union of two unrelated `ModelRef`s.\ntype Selectable<Root, Value, Key extends string, Encoded = unknown> = [Value] extends [\n Option.Option<infer Inner>,\n]\n ? FieldRef<Root, Value, Key, Encoded> & {\n readonly select: <P>(projection: Projection<Inner, P>) => Projection<Root, Option.Option<P>>\n }\n : FieldRef<Root, Value, Key, Encoded> & {\n readonly select: <P>(projection: Projection<Value, P>) => Projection<Root, P>\n }\n\n/**\n * A dynamic focus from `.at`/`.index`. Deliberately not a `FieldRef`: its key is\n * a record key or index, not a Model field, so a static `Projection.pick` cannot\n * infer a field name from it.\n */\ntype OptionalRef<Root, Value> = [Value] extends [Option.Option<infer Inner>]\n ? ModelRef<Root, Value> & {\n readonly select: <P>(projection: Projection<Inner, P>) => Projection<Root, Option.Option<P>>\n }\n : ModelRef<Root, Value> & {\n readonly select: <P>(projection: Projection<Value, P>) => Projection<Root, P>\n }\n\ntype RefNode<Root, S, Key extends string> =\n S extends Schema.Codec<infer A, infer Encoded, any, any>\n ? S extends Schema.Struct<infer F>\n ? Selectable<Root, A, Key, Encoded> & RefTree<Root, F>\n : A extends ReadonlyArray<infer E>\n ? Selectable<Root, A, Key, Encoded> & {\n readonly index: (index: number) => OptionalRef<Root, Option.Option<E>>\n }\n : A extends Readonly<Record<infer K extends string, infer V>>\n ? Selectable<Root, A, Key, Encoded> & {\n readonly at: (key: K) => OptionalRef<Root, Option.Option<V>>\n }\n : Selectable<Root, A, Key, Encoded>\n : never\n\ntype AnySchema = Schema.Codec<unknown, unknown>\n\n/**\n * Names that belong to the ModelRef surface. A Struct field with one of these\n * names would silently shadow a method, so building the tree rejects it.\n */\nconst RESERVED_REF_NAMES = new Set([\n 'Schema',\n 'optic',\n 'dependency',\n 'key',\n 'read',\n 'get',\n 'set',\n 'at',\n 'index',\n 'select',\n])\n\nfunction propertyReader(root: unknown, key: string): unknown {\n return root === null || root === undefined ? undefined : (root as Record<string, unknown>)[key]\n}\n\nfunction optionalReader(value: unknown): Option.Option<unknown> {\n return value === undefined ? Option.none() : Option.some(value)\n}\n\n/** Reads the tag off a Foldkit Message constructor without constructing one. */\nconst messageTag = (constructor: unknown): string | undefined => {\n const literal = (constructor as { fields?: { _tag?: { ast?: { literal?: unknown } } } }).fields\n ?._tag?.ast?.literal\n return typeof literal === 'string' ? literal : undefined\n}\n\n/** Whether a Message, of an application this cannot name, has one of `tags`. */\nconst hasTagIn = (tags: ReadonlySet<string>, message: unknown): boolean =>\n Predicate.hasProperty(message, '_tag') &&\n typeof message._tag === 'string' &&\n tags.has(message._tag)\n\n/** The tags of the Messages a Surface lists in `messages`. */\nconst messageTags = (surface: { readonly messages: readonly unknown[] }): ReadonlyArray<string> =>\n surface.messages.map(messageTag).filter((tag): tag is string => tag !== undefined)\n\nfunction makeTree(\n schema: AnySchema,\n path: readonly string[],\n optic: Optic.Optional<unknown, unknown>,\n get: (root: unknown) => unknown,\n optional = false,\n set: ((root: unknown, value: unknown) => unknown) | undefined,\n owner: object,\n): Record<string, unknown> {\n const erasedOptic = optic as {\n key(key: string): Optic.Optional<unknown, unknown>\n at(key: string): Optic.Optional<unknown, unknown>\n }\n // `Optic.at` cannot *insert* or *remove* an absent key (`replace` is a no-op\n // when the prism fails), so optional foci get container-aware setters below.\n const setFocus = set ?? ((root: unknown, value: unknown): unknown => optic.replace(value, root))\n const node: Record<string, unknown> = {\n Schema: schema,\n optic,\n dependency: path,\n key: path[path.length - 1] ?? '',\n owner,\n get,\n set: setFocus,\n modify: (root: unknown, fn: (value: unknown) => unknown) => setFocus(root, fn(get(root))),\n }\n\n const fields = (schema as { readonly fields?: Schema.Struct.Fields }).fields\n if (fields !== undefined) {\n for (const key of Object.keys(fields)) {\n if (RESERVED_REF_NAMES.has(key)) {\n throw new Error(`Model field \"${key}\" is reserved by ModelRef`)\n }\n node[key] = makeTree(\n fields[key] as AnySchema,\n [...path, key],\n erasedOptic.key(key),\n root => propertyReader(get(root), key),\n false,\n undefined,\n owner,\n )\n }\n }\n\n node.at = (key: string) =>\n makeTree(\n schema,\n [...path, key],\n erasedOptic.at(key),\n root => optionalReader(propertyReader(get(root), key)),\n true,\n (root, value) => {\n const container = get(root) as Record<string, unknown>\n const option = value as Option.Option<unknown>\n if (Option.isSome(option)) {\n return setFocus(root, { ...container, [key]: option.value })\n }\n const { [key]: _removed, ...rest } = container\n return setFocus(root, rest)\n },\n owner,\n )\n node.index = (index: number) =>\n makeTree(\n schema,\n [...path, String(index)],\n optic,\n root =>\n optionalReader(\n Array.isArray(get(root)) ? (get(root) as ReadonlyArray<unknown>)[index] : undefined,\n ),\n true,\n (root, value) => {\n const array = (Array.isArray(get(root)) ? get(root) : []) as ReadonlyArray<unknown>\n const option = value as Option.Option<unknown>\n const next = Option.isSome(option)\n ? array.map((item, i) => (i === index ? option.value : item))\n : array.filter((_, i) => i !== index)\n return setFocus(root, next)\n },\n owner,\n )\n node.select = (projection: Projection<unknown, unknown>) => {\n const dependencies = mergeDependencies([path, ...projection.dependencies])\n return optional\n ? makeProjection(\n Schema.Option(projection.Model),\n dependencies,\n root => Option.map(get(root) as Option.Option<unknown>, value => projection.read(value)),\n projection.metadata,\n )\n : makeProjection(\n projection.Model,\n dependencies,\n root => projection.read(get(root)),\n projection.metadata,\n )\n }\n return node\n}\n\n// ===========================================================================\n// Projection (Phase 0 case 2)\n// ===========================================================================\n\nexport type DependencyTree = readonly (readonly string[])[]\n\n/** Unions dependency trees, dropping duplicates; the result is a set. */\nfunction mergeDependencies(dependencies: DependencyTree): DependencyTree {\n const seen = new Set<string>()\n const merged: (readonly string[])[] = []\n for (const dependency of dependencies) {\n const key = dependency.join('\\u0000')\n if (seen.has(key)) continue\n seen.add(key)\n merged.push(dependency)\n }\n return merged\n}\n\nexport interface Projection<Root, Value> {\n readonly Model: Schema.Codec<Value, unknown>\n readonly dependencies: DependencyTree\n /** Interpreter-owned facts about this node and everything it composes. */\n readonly metadata: Metadata\n readonly read: (root: Root) => Value\n}\n\n/**\n * A projection Surface can install back into a Model. Public reads use the\n * read-only `Projection`; only a writable selection carries installation.\n * `set` writes exactly the declared fields, so an excess field in an untrusted\n * value cannot reach local state.\n */\nexport interface WritableProjection<Model, Fields extends Schema.Struct.Fields> {\n readonly schema: Schema.Struct<Fields>\n readonly dependencies: DependencyTree\n readonly get: (model: Model) => Schema.Struct.Type<Fields>\n readonly set: (model: Model, shared: Schema.Struct.Type<Fields>) => Model\n}\n\nfunction makeProjection<Value>(\n Model: Schema.Codec<Value, unknown>,\n dependencies: DependencyTree,\n read: (root: unknown) => Value,\n metadata: Metadata = Metadata.empty,\n): Projection<unknown, Value> {\n return { Model, dependencies, metadata, read }\n}\n\n/**\n * `Schema.Struct({})` is not an empty-object schema: it accepts `{foo:1}`, `[]`,\n * and `\"str\"` even with `onExcessProperty: 'error'`. A genuinely empty selection\n * needs a `never`-valued record.\n */\nfunction objectSchema(fields: Record<string, AnySchema>): AnySchema {\n return Object.keys(fields).length === 0\n ? Schema.Record(Schema.String, Schema.Never)\n : Schema.Struct(fields)\n}\n\ntype OfSelection<F extends Schema.Struct.Fields> = {\n readonly [K in keyof F]?: true | Projection<Schema.Schema.Type<F[K]>, unknown>\n}\n\ntype OfValue<F extends Schema.Struct.Fields, Sel> = {\n readonly [K in keyof Sel & keyof F]: Sel[K] extends true\n ? Schema.Schema.Type<F[K]>\n : Sel[K] extends Projection<any, infer V>\n ? V\n : never\n}\n\ntype EntryValue<E> =\n E extends Projection<any, infer V> ? V : E extends ModelRef<any, infer V> ? V : never\n\ntype EntryRoot<E> =\n E extends Projection<infer R, any> ? R : E extends ModelRef<infer R, any> ? R : never\n\ntype EntryRoots<Entries> = { readonly [K in keyof Entries]: EntryRoot<Entries[K]> }\n\n/** `true` when the union has more than one member. Used to reject mixed roots. */\ntype IsUnion<T, U = T> = [T] extends [never]\n ? false\n : T extends unknown\n ? [U] extends [T]\n ? false\n : true\n : never\n\ntype StructValue<Entries> = {\n readonly [K in keyof Entries]: EntryValue<Entries[K]>\n} extends infer Value\n ? { readonly [K in keyof Value]: Value[K] }\n : never\n\nexport const Projection = {\n of:\n <F extends Schema.Struct.Fields>(schema: Schema.Struct<F>) =>\n <const Sel extends OfSelection<F>>(\n selection: Sel,\n ): Projection<Schema.Struct.Type<F>, OfValue<F, Sel>> => {\n const picked: Record<string, AnySchema> = {}\n const dependencies: (readonly string[])[] = []\n const metadata: Metadata[] = []\n const readers: (readonly [string, (root: unknown) => unknown])[] = []\n\n for (const key of Object.keys(selection)) {\n const choice = (selection as Record<string, unknown>)[key]\n if (choice === true) {\n picked[key] = schema.fields[key] as AnySchema\n readers.push([key, root => propertyReader(root, key)])\n } else {\n const nested = choice as Projection<unknown, unknown>\n picked[key] = nested.Model\n dependencies.push(...nested.dependencies)\n metadata.push(nested.metadata)\n readers.push([key, root => nested.read(propertyReader(root, key))])\n }\n }\n\n const read = (root: unknown): unknown => {\n const out: Record<string, unknown> = {}\n for (const [key, reader] of readers) out[key] = reader(root)\n return out\n }\n return makeProjection(\n objectSchema(picked),\n mergeDependencies(dependencies),\n read,\n Metadata.combine(metadata),\n ) as unknown as Projection<Schema.Struct.Type<F>, OfValue<F, Sel>>\n },\n\n struct: <const Entries extends Record<string, Projection<any, any> | ModelRef<any, any>>>(\n entries: Entries & (IsUnion<EntryRoots<Entries>[keyof Entries]> extends true ? never : unknown),\n ): Projection<EntryRoot<Entries[keyof Entries]>, StructValue<Entries>> => {\n const picked: Record<string, AnySchema> = {}\n const dependencies: (readonly string[])[] = []\n const metadata: Metadata[] = []\n const readers: (readonly [string, (root: unknown) => unknown])[] = []\n\n for (const key of Object.keys(entries)) {\n const entry = entries[key] as Projection<unknown, unknown> | ModelRef<unknown, unknown>\n if ('dependencies' in entry) {\n picked[key] = entry.Model\n dependencies.push(...entry.dependencies)\n metadata.push(entry.metadata)\n readers.push([key, entry.read])\n } else {\n picked[key] = entry.Schema\n dependencies.push(entry.dependency)\n readers.push([key, entry.get])\n }\n }\n\n const read = (root: unknown): unknown => {\n const out: Record<string, unknown> = {}\n for (const [key, reader] of readers) out[key] = reader(root)\n return out\n }\n return makeProjection(\n objectSchema(picked),\n mergeDependencies(dependencies),\n read,\n Metadata.combine(metadata),\n ) as unknown as Projection<EntryRoot<Entries[keyof Entries]>, StructValue<Entries>>\n },\n\n /**\n * Maps a Projection over an array: `array(p): Projection<ReadonlyArray<Root>,\n * ReadonlyArray<Value>>`. Nesting is explicit (an array of arrays stays an\n * array of arrays); there is no flatten or double-wrap.\n */\n array: <Root, Value>(\n projection: Projection<Root, Value>,\n ): Projection<ReadonlyArray<Root>, ReadonlyArray<Value>> => ({\n Model: Schema.Array(projection.Model),\n dependencies: projection.dependencies,\n metadata: projection.metadata,\n read: root => root.map(value => projection.read(value)),\n }),\n\n /** Maps a Projection inside an Option, preserving absence. */\n option: <Root, Value>(\n projection: Projection<Root, Value>,\n ): Projection<Option.Option<Root>, Option.Option<Value>> => ({\n Model: Schema.Option(projection.Model),\n dependencies: projection.dependencies,\n metadata: projection.metadata,\n read: root => Option.map(root, value => projection.read(value)),\n }),\n\n read: <Root, Value>(projection: Projection<Root, Value>, root: Root): Value =>\n projection.read(root),\n\n /**\n * Low-level escape hatch: a Projection from a Schema and a reader, for\n * projections not derived from ModelRefs (agent context, adapters). Prefer\n * `of`/`struct`/`select`; dependencies default to empty.\n */\n fromReader: <Root, Value>(\n Model: Schema.Codec<Value, unknown>,\n read: (root: Root) => Value,\n options?: {\n readonly dependencies?: DependencyTree\n readonly metadata?: Metadata\n },\n ): Projection<Root, Value> => ({\n Model,\n dependencies: options?.dependencies ?? [],\n metadata: options?.metadata ?? Metadata.empty,\n read,\n }),\n\n /**\n * Derives a writable projection from generated Model field references:\n * `Projection.pick(App.model.todos, App.model.selectedTodoId)` infers\n * `{ todos, selectedTodoId }` and its codec. Every reference must share one\n * Root; a raw optic or an unrelated application is rejected. Repeated\n * identical members deduplicate; a conflicting definition throws.\n */\n pick: <const Refs extends readonly FieldRef<any, any, string>[]>(\n ...refs: Refs & (IsUnion<RefRoots<Refs>[number]> extends true ? never : unknown)\n ): WritableProjection<RefRoots<Refs>[number], PickFields<Refs>> => {\n const selected = [...refs]\n // Two applications can have structurally identical Models, so the root type\n // check cannot separate them; the owner token can.\n const owner = selected[0]?.owner\n for (const ref of selected) {\n if (ref.owner !== owner) {\n throw new Error('Projection.pick: references from different applications')\n }\n }\n // A picked field is named by its last key alone, so two fields at\n // different paths with the same name would be one field: `get` would keep\n // one value and `set` would write it into both. The same field picked twice\n // is harmless and kept once; two different ones are refused here.\n const fields: Record<string, AnySchema> = {}\n const paths: Record<string, string> = {}\n for (const ref of [...selected]) {\n const path = ref.dependency.join('.')\n const existing = paths[ref.key]\n if (existing !== undefined) {\n if (existing === path) {\n selected.splice(selected.indexOf(ref), 1)\n continue\n }\n throw new Error(\n `Projection.pick: \"${existing}\" and \"${path}\" would both be read as \"${ref.key}\". Pick them in separate projections.`,\n )\n }\n paths[ref.key] = path\n fields[ref.key] = ref.Schema\n }\n return {\n schema: objectSchema(fields) as never,\n dependencies: mergeDependencies(selected.map(ref => ref.dependency)),\n get: model => {\n const out: Record<string, unknown> = {}\n for (const ref of selected) out[ref.key] = ref.get(model as never)\n return out as never\n },\n set: (model, shared) => {\n let next = model\n for (const ref of selected)\n next = ref.set(next as never, (shared as Record<string, unknown>)[ref.key] as never)\n return next\n },\n }\n },\n\n /**\n * Merges disjoint writable projections into one: `Projection.compose(Todos,\n * Selection)`. Every projection must own the same Model; a field defined twice\n * with a different codec throws, while an identical definition deduplicates.\n * `set` installs each part, so composed fields keep their own write behaviour.\n */\n compose: <const Ps extends readonly WritableProjection<any, any>[]>(\n ...projections: Ps & (IsUnion<ProjectionModel<Ps[number]>> extends true ? never : unknown)\n ): WritableProjection<ProjectionModel<Ps[number]>, MergeFields<Ps>> => {\n const parts = [...projections]\n const fields: Record<string, AnySchema> = {}\n // Where each field is read from, where the part says: a dependency path\n // ending in the field's name. The same name from two different paths is two\n // fields that would be read as one, as in `pick`.\n const paths: Record<string, string> = {}\n const pathOf = (part: (typeof parts)[number], key: string): string | undefined =>\n part.dependencies.find(dependency => dependency.at(-1) === key)?.join('.')\n for (const part of parts) {\n for (const [key, codec] of Object.entries(part.schema.fields)) {\n const existing = fields[key]\n const path = pathOf(part, key)\n if (existing !== undefined) {\n const previous = paths[key]\n if (previous !== undefined && path !== undefined && previous !== path) {\n throw new Error(\n `Projection.compose: \"${previous}\" and \"${path}\" would both be read as \"${key}\"`,\n )\n }\n if (existing === codec) continue\n throw new Error(`Projection.compose: conflicting definitions for \"${key}\"`)\n }\n fields[key] = codec as AnySchema\n if (path !== undefined) paths[key] = path\n }\n }\n return {\n schema: objectSchema(fields) as never,\n dependencies: mergeDependencies(parts.flatMap(part => [...part.dependencies])),\n get: model => {\n const out: Record<string, unknown> = {}\n for (const part of parts) Object.assign(out, part.get(model as never))\n return out as never\n },\n set: (model, shared) => {\n let next = model\n // Each part reads only its own fields from the merged value.\n for (const part of parts) next = part.set(next as never, shared as never)\n return next\n },\n }\n },\n}\n\n// ===========================================================================\n// Surface (Phase 0 case 3)\n// ===========================================================================\n\nexport interface AppScope<\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n> {\n readonly Model: Schema.Struct<F>\n readonly Message: MessageUnion<Cases>\n readonly model: RefTree<Root, F>\n /** Identity token shared by this application's references and subsets. */\n readonly owner: object\n}\n\nexport interface SurfaceInspection {\n readonly name: string\n readonly dependencies: DependencyTree\n readonly metadata: readonly MetadataSummary[]\n readonly emits: readonly unknown[]\n}\n\n/**\n * A Surface's params codec: present when the Surface declares params, absent\n * when `Params` is `void`, and possibly either when `Params` is `any`/`unknown`\n * so a params Surface still fits a `Surface<…, any>` position.\n */\nexport type ParamsSchema<Params> = unknown extends Params\n ? Schema.Codec<Params, unknown> | undefined\n : [Params] extends [void]\n ? [void] extends [Params]\n ? // Exactly `void`: no params, no schema.\n undefined\n : // `undefined` also extends `void`, but a Surface may still declare its schema.\n Schema.Codec<Params, unknown> | undefined\n : [void] extends [Params]\n ? // `void | X`: the schema is optional.\n Schema.Codec<Params, unknown> | undefined\n : Schema.Codec<Params, unknown>\n\nexport interface Surface<Root, Model, Message, Params> {\n readonly name: string\n /** Identity token of the application this Surface belongs to. */\n readonly owner: object\n readonly Params: ParamsSchema<Params>\n readonly Message: Schema.Schema<Message>\n readonly messages: readonly unknown[]\n readonly projection: (params: Params) => Projection<Root, Model>\n}\n\n/**\n * A Surface as the Model activates it: its params are a function of the Model\n * (`undefined` while inactive), so its requirements are too. `Surface.at`\n * builds one; a Subscription derives what to fetch, subscribe, and retain\n * from a list of them.\n */\n/**\n * Why a Surface is active, when that is something other than a callback.\n *\n * `Surface.at` takes an arbitrary function of the Model, which is correct and\n * opaque: nothing can say *why* the Surface is on without running it. When\n * activation is a tagged value at a known place — a route, a mode, a\n * selection — `Surface.when` records the place and the tag, and a manifest can\n * be built without evaluating anything.\n */\n/**\n * What `Surface.when` needs of a place in the Model: where it is, and how to\n * read it.\n *\n * The read half of a `ModelRef`, and deliberately not the whole thing.\n * Activation **observes** — it never installs a value — so asking for a\n * writable reference would claim an authority it does not use. It also makes\n * the common case work: a field holding a tagged union is a *union of*\n * `FieldRef`s, one per case, which no single `ModelRef<Root, Value>` accepts.\n */\nexport interface ModelPlace<Root> {\n /** Where the value lives, as `ModelRef.dependency` gives it. */\n readonly dependency: readonly string[]\n readonly get: (root: Root) => unknown\n}\n\nexport interface Activation {\n /** The Model path the tagged value lives at, as `ModelRef.dependency` gives it. */\n readonly path: readonly string[]\n /** The tag that makes the Surface active. */\n readonly tag: string\n}\n\nexport interface ActiveSurface<Root> {\n readonly name: string\n /** Identity token of the application the Surface belongs to. */\n readonly owner: object\n /** The projection for the params the Model gives; none while the Surface is inactive. */\n readonly projectionOf: (model: Root) => Option.Option<Projection<Root, unknown>>\n /** The tags of the Messages the Surface lists in `messages`: what it may send. */\n readonly messages: ReadonlyArray<string>\n /** Present when the Surface was placed with `Surface.when`; absent for `Surface.at`. */\n readonly activation?: Activation | undefined\n}\n\ndeclare const invalid: unique symbol\n\n/**\n * A compile-time failure that names its cause. Intersected onto a parameter\n * type when a type-level check fails, so the error reads as one line\n * (`Property '[invalid]' is missing … required in type 'Invalid<\"…\">'`)\n * naming the descriptor, instead of a wall of structural mismatch.\n */\nexport interface Invalid<Message extends string> {\n readonly [invalid]: Message\n}\n\n/** The fields of a `Schema.Struct`, or a schema, where params are declared. */\ntype ParamsShape = Schema.Struct.Fields | Schema.Top\n\ntype ParamsOf<P> = P extends Schema.Top\n ? Schema.Schema.Type<P>\n : P extends Schema.Struct.Fields\n ? Schema.Struct.Type<P>\n : void\n\n/** What a Surface's `model` may return: a Projection, or an object of Projections and refs to lift. */\ntype ModelShape<Root> =\n Projection<Root, unknown> | Record<string, Projection<Root, any> | ModelRef<Root, any>>\n\ntype ModelOf<Root, R> = R extends Projection<Root, infer M> ? M : StructValue<R>\n\nconst isProjection = (value: unknown): value is Projection<unknown, unknown> =>\n typeof value === 'object' &&\n value !== null &&\n typeof (value as { read?: unknown }).read === 'function' &&\n Metadata.is((value as { metadata?: unknown }).metadata)\n\ntype MsgOf<Ms extends readonly unknown[]> = {\n readonly [K in keyof Ms]: Ms[K] extends (...args: never[]) => infer M ? M : never\n}[number]\n\n/** The union of Messages a tuple of constructors produces. */\ntype SubsetOf<Ms extends readonly unknown[]> = Ms[number] extends (...args: never[]) => infer M\n ? M\n : never\n\ntype AppMessage<Cases extends Record<string, Schema.Struct.Fields>> = Schema.Schema.Type<\n MessageUnion<Cases>\n>\n\n/** A Message constructor whose produced Message belongs to the App's universe. */\ntype MessageConstructor<Cases extends Record<string, Schema.Struct.Fields>> = (\n ...args: never[]\n) => AppMessage<Cases>\n\n/**\n * The renderer's builder: the real `HtmlBuilder` with its private\n * `MessageUniverse` phantom removed, so the renderer's `OnClick` accepts only\n * the Surface's Message subset. `HtmlBuilder<M>` stays invariant even without\n * the phantom (`OnClick` returns `{ message: M }`), so a superset builder is\n * not assignable to this; `Surface.view` casts, which is sound because the\n * renderer can only construct subset Messages and the real builder accepts the\n * superset.\n */\ntype ViewBuilder<Message> = Omit<HtmlBuilder<Message>, keyof HtmlBuilder<never> & symbol>\n\n/** A renderer for a Surface's projected Model, with its Message set narrowed. */\nexport type Renderer<Model, Message> = (model: Model, h: ViewBuilder<Message>) => Html\n\n/** `unknown` when `Sub` is a subtype of `Super`, `never` otherwise. */\ntype Subset<Sub, Super> = [Sub] extends [Super] ? unknown : never\n\ntype RefRoot<R> = R extends ModelRef<infer Root, any> ? Root : never\n\ntype RefRoots<Refs extends readonly unknown[]> = {\n readonly [K in keyof Refs]: RefRoot<Refs[K]>\n}\n\n/** The struct fields a reference selection produces, keyed by each ref's field. */\ntype PickFields<Refs extends readonly FieldRef<any, any, string>[]> = {\n readonly [R in Refs[number] as R['key']]: R['Schema']\n}\n\ntype ProjectionModel<P> = P extends WritableProjection<infer M, any> ? M : never\n\ntype ProjectionFields<P> = P extends WritableProjection<any, infer F> ? F : never\n\ntype Merge2<A, B> = {\n readonly [K in keyof A | keyof B]: K extends keyof A ? A[K] : K extends keyof B ? B[K] : never\n}\n\n/** Merges the fields of several projections; an overlapping key is rejected at runtime. */\nexport type MergeFields<Ps extends readonly WritableProjection<any, any>[]> = Ps extends readonly [\n infer Head extends WritableProjection<any, any>,\n ...infer Tail extends readonly WritableProjection<any, any>[],\n]\n ? Merge2<ProjectionFields<Head>, MergeFields<Tail>>\n : {}\n\n/**\n * An application definition: the Model and Message schemas and the generated\n * field references. It is data, not a running instance, so it can be inspected\n * without mounting anything. Context, replication, and validation all read the\n * same `App.model` references.\n */\nexport interface Application<\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n> extends AppScope<Root, F, Cases> {\n /**\n * @deprecated Use `App.model`, the same references under the name the rest\n * of the API uses: `App.surface` hands a Surface `{ model }`, and\n * `Remote.make` and `Editor.at` take `model: App.model.…`. Removed in a\n * later minor.\n */\n readonly fields: RefTree<Root, F>\n /**\n * `Surface.make` with the mechanical wrappers lifted: `params` are the\n * fields of a `Schema.Struct` (or a schema), and `model` may return an\n * object of Projections and refs, which becomes `Projection.struct`.\n */\n readonly surface: <\n const Params extends ParamsShape | undefined = undefined,\n Shape extends ModelShape<Root> = Projection<Root, unknown>,\n const Ms extends readonly MessageConstructor<Cases>[] = readonly [],\n >(\n name: string,\n config: {\n readonly params?: Params\n readonly model: (context: {\n readonly model: RefTree<Root, F>\n readonly params: ParamsOf<Params>\n }) => Shape\n readonly messages?: Ms\n },\n ) => Surface<Root, ModelOf<Root, Shape>, MsgOf<Ms>, ParamsOf<Params>>\n}\n\n/**\n * An `Application` that also carries the initial Model and the transition\n * function, so a replicator can derive the initial shared value and replay.\n * `Resources` is whatever `update`'s Commands need.\n */\nexport interface RunnableApplication<\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n Resources = never,\n> extends Application<Root, F, Cases> {\n readonly initial: Root\n readonly update: (\n model: Root,\n message: Schema.Schema.Type<MessageUnion<Cases>>,\n ) => Update.Return<Root, Schema.Schema.Type<MessageUnion<Cases>>, Resources>\n}\n\ndeclare const messageSubsetRoot: unique symbol\n\n/**\n * A typed subset of one application's Messages: the selected constructors, a\n * codec for exactly those variants, and a runtime membership test. Surface does\n * not label a subset agent-visible, durable, or presence; `Agent` and `Sync`\n * attach their own policy to the same value.\n */\n/** The union of encoded types a tuple of constructor schemas produces. */\ntype SubsetEncoded<Ms extends readonly unknown[]> =\n Ms[number] extends Schema.Codec<any, infer Encoded, any, any> ? Encoded : never\n\nexport interface MessageSet<\n Root,\n Message,\n Subset extends Message,\n Ms extends readonly ((...args: never[]) => Message)[],\n Cases extends Record<string, Schema.Struct.Fields> = Record<string, Schema.Struct.Fields>,\n Encoded = unknown,\n> {\n /** Phantom owner, so a subset cannot be crossed between applications. */\n readonly [messageSubsetRoot]?: Root\n /** The application identity token, checked when subsets compose. */\n readonly owner: object\n readonly constructors: Ms\n /** A pure codec for exactly the selected variants. */\n readonly schema: Schema.Codec<Subset, Encoded, never, never>\n readonly tags: ReadonlySet<string>\n readonly includes: (message: Message) => message is Subset\n}\n\nconst makeScope = <\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n>(config: {\n readonly Model: Schema.Struct<F>\n readonly Message: MessageUnion<Cases>\n}): AppScope<Schema.Struct.Type<F>, F, Cases> => {\n // One token per application, so a selection cannot silently mix two\n // applications whose Models happen to be structurally identical.\n const owner: object = {}\n return {\n Model: config.Model,\n Message: config.Message,\n owner,\n model: makeTree(\n // A generic `F` hides the Struct's services; a Foldkit Model is pure.\n config.Model as unknown as AnySchema,\n [],\n Optic.id(),\n root => root,\n false,\n undefined,\n owner,\n ) as unknown as RefTree<Schema.Struct.Type<F>, F>,\n }\n}\n\n/**\n * Captures an application's pure references once. `initial` and `update` are\n * optional: an agent needs only the Model, Message, and field references, while\n * a replicator needs them to derive the initial shared value and replay. A\n * `RunnableApplication` is returned when both are supplied.\n */\nfunction application<\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n Resources = never,\n ManagedResourceServices = never,\n>(config: {\n readonly Model: Schema.Struct<F>\n readonly Message: MessageUnion<Cases>\n readonly initial: Schema.Struct.Type<F>\n readonly update: (\n model: Schema.Struct.Type<F>,\n message: Schema.Schema.Type<MessageUnion<Cases>>,\n ) => Update.Return<\n Schema.Struct.Type<F>,\n Schema.Schema.Type<MessageUnion<Cases>>,\n Resources | ManagedResourceServices\n >\n}): RunnableApplication<Schema.Struct.Type<F>, F, Cases, Resources | ManagedResourceServices>\nfunction application<\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n>(config: {\n readonly Model: Schema.Struct<F>\n readonly Message: MessageUnion<Cases>\n}): Application<Schema.Struct.Type<F>, F, Cases>\nfunction application(config: any): any {\n const scope = makeScope(config)\n const surface = (\n name: string,\n surfaceConfig: {\n readonly params?: ParamsShape | undefined\n readonly model: (context: { readonly model: unknown; readonly params: unknown }) => unknown\n readonly messages?: readonly unknown[]\n },\n ) =>\n Surface.make(scope, name, {\n ...(surfaceConfig.params === undefined\n ? {}\n : {\n Params: Schema.isSchema(surfaceConfig.params)\n ? surfaceConfig.params\n : Schema.Struct(surfaceConfig.params),\n }),\n model: (context: { readonly model: unknown; readonly params: unknown }) => {\n const shape = surfaceConfig.model(context)\n return isProjection(shape) ? shape : Projection.struct(shape as never)\n },\n messages: surfaceConfig.messages,\n } as never)\n return { ...scope, initial: config.initial, fields: scope.model, update: config.update, surface }\n}\n\ntype ConstructorOfSubset<S> = S extends MessageSet<any, any, any, infer Ms, any> ? Ms : never\ntype ValueOfSubset<S> = S extends MessageSet<any, any, infer V, any, any> ? V : never\ntype RootOfSubset<S> = S extends MessageSet<infer R, any, any, any, any> ? R : never\ntype MessageOfSubset<S> = S extends MessageSet<any, infer M, any, any, any> ? M : never\ntype CasesOfSubset<S> = S extends MessageSet<any, any, any, any, infer C> ? C : never\n\ntype Concat<A extends readonly unknown[], B extends readonly unknown[]> = [...A, ...B]\n\n/** Concatenates the constructor tuples of several subsets, preserving each. */\nexport type MergeConstructors<Subs extends readonly MessageSet<any, any, any, any, any>[]> =\n Subs extends readonly [\n infer Head extends MessageSet<any, any, any, any, any>,\n ...infer Tail extends readonly MessageSet<any, any, any, any, any>[],\n ]\n ? Concat<ConstructorOfSubset<Head>, MergeConstructors<Tail>>\n : []\n\n/** Typed Message subsets of one application, by constructor reference. */\nexport const MessageSet = {\n /**\n * Selects a typed Message subset by constructor reference:\n * `MessageSet.make(App, [Message.CreatedTodo, Message.RenamedTodo])`. Each\n * constructor must be this application's own variant; a duplicate or a variant\n * from another union throws.\n */\n make: <\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n const Ms extends readonly MessageConstructor<Cases>[],\n >(\n app: AppScope<Root, F, Cases>,\n messages: Ms,\n ): MessageSet<\n Root,\n Schema.Schema.Type<MessageUnion<Cases>>,\n SubsetOf<Ms> & Schema.Schema.Type<MessageUnion<Cases>>,\n Ms,\n Cases,\n SubsetEncoded<Ms>\n > => {\n const tags = new Set<string>()\n for (const constructor of messages) {\n const tag = messageTag(constructor)\n if (tag === undefined) {\n throw new Error('MessageSet.make: expected Message constructors')\n }\n if ((app.Message as unknown as Record<string, unknown>)[tag] !== constructor) {\n throw new Error(\n `MessageSet.make: \"${tag}\" is not a variant of this application's Message union`,\n )\n }\n if (tags.has(tag)) throw new Error(`MessageSet.make: duplicate \"${tag}\"`)\n tags.add(tag)\n }\n return {\n owner: app.owner,\n constructors: messages,\n schema: Schema.Union([...messages] as unknown as ReadonlyArray<\n Schema.Schema<unknown>\n >) as unknown as Schema.Codec<\n SubsetOf<Ms> & Schema.Schema.Type<MessageUnion<Cases>>,\n SubsetEncoded<Ms>,\n never,\n never\n >,\n tags,\n includes: (message): message is SubsetOf<Ms> & Schema.Schema.Type<MessageUnion<Cases>> =>\n hasTagIn(tags, message),\n }\n },\n\n /**\n * Unions several Message subsets into one. Every subset must belong to the\n * same application; a tag declared twice throws. Disjoint feature modules can\n * each declare their own subset and compose them here.\n */\n union: <const Subs extends readonly MessageSet<any, any, any, any, any>[]>(\n ...subsets: Subs\n ): MessageSet<\n RootOfSubset<Subs[number]>,\n MessageOfSubset<Subs[number]>,\n ValueOfSubset<Subs[number]>,\n MergeConstructors<Subs>,\n CasesOfSubset<Subs[number]>,\n SubsetEncoded<MergeConstructors<Subs>>\n > => {\n const parts = [...subsets]\n const owner = parts[0]?.owner\n const tags = new Set<string>()\n const constructors: Array<Schema.Schema<unknown>> = []\n for (const part of parts) {\n if (part.owner !== owner) {\n throw new Error('MessageSet.union: subsets from different applications')\n }\n for (const constructor of part.constructors) {\n const tag = messageTag(constructor)\n if (tag === undefined) continue\n if (tags.has(tag)) throw new Error(`MessageSet.union: duplicate \"${tag}\"`)\n tags.add(tag)\n constructors.push(constructor as Schema.Schema<unknown>)\n }\n }\n return {\n owner: owner as object,\n constructors: constructors as never,\n schema: Schema.Union(constructors) as unknown as Schema.Codec<\n ValueOfSubset<Subs[number]>,\n SubsetEncoded<MergeConstructors<Subs>>,\n never,\n never\n >,\n tags,\n includes: (message): message is ValueOfSubset<Subs[number]> => hasTagIn(tags, message),\n }\n },\n}\n\n// ===========================================================================\n// Action: a named capability that ends in an existing Message\n// ===========================================================================\n\n/**\n * A capability a consumer may invoke by name with data, such as an agent's\n * tool or a page Block's button. It ends in one of the application's own\n * Messages, so `update` stays the only place a Message has effects, and its\n * input is decoded by its Schema before `toMessage` sees it: stored or\n * untrusted data never executes.\n */\n// `Input` defaults to `never`: an Action known only as an Action takes no input but through `run`.\nexport interface Action<\n Name extends string = string,\n Input = never,\n Encoded = unknown,\n Message = unknown,\n> {\n readonly _tag: 'Action'\n readonly name: Name\n /** What it does, for a person choosing it or an agent deciding to. */\n readonly description: string\n readonly input: Schema.Codec<Input, Encoded, never, never>\n readonly toMessage: (input: Input) => Message\n}\n\nexport const Action = {\n /** An Action: `Action.define({ name: 'addToCart', description, input, toMessage })`. */\n define: <const Name extends string, Input, Encoded, Message>(config: {\n readonly name: Name\n readonly description: string\n readonly input: Schema.Codec<Input, Encoded, never, never>\n readonly toMessage: (input: Input) => Message\n }): Action<Name, Input, Encoded, Message> => {\n if (config.name.length === 0) throw new Error('Action.define: an Action needs a name')\n return Object.freeze({ _tag: 'Action', ...config })\n },\n\n /** Whether a value is an Action. */\n is: (value: unknown): value is Action =>\n typeof value === 'object' && Predicate.isTagged(value, 'Action'),\n\n /**\n * The Message an Action makes of `data`, decoded as its input first; a\n * failure says why the input was refused and makes no Message.\n */\n run: <Input, Encoded, Message>(\n action: Action<string, Input, Encoded, Message>,\n data: unknown,\n ): Result.Result<Message, Schema.SchemaError> =>\n Result.map(Schema.decodeUnknownResult(action.input)(data), action.toMessage),\n}\n\nexport const Surface = {\n application,\n\n /**\n * A Surface as the Model activates it. `params` is the value, or a function\n * of the Model returning it (none while the Surface is inactive, e.g. on\n * another route); the Surface's requirements then follow the Model.\n */\n at: <Root, Model, Message, Params>(\n surface: Surface<Root, Model, Message, Params>,\n params: Params | ((model: Root) => Option.Option<Params>),\n ): ActiveSurface<Root> => ({\n name: surface.name,\n owner: surface.owner,\n messages: messageTags(surface),\n projectionOf: model =>\n Option.map(\n typeof params === 'function'\n ? (params as (model: Root) => Option.Option<Params>)(model)\n : Option.some(params),\n surface.projection,\n ),\n }),\n\n /**\n * A Surface active while a tagged value at a known place has a given tag.\n *\n * ```ts\n * Surface.when(ProjectPage, App.model.route, AppRoute.Project, route => ({\n * projectId: route.projectId,\n * }))\n * ```\n *\n * The same thing `Surface.at` does with a callback, and one fact more: the\n * place and the tag are **values**, so what activates the Surface can be read\n * without running anything. That is what a route-to-Surface manifest, a\n * prefetch analysis, or an explanation of why a read is happening needs.\n *\n * Deliberately **not router-specific.** A route is one kind of tagged Model\n * state; a mode, a wizard step and a selected tab are others, and none of\n * them should need their own helper.\n *\n * `Surface.at` stays, and is still the answer when activation is a genuine\n * computation rather than a tag.\n */\n when: <Root, Model, Message, Params, Case extends Schema.Top>(\n surface: Surface<Root, Model, Message, Params>,\n place: ModelPlace<Root>,\n tagged: Case,\n params: (value: Schema.Schema.Type<Case>) => Params,\n ): ActiveSurface<Root> => {\n const tag = messageTag(tagged)\n if (tag === undefined) {\n throw new Error(\n `Surface.when: expected a tagged constructor for \"${surface.name}\", which is what names the case that activates it`,\n )\n }\n return {\n name: surface.name,\n owner: surface.owner,\n messages: messageTags(surface),\n activation: { path: place.dependency, tag },\n projectionOf: model => {\n const value = place.get(model)\n return Predicate.isTagged(value, tag)\n ? Option.some(surface.projection(params(value as Schema.Schema.Type<Case>)))\n : Option.none()\n },\n }\n },\n\n make: <\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n Params = void,\n Model = unknown,\n const Ms extends readonly MessageConstructor<Cases>[] = readonly [],\n >(\n app: AppScope<Root, F, Cases>,\n name: string,\n config: {\n readonly Params?: Schema.Codec<Params, unknown>\n readonly model: (context: {\n readonly model: RefTree<Root, F>\n readonly params: Params\n }) => Projection<Root, Model>\n readonly messages?: Ms\n },\n ): Surface<Root, Model, MsgOf<Ms>, Params> => {\n // Deliberately no eager `projection(undefined)`: a parameterized Surface's\n // projection may read `params`.\n const projection = (params: Params): Projection<Root, Model> =>\n config.model({ model: app.model, params })\n return {\n name,\n owner: app.owner,\n // Absent only when `Params` is exactly `void`; `ParamsSchema` keeps it optional otherwise.\n Params: config.Params as ParamsSchema<Params>,\n Message: Schema.Never as unknown as Schema.Schema<MsgOf<Ms>>,\n messages: config.messages ?? [],\n projection,\n }\n },\n\n read: <Root, Model, Message, Params>(\n surface: Surface<Root, Model, Message, Params>,\n root: Root,\n params?: Params,\n ): Model => surface.projection(params as Params).read(root),\n\n /**\n * Binds a renderer to a Surface's projected Model and Message set. A\n * type-level binder: the renderer already has this shape, but `Model` and\n * `Message` are derived from the Surface instead of written by hand.\n */\n view: <Root, Model, Message, Params>(\n _surface: Surface<Root, Model, Message, Params>,\n render: Renderer<Model, Message>,\n ): Renderer<Model, Message> => render,\n\n /**\n * The application boundary: consume the Root Model, project it, and hand the\n * projected Model to the renderer. `Subset` rejects a Surface whose Messages\n * the application builder cannot route.\n */\n rootView: <Root, Model, Message, Params>(\n surface: Surface<Root, Model, Message, Params>,\n params: Params,\n render: Renderer<Model, Message>,\n ): (<AppMessage>(\n root: Root,\n h: HtmlBuilder<AppMessage> & Subset<Message, AppMessage>,\n ) => Html) => {\n const projection = surface.projection(params)\n // Sound narrowing: the renderer can only construct this Surface's Messages,\n // and `Subset` guarantees the application builder accepts them.\n return <AppMessage>(\n root: Root,\n h: HtmlBuilder<AppMessage> & Subset<Message, AppMessage>,\n ): Html => render(projection.read(root), h as unknown as ViewBuilder<Message>)\n },\n\n /**\n * Embeds a child renderer in a parent view. `ParentModel extends ChildModel`\n * enforces \"child Model requirement ⊆ parent projected Model\"; `Subset`\n * enforces \"child Message set ⊆ parent Message set\".\n */\n embed:\n <ChildModel, ChildMessage>(child: Renderer<ChildModel, ChildMessage>) =>\n <ParentModel extends ChildModel, ParentMessage>(\n model: ParentModel,\n h: ViewBuilder<ParentMessage> & Subset<ChildMessage, ParentMessage>,\n ): Html =>\n child(model, h as unknown as ViewBuilder<ChildMessage>),\n\n /**\n * A Surface as a `Contract` for `Module`: what it observes, requires, and may\n * emit. A parameterized Surface needs its `params` to build the projection.\n */\n contract: <Root, Model, Message, Params>(\n surface: Surface<Root, Model, Message, Params>,\n params: Params,\n ): Contract => {\n const projection = surface.projection(params)\n return {\n kind: 'surface',\n name: surface.name,\n owner: surface.owner,\n owns: [],\n observes: projection.dependencies,\n messages: messageTags(surface),\n metadata: Metadata.summarize(projection.metadata),\n }\n },\n\n /**\n * Pure introspection for DevTools: what a Surface observes (dependencies,\n * requirements) and what it may emit. No behavior change, no I/O.\n */\n inspect: <Root, Model, Message, Params>(\n surface: Surface<Root, Model, Message, Params>,\n params: Params,\n ): SurfaceInspection => {\n const projection = surface.projection(params)\n return {\n name: surface.name,\n dependencies: projection.dependencies,\n metadata: Metadata.summarize(projection.metadata),\n emits: surface.messages,\n }\n },\n}\n\n// ===========================================================================\n// Entity, Selection, Remote moved to `foldkit-remote` (Phase 3).\n// ===========================================================================\n\n// ===========================================================================\n// Module: the pure composition root\n// ===========================================================================\n\n/**\n * What one contract claims about an application, as data. Sync, Remote, and\n * Agent attach one to the values they produce; `Surface.contract` derives one\n * from a Surface. `owns` are the Model paths the contract is the authority for\n * (a replicated projection, a remote store); `observes` are the paths it reads.\n */\nexport interface Contract {\n readonly kind: string\n readonly name: string\n /** The application's identity token; absent when the value cannot know it. */\n readonly owner?: object | undefined\n readonly owns: DependencyTree\n readonly observes: DependencyTree\n /** Message tags the contract may cause, expose, or record. */\n readonly messages: readonly string[]\n /** What interpreters attached to the contract's reads, as text. */\n readonly metadata: readonly MetadataSummary[]\n}\n\n/**\n * How one integration joins an application, as data and pure functions: the\n * Messages it routes, what it runs at startup and on a URL change, its\n * Subscriptions and Managed Resources, and its contract. Remote, Mirror, Sync,\n * and Agent produce one; `foldkit-bundle`'s assembly derives the application's\n * `update`, initial state, runtime config, and Module from a list of them.\n * `R` is the services its Commands and Subscriptions need.\n */\nexport interface Wiring<Model, Message, R = never> {\n /** Names the integration in errors and the Module: `remote:Board`, `mirror:filters`. */\n readonly key: string\n /** Message tags `route` handles. Two integrations handling one tag is an error unless it is `shared`. */\n readonly handles: readonly string[]\n /** Tags several integrations may handle, each for its own values (Mirror's `MirrorRestored`, by name). */\n readonly shared?: readonly string[] | undefined\n /**\n * Folds a Message this integration handles; `None` for any other. A method, so\n * a wiring that routes only its own variants fits an assembly over the whole\n * application union.\n */\n route?(model: Model, message: Message): Option.Option<Update.Return<Model, Message, R>>\n /** Runs once when the application starts, after placements: a restore Command, a warm-up. */\n readonly init?: Update.Step<Model, Message, R> | undefined\n /** Applies the URL to the Model, at startup and whenever the URL changes. */\n readonly onUrl?: ((model: Model, url: Url) => Model) | undefined\n readonly subscriptions?: Subscriptions<Model, Message, R> | undefined\n readonly resources?:\n Readonly<Record<string, ManagedResourceEntry<Model, Message, any, any, any>>> | undefined\n /** Its Module contract; absent for wiring that owns and observes nothing. */\n readonly contract?: Contract | undefined\n}\n\n/** Contracts of one application, in declaration order. Data, not a runtime. */\nexport interface Module<\n Root,\n F extends Schema.Struct.Fields,\n Cases extends Record<string, Schema.Struct.Fields>,\n> {\n readonly app: AppScope<Root, F, Cases>\n readonly contracts: readonly Contract[]\n}\n\nexport interface Finding {\n readonly rule:\n | 'foreign-contract'\n | 'duplicate-name'\n | 'ownership-overlap'\n | 'message-claimed-twice'\n | 'unknown-path'\n | 'unknown-message'\n /** `kind:name` of each contract involved. */\n readonly contracts: readonly string[]\n readonly message: string\n}\n\n/** Who owns a Model path; `undefined` is local state. */\nexport interface Ownership {\n readonly path: readonly string[]\n readonly owner: { readonly kind: string; readonly name: string } | undefined\n}\n\nexport interface ModuleManifest {\n readonly fields: readonly string[]\n readonly messages: readonly string[]\n readonly ownership: readonly Ownership[]\n readonly contracts: readonly Omit<Contract, 'owner'>[]\n readonly findings: readonly Finding[]\n}\n\n/** A value `Module.make` accepts: a contract, a value carrying one, or a Surface without params. */\nexport type ModuleItem<Root> =\n Contract | { readonly contract: Contract } | Surface<Root, any, any, void>\n\nconst label = (contract: Contract): string => `${contract.kind}:${contract.name}`\n/** Metadata summaries are application data (a query's input), so they cannot break the table. */\nconst tableCell = (text: string): string =>\n text\n .replace(/\\\\/g, '\\\\\\\\')\n .replace(/\\|/g, '\\\\|')\n .replace(/\\r\\n?|\\n/g, ' ')\nconst pathKey = (path: readonly string[]): string => path.join('.')\nconst isPrefix = (prefix: readonly string[], path: readonly string[]): boolean =>\n prefix.length <= path.length && prefix.every((segment, index) => segment === path[index])\n\n// A carried contract wins: a sync contract also has a `projection` (writable, not a function).\nconst toContract = <Root>(item: ModuleItem<Root>): Contract =>\n 'contract' in item\n ? item.contract\n : 'projection' in item\n ? Surface.contract(item, undefined)\n : item\n\nconst applicationTags = (app: AppScope<any, any, any>): readonly string[] =>\n Object.entries(app.Message as unknown as Record<string, unknown>)\n .filter(([key, value]) => messageTag(value) === key)\n .map(([key]) => key)\n\n/** Contracts that own at least one path, with a stable label. */\nconst owners = (module: Module<any, any, any>) =>\n module.contracts.filter(contract => contract.owns.length > 0)\n\n/**\n * Collects an application's contracts as pure data so their relationships can\n * be validated and inspected without starting a runtime.\n *\n * ```ts\n * const Project = Module.make(App, [BoardSurface, ProjectSync, ProjectRemote, ProjectAgent])\n * Module.validate(Project) // findings, or []\n * Module.toMarkdown(Project)\n * ```\n */\nexport const Module = {\n make: <Root, F extends Schema.Struct.Fields, Cases extends Record<string, Schema.Struct.Fields>>(\n app: AppScope<Root, F, Cases>,\n items: readonly ModuleItem<Root>[] = [],\n ): Module<Root, F, Cases> => ({ app, contracts: items.map(toContract) }),\n\n /** A new Module with more contracts; the input is unchanged. */\n add: <Root, F extends Schema.Struct.Fields, Cases extends Record<string, Schema.Struct.Fields>>(\n module: Module<Root, F, Cases>,\n ...items: readonly ModuleItem<Root>[]\n ): Module<Root, F, Cases> => ({\n app: module.app,\n contracts: [...module.contracts, ...items.map(toContract)],\n }),\n\n /**\n * Cross-contract invariants the types cannot express: a contract from another\n * application, a duplicate `kind:name`, two owners of overlapping Model paths,\n * a Message recorded by two replication contracts, and a path or Message the\n * application does not declare.\n */\n validate: (module: Module<any, any, any>): readonly Finding[] => {\n const findings: Finding[] = []\n const fields = new Set(Object.keys(module.app.Model.fields))\n const tags = new Set(applicationTags(module.app))\n const seen = new Map<string, Contract>()\n\n for (const contract of module.contracts) {\n const name = label(contract)\n if (contract.owner !== undefined && contract.owner !== module.app.owner)\n findings.push({\n rule: 'foreign-contract',\n contracts: [name],\n message: `${name} belongs to a different application`,\n })\n const duplicate = seen.get(name)\n if (duplicate !== undefined && duplicate !== contract)\n findings.push({\n rule: 'duplicate-name',\n contracts: [name],\n message: `${name} is declared twice`,\n })\n seen.set(name, contract)\n for (const path of [...contract.owns, ...contract.observes]) {\n const head = path[0]\n if (head === undefined || !fields.has(head))\n findings.push({\n rule: 'unknown-path',\n contracts: [name],\n message: `${name} references \"${pathKey(path)}\", which is not a Model field`,\n })\n }\n for (const tag of contract.messages)\n if (!tags.has(tag))\n findings.push({\n rule: 'unknown-message',\n contracts: [name],\n message: `${name} names \"${tag}\", which is not a Message of this application`,\n })\n }\n\n // The same value listed twice is one owner, as `duplicate-name` treats it.\n const owning = [...new Set(owners(module))]\n for (let i = 0; i < owning.length; i += 1)\n for (let j = i + 1; j < owning.length; j += 1) {\n const a = owning[i]!\n const b = owning[j]!\n for (const pa of a.owns)\n for (const pb of b.owns)\n // An empty path is reported as `unknown-path`, not as owning everything.\n if (pa.length > 0 && pb.length > 0 && (isPrefix(pa, pb) || isPrefix(pb, pa)))\n findings.push({\n rule: 'ownership-overlap',\n contracts: [label(a), label(b)],\n message: `${label(a)} owns \"${pathKey(pa)}\" and ${label(b)} owns \"${pathKey(pb)}\"`,\n })\n }\n\n const recorded = new Map<string, Contract>()\n for (const contract of module.contracts.filter(contract => contract.kind === 'sync'))\n for (const tag of contract.messages) {\n const other = recorded.get(tag)\n if (other !== undefined && other !== contract)\n findings.push({\n rule: 'message-claimed-twice',\n contracts: [label(other), label(contract)],\n message: `\"${tag}\" is durable in both ${label(other)} and ${label(contract)}`,\n })\n else recorded.set(tag, contract)\n }\n\n return findings\n },\n\n /**\n * The application's fields and Messages, who owns each Model path (local when\n * no contract does), every contract, and the findings. Reproducible for a\n * given Module, so it can be committed and diffed.\n */\n manifest: (module: Module<any, any, any>): ModuleManifest => {\n const ownership: Ownership[] = []\n const owning = owners(module)\n for (const field of Object.keys(module.app.Model.fields)) {\n const claims = owning.flatMap(contract =>\n contract.owns\n .filter(path => path[0] === field)\n .map(path => ({ path, owner: { kind: contract.kind, name: contract.name } })),\n )\n const whole = claims.find(claim => claim.path.length === 1)\n if (whole !== undefined) ownership.push(whole)\n else {\n ownership.push({ path: [field], owner: undefined })\n ownership.push(...claims.sort((a, b) => pathKey(a.path).localeCompare(pathKey(b.path))))\n }\n }\n return {\n fields: Object.keys(module.app.Model.fields),\n messages: applicationTags(module.app),\n ownership,\n contracts: module.contracts.map(({ owner: _owner, ...rest }) => rest),\n findings: Module.validate(module),\n }\n },\n\n /** The manifest as Markdown: the ownership tree, a table of contracts, and findings. */\n toMarkdown: (module: Module<any, any, any>): string => {\n const manifest = Module.manifest(module)\n const lines: string[] = ['```text', 'Model']\n const width = Math.max(0, ...manifest.ownership.map(row => pathKey(row.path).length))\n manifest.ownership.forEach((row, index) => {\n const last = index === manifest.ownership.length - 1\n const owner =\n row.owner === undefined ? 'LOCAL' : `${row.owner.kind.toUpperCase()} ${row.owner.name}`\n lines.push(`${last ? '└── ' : '├── '}${pathKey(row.path).padEnd(width)} ${owner}`)\n })\n lines.push(\n '```',\n '',\n '| Contract | Owns | Observes | Messages | Metadata |',\n '| --- | --- | --- | --- | --- |',\n )\n for (const contract of manifest.contracts)\n lines.push(\n `| ${contract.kind}:${contract.name} | ${contract.owns.map(pathKey).join(', ')} | ${contract.observes.map(pathKey).join(', ')} | ${contract.messages.join(', ')} | ${tableCell(contract.metadata.map(summary => `${summary.name}: ${summary.entries.join(', ')}`).join('; '))} |`,\n )\n if (manifest.findings.length > 0) {\n lines.push('', '## Findings', '')\n for (const finding of manifest.findings)\n lines.push(`- **${finding.rule}** ${finding.message}`)\n }\n return lines.join('\\n')\n },\n\n /**\n * The manifest as a Mermaid flowchart: Model fields in a subgraph, one node\n * per contract, a solid edge for ownership and a dotted edge for observation.\n */\n toMermaid: (module: Module<any, any, any>): string => {\n const manifest = Module.manifest(module)\n const lines = ['flowchart LR', ' subgraph Model']\n manifest.fields.forEach((field, index) => lines.push(` f${index}[\"${field}\"]`))\n lines.push(' end')\n // A path outside the Model (reported by `validate`) draws no edge.\n const fieldId = (path: readonly string[]): string | undefined => {\n const index = path.length === 0 ? -1 : manifest.fields.indexOf(path[0]!)\n return index < 0 ? undefined : `f${index}`\n }\n manifest.contracts.forEach((contract, index) => {\n lines.push(` c${index}[\"${contract.kind}:${contract.name}\"]`)\n for (const path of contract.owns) {\n const field = fieldId(path)\n if (field !== undefined) lines.push(` c${index} -->|owns| ${field}`)\n }\n for (const path of contract.observes) {\n const field = fieldId(path)\n if (field !== undefined && !contract.owns.some(owned => pathKey(owned) === pathKey(path)))\n lines.push(` c${index} -.-> ${field}`)\n }\n })\n return lines.join('\\n')\n },\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "foldkit-surface",
3
- "version": "0.4.1",
3
+ "version": "0.5.1",
4
4
  "description": "Typed observation and capability boundaries for Foldkit: ModelRef, Projection, and Surface.",
5
5
  "keywords": [
6
6
  "foldkit",
@@ -28,6 +28,7 @@
28
28
  "sideEffects": false,
29
29
  "exports": {
30
30
  ".": {
31
+ "foldkit-plus:source": "./src/index.ts",
31
32
  "types": "./dist/index.d.mts",
32
33
  "import": "./dist/index.mjs"
33
34
  }
@@ -41,12 +42,13 @@
41
42
  "foldkit-metadata": "0.1.0"
42
43
  },
43
44
  "peerDependencies": {
44
- "effect": "^4.0.0-rc.112",
45
- "foldkit": "^0.158.2"
45
+ "effect": ">=4.0.0-rc.116 <4.0.0-rc.118",
46
+ "foldkit": "^0.163.0"
46
47
  },
47
48
  "devDependencies": {
48
- "effect": "4.0.0-rc.112",
49
- "foldkit": "0.158.2",
49
+ "@effect/platform-browser": "4.0.0-rc.116",
50
+ "effect": "4.0.0-rc.116",
51
+ "foldkit": "0.163.0",
50
52
  "tsdown": "^0.23.0",
51
53
  "typescript": "5.9.3"
52
54
  },