foldkit-surface 0.10.2 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","names":["Metadata","MetadataSummary","ManagedResourceEntry"],"sources":["../src/index.ts"],"mappings":"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"}
@@ -1,6 +1,7 @@
1
1
  import { Optic, Option, Predicate, Result, Schema } from "effect";
2
2
  import { Metadata, Metadata as Metadata$1, MetadataTypeId } from "foldkit-metadata";
3
- //#region src/index.ts
3
+ import { Diagnostics } from "./diagnostics.js";
4
+ // src/index.ts
4
5
  /**
5
6
  * `foldkit-surface` — the observation boundary for a Foldkit application.
6
7
  *
@@ -14,39 +15,37 @@ import { Metadata, Metadata as Metadata$1, MetadataTypeId } from "foldkit-metada
14
15
  * `test/inference.test-d.ts`.
15
16
  */
16
17
  /**
17
- * Low-level escape hatch for a focus with no Model path of its own. Prefer the
18
- * `App.model` tree; use this for an optic that is not part of the Model.
18
+ * The key a ref keeps its own members under; read them with `ModelRef.focus`.
19
+ * A ref's string keys are the Model's fields, whatever their names (#331),
20
+ * and no Schema field reaches a symbol. `Symbol.for`, so two copies of this
21
+ * package read each other's refs.
19
22
  */
20
- const ModelRef = { fromOptic: (Schema, optic, dependency = []) => {
21
- const get = (root) => Result.getOrThrow(optic.getResult(root));
22
- const set = (root, value) => optic.replace(value, root);
23
- return {
24
- Schema,
25
- optic,
26
- dependency,
27
- get,
28
- set,
29
- modify: (root, fn) => set(root, fn(get(root)))
30
- };
31
- } };
32
- /**
33
- * Names that belong to the ModelRef surface. A Struct field with one of these
34
- * names would silently shadow a method, so building the tree rejects it.
35
- */
36
- const RESERVED_REF_NAMES = /* @__PURE__ */ new Set([
37
- "Schema",
38
- "optic",
39
- "dependency",
40
- "key",
41
- "read",
42
- "get",
43
- "set",
44
- "at",
45
- "index",
46
- "select"
47
- ]);
23
+ const RefTypeId = Symbol.for("foldkit-surface/ModelRef");
24
+ const makeFocus = (Schema, optic, dependency, get, set) => ({
25
+ Schema,
26
+ optic,
27
+ dependency,
28
+ get,
29
+ set,
30
+ modify: (root, fn) => set(root, fn(get(root)))
31
+ });
32
+ const ModelRef = {
33
+ /**
34
+ * Low-level escape hatch for a focus with no Model path of its own. Prefer
35
+ * the `App.model` tree; use this for an optic that is not part of the Model.
36
+ */
37
+ fromOptic: (Schema, optic, dependency = []) => ({ [RefTypeId]: makeFocus(Schema, optic, dependency, (root) => Result.getOrThrow(optic.getResult(root)), (root, value) => optic.replace(value, root)) }),
38
+ /**
39
+ * A ref's own members: where it points, how to read and write it, and, as
40
+ * its value allows, `at` (a record), `index` (an array) and `select`. They
41
+ * are kept apart from the ref's string keys, which are the Model's fields.
42
+ */
43
+ focus: (ref) => ref[RefTypeId],
44
+ /** Whether a value is a ref, as opposed to a Projection or a plain object. */
45
+ is: (value) => typeof value === "object" && value !== null && RefTypeId in value
46
+ };
48
47
  function propertyReader(root, key) {
49
- return root === null || root === void 0 ? void 0 : root[key];
48
+ return root === null || root === void 0 || !Object.hasOwn(root, key) ? void 0 : root[key];
50
49
  }
51
50
  function optionalReader(value) {
52
51
  return value === void 0 ? Option.none() : Option.some(value);
@@ -63,22 +62,20 @@ const messageTags = (surface) => surface.messages.map(messageTag).filter((tag) =
63
62
  function makeTree(schema, path, optic, get, optional = false, set, owner) {
64
63
  const erasedOptic = optic;
65
64
  const setFocus = set ?? ((root, value) => optic.replace(value, root));
66
- const node = {
67
- Schema: schema,
68
- optic,
69
- dependency: path,
65
+ const focus = {
66
+ ...makeFocus(schema, optic, path, get, setFocus),
70
67
  key: path[path.length - 1] ?? "",
71
- owner,
72
- get,
73
- set: setFocus,
74
- modify: (root, fn) => setFocus(root, fn(get(root)))
68
+ owner
75
69
  };
70
+ const node = { [RefTypeId]: focus };
76
71
  const fields = schema.fields;
77
- if (fields !== void 0) for (const key of Object.keys(fields)) {
78
- if (RESERVED_REF_NAMES.has(key)) throw new Error(`Model field "${key}" is reserved by ModelRef`);
79
- node[key] = makeTree(fields[key], [...path, key], erasedOptic.key(key), (root) => propertyReader(get(root), key), false, void 0, owner);
80
- }
81
- node.at = (key) => makeTree(schema, [...path, key], erasedOptic.at(key), (root) => optionalReader(propertyReader(get(root), key)), true, (root, value) => {
72
+ if (fields !== void 0) for (const key of Object.keys(fields)) Object.defineProperty(node, key, {
73
+ value: makeTree(fields[key], [...path, key], erasedOptic.key(key), (root) => propertyReader(get(root), key), false, void 0, owner),
74
+ enumerable: true,
75
+ writable: true,
76
+ configurable: true
77
+ });
78
+ focus.at = (key) => makeTree(schema, [...path, key], erasedOptic.at(key), (root) => optionalReader(propertyReader(get(root), key)), true, (root, value) => {
82
79
  const container = get(root);
83
80
  const option = value;
84
81
  if (Option.isSome(option)) return setFocus(root, {
@@ -88,13 +85,13 @@ function makeTree(schema, path, optic, get, optional = false, set, owner) {
88
85
  const { [key]: _removed, ...rest } = container;
89
86
  return setFocus(root, rest);
90
87
  }, owner);
91
- node.index = (index) => makeTree(schema, [...path, String(index)], optic, (root) => optionalReader(Array.isArray(get(root)) ? get(root)[index] : void 0), true, (root, value) => {
88
+ focus.index = (index) => makeTree(schema, [...path, String(index)], optic, (root) => optionalReader(Array.isArray(get(root)) ? get(root)[index] : void 0), true, (root, value) => {
92
89
  const array = Array.isArray(get(root)) ? get(root) : [];
93
90
  const option = value;
94
91
  const next = Option.isSome(option) ? array.map((item, i) => i === index ? option.value : item) : array.filter((_, i) => i !== index);
95
92
  return setFocus(root, next);
96
93
  }, owner);
97
- node.select = (projection) => {
94
+ focus.select = (projection) => {
98
95
  const dependencies = mergeDependencies([path, ...projection.dependencies]);
99
96
  return optional ? makeProjection(Schema.Option(projection.Model), dependencies, (root) => Option.map(get(root), (value) => projection.read(value)), projection.metadata) : makeProjection(projection.Model, dependencies, (root) => projection.read(get(root)), projection.metadata);
100
97
  };
@@ -128,48 +125,77 @@ function makeProjection(Model, dependencies, read, metadata = Metadata$1.empty)
128
125
  function objectSchema(fields) {
129
126
  return Object.keys(fields).length === 0 ? Schema.Record(Schema.String, Schema.Never) : Schema.Struct(fields);
130
127
  }
128
+ const readsUnnamed = /* @__PURE__ */ new WeakSet();
129
+ const unnamed = (entry) => entry.dependencies.length === 0 || readsUnnamed.has(entry);
130
+ const markedBy = (composed, parts) => {
131
+ if (parts.some(unnamed)) readsUnnamed.add(composed);
132
+ return composed;
133
+ };
134
+ const valueAt = (root, path) => {
135
+ let value = root;
136
+ for (const key of path) {
137
+ if (typeof value !== "object" || value === null) return void 0;
138
+ value = value[key];
139
+ }
140
+ return value;
141
+ };
142
+ const keepAlike = (before, value) => sameFields(before, value) ? before : value;
143
+ const sameFields = (left, right) => {
144
+ if (Object.is(left, right)) return true;
145
+ if (typeof left !== "object" || typeof right !== "object" || left === null || right === null) return false;
146
+ const prototype = Object.getPrototypeOf(left);
147
+ if (!(prototype === Object.prototype || prototype === null || Array.isArray(left)) || Object.getPrototypeOf(right) !== prototype) return false;
148
+ const keys = Object.keys(left);
149
+ return keys.length === Object.keys(right).length && keys.every((key) => Object.hasOwn(right, key) && Object.is(left[key], right[key]));
150
+ };
131
151
  const Projection = {
132
152
  of: (schema) => (selection) => {
133
- const picked = {};
153
+ const picked = Object.create(null);
134
154
  const dependencies = [];
135
155
  const metadata = [];
156
+ const parts = [];
136
157
  const readers = [];
137
158
  for (const key of Object.keys(selection)) {
138
159
  const choice = selection[key];
139
160
  if (choice === true) {
140
161
  picked[key] = schema.fields[key];
162
+ parts.push({ dependencies: [] });
141
163
  readers.push([key, (root) => propertyReader(root, key)]);
142
164
  } else {
143
165
  const nested = choice;
144
166
  picked[key] = nested.Model;
145
167
  dependencies.push(...nested.dependencies);
146
168
  metadata.push(nested.metadata);
169
+ parts.push(nested);
147
170
  readers.push([key, (root) => nested.read(propertyReader(root, key))]);
148
171
  }
149
172
  }
150
173
  const read = (root) => {
151
- const out = {};
174
+ const out = Object.create(null);
152
175
  for (const [key, reader] of readers) out[key] = reader(root);
153
176
  return out;
154
177
  };
155
- return makeProjection(objectSchema(picked), mergeDependencies(dependencies), read, Metadata$1.combine(metadata));
178
+ return markedBy(makeProjection(objectSchema(picked), mergeDependencies(dependencies), read, Metadata$1.combine(metadata)), parts);
156
179
  },
157
180
  struct: (entries) => {
158
181
  const picked = Object.create(null);
159
182
  const dependencies = [];
160
183
  const metadata = [];
184
+ const nesteds = [];
161
185
  const readers = [];
162
186
  for (const key of Object.keys(entries)) {
163
187
  const entry = entries[key];
164
- if ("dependencies" in entry) {
188
+ if (ModelRef.is(entry)) {
189
+ const focus = entry[RefTypeId];
190
+ picked[key] = focus.Schema;
191
+ dependencies.push(focus.dependency);
192
+ readers.push([key, focus.get]);
193
+ } else {
165
194
  picked[key] = entry.Model;
166
195
  dependencies.push(...entry.dependencies);
167
196
  metadata.push(entry.metadata);
197
+ nesteds.push(entry);
168
198
  readers.push([key, entry.read]);
169
- } else {
170
- picked[key] = entry.Schema;
171
- dependencies.push(entry.dependency);
172
- readers.push([key, entry.get]);
173
199
  }
174
200
  }
175
201
  const read = (root) => {
@@ -177,26 +203,26 @@ const Projection = {
177
203
  for (const [key, reader] of readers) out[key] = reader(root);
178
204
  return out;
179
205
  };
180
- return makeProjection(objectSchema(picked), mergeDependencies(dependencies), read, Metadata$1.combine(metadata));
206
+ return markedBy(makeProjection(objectSchema(picked), mergeDependencies(dependencies), read, Metadata$1.combine(metadata)), nesteds);
181
207
  },
182
208
  /**
183
209
  * Maps a Projection over an array: `array(p): Projection<ReadonlyArray<Root>,
184
210
  * ReadonlyArray<Value>>`. Nesting is explicit (an array of arrays stays an
185
211
  * array of arrays); there is no flatten or double-wrap.
186
212
  */
187
- array: (projection) => ({
213
+ array: (projection) => markedBy({
188
214
  Model: Schema.Array(projection.Model),
189
215
  dependencies: projection.dependencies,
190
216
  metadata: projection.metadata,
191
217
  read: (root) => root.map((value) => projection.read(value))
192
- }),
218
+ }, [projection]),
193
219
  /** Maps a Projection inside an Option, preserving absence. */
194
- option: (projection) => ({
220
+ option: (projection) => markedBy({
195
221
  Model: Schema.Option(projection.Model),
196
222
  dependencies: projection.dependencies,
197
223
  metadata: projection.metadata,
198
224
  read: (root) => Option.map(root, (value) => projection.read(value))
199
- }),
225
+ }, [projection]),
200
226
  read: (projection, root) => projection.read(root),
201
227
  /**
202
228
  * Low-level escape hatch: a Projection from a Schema and a reader, for
@@ -210,6 +236,48 @@ const Projection = {
210
236
  read
211
237
  }),
212
238
  /**
239
+ * A value worked out from the Model, and worked out again only when a value
240
+ * at a path it reads is a new object: the value counterpart of
241
+ * `foldkit-mixins`' `SlotView.region`, and what a region can be drawn from.
242
+ * `on` names what `derive` reads, as field references or Projections;
243
+ * `derive` must read nothing else, or it shows what it read last. While
244
+ * something in `on` reads what no path of its names (a Remote read, alone or
245
+ * inside a `struct`), the value is worked out on every read. A result with
246
+ * the same fields as the last, shallowly, gives the last back, so a memo
247
+ * keyed on it holds. It keeps one result: the one for the last Model it was
248
+ * given.
249
+ *
250
+ * @example
251
+ * ```ts
252
+ * const shown = Projection.derive([App.model.todos, App.model.filter], (model: Model) =>
253
+ * model.todos.filter(todo => model.filter === 'all' || todo.done === (model.filter === 'done')),
254
+ * )
255
+ * // In the view: shown.read(model)
256
+ * ```
257
+ */
258
+ derive: (on, derive) => {
259
+ if (on.length === 0) throw new Error("Projection.derive: it names nothing it reads, so nothing could tell it to work the value out again. Name field references, or Projections built from them.");
260
+ const parts = on.map((entry) => RefTypeId in entry ? { dependencies: [entry[RefTypeId].dependency] } : entry);
261
+ const dependencies = mergeDependencies(parts.flatMap((part) => part.dependencies));
262
+ const always = parts.some(unnamed);
263
+ let last;
264
+ const derived = {
265
+ dependencies,
266
+ read: (root) => {
267
+ const values = dependencies.map((path) => valueAt(root, path));
268
+ const before = last;
269
+ const value = before === void 0 ? derive(root) : !always && values.every((value, index) => Object.is(value, before.values[index])) ? before.value : keepAlike(before.value, derive(root));
270
+ last = {
271
+ values,
272
+ value
273
+ };
274
+ return value;
275
+ }
276
+ };
277
+ if (always) readsUnnamed.add(derived);
278
+ return derived;
279
+ },
280
+ /**
213
281
  * Derives a writable projection from generated Model field references:
214
282
  * `Projection.pick(App.model.todos, App.model.selectedTodoId)` infers
215
283
  * `{ todos, selectedTodoId }` and its codec. Every reference must share one
@@ -217,35 +285,35 @@ const Projection = {
217
285
  * identical members deduplicate; a conflicting definition throws.
218
286
  */
219
287
  pick: (...refs) => {
220
- const selected = [...refs];
288
+ const selected = refs.map((ref) => ref[RefTypeId]);
221
289
  const owner = selected[0]?.owner;
222
- for (const ref of selected) if (ref.owner !== owner) throw new Error("Projection.pick: references from different applications");
223
- const fields = {};
224
- const paths = {};
225
- for (const ref of [...selected]) {
226
- const path = ref.dependency.join(".");
227
- const existing = paths[ref.key];
290
+ for (const focus of selected) if (focus.owner !== owner) throw new Error("Projection.pick: references from different applications");
291
+ const fields = Object.create(null);
292
+ const paths = Object.create(null);
293
+ for (const focus of [...selected]) {
294
+ const path = focus.dependency.join(".");
295
+ const existing = paths[focus.key];
228
296
  if (existing !== void 0) {
229
297
  if (existing === path) {
230
- selected.splice(selected.indexOf(ref), 1);
298
+ selected.splice(selected.indexOf(focus), 1);
231
299
  continue;
232
300
  }
233
- throw new Error(`Projection.pick: "${existing}" and "${path}" would both be read as "${ref.key}". Pick them in separate projections.`);
301
+ throw new Error(`Projection.pick: "${existing}" and "${path}" would both be read as "${focus.key}". Pick them in separate projections.`);
234
302
  }
235
- paths[ref.key] = path;
236
- fields[ref.key] = ref.Schema;
303
+ paths[focus.key] = path;
304
+ fields[focus.key] = focus.Schema;
237
305
  }
238
306
  return {
239
307
  schema: objectSchema(fields),
240
- dependencies: mergeDependencies(selected.map((ref) => ref.dependency)),
308
+ dependencies: mergeDependencies(selected.map((focus) => focus.dependency)),
241
309
  get: (model) => {
242
- const out = {};
243
- for (const ref of selected) out[ref.key] = ref.get(model);
310
+ const out = Object.create(null);
311
+ for (const focus of selected) out[focus.key] = focus.get(model);
244
312
  return out;
245
313
  },
246
314
  set: (model, shared) => {
247
315
  let next = model;
248
- for (const ref of selected) next = ref.set(next, shared[ref.key]);
316
+ for (const focus of selected) next = focus.set(next, shared[focus.key]);
249
317
  return next;
250
318
  }
251
319
  };
@@ -258,8 +326,8 @@ const Projection = {
258
326
  */
259
327
  compose: (...projections) => {
260
328
  const parts = [...projections];
261
- const fields = {};
262
- const paths = {};
329
+ const fields = Object.create(null);
330
+ const paths = Object.create(null);
263
331
  const pathOf = (part, key) => part.dependencies.find((dependency) => dependency.at(-1) === key)?.join(".");
264
332
  for (const part of parts) for (const [key, codec] of Object.entries(part.schema.fields)) {
265
333
  const existing = fields[key];
@@ -277,7 +345,7 @@ const Projection = {
277
345
  schema: objectSchema(fields),
278
346
  dependencies: mergeDependencies(parts.flatMap((part) => [...part.dependencies])),
279
347
  get: (model) => {
280
- const out = {};
348
+ const out = Object.create(null);
281
349
  for (const part of parts) Object.assign(out, part.get(model));
282
350
  return out;
283
351
  },
@@ -449,8 +517,9 @@ const Surface = {
449
517
  when: (surface, place, tagged, params) => {
450
518
  const tag = messageTag(tagged);
451
519
  if (tag === void 0) throw new Error(`Surface.when: expected a tagged constructor for "${surface.name}", which is what names the case that activates it`);
520
+ const focus = place[RefTypeId];
452
521
  const paramsOf = (model) => {
453
- const value = place.get(model);
522
+ const value = focus.get(model);
454
523
  return Predicate.isTagged(value, tag) ? Option.some(params(value)) : Option.none();
455
524
  };
456
525
  return {
@@ -458,7 +527,7 @@ const Surface = {
458
527
  owner: surface.owner,
459
528
  messages: messageTags(surface),
460
529
  activation: {
461
- path: place.dependency,
530
+ path: focus.dependency,
462
531
  tag
463
532
  },
464
533
  projectionOf: (model) => Option.map(paramsOf(model), surface.projection),
@@ -526,10 +595,13 @@ const Surface = {
526
595
  */
527
596
  instances: (source, model) => source.instancesOf(model),
528
597
  make: (app, name, config) => {
529
- const projection = (params) => config.model({
530
- model: app.model,
531
- params
532
- });
598
+ const projection = (params) => {
599
+ if (params === void 0 && config.Params !== void 0 && !Schema.is(config.Params)(void 0)) throw new Error(`Surface "${name}" declares params, and was given none`);
600
+ return config.model({
601
+ model: app.model,
602
+ params
603
+ });
604
+ };
533
605
  return {
534
606
  name,
535
607
  owner: app.owner,
@@ -539,7 +611,7 @@ const Surface = {
539
611
  projection
540
612
  };
541
613
  },
542
- read: (surface, root, params) => surface.projection(params).read(root),
614
+ read: (surface, root, ...params) => surface.projection(params[0]).read(root),
543
615
  /**
544
616
  * Binds a renderer to a Surface's projected Model and Message set. A
545
617
  * type-level binder: the renderer already has this shape, but `Model` and
@@ -565,8 +637,8 @@ const Surface = {
565
637
  * A Surface as a `Contract` for `Module`: what it observes, requires, and may
566
638
  * emit. A parameterized Surface needs its `params` to build the projection.
567
639
  */
568
- contract: (surface, params) => {
569
- const projection = surface.projection(params);
640
+ contract: (surface, ...params) => {
641
+ const projection = surface.projection(params[0]);
570
642
  return {
571
643
  kind: "surface",
572
644
  name: surface.name,
@@ -581,8 +653,8 @@ const Surface = {
581
653
  * Pure introspection for DevTools: what a Surface observes (dependencies,
582
654
  * requirements) and what it may emit. No behavior change, no I/O.
583
655
  */
584
- inspect: (surface, params) => {
585
- const projection = surface.projection(params);
656
+ inspect: (surface, ...params) => {
657
+ const projection = surface.projection(params[0]);
586
658
  return {
587
659
  name: surface.name,
588
660
  dependencies: projection.dependencies,
@@ -760,7 +832,6 @@ const Module = {
760
832
  return lines.join("\n");
761
833
  }
762
834
  };
763
- //#endregion
764
- export { Action, MessageSet, Metadata, MetadataTypeId, ModelRef, Module, Projection, Surface };
835
+ export { Action, Diagnostics, MessageSet, Metadata, MetadataTypeId, ModelRef, Module, Projection, RefTypeId, Surface };
765
836
 
766
- //# sourceMappingURL=index.mjs.map
837
+ //# sourceMappingURL=index.js.map