foldkit-ssr 0.9.0 → 0.10.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.
Files changed (39) hide show
  1. package/README.md +315 -36
  2. package/dist/{client-F16QT0sc.d.ts → client-XnpTQZHw.d.ts} +15 -5
  3. package/dist/client-XnpTQZHw.d.ts.map +1 -0
  4. package/dist/client.d.ts +5 -5
  5. package/dist/client.js +126 -54
  6. package/dist/client.js.map +1 -1
  7. package/dist/context.d.ts +1 -1
  8. package/dist/context.js +12 -0
  9. package/dist/context.js.map +1 -1
  10. package/dist/diagnostics.d.ts +1 -1
  11. package/dist/index.d.ts +83 -23
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.js +174 -54
  14. package/dist/index.js.map +1 -1
  15. package/dist/keep.d.ts +34 -0
  16. package/dist/keep.d.ts.map +1 -0
  17. package/dist/keep.js +80 -0
  18. package/dist/keep.js.map +1 -0
  19. package/dist/{listen-zNd0IIAT.d.ts → listen-DaUPRKVR.d.ts} +4 -2
  20. package/dist/listen-DaUPRKVR.d.ts.map +1 -0
  21. package/dist/listen.d.ts +2 -2
  22. package/dist/listen.js +31 -23
  23. package/dist/listen.js.map +1 -1
  24. package/dist/{resumable-BWItJsxF.d.ts → resumable-BPN_qQHU.d.ts} +33 -12
  25. package/dist/resumable-BPN_qQHU.d.ts.map +1 -0
  26. package/dist/resumable.d.ts +2 -2
  27. package/dist/resumable.js +51 -8
  28. package/dist/resumable.js.map +1 -1
  29. package/dist/{shared-v1u-OEQI.d.ts → shared-DbupL3vO.d.ts} +20 -5
  30. package/dist/shared-DbupL3vO.d.ts.map +1 -0
  31. package/dist/shared.d.ts +2 -2
  32. package/dist/shared.js +25 -2
  33. package/dist/shared.js.map +1 -1
  34. package/dist/vite.d.ts +1 -1
  35. package/package.json +9 -9
  36. package/dist/client-F16QT0sc.d.ts.map +0 -1
  37. package/dist/listen-zNd0IIAT.d.ts.map +0 -1
  38. package/dist/resumable-BWItJsxF.d.ts.map +0 -1
  39. package/dist/shared-v1u-OEQI.d.ts.map +0 -1
package/dist/listen.js CHANGED
@@ -97,48 +97,56 @@ const modifiersOf = (event) => ({
97
97
  altKey: event.altKey,
98
98
  metaKey: event.metaKey
99
99
  });
100
- /** The Message a binding dispatches for this event: its own, with the hole filled. */
101
- const messageFor = (binding, event) => {
102
- if (binding.hole === void 0) return binding.message;
103
- const fill = (template) => {
104
- if (binding.event === "input" || binding.event === "change") {
105
- const [field] = binding.hole ?? [];
106
- return {
107
- ...template,
108
- [field ?? "value"]: inputValue(event.target)
109
- };
110
- }
111
- if (event instanceof KeyboardEvent) return {
112
- ...template,
113
- key: event.key,
114
- modifiers: modifiersOf(event)
115
- };
116
- return template;
117
- };
100
+ /** A binding's Message with its hole filled by `fill`, inside each placement wrapper's `message`. */
101
+ const filled = (binding, fill) => {
118
102
  const inside = (template, depth) => depth === 0 ? fill(template) : {
119
103
  ...template,
120
104
  message: inside(template.message, depth - 1)
121
105
  };
122
106
  return inside(binding.message, binding.depth ?? 0);
123
107
  };
108
+ /** The Message an `OnInput` or `OnChange` hole binding dispatches for a field holding `value`. */
109
+ const typedMessage = (binding, value) => filled(binding, (template) => {
110
+ const [field] = binding.hole ?? [];
111
+ return {
112
+ ...template,
113
+ [field ?? "value"]: value
114
+ };
115
+ });
116
+ /** The Message a binding dispatches for this event: its own, with the hole filled. */
117
+ const messageFor = (binding, event) => {
118
+ if (binding.hole === void 0) return binding.message;
119
+ if (binding.event === "input" || binding.event === "change") return typedMessage(binding, inputValue(event.target));
120
+ return filled(binding, (template) => event instanceof KeyboardEvent ? {
121
+ ...template,
122
+ key: event.key,
123
+ modifiers: modifiersOf(event)
124
+ } : template);
125
+ };
124
126
  /**
125
127
  * Listens at `root` for every event the bindings name, and answers each from
126
128
  * the markers. Returns what removes the listeners.
127
129
  */
128
130
  const listen = (root, options) => {
131
+ const markers = /* @__PURE__ */ new Map();
132
+ for (const element of [root, ...Array.from(root.querySelectorAll("*"))]) for (const name of element.getAttributeNames()) {
133
+ if (!name.startsWith("data-foldkit-plus-on-")) continue;
134
+ const held = markers.get(element) ?? /* @__PURE__ */ new Map();
135
+ held.set(name.slice(BINDING_ATTRIBUTE.length), element.getAttribute(name) ?? "");
136
+ markers.set(element, held);
137
+ }
129
138
  const events = new Set(options.bindings.map((binding) => binding.event));
130
139
  if (options.events !== void 0) for (const event of options.events) events.add(event);
131
- else for (const element of [root, ...Array.from(root.querySelectorAll("*"))]) for (const { name } of Array.from(element.attributes)) if (name.startsWith("data-foldkit-plus-on-")) events.add(name.slice(BINDING_ATTRIBUTE.length));
140
+ else for (const held of markers.values()) for (const event of held.keys()) events.add(event);
132
141
  const handler = (event) => {
133
142
  const type = event.type;
134
- const attribute = `${BINDING_ATTRIBUTE}${type}`;
135
143
  const messages = [];
136
144
  const path = event.bubbles ? event.composedPath() : [event.target];
137
145
  for (const node of path) {
138
146
  if (!(node instanceof Element)) continue;
139
- const tokens = node.getAttribute(attribute);
147
+ const tokens = markers.get(node)?.get(type);
140
148
  let stopped = false;
141
- if (tokens !== null) for (const token of tokens.split(" ")) {
149
+ if (tokens !== void 0) for (const token of tokens.split(" ")) {
142
150
  if (token === "*") {
143
151
  options.onAnswer({
144
152
  event,
@@ -174,6 +182,6 @@ const listen = (root, options) => {
174
182
  for (const type of events) root.removeEventListener(type, handler, true);
175
183
  };
176
184
  };
177
- export { decodeBindings, listen, readBindings };
185
+ export { decodeBindings, listen, readBindings, typedMessage };
178
186
 
179
187
  //# sourceMappingURL=listen.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"listen.js","names":[],"sources":["../src/listen.ts"],"sourcesContent":["/**\n * Delegated dispatch: the page answers an event from its markers, before the\n * application has booted.\n *\n * One capture-phase listener per event type sits at the root, so events that\n * do not bubble (`focus`, `blur`) are caught, and it runs before anything\n * Foldkit attaches later. On an event it walks from the target to the root\n * and, for every marker of that event on the way, collects each binding's\n * Message in order, the way Foldkit's own handler would dispatch it: a hole is\n * filled from the event, `OnClick`'s options are honoured, `OnSubmit`\n * prevents the default. A marker token the page could not name (`*`) means\n * the live page does something here the page cannot describe, so the walk\n * ends and the answer names that element.\n */\nimport { Predicate, Result, Schema } from 'effect'\nimport type { KeyboardModifiers } from 'foldkit/html'\nimport { BINDING_ATTRIBUTE, EVENT_OF, UNNAMED_HANDLER } from './resumable.js'\n\n/**\n * A binding as the envelope carries it: Foldkit's attribute (`OnSubmit`,\n * `OnBlur`), whose tag says what its handler does beside dispatching; the\n * Message, encoded through the application's Message Schema (for a hole, with\n * the hole filled by a placeholder); the fields the event fills, `depth`\n * placement wrappers down; and the attribute's options. Its ordinal is its\n * index.\n */\nexport interface EncodedBinding {\n readonly attribute: string\n readonly message: unknown\n readonly hole?: ReadonlyArray<string>\n readonly depth?: number\n readonly options?: unknown\n}\n\nconst isRecord = (value: unknown): value is Readonly<Record<string, unknown>> =>\n typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * The page's list of bindings, read as untrusted input: each entry checked,\n * and only its known keys kept, or the reason the list is refused. Checked by\n * hand rather than through a Schema, which at a thousand rows took most of a\n * frame for a shape this plain; the Message inside each entry is still decoded\n * through the application's Schema by `decodeBindings`.\n */\nexport const readBindings = (\n value: unknown,\n): Result.Result<ReadonlyArray<EncodedBinding>, string> => {\n if (!Array.isArray(value)) return Result.fail('the list is not an array')\n const out: Array<EncodedBinding> = []\n for (const [index, entry] of value.entries()) {\n if (!isRecord(entry)) return Result.fail(`entry ${index} is not an object`)\n if (typeof entry.attribute !== 'string') {\n return Result.fail(`entry ${index} has no attribute`)\n }\n if (!Object.hasOwn(entry, 'message')) return Result.fail(`entry ${index} has no message`)\n const { hole, depth } = entry\n if (\n hole !== undefined &&\n !(Array.isArray(hole) && hole.every(field => typeof field === 'string'))\n ) {\n return Result.fail(`entry ${index} has a hole that is not a list of fields`)\n }\n if (depth !== undefined && !(Number.isInteger(depth) && (depth as number) >= 0)) {\n return Result.fail(`entry ${index} has a depth that is not a count`)\n }\n out.push({\n attribute: entry.attribute,\n message: entry.message,\n ...(hole === undefined ? {} : { hole: hole as ReadonlyArray<string> }),\n ...(depth === undefined ? {} : { depth: depth as number }),\n ...(Object.hasOwn(entry, 'options') ? { options: entry.options } : {}),\n })\n }\n return Result.succeed(out)\n}\n\n/** A binding decoded from the page: its Message is one of the application's. */\nexport interface DecodedBinding {\n readonly attribute: string\n readonly event: string\n readonly message: unknown\n readonly hole?: ReadonlyArray<string> | undefined\n readonly depth?: number | undefined\n readonly options?: unknown\n}\n\n/**\n * The page's bindings, decoded through the application's Message Schema, and\n * every marker in `root` checked against them. A page whose markers name a\n * binding it does not carry, or whose entry is not one of the application's\n * Messages, is refused whole, with the reason.\n */\nexport const decodeBindings = (\n Message: Schema.Top | undefined,\n encoded: ReadonlyArray<EncodedBinding>,\n root: ParentNode,\n allowed: ReadonlySet<string>,\n): Result.Result<ReadonlyArray<DecodedBinding>, string> => {\n if (encoded.length > 0 && Message === undefined) {\n return Result.fail(\n 'the page has bindings and the plan has no Message Schema to decode them with',\n )\n }\n const decode =\n Message === undefined\n ? undefined\n : Schema.decodeUnknownResult(Message as Schema.Codec<unknown, unknown>)\n const bindings: Array<DecodedBinding> = []\n for (const [index, entry] of encoded.entries()) {\n const event = EVENT_OF[entry.attribute]\n if (event === undefined) {\n return Result.fail(\n `binding ${index} is for \"${entry.attribute}\", which is no event attribute`,\n )\n }\n const message = decode!(entry.message)\n if (Result.isFailure(message)) {\n return Result.fail(\n `binding ${index} does not decode as a Message: ${message.failure.message}`,\n )\n }\n const tag = Predicate.hasProperty(message.success, '_tag') ? message.success._tag : undefined\n if (typeof tag !== 'string' || !allowed.has(tag)) {\n return Result.fail(\n `binding ${index} dispatches ${typeof tag === 'string' ? tag : 'an untagged Message'}, which no active Surface lists in its messages`,\n )\n }\n bindings.push({\n attribute: entry.attribute,\n event,\n message: message.success,\n ...(entry.hole === undefined ? {} : { hole: entry.hole }),\n ...(entry.depth === undefined ? {} : { depth: entry.depth }),\n ...(entry.options === undefined ? {} : { options: entry.options }),\n })\n }\n for (const element of Array.from(root.querySelectorAll('*'))) {\n for (const attribute of element.getAttributeNames()) {\n if (!attribute.startsWith(BINDING_ATTRIBUTE)) continue\n for (const token of (element.getAttribute(attribute) ?? '').split(' ')) {\n if (token === UNNAMED_HANDLER) continue\n const ordinal = Number(token)\n if (!Number.isInteger(ordinal) || bindings[ordinal] === undefined) {\n return Result.fail(`the marker ${attribute}=\"${token}\" names no binding the page carries`)\n }\n }\n }\n }\n return Result.succeed(bindings)\n}\n\n/** A string property of the target, if it has one. */\nconst stringProperty = (target: EventTarget | null, name: string): string | undefined => {\n if (target === null || !(name in target)) return undefined\n const value: unknown = Reflect.get(target, name)\n return typeof value === 'string' ? value : undefined\n}\n\n/**\n * Foldkit's reading of an input's value (`inputEventValue`): any target's\n * string `value`, a custom element's included, else its `innerText`, else its\n * `textContent`.\n */\nconst inputValue = (target: EventTarget | null): string =>\n stringProperty(target, 'value') ??\n stringProperty(target, 'innerText') ??\n stringProperty(target, 'textContent') ??\n ''\n\nconst modifiersOf = (event: KeyboardEvent): KeyboardModifiers => ({\n shiftKey: event.shiftKey,\n ctrlKey: event.ctrlKey,\n altKey: event.altKey,\n metaKey: event.metaKey,\n})\n\n/** The Message a binding dispatches for this event: its own, with the hole filled. */\nconst messageFor = (binding: DecodedBinding, event: Event): unknown => {\n if (binding.hole === undefined) return binding.message\n const fill = (template: Readonly<Record<string, unknown>>): unknown => {\n if (binding.event === 'input' || binding.event === 'change') {\n const [field] = binding.hole ?? []\n return { ...template, [field ?? 'value']: inputValue(event.target) }\n }\n if (event instanceof KeyboardEvent) {\n return { ...template, key: event.key, modifiers: modifiersOf(event) }\n }\n return template\n }\n // The hole's fields sit inside each placement wrapper's `message`.\n const inside = (template: Readonly<Record<string, unknown>>, depth: number): unknown =>\n depth === 0\n ? fill(template)\n : {\n ...template,\n message: inside(template.message as Readonly<Record<string, unknown>>, depth - 1),\n }\n return inside(binding.message as Readonly<Record<string, unknown>>, binding.depth ?? 0)\n}\n\n/** What `OnClick` declares beside its Message. */\ninterface ClickOptions {\n readonly defaultAction?: 'Allow' | 'Prevent'\n readonly propagation?: 'Bubble' | 'Stop'\n readonly focusSelector?: string\n}\n\n/**\n * What the markers make of one event: the Messages its bindings dispatch, in\n * the order the live page would, and, when the walk met a handler the page\n * could not name, that element. An answer with `unnamed` is incomplete: the\n * live page would do more than its Messages say.\n */\nexport interface Answer {\n readonly event: Event\n readonly messages: ReadonlyArray<unknown>\n readonly unnamed?: Element | undefined\n}\n\nexport interface ListenOptions {\n readonly bindings: ReadonlyArray<DecodedBinding>\n readonly onAnswer: (answer: Answer) => void\n /**\n * Every event the page's markers name, as the envelope lists them. Given,\n * `listen` needs no pass over the page to find the events a marker names\n * with `*` alone; without it, it reads every element's attributes, which on\n * a large page is most of its cost.\n */\n readonly events?: Iterable<string> | undefined\n}\n\n/**\n * Listens at `root` for every event the bindings name, and answers each from\n * the markers. Returns what removes the listeners.\n */\nexport const listen = (root: Element, options: ListenOptions): (() => void) => {\n // The bindings name most events; a marker whose handlers the page could not\n // name is `*` alone, so the markers themselves say the rest.\n const events = new Set(options.bindings.map(binding => binding.event))\n if (options.events !== undefined) {\n for (const event of options.events) events.add(event)\n } else {\n for (const element of [root, ...Array.from(root.querySelectorAll('*'))]) {\n for (const { name } of Array.from(element.attributes)) {\n if (name.startsWith(BINDING_ATTRIBUTE)) events.add(name.slice(BINDING_ATTRIBUTE.length))\n }\n }\n }\n const handler = (event: Event) => {\n const type = event.type\n const attribute = `${BINDING_ATTRIBUTE}${type}`\n const messages: Array<unknown> = []\n // An event that does not bubble (`focus`, `blur`, `mouseenter`) reaches only\n // its target's own handlers on the live page, so only those answer it here.\n const path = event.bubbles ? event.composedPath() : [event.target]\n for (const node of path) {\n if (!(node instanceof Element)) continue\n const tokens = node.getAttribute(attribute)\n // Foldkit chains an element's handlers in one listener, so a Stop among\n // them keeps the event from other elements, not from its siblings.\n let stopped = false\n if (tokens !== null) {\n for (const token of tokens.split(' ')) {\n if (token === UNNAMED_HANDLER) {\n options.onAnswer({ event, messages, unnamed: node })\n return\n }\n const binding = options.bindings[Number(token)]\n if (binding === undefined) continue\n if (binding.attribute === 'OnSubmit') event.preventDefault()\n if (binding.attribute === 'OnClick') {\n const click = (binding.options ?? {}) as ClickOptions\n if (click.defaultAction === 'Prevent') event.preventDefault()\n if (click.propagation === 'Stop') event.stopPropagation()\n if (click.focusSelector !== undefined) {\n const focusTarget = document.querySelector(click.focusSelector)\n if (focusTarget instanceof HTMLElement) focusTarget.focus()\n }\n if (click.propagation === 'Stop') stopped = true\n }\n messages.push(messageFor(binding, event))\n }\n }\n if (stopped || node === root) break\n }\n options.onAnswer({ event, messages })\n }\n for (const type of events) root.addEventListener(type, handler, true)\n return () => {\n for (const type of events) root.removeEventListener(type, handler, true)\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"listen.js","names":[],"sources":["../src/listen.ts"],"sourcesContent":["/**\n * Delegated dispatch: the page answers an event from its markers, before the\n * application has booted.\n *\n * One capture-phase listener per event type sits at the root, so events that\n * do not bubble (`focus`, `blur`) are caught, and it runs before anything\n * Foldkit attaches later. On an event it walks from the target to the root\n * and, for every marker of that event on the way, collects each binding's\n * Message in order, the way Foldkit's own handler would dispatch it: a hole is\n * filled from the event, `OnClick`'s options are honoured, `OnSubmit`\n * prevents the default. A marker token the page could not name (`*`) means\n * the live page does something here the page cannot describe, so the walk\n * ends and the answer names that element.\n */\nimport { Predicate, Result, Schema } from 'effect'\nimport type { KeyboardModifiers } from 'foldkit/html'\nimport { BINDING_ATTRIBUTE, EVENT_OF, UNNAMED_HANDLER } from './resumable.js'\n\n/**\n * A binding as the envelope carries it: Foldkit's attribute (`OnSubmit`,\n * `OnBlur`), whose tag says what its handler does beside dispatching; the\n * Message, encoded through the application's Message Schema (for a hole, with\n * the hole filled by a placeholder); the fields the event fills, `depth`\n * placement wrappers down; and the attribute's options. Its ordinal is its\n * index.\n */\nexport interface EncodedBinding {\n readonly attribute: string\n readonly message: unknown\n readonly hole?: ReadonlyArray<string>\n readonly depth?: number\n readonly options?: unknown\n}\n\nconst isRecord = (value: unknown): value is Readonly<Record<string, unknown>> =>\n typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * The page's list of bindings, read as untrusted input: each entry checked,\n * and only its known keys kept, or the reason the list is refused. Checked by\n * hand rather than through a Schema, which at a thousand rows took most of a\n * frame for a shape this plain; the Message inside each entry is still decoded\n * through the application's Schema by `decodeBindings`.\n */\nexport const readBindings = (\n value: unknown,\n): Result.Result<ReadonlyArray<EncodedBinding>, string> => {\n if (!Array.isArray(value)) return Result.fail('the list is not an array')\n const out: Array<EncodedBinding> = []\n for (const [index, entry] of value.entries()) {\n if (!isRecord(entry)) return Result.fail(`entry ${index} is not an object`)\n if (typeof entry.attribute !== 'string') {\n return Result.fail(`entry ${index} has no attribute`)\n }\n if (!Object.hasOwn(entry, 'message')) return Result.fail(`entry ${index} has no message`)\n const { hole, depth } = entry\n if (\n hole !== undefined &&\n !(Array.isArray(hole) && hole.every(field => typeof field === 'string'))\n ) {\n return Result.fail(`entry ${index} has a hole that is not a list of fields`)\n }\n if (depth !== undefined && !(Number.isInteger(depth) && (depth as number) >= 0)) {\n return Result.fail(`entry ${index} has a depth that is not a count`)\n }\n out.push({\n attribute: entry.attribute,\n message: entry.message,\n ...(hole === undefined ? {} : { hole: hole as ReadonlyArray<string> }),\n ...(depth === undefined ? {} : { depth: depth as number }),\n ...(Object.hasOwn(entry, 'options') ? { options: entry.options } : {}),\n })\n }\n return Result.succeed(out)\n}\n\n/** A binding decoded from the page: its Message is one of the application's. */\nexport interface DecodedBinding {\n readonly attribute: string\n readonly event: string\n readonly message: unknown\n readonly hole?: ReadonlyArray<string> | undefined\n readonly depth?: number | undefined\n readonly options?: unknown\n}\n\n/**\n * The page's bindings, decoded through the application's Message Schema, and\n * every marker in `root` checked against them. A page whose markers name a\n * binding it does not carry, or whose entry is not one of the application's\n * Messages, is refused whole, with the reason.\n */\nexport const decodeBindings = (\n Message: Schema.Top | undefined,\n encoded: ReadonlyArray<EncodedBinding>,\n root: ParentNode,\n allowed: ReadonlySet<string>,\n): Result.Result<ReadonlyArray<DecodedBinding>, string> => {\n if (encoded.length > 0 && Message === undefined) {\n return Result.fail(\n 'the page has bindings and the plan has no Message Schema to decode them with',\n )\n }\n const decode =\n Message === undefined\n ? undefined\n : Schema.decodeUnknownResult(Message as Schema.Codec<unknown, unknown>)\n const bindings: Array<DecodedBinding> = []\n for (const [index, entry] of encoded.entries()) {\n const event = EVENT_OF[entry.attribute]\n if (event === undefined) {\n return Result.fail(\n `binding ${index} is for \"${entry.attribute}\", which is no event attribute`,\n )\n }\n const message = decode!(entry.message)\n if (Result.isFailure(message)) {\n return Result.fail(\n `binding ${index} does not decode as a Message: ${message.failure.message}`,\n )\n }\n const tag = Predicate.hasProperty(message.success, '_tag') ? message.success._tag : undefined\n if (typeof tag !== 'string' || !allowed.has(tag)) {\n return Result.fail(\n `binding ${index} dispatches ${typeof tag === 'string' ? tag : 'an untagged Message'}, which no active Surface lists in its messages`,\n )\n }\n bindings.push({\n attribute: entry.attribute,\n event,\n message: message.success,\n ...(entry.hole === undefined ? {} : { hole: entry.hole }),\n ...(entry.depth === undefined ? {} : { depth: entry.depth }),\n ...(entry.options === undefined ? {} : { options: entry.options }),\n })\n }\n for (const element of Array.from(root.querySelectorAll('*'))) {\n for (const attribute of element.getAttributeNames()) {\n if (!attribute.startsWith(BINDING_ATTRIBUTE)) continue\n for (const token of (element.getAttribute(attribute) ?? '').split(' ')) {\n if (token === UNNAMED_HANDLER) continue\n const ordinal = Number(token)\n if (!Number.isInteger(ordinal) || bindings[ordinal] === undefined) {\n return Result.fail(`the marker ${attribute}=\"${token}\" names no binding the page carries`)\n }\n }\n }\n }\n return Result.succeed(bindings)\n}\n\n/** A string property of the target, if it has one. */\nconst stringProperty = (target: EventTarget | null, name: string): string | undefined => {\n if (target === null || !(name in target)) return undefined\n const value: unknown = Reflect.get(target, name)\n return typeof value === 'string' ? value : undefined\n}\n\n/**\n * Foldkit's reading of an input's value (`inputEventValue`): any target's\n * string `value`, a custom element's included, else its `innerText`, else its\n * `textContent`.\n */\nconst inputValue = (target: EventTarget | null): string =>\n stringProperty(target, 'value') ??\n stringProperty(target, 'innerText') ??\n stringProperty(target, 'textContent') ??\n ''\n\nconst modifiersOf = (event: KeyboardEvent): KeyboardModifiers => ({\n shiftKey: event.shiftKey,\n ctrlKey: event.ctrlKey,\n altKey: event.altKey,\n metaKey: event.metaKey,\n})\n\n/** A binding's Message with its hole filled by `fill`, inside each placement wrapper's `message`. */\nconst filled = (\n binding: DecodedBinding,\n fill: (template: Readonly<Record<string, unknown>>) => unknown,\n): unknown => {\n const inside = (template: Readonly<Record<string, unknown>>, depth: number): unknown =>\n depth === 0\n ? fill(template)\n : {\n ...template,\n message: inside(template.message as Readonly<Record<string, unknown>>, depth - 1),\n }\n return inside(binding.message as Readonly<Record<string, unknown>>, binding.depth ?? 0)\n}\n\n/** The Message an `OnInput` or `OnChange` hole binding dispatches for a field holding `value`. */\nexport const typedMessage = (binding: DecodedBinding, value: string): unknown =>\n filled(binding, template => {\n const [field] = binding.hole ?? []\n return { ...template, [field ?? 'value']: value }\n })\n\n/** The Message a binding dispatches for this event: its own, with the hole filled. */\nconst messageFor = (binding: DecodedBinding, event: Event): unknown => {\n if (binding.hole === undefined) return binding.message\n if (binding.event === 'input' || binding.event === 'change') {\n return typedMessage(binding, inputValue(event.target))\n }\n return filled(binding, template =>\n event instanceof KeyboardEvent\n ? { ...template, key: event.key, modifiers: modifiersOf(event) }\n : template,\n )\n}\n\n/** What `OnClick` declares beside its Message. */\ninterface ClickOptions {\n readonly defaultAction?: 'Allow' | 'Prevent'\n readonly propagation?: 'Bubble' | 'Stop'\n readonly focusSelector?: string\n}\n\n/**\n * What the markers make of one event: the Messages its bindings dispatch, in\n * the order the live page would, and, when the walk met a handler the page\n * could not name, that element. An answer with `unnamed` is incomplete: the\n * live page would do more than its Messages say.\n */\nexport interface Answer {\n readonly event: Event\n readonly messages: ReadonlyArray<unknown>\n readonly unnamed?: Element | undefined\n}\n\nexport interface ListenOptions {\n readonly bindings: ReadonlyArray<DecodedBinding>\n readonly onAnswer: (answer: Answer) => void\n /**\n * Every event the page's markers name, as the envelope lists them. Given,\n * `listen` needs no pass over the page to find the events a marker names\n * with `*` alone; without it, it reads every element's attributes, which on\n * a large page is most of its cost.\n */\n readonly events?: Iterable<string> | undefined\n}\n\n/**\n * Listens at `root` for every event the bindings name, and answers each from\n * the markers. Returns what removes the listeners.\n */\nexport const listen = (root: Element, options: ListenOptions): (() => void) => {\n // The markers as served, read once: the boot takes them off the page before\n // Foldkit adopts it, and an event landing before the first render is still\n // answered from them.\n const markers = new Map<Element, Map<string, string>>()\n for (const element of [root, ...Array.from(root.querySelectorAll('*'))]) {\n for (const name of element.getAttributeNames()) {\n if (!name.startsWith(BINDING_ATTRIBUTE)) continue\n const held = markers.get(element) ?? new Map<string, string>()\n held.set(name.slice(BINDING_ATTRIBUTE.length), element.getAttribute(name) ?? '')\n markers.set(element, held)\n }\n }\n // The bindings name most events; a marker whose handlers the page could not\n // name is `*` alone, so the markers themselves say the rest.\n const events = new Set(options.bindings.map(binding => binding.event))\n if (options.events !== undefined) {\n for (const event of options.events) events.add(event)\n } else {\n for (const held of markers.values()) for (const event of held.keys()) events.add(event)\n }\n const handler = (event: Event) => {\n const type = event.type\n const messages: Array<unknown> = []\n // An event that does not bubble (`focus`, `blur`, `mouseenter`) reaches only\n // its target's own handlers on the live page, so only those answer it here.\n const path = event.bubbles ? event.composedPath() : [event.target]\n for (const node of path) {\n if (!(node instanceof Element)) continue\n const tokens = markers.get(node)?.get(type)\n // Foldkit chains an element's handlers in one listener, so a Stop among\n // them keeps the event from other elements, not from its siblings.\n let stopped = false\n if (tokens !== undefined) {\n for (const token of tokens.split(' ')) {\n if (token === UNNAMED_HANDLER) {\n options.onAnswer({ event, messages, unnamed: node })\n return\n }\n const binding = options.bindings[Number(token)]\n if (binding === undefined) continue\n if (binding.attribute === 'OnSubmit') event.preventDefault()\n if (binding.attribute === 'OnClick') {\n const click = (binding.options ?? {}) as ClickOptions\n if (click.defaultAction === 'Prevent') event.preventDefault()\n if (click.propagation === 'Stop') event.stopPropagation()\n if (click.focusSelector !== undefined) {\n const focusTarget = document.querySelector(click.focusSelector)\n if (focusTarget instanceof HTMLElement) focusTarget.focus()\n }\n if (click.propagation === 'Stop') stopped = true\n }\n messages.push(messageFor(binding, event))\n }\n }\n if (stopped || node === root) break\n }\n options.onAnswer({ event, messages })\n }\n for (const type of events) root.addEventListener(type, handler, true)\n return () => {\n for (const type of events) root.removeEventListener(type, handler, true)\n }\n}\n"],"mappings":"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"}
@@ -14,6 +14,13 @@ declare const UNNAMED_HANDLER = "*";
14
14
  declare const FALLBACK_FIELD = "foldkit-plus-message";
15
15
  /** The posted field that says how many placement wrappers the form's fields sit under. */
16
16
  declare const FALLBACK_DEPTH_FIELD = "foldkit-plus-depth";
17
+ /**
18
+ * The attribute on a field whose typing before boot is kept (`KeepTyped`),
19
+ * naming the binding whose Message replays it.
20
+ */
21
+ declare const KEEP_ATTRIBUTE = "data-foldkit-plus-keep";
22
+ /** The value of a `KeepTyped` marker no resumable element took, while the server renders. */
23
+ declare const UNPLACED_KEEP = "?";
17
24
  /** The attribute on a placement's root naming its slot, while the server renders. */
18
25
  declare const SLOT_ATTRIBUTE = "data-foldkit-plus-slot";
19
26
  declare const invalid: unique symbol;
@@ -37,15 +44,22 @@ type Rest<M, Fixed> = Omit<Made<M>, '_tag' | keyof Fixed>;
37
44
  type ProducesMessage<M, Message> = [Made<M>] extends [Message] ? unknown : Invalid<"the member is not one of this view's Messages">;
38
45
  type TextHoleCheck<M, Fixed> = [keyof Rest<M, Fixed>] extends [never] ? Invalid<'the member has no field left for the event to fill'> : true extends IsUnion<keyof Rest<M, Fixed>> ? Invalid<'the member leaves more than one field for the event to fill: fix the others'> : Rest<M, Fixed>[keyof Rest<M, Fixed>] extends string ? string extends Rest<M, Fixed>[keyof Rest<M, Fixed>] ? unknown : Invalid<'the field the event fills must be a string'> : Invalid<'the field the event fills must be a string'>;
39
46
  type KeyHoleCheck<M, Fixed> = [keyof Rest<M, Fixed>] extends ['key' | 'modifiers'] ? ['key' | 'modifiers'] extends [keyof Rest<M, Fixed>] ? unknown : Invalid<'the member must leave exactly key and modifiers for the event to fill'> : Invalid<'the member must leave exactly key and modifiers for the event to fill'>;
47
+ /**
48
+ * Foldkit's attribute of one tag, as its own builder returns it, so an
49
+ * element that refuses some attributes (a `textarea`, `InnerHTML`) takes it.
50
+ */
51
+ type Tagged<Message, Tag extends string> = Extract<Attribute<Message>, {
52
+ readonly _tag: Tag;
53
+ }>;
40
54
  /** `OnInput` and `OnChange`: a closure, or a member whose one string field the event fills. */
41
- interface TextHole<Message> {
42
- (toMessage: (value: string) => Message): Attribute<Message>;
43
- <M extends AnyMemberSchema, const Fixed extends Fixable<M> = {}>(member: M & ProducesMessage<M, Message> & TextHoleCheck<M, Fixed>, fixed?: Fixed): Attribute<Message>;
55
+ interface TextHole<Message, Tag extends string> {
56
+ (toMessage: (value: string) => Message): Tagged<Message, Tag>;
57
+ <M extends AnyMemberSchema, const Fixed extends Fixable<M> = {}>(member: M & ProducesMessage<M, Message> & TextHoleCheck<M, Fixed>, fixed?: Fixed): Tagged<Message, Tag>;
44
58
  }
45
59
  /** `OnKeyDown` and `OnKeyUp`: a closure, or a member whose `key` and `modifiers` the event fills. */
46
- interface KeyHole<Message> {
47
- (toMessage: (key: string, modifiers: KeyboardModifiers) => Message): Attribute<Message>;
48
- <M extends AnyMemberSchema, const Fixed extends Fixable<M> = {}>(member: M & ProducesMessage<M, Message> & KeyHoleCheck<M, Fixed>, fixed?: Fixed): Attribute<Message>;
60
+ interface KeyHole<Message, Tag extends string> {
61
+ (toMessage: (key: string, modifiers: KeyboardModifiers) => Message): Tagged<Message, Tag>;
62
+ <M extends AnyMemberSchema, const Fixed extends Fixable<M> = {}>(member: M & ProducesMessage<M, Message> & KeyHoleCheck<M, Fixed>, fixed?: Fixed): Tagged<Message, Tag>;
49
63
  }
50
64
  /**
51
65
  * A builder a view is given: Foldkit's `HtmlBuilder`, or a Surface renderer's,
@@ -66,10 +80,17 @@ type MessageOf<Builder> = Builder extends {
66
80
  * so a placement's view accepts it as the parent's builder.
67
81
  */
68
82
  type ResumableBuilder<Message> = Omit<HtmlBuilder<Message>, 'OnInput' | 'OnChange' | 'OnKeyDown' | 'OnKeyUp'> & {
69
- readonly OnInput: TextHole<Message>;
70
- readonly OnChange: TextHole<Message>;
71
- readonly OnKeyDown: KeyHole<Message>;
72
- readonly OnKeyUp: KeyHole<Message>;
83
+ readonly OnInput: TextHole<Message, 'OnInput'>;
84
+ readonly OnChange: TextHole<Message, 'OnChange'>;
85
+ readonly OnKeyDown: KeyHole<Message, 'OnKeyDown'>;
86
+ readonly OnKeyUp: KeyHole<Message, 'OnKeyUp'>;
87
+ /**
88
+ * Keeps what is typed into this field before the runtime starts: the
89
+ * browser replays it as the field's `OnInput` Message (else its
90
+ * `OnChange`), given in the hole form, and keeps the caret. The field must
91
+ * be an `input` that takes text, a `textarea` or a `select`.
92
+ */
93
+ readonly KeepTyped: () => Tagged<Message, 'Attribute'>;
73
94
  };
74
95
  /**
75
96
  * The resumable builder for a view's `h`. Use it in place of `h`; it has the
@@ -82,5 +103,5 @@ declare const builder: <Builder extends AnyBuilder>(h: Builder) => ResumableBuil
82
103
  * `SurfaceView.define`, or an application's own view.
83
104
  */
84
105
  declare const view: <Model, Builder extends AnyBuilder, Out>(render: (model: Model, rh: ResumableBuilder<MessageOf<Builder>>) => Out) => (model: Model, h: Builder) => Out;
85
- export { FALLBACK_FIELD as a, MessageOf as c, TextHole as d, UNNAMED_HANDLER as f, FALLBACK_DEPTH_FIELD as i, ResumableBuilder as l, view as m, BINDING_ATTRIBUTE as n, Invalid as o, builder as p, EVENT_OF as r, KeyHole as s, AnyBuilder as t, SLOT_ATTRIBUTE as u };
86
- //# sourceMappingURL=resumable-BWItJsxF.d.ts.map
106
+ export { FALLBACK_FIELD as a, KeyHole as c, SLOT_ATTRIBUTE as d, TextHole as f, view as g, builder as h, FALLBACK_DEPTH_FIELD as i, MessageOf as l, UNPLACED_KEEP as m, BINDING_ATTRIBUTE as n, Invalid as o, UNNAMED_HANDLER as p, EVENT_OF as r, KEEP_ATTRIBUTE as s, AnyBuilder as t, ResumableBuilder as u };
107
+ //# sourceMappingURL=resumable-BPN_qQHU.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resumable-BPN_qQHU.d.ts","names":[],"sources":["../src/resumable.ts"],"mappings":";;;cAoBa;;;;;;cAOA,UAAU,SAAS;;cAkGnB;;cAGA;;cAGA;;;;;cAMA;;cAGA;;cAkBA;cAEC;;UAGG,QAAQ;YACb,UAAU;;KAGjB,QAAQ,GAAG,IAAI,KAAK,sBAAsB,YAAY;;KAGtD,kBAAkB,OAAO;WAAiB,QAAQ,OAAO,OAAO;;;KAGhE,KAAK,KAAK;WAAqB,YAAY;IAAM;;KAGjD,QAAQ,KAAK,QAAQ,KAAK,KAAK;;KAG/B,KAAK,GAAG,SAAS,KAAK,KAAK,mBAAmB;KAE9C,gBAAgB,GAAG,YAAY,KAAK,aAAa,qBAElD;KAEC,cAAc,GAAG,gBAAgB,KAAK,GAAG,0BAC1C,6EACa,cAAc,KAAK,GAAG,UACjC,yFACA,KAAK,GAAG,aAAa,KAAK,GAAG,wCACZ,KAAK,GAAG,aAAa,KAAK,GAAG,oBAE1C,wDACF;KAEH,aAAa,GAAG,gBAAgB,KAAK,GAAG,6EACJ,KAAK,GAAG,oBAE3C,mFACF;;;;;KAMC,OAAO,SAAS,sBAAsB,QAAQ,UAAU;WAAqB,MAAM;;;UAGvE,SAAS,SAAS;GAChC,YAAY,kBAAkB,UAAU,OAAO,SAAS;GACxD,UAAU,uBAAuB,cAAc,QAAQ,SACtD,QAAQ,IAAI,gBAAgB,GAAG,WAAW,cAAc,GAAG,QAC3D,QAAQ,QACP,OAAO,SAAS;;;UAIJ,QAAQ,SAAS;GAC/B,YAAY,aAAa,WAAW,sBAAsB,UAAU,OAAO,SAAS;GACpF,UAAU,uBAAuB,cAAc,QAAQ,SACtD,QAAQ,IAAI,gBAAgB,GAAG,WAAW,aAAa,GAAG,QAC1D,QAAQ,QACP,OAAO,SAAS;;;;;;KAOT;WACD,UAAU,mBAAmB,MAAM;;;KAIlC,UAAU,WAAW;WACtB,UAAU,eAAe,YAAY,MAAM;IAElD;;;;;;;;KAUQ,iBAAiB,WAAW,KACtC,YAAY;WAGH,SAAS,SAAS;WAClB,UAAU,SAAS;WACnB,WAAW,QAAQ;WACnB,SAAS,QAAQ;;;;;;;WAOjB,iBAAiB,OAAO;;;;;;cA4DtB,UAAW,gBAAgB,YAAU,GAC7C,YACF,iBAAiB,UAAU;;;;;;cAsQjB,OACV,OAAO,gBAAgB,YAAY,KAAG,SAC5B,OAAO,OAAO,IAAI,iBAAiB,UAAU,cAAc,SAAG,OAEjE,OAAK,GAAK,YAAU"}
@@ -1,2 +1,2 @@
1
- import { a as FALLBACK_FIELD, c as MessageOf, d as TextHole, f as UNNAMED_HANDLER, i as FALLBACK_DEPTH_FIELD, l as ResumableBuilder, m as view, n as BINDING_ATTRIBUTE, o as Invalid, p as builder, r as EVENT_OF, s as KeyHole, t as AnyBuilder, u as SLOT_ATTRIBUTE } from "./resumable-BWItJsxF.js";
2
- export { AnyBuilder, BINDING_ATTRIBUTE, EVENT_OF, FALLBACK_DEPTH_FIELD, FALLBACK_FIELD, Invalid, KeyHole, MessageOf, ResumableBuilder, SLOT_ATTRIBUTE, TextHole, UNNAMED_HANDLER, builder, view };
1
+ import { a as FALLBACK_FIELD, c as KeyHole, d as SLOT_ATTRIBUTE, f as TextHole, g as view, h as builder, i as FALLBACK_DEPTH_FIELD, l as MessageOf, m as UNPLACED_KEEP, n as BINDING_ATTRIBUTE, o as Invalid, p as UNNAMED_HANDLER, r as EVENT_OF, s as KEEP_ATTRIBUTE, t as AnyBuilder, u as ResumableBuilder } from "./resumable-BPN_qQHU.js";
2
+ export { AnyBuilder, BINDING_ATTRIBUTE, EVENT_OF, FALLBACK_DEPTH_FIELD, FALLBACK_FIELD, Invalid, KEEP_ATTRIBUTE, KeyHole, MessageOf, ResumableBuilder, SLOT_ATTRIBUTE, TextHole, UNNAMED_HANDLER, UNPLACED_KEEP, builder, view };
package/dist/resumable.js CHANGED
@@ -124,6 +124,27 @@ const UNNAMED_HANDLER = "*";
124
124
  const FALLBACK_FIELD = "foldkit-plus-message";
125
125
  /** The posted field that says how many placement wrappers the form's fields sit under. */
126
126
  const FALLBACK_DEPTH_FIELD = "foldkit-plus-depth";
127
+ /**
128
+ * The attribute on a field whose typing before boot is kept (`KeepTyped`),
129
+ * naming the binding whose Message replays it.
130
+ */
131
+ const KEEP_ATTRIBUTE = "data-foldkit-plus-keep";
132
+ /** The value of a `KeepTyped` marker no resumable element took, while the server renders. */
133
+ const UNPLACED_KEEP = "?";
134
+ /**
135
+ * The `input` types whose value is not something typed, so `KeepTyped` has
136
+ * nothing to keep on them.
137
+ */
138
+ const UNTYPED_INPUTS = /* @__PURE__ */ new Set([
139
+ "checkbox",
140
+ "radio",
141
+ "file",
142
+ "hidden",
143
+ "button",
144
+ "submit",
145
+ "reset",
146
+ "image"
147
+ ]);
127
148
  /** The attribute on a placement's root naming its slot, while the server renders. */
128
149
  const SLOT_ATTRIBUTE = "data-foldkit-plus-slot";
129
150
  const isMember = (value) => typeof value === "function" && typeof value.fields === "object";
@@ -146,6 +167,8 @@ const NO_MODIFIERS = {
146
167
  const holes = /* @__PURE__ */ new WeakMap();
147
168
  const isAttribute = (item) => "_tag" in item;
148
169
  const builders = /* @__PURE__ */ new WeakMap();
170
+ /** Each attribute `KeepTyped` made: a request to the element it is given, never written as it is. */
171
+ const keeps = /* @__PURE__ */ new WeakSet();
149
172
  /** A hole form's placeholder Message, or `undefined` when its field's checks refuse one. */
150
173
  const placeholder = (make) => {
151
174
  try {
@@ -164,12 +187,15 @@ const builder = (h) => {
164
187
  const source = h;
165
188
  const attribute = source.Attribute;
166
189
  /** The attributes with a marker for each binding, while the server renders. */
167
- const mark = (tag, attributes) => {
190
+ const mark = (tag, given) => {
191
+ const kept = given.some((item) => keeps.has(item));
192
+ const attributes = kept ? given.filter((item) => !keeps.has(item)) : given;
168
193
  const now = current();
169
194
  if (now?.mode !== "collect" && now?.mode !== "replay") return attributes;
170
195
  const id = attributes.find((item) => isAttribute(item) && item._tag === "Id");
171
196
  const element = id === void 0 ? tag : `${tag}#${id.value}`;
172
197
  const tokens = /* @__PURE__ */ new Map();
198
+ const typed = /* @__PURE__ */ new Map();
173
199
  for (const item of attributes) {
174
200
  if (!isAttribute(item)) continue;
175
201
  const event = item._tag === "OnCustomEvent" ? item.name : EVENT_OF[item._tag];
@@ -204,20 +230,31 @@ const builder = (h) => {
204
230
  });
205
231
  list.push("*");
206
232
  } else {
233
+ if (binding.hole !== void 0 && !typed.has(binding.attribute)) typed.set(binding.attribute, now.bindings.length);
207
234
  list.push(String(now.bindings.length));
208
235
  now.bindings.push(binding);
209
236
  }
210
237
  }
211
- if (tokens.size === 0) return attributes;
212
238
  const markers = [...tokens].map(([event, list]) => attribute(`${BINDING_ATTRIBUTE}${event}`, list.join(" ")));
213
- return [...attributes, ...markers];
239
+ if (kept) {
240
+ const ordinal = typed.get("OnInput") ?? typed.get("OnChange");
241
+ const type = attributes.find((item) => isAttribute(item) && item._tag === "Type")?.value;
242
+ if (!(tag === "textarea" || tag === "select" || tag === "input" && (type === void 0 || !UNTYPED_INPUTS.has(type.toLowerCase())))) {
243
+ if (now.mode === "collect") now.unkeepable.push(`KeepTyped on ${type === void 0 ? element : `${element} of type ${type}`}, which holds no typed value: keep an input that takes text, a textarea or a select`);
244
+ } else if (ordinal === void 0) {
245
+ if (now.mode === "collect") now.unkeepable.push(`KeepTyped on ${element}, which has no OnInput or OnChange given a Message member, so nothing names the Message its typing replays as`);
246
+ } else markers.push(attribute(KEEP_ATTRIBUTE, String(ordinal)));
247
+ }
248
+ return markers.length === 0 ? attributes : [...attributes, ...markers];
214
249
  };
215
250
  /**
216
251
  * A form whose `OnSubmit` names a Message, while the server renders for a
217
252
  * plan with a fallback, also posts that Message: `method="post"` to its own
218
253
  * URL, and a hidden input carrying the Message encoded. Posted fields named
219
254
  * as the Message's own fields override them, so a typed title reaches
220
- * `update` as it would through the page.
255
+ * `update` as it would through the page. A form given its own `Method` is
256
+ * the view's, left as drawn: a search is a GET of the address the URL
257
+ * mirror reads, and posts no Message.
221
258
  */
222
259
  const fallback = (tag, attributes, children) => {
223
260
  const now = current();
@@ -226,7 +263,8 @@ const builder = (h) => {
226
263
  children
227
264
  };
228
265
  const submit = attributes.find((item) => isAttribute(item) && item._tag === "OnSubmit");
229
- if (submit === void 0 || !Array.isArray(children)) return {
266
+ const method = attributes.some((item) => isAttribute(item) && item._tag === "Method");
267
+ if (submit === void 0 || method || !Array.isArray(children)) return {
230
268
  attributes,
231
269
  children
232
270
  };
@@ -294,8 +332,8 @@ const builder = (h) => {
294
332
  };
295
333
  /**
296
334
  * `h.submodel` with the child's root stamped with its slot, while the
297
- * server renders: a boundary a tool can find, which the browser's first
298
- * patch removes as it removes the markers.
335
+ * server renders: a boundary a tool can find, which the browser takes off
336
+ * as the page boots, with the markers.
299
337
  */
300
338
  const submodel = (config) => {
301
339
  const original = source.submodel;
@@ -344,6 +382,11 @@ const builder = (h) => {
344
382
  return element(mark(name, posted.attributes), posted.children, ...rest.slice(1));
345
383
  };
346
384
  } else wrapped[name] = value;
385
+ wrapped.KeepTyped = () => {
386
+ const made = attribute(KEEP_ATTRIBUTE, current()?.mode === "collect" ? "?" : "");
387
+ keeps.add(made);
388
+ return made;
389
+ };
347
390
  builders.set(h, wrapped);
348
391
  return wrapped;
349
392
  };
@@ -353,6 +396,6 @@ const builder = (h) => {
353
396
  * `SurfaceView.define`, or an application's own view.
354
397
  */
355
398
  const view = (render) => (model, h) => render(model, builder(h));
356
- export { BINDING_ATTRIBUTE, EVENT_OF, FALLBACK_DEPTH_FIELD, FALLBACK_FIELD, SLOT_ATTRIBUTE, UNNAMED_HANDLER, builder, view };
399
+ export { BINDING_ATTRIBUTE, EVENT_OF, FALLBACK_DEPTH_FIELD, FALLBACK_FIELD, KEEP_ATTRIBUTE, SLOT_ATTRIBUTE, UNNAMED_HANDLER, UNPLACED_KEEP, builder, view };
357
400
 
358
401
  //# sourceMappingURL=resumable.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"resumable.js","names":[],"sources":["../src/resumable.ts"],"sourcesContent":["/**\n * The resumable builder: the application's `h`, whose event attributes say, in\n * the server's markup, which Message each element causes.\n *\n * A Foldkit handler is a Message value (`h.OnClick(Message.Liked({ id }))`), so\n * for most events that is already data. The events that carry a value\n * (`OnInput`, `OnChange`, `OnKeyDown`, `OnKeyUp`) take a closure only to put\n * the value into a Message field; this builder also takes the Message's own\n * constructor there, a Message with a hole, and fills the hole the same way.\n *\n * During the server's renders each binding gets an ordinal, recorded in render\n * order, and its element a `data-foldkit-plus-on-<event>` attribute naming it.\n * In the browser the builder marks nothing: it is the application's `h`, with\n * the hole forms turned into the closures Foldkit expects.\n */\nimport { Schema, SchemaAST } from 'effect'\nimport type { Attribute, ChildAttribute, HtmlBuilder, KeyboardModifiers } from 'foldkit/html'\nimport { current, type Binding } from './context.js'\n\n/** The attribute prefix of an element's binding marker. */\nexport const BINDING_ATTRIBUTE = 'data-foldkit-plus-on-'\n\n/**\n * The DOM event each of Foldkit's event attributes listens to, read from\n * Foldkit's own attribute table (0.163). `OnCustomEvent` names its event in\n * its payload, and `OnMount` and `OnUnmount` listen to none.\n */\nexport const EVENT_OF: Readonly<Record<string, string>> = {\n OnClick: 'click',\n OnDoubleClick: 'dblclick',\n OnMouseDown: 'mousedown',\n OnMouseUp: 'mouseup',\n OnMouseEnter: 'mouseenter',\n OnMouseLeave: 'mouseleave',\n OnMouseOver: 'mouseover',\n OnMouseOut: 'mouseout',\n OnMouseMove: 'mousemove',\n OnPointerMove: 'pointermove',\n OnPointerLeave: 'pointerleave',\n OnPointerDown: 'pointerdown',\n OnPointerUp: 'pointerup',\n OnKeyDown: 'keydown',\n OnKeyDownPreventDefault: 'keydown',\n OnKeyDownSelf: 'keydown',\n OnKeyDownSelfPreventDefault: 'keydown',\n OnKeyDownFocus: 'keydown',\n OnKeyUp: 'keyup',\n OnKeyUpPreventDefault: 'keyup',\n OnKeyPress: 'keypress',\n OnFocus: 'focus',\n OnBlur: 'blur',\n OnFocusEnter: 'focusin',\n OnFocusLeave: 'focusout',\n OnInput: 'input',\n OnChange: 'change',\n OnBeforeInput: 'beforeinput',\n OnBeforeInputPreventDefault: 'beforeinput',\n OnFileChange: 'change',\n OnSubmit: 'submit',\n OnReset: 'reset',\n OnScroll: 'scroll',\n OnWheel: 'wheel',\n OnCopy: 'copy',\n OnCut: 'cut',\n OnPaste: 'paste',\n OnPastePreventDefault: 'paste',\n OnCopyText: 'copy',\n OnCutText: 'cut',\n OnCancel: 'cancel',\n OnCancelPreventDefault: 'cancel',\n OnToggle: 'toggle',\n OnContextMenu: 'contextmenu',\n OnDragStart: 'dragstart',\n OnDrag: 'drag',\n OnDragEnd: 'dragend',\n OnDragEnter: 'dragenter',\n OnDragLeave: 'dragleave',\n OnDragOver: 'dragover',\n OnDrop: 'drop',\n OnDropFiles: 'drop',\n OnTouchStart: 'touchstart',\n OnTouchEnd: 'touchend',\n OnTouchMove: 'touchmove',\n OnTouchCancel: 'touchcancel',\n OnAnimationStart: 'animationstart',\n OnAnimationEnd: 'animationend',\n OnAnimationIteration: 'animationiteration',\n OnTransitionEnd: 'transitionend',\n OnLoad: 'load',\n OnError: 'error',\n OnPlay: 'play',\n OnPause: 'pause',\n OnEnded: 'ended',\n OnTimeUpdate: 'timeupdate',\n OnVolumeChange: 'volumechange',\n OnSelect: 'select',\n}\n\n/**\n * The attributes whose binding the page can describe: a Message value, or one\n * of the hole forms this builder records. Any other handler still runs on the\n * live page, so its event is marked `*`: the page does something there it\n * cannot name, and a dispatcher that ran only the named bindings would do less.\n */\nconst MARKABLE: ReadonlySet<string> = new Set([\n 'OnClick',\n 'OnDoubleClick',\n 'OnMouseDown',\n 'OnMouseUp',\n 'OnMouseEnter',\n 'OnMouseLeave',\n 'OnMouseOver',\n 'OnMouseOut',\n 'OnMouseMove',\n 'OnFocus',\n 'OnBlur',\n 'OnSubmit',\n 'OnReset',\n 'OnInput',\n 'OnChange',\n 'OnKeyDown',\n 'OnKeyUp',\n])\n\n/** The token in a marker for a handler the page cannot describe. */\nexport const UNNAMED_HANDLER = '*'\n\n/** The posted field that carries a form's encoded Message, for the server fallback. */\nexport const FALLBACK_FIELD = 'foldkit-plus-message'\n\n/** The posted field that says how many placement wrappers the form's fields sit under. */\nexport const FALLBACK_DEPTH_FIELD = 'foldkit-plus-depth'\n\n/** The attribute on a placement's root naming its slot, while the server renders. */\nexport const SLOT_ATTRIBUTE = 'data-foldkit-plus-slot'\n\ndeclare const invalid: unique symbol\n\n/** A compile-time failure that names its cause. */\nexport interface Invalid<Message extends string> {\n readonly [invalid]: Message\n}\n\ntype IsUnion<T, U = T> = T extends unknown ? ([U] extends [T] ? false : true) : never\n\n/** A Message constructor from `defineMessageUnion`: a tagged Schema that can be called. */\ntype AnyMemberSchema = Schema.Top & { readonly fields: Schema.Struct.Fields }\n\n/** The Message a member makes. */\ntype Made<M> = M extends { readonly Type: infer T } ? T : never\n\n/** The fields a member's event may be given fixed: all but `_tag`. */\ntype Fixable<M> = Partial<Omit<Made<M>, '_tag'>>\n\n/** The fields of a member the event fills: those neither `_tag` nor fixed. */\ntype Rest<M, Fixed> = Omit<Made<M>, '_tag' | keyof Fixed>\n\ntype ProducesMessage<M, Message> = [Made<M>] extends [Message]\n ? unknown\n : Invalid<\"the member is not one of this view's Messages\">\n\ntype TextHoleCheck<M, Fixed> = [keyof Rest<M, Fixed>] extends [never]\n ? Invalid<'the member has no field left for the event to fill'>\n : true extends IsUnion<keyof Rest<M, Fixed>>\n ? Invalid<'the member leaves more than one field for the event to fill: fix the others'>\n : Rest<M, Fixed>[keyof Rest<M, Fixed>] extends string\n ? string extends Rest<M, Fixed>[keyof Rest<M, Fixed>]\n ? unknown\n : Invalid<'the field the event fills must be a string'>\n : Invalid<'the field the event fills must be a string'>\n\ntype KeyHoleCheck<M, Fixed> = [keyof Rest<M, Fixed>] extends ['key' | 'modifiers']\n ? ['key' | 'modifiers'] extends [keyof Rest<M, Fixed>]\n ? unknown\n : Invalid<'the member must leave exactly key and modifiers for the event to fill'>\n : Invalid<'the member must leave exactly key and modifiers for the event to fill'>\n\n/** `OnInput` and `OnChange`: a closure, or a member whose one string field the event fills. */\nexport interface TextHole<Message> {\n (toMessage: (value: string) => Message): Attribute<Message>\n <M extends AnyMemberSchema, const Fixed extends Fixable<M> = {}>(\n member: M & ProducesMessage<M, Message> & TextHoleCheck<M, Fixed>,\n fixed?: Fixed,\n ): Attribute<Message>\n}\n\n/** `OnKeyDown` and `OnKeyUp`: a closure, or a member whose `key` and `modifiers` the event fills. */\nexport interface KeyHole<Message> {\n (toMessage: (key: string, modifiers: KeyboardModifiers) => Message): Attribute<Message>\n <M extends AnyMemberSchema, const Fixed extends Fixable<M> = {}>(\n member: M & ProducesMessage<M, Message> & KeyHoleCheck<M, Fixed>,\n fixed?: Fixed,\n ): Attribute<Message>\n}\n\n/**\n * A builder a view is given: Foldkit's `HtmlBuilder`, or a Surface renderer's,\n * which leaves out Foldkit's phantom key. Its Message is what `OnClick` takes.\n */\nexport type AnyBuilder = {\n readonly OnClick: (message: never, ...rest: ReadonlyArray<never>) => unknown\n}\n\n/** The Message a builder's handlers make. */\nexport type MessageOf<Builder> = Builder extends {\n readonly OnClick: (message: infer Message, ...rest: ReadonlyArray<never>) => unknown\n}\n ? Message\n : never\n\n/**\n * The resumable builder for a view whose Messages are `Message`: its elements\n * and attributes, and the hole forms of the four value events. One shape\n * whether it wraps a view's `HtmlBuilder` or a Surface renderer's builder, so a\n * helper typed with it takes either. It keeps Foldkit's phantom Message key,\n * so a placement's view accepts it as the parent's builder.\n */\nexport type ResumableBuilder<Message> = Omit<\n HtmlBuilder<Message>,\n 'OnInput' | 'OnChange' | 'OnKeyDown' | 'OnKeyUp'\n> & {\n readonly OnInput: TextHole<Message>\n readonly OnChange: TextHole<Message>\n readonly OnKeyDown: KeyHole<Message>\n readonly OnKeyUp: KeyHole<Message>\n}\n\ntype AnyMember = ((value: Record<string, unknown>) => unknown) & {\n readonly fields: Readonly<Record<string, unknown>>\n}\n\nconst isMember = (value: unknown): value is AnyMember =>\n typeof value === 'function' && typeof (value as { fields?: unknown }).fields === 'object'\n\nconst tagOf = (member: AnyMember): string => {\n const tag = member.fields._tag\n return Schema.isSchema(tag) && SchemaAST.isLiteral(tag.ast) && typeof tag.ast.literal === 'string'\n ? tag.ast.literal\n : 'the member'\n}\n\n/**\n * The fields a member leaves for the event to fill, given what is fixed. Only\n * `fixed`'s own keys fix a field: `in` finds `constructor` on every object.\n */\nconst holeOf = (member: AnyMember, fixed: object): ReadonlyArray<string> =>\n Object.keys(member.fields).filter(field => field !== '_tag' && !Object.hasOwn(fixed, field))\n\nconst NO_MODIFIERS: KeyboardModifiers = {\n shiftKey: false,\n ctrlKey: false,\n altKey: false,\n metaKey: false,\n}\n\n/** Each hole-form attribute, with its Message filled by a placeholder and the fields the event fills. */\nconst holes = new WeakMap<\n object,\n { readonly template: unknown; readonly hole: ReadonlyArray<string> }\n>()\n\n/** What an element is given: Foldkit's attributes, and a Submodel's wrapped ones, which carry no tag. */\ntype Item = Attribute<unknown> | ChildAttribute\n\nconst isAttribute = (item: Item): item is Attribute<unknown> => '_tag' in item\n\nconst builders = new WeakMap<object, unknown>()\n\n/** A hole form's placeholder Message, or `undefined` when its field's checks refuse one. */\nconst placeholder = (make: () => unknown): unknown => {\n try {\n return make()\n } catch {\n return undefined\n }\n}\n\n/**\n * The resumable builder for a view's `h`. Use it in place of `h`; it has the\n * same elements and attributes, and the hole forms of the four value events.\n */\nexport const builder = <Builder extends AnyBuilder>(\n h: Builder,\n): ResumableBuilder<MessageOf<Builder>> => {\n const cached = builders.get(h)\n if (cached !== undefined) return cached as ResumableBuilder<MessageOf<Builder>>\n const source = h as unknown as Record<string, unknown>\n const attribute = source.Attribute as (name: string, value: string) => unknown\n\n /** The attributes with a marker for each binding, while the server renders. */\n const mark = (tag: string, attributes: ReadonlyArray<Item>): ReadonlyArray<unknown> => {\n const now = current()\n if (now?.mode !== 'collect' && now?.mode !== 'replay') return attributes\n const id = attributes.find(\n (item): item is Extract<Attribute<unknown>, { readonly _tag: 'Id' }> =>\n isAttribute(item) && item._tag === 'Id',\n )\n const element = id === undefined ? tag : `${tag}#${id.value}`\n // Foldkit chains every handler of an event, in the order the attributes\n // come, so a marker lists every binding of its event in that order.\n const tokens = new Map<string, Array<string>>()\n for (const item of attributes) {\n if (!isAttribute(item)) continue\n const event = item._tag === 'OnCustomEvent' ? item.name : EVENT_OF[item._tag]\n if (event === undefined) continue\n // Recorded for the refusal; the render does not survive it.\n if (now.mode === 'collect' && now.region !== undefined) {\n now.inStatic.push({ region: now.region, element, event })\n }\n const recorded = holes.get(item)\n const nested = now.depth === 0 ? {} : { depth: now.depth }\n const binding: Binding | undefined = !MARKABLE.has(item._tag)\n ? undefined\n : 'message' in item\n ? {\n attribute: item._tag,\n event,\n element,\n message: now.wrap(item.message),\n ...('options' in item && item.options !== undefined ? { options: item.options } : {}),\n }\n : recorded === undefined\n ? undefined\n : {\n attribute: item._tag,\n event,\n element,\n message: now.wrap(recorded.template),\n hole: recorded.hole,\n ...nested,\n }\n const list = tokens.get(event) ?? []\n tokens.set(event, list)\n if (binding === undefined) {\n // One entry per element and event, however many handlers it chains.\n if (now.mode === 'collect' && !list.includes(UNNAMED_HANDLER)) {\n now.unnamed.push({ element, event })\n }\n list.push(UNNAMED_HANDLER)\n } else {\n list.push(String(now.bindings.length))\n now.bindings.push(binding)\n }\n }\n if (tokens.size === 0) return attributes\n const markers = [...tokens].map(([event, list]) =>\n attribute(`${BINDING_ATTRIBUTE}${event}`, list.join(' ')),\n )\n return [...attributes, ...markers]\n }\n\n /**\n * A form whose `OnSubmit` names a Message, while the server renders for a\n * plan with a fallback, also posts that Message: `method=\"post\"` to its own\n * URL, and a hidden input carrying the Message encoded. Posted fields named\n * as the Message's own fields override them, so a typed title reaches\n * `update` as it would through the page.\n */\n const fallback = (\n tag: string,\n attributes: ReadonlyArray<Item>,\n children: unknown,\n ): { readonly attributes: ReadonlyArray<Item>; readonly children: unknown } => {\n const now = current()\n if (\n tag !== 'form' ||\n now?.mode === undefined ||\n now.mode === 'resume' ||\n now.fallback === undefined\n ) {\n return { attributes, children }\n }\n const submit = attributes.find(\n (item): item is Extract<Attribute<unknown>, { readonly _tag: 'OnSubmit' }> =>\n isAttribute(item) && item._tag === 'OnSubmit',\n )\n if (submit === undefined || !Array.isArray(children)) return { attributes, children }\n const encoded = now.fallback(now.wrap(submit.message))\n if (encoded === undefined) return { attributes, children }\n const make = (name: string) => source[name] as (value: string) => Attribute<unknown>\n const input = source.input as (attributes: ReadonlyArray<unknown>) => unknown\n const hidden = (name: string, value: string) =>\n input([make('Type')('hidden'), make('Name')(name), make('Value')(value)])\n return {\n attributes: [...attributes, make('Method')('post')],\n children: [\n ...children,\n hidden(FALLBACK_FIELD, encoded),\n ...(now.depth === 0 ? [] : [hidden(FALLBACK_DEPTH_FIELD, String(now.depth))]),\n ],\n }\n }\n\n const textHole =\n (name: string) =>\n (given: unknown, fixed: Record<string, unknown> = {}): unknown => {\n const make = source[name] as (toMessage: (value: string) => unknown) => object\n if (!isMember(given)) return make(given as (value: string) => unknown)\n const hole = holeOf(given, fixed)\n if (hole.length !== 1) {\n throw new Error(\n `Resume.builder: ${name}(${tagOf(given)}) leaves ${hole.length === 0 ? 'no field' : hole.join(', ')} for the event to fill; it must leave one string field`,\n )\n }\n const [field] = hole as [string]\n const made = make(value => given({ ...fixed, [field]: value }))\n const template = placeholder(() => given({ ...fixed, [field]: '' }))\n // A field whose checks refuse the empty placeholder cannot be written\n // into the page as data; left unrecorded, the handler is marked as one\n // the page cannot name, and the live page answers it.\n if (template !== undefined) holes.set(made, { template, hole })\n return made\n }\n\n const keyHole =\n (name: string) =>\n (given: unknown, fixed: Record<string, unknown> = {}): unknown => {\n const make = source[name] as (\n toMessage: (key: string, modifiers: KeyboardModifiers) => unknown,\n ) => object\n if (!isMember(given)) {\n return make(given as (key: string, modifiers: KeyboardModifiers) => unknown)\n }\n const hole = holeOf(given, fixed)\n if (hole.length !== 2 || !hole.includes('key') || !hole.includes('modifiers')) {\n throw new Error(\n `Resume.builder: ${name}(${tagOf(given)}) leaves ${hole.join(', ') || 'no field'} for the event to fill; it must leave exactly key and modifiers`,\n )\n }\n const made = make((key, modifiers) => given({ ...fixed, key, modifiers }))\n const template = placeholder(() => given({ ...fixed, key: '', modifiers: NO_MODIFIERS }))\n if (template !== undefined) holes.set(made, { template, hole })\n return made\n }\n\n /**\n * `h.submodel` with the child's root stamped with its slot, while the\n * server renders: a boundary a tool can find, which the browser's first\n * patch removes as it removes the markers.\n */\n const submodel = (config: {\n readonly slotId: string\n readonly view: unknown\n readonly toParentMessage: (message: unknown) => unknown\n }): unknown => {\n const original = source.submodel as (config: unknown) => unknown\n const now = current()\n if (now?.mode !== 'collect' && now?.mode !== 'replay') return original(config)\n const view = config.view as (...args: ReadonlyArray<unknown>) => unknown\n const stamped = (...args: ReadonlyArray<unknown>) => {\n // A binding inside dispatches the parent's Message, as Foldkit's own\n // handlers do, so it is recorded lifted through this placement.\n const outer = { wrap: now.wrap, depth: now.depth }\n now.wrap = message => outer.wrap(config.toParentMessage(message))\n now.depth = outer.depth + 1\n let out: { data?: { attrs?: Record<string, unknown> } } | null\n try {\n out = view(...args) as typeof out\n } finally {\n now.wrap = outer.wrap\n now.depth = outer.depth\n }\n if (out !== null && typeof out === 'object' && out.data !== undefined) {\n out.data.attrs = { ...out.data.attrs, [SLOT_ATTRIBUTE]: config.slotId }\n }\n return out\n }\n // The view carries Foldkit's Submodel brand as an own property; keep it.\n return original({ ...config, view: Object.assign(stamped, view) })\n }\n\n const wrapped: Record<string, unknown> = {}\n for (const [name, value] of Object.entries(source)) {\n if (name === 'submodel') wrapped[name] = submodel\n else if (name === 'OnInput' || name === 'OnChange') wrapped[name] = textHole(name)\n else if (name === 'OnKeyDown' || name === 'OnKeyUp') wrapped[name] = keyHole(name)\n else if (name === 'keyed') {\n const keyed = value as (tag: string) => (key: PropertyKey, ...rest: Array<unknown>) => unknown\n wrapped[name] =\n (tag: string) =>\n (key: PropertyKey, attributes: ReadonlyArray<Item> = [], ...rest: Array<unknown>) => {\n const posted = fallback(tag, attributes, rest[0])\n return keyed(tag)(key, mark(tag, posted.attributes), posted.children, ...rest.slice(1))\n }\n } else if (/^[a-z]/.test(name) && typeof value === 'function') {\n const element = value as (\n attributes: ReadonlyArray<unknown>,\n ...rest: Array<unknown>\n ) => unknown\n wrapped[name] = (attributes: ReadonlyArray<Item>, ...rest: Array<unknown>) => {\n const posted = fallback(name, attributes, rest[0])\n return element(mark(name, posted.attributes), posted.children, ...rest.slice(1))\n }\n } else wrapped[name] = value\n }\n builders.set(h, wrapped)\n return wrapped as unknown as ResumableBuilder<MessageOf<Builder>>\n}\n\n/**\n * A view or renderer written against the resumable builder, as one that takes\n * the builder it is given: `Surface.rootView(Page, params, Resume.view(render))`,\n * `SurfaceView.define`, or an application's own view.\n */\nexport const view =\n <Model, Builder extends AnyBuilder, Out>(\n render: (model: Model, rh: ResumableBuilder<MessageOf<Builder>>) => Out,\n ) =>\n (model: Model, h: Builder): Out =>\n render(model, builder(h))\n"],"mappings":"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"}
1
+ {"version":3,"file":"resumable.js","names":[],"sources":["../src/resumable.ts"],"sourcesContent":["/**\n * The resumable builder: the application's `h`, whose event attributes say, in\n * the server's markup, which Message each element causes.\n *\n * A Foldkit handler is a Message value (`h.OnClick(Message.Liked({ id }))`), so\n * for most events that is already data. The events that carry a value\n * (`OnInput`, `OnChange`, `OnKeyDown`, `OnKeyUp`) take a closure only to put\n * the value into a Message field; this builder also takes the Message's own\n * constructor there, a Message with a hole, and fills the hole the same way.\n *\n * During the server's renders each binding gets an ordinal, recorded in render\n * order, and its element a `data-foldkit-plus-on-<event>` attribute naming it.\n * In the browser the builder marks nothing: it is the application's `h`, with\n * the hole forms turned into the closures Foldkit expects.\n */\nimport { Schema, SchemaAST } from 'effect'\nimport type { Attribute, ChildAttribute, HtmlBuilder, KeyboardModifiers } from 'foldkit/html'\nimport { current, type Binding } from './context.js'\n\n/** The attribute prefix of an element's binding marker. */\nexport const BINDING_ATTRIBUTE = 'data-foldkit-plus-on-'\n\n/**\n * The DOM event each of Foldkit's event attributes listens to, read from\n * Foldkit's own attribute table (0.163). `OnCustomEvent` names its event in\n * its payload, and `OnMount` and `OnUnmount` listen to none.\n */\nexport const EVENT_OF: Readonly<Record<string, string>> = {\n OnClick: 'click',\n OnDoubleClick: 'dblclick',\n OnMouseDown: 'mousedown',\n OnMouseUp: 'mouseup',\n OnMouseEnter: 'mouseenter',\n OnMouseLeave: 'mouseleave',\n OnMouseOver: 'mouseover',\n OnMouseOut: 'mouseout',\n OnMouseMove: 'mousemove',\n OnPointerMove: 'pointermove',\n OnPointerLeave: 'pointerleave',\n OnPointerDown: 'pointerdown',\n OnPointerUp: 'pointerup',\n OnKeyDown: 'keydown',\n OnKeyDownPreventDefault: 'keydown',\n OnKeyDownSelf: 'keydown',\n OnKeyDownSelfPreventDefault: 'keydown',\n OnKeyDownFocus: 'keydown',\n OnKeyUp: 'keyup',\n OnKeyUpPreventDefault: 'keyup',\n OnKeyPress: 'keypress',\n OnFocus: 'focus',\n OnBlur: 'blur',\n OnFocusEnter: 'focusin',\n OnFocusLeave: 'focusout',\n OnInput: 'input',\n OnChange: 'change',\n OnBeforeInput: 'beforeinput',\n OnBeforeInputPreventDefault: 'beforeinput',\n OnFileChange: 'change',\n OnSubmit: 'submit',\n OnReset: 'reset',\n OnScroll: 'scroll',\n OnWheel: 'wheel',\n OnCopy: 'copy',\n OnCut: 'cut',\n OnPaste: 'paste',\n OnPastePreventDefault: 'paste',\n OnCopyText: 'copy',\n OnCutText: 'cut',\n OnCancel: 'cancel',\n OnCancelPreventDefault: 'cancel',\n OnToggle: 'toggle',\n OnContextMenu: 'contextmenu',\n OnDragStart: 'dragstart',\n OnDrag: 'drag',\n OnDragEnd: 'dragend',\n OnDragEnter: 'dragenter',\n OnDragLeave: 'dragleave',\n OnDragOver: 'dragover',\n OnDrop: 'drop',\n OnDropFiles: 'drop',\n OnTouchStart: 'touchstart',\n OnTouchEnd: 'touchend',\n OnTouchMove: 'touchmove',\n OnTouchCancel: 'touchcancel',\n OnAnimationStart: 'animationstart',\n OnAnimationEnd: 'animationend',\n OnAnimationIteration: 'animationiteration',\n OnTransitionEnd: 'transitionend',\n OnLoad: 'load',\n OnError: 'error',\n OnPlay: 'play',\n OnPause: 'pause',\n OnEnded: 'ended',\n OnTimeUpdate: 'timeupdate',\n OnVolumeChange: 'volumechange',\n OnSelect: 'select',\n}\n\n/**\n * The attributes whose binding the page can describe: a Message value, or one\n * of the hole forms this builder records. Any other handler still runs on the\n * live page, so its event is marked `*`: the page does something there it\n * cannot name, and a dispatcher that ran only the named bindings would do less.\n */\nconst MARKABLE: ReadonlySet<string> = new Set([\n 'OnClick',\n 'OnDoubleClick',\n 'OnMouseDown',\n 'OnMouseUp',\n 'OnMouseEnter',\n 'OnMouseLeave',\n 'OnMouseOver',\n 'OnMouseOut',\n 'OnMouseMove',\n 'OnFocus',\n 'OnBlur',\n 'OnSubmit',\n 'OnReset',\n 'OnInput',\n 'OnChange',\n 'OnKeyDown',\n 'OnKeyUp',\n])\n\n/** The token in a marker for a handler the page cannot describe. */\nexport const UNNAMED_HANDLER = '*'\n\n/** The posted field that carries a form's encoded Message, for the server fallback. */\nexport const FALLBACK_FIELD = 'foldkit-plus-message'\n\n/** The posted field that says how many placement wrappers the form's fields sit under. */\nexport const FALLBACK_DEPTH_FIELD = 'foldkit-plus-depth'\n\n/**\n * The attribute on a field whose typing before boot is kept (`KeepTyped`),\n * naming the binding whose Message replays it.\n */\nexport const KEEP_ATTRIBUTE = 'data-foldkit-plus-keep'\n\n/** The value of a `KeepTyped` marker no resumable element took, while the server renders. */\nexport const UNPLACED_KEEP = '?'\n\n/**\n * The `input` types whose value is not something typed, so `KeepTyped` has\n * nothing to keep on them.\n */\nconst UNTYPED_INPUTS: ReadonlySet<string> = new Set([\n 'checkbox',\n 'radio',\n 'file',\n 'hidden',\n 'button',\n 'submit',\n 'reset',\n 'image',\n])\n\n/** The attribute on a placement's root naming its slot, while the server renders. */\nexport const SLOT_ATTRIBUTE = 'data-foldkit-plus-slot'\n\ndeclare const invalid: unique symbol\n\n/** A compile-time failure that names its cause. */\nexport interface Invalid<Message extends string> {\n readonly [invalid]: Message\n}\n\ntype IsUnion<T, U = T> = T extends unknown ? ([U] extends [T] ? false : true) : never\n\n/** A Message constructor from `defineMessageUnion`: a tagged Schema that can be called. */\ntype AnyMemberSchema = Schema.Top & { readonly fields: Schema.Struct.Fields }\n\n/** The Message a member makes. */\ntype Made<M> = M extends { readonly Type: infer T } ? T : never\n\n/** The fields a member's event may be given fixed: all but `_tag`. */\ntype Fixable<M> = Partial<Omit<Made<M>, '_tag'>>\n\n/** The fields of a member the event fills: those neither `_tag` nor fixed. */\ntype Rest<M, Fixed> = Omit<Made<M>, '_tag' | keyof Fixed>\n\ntype ProducesMessage<M, Message> = [Made<M>] extends [Message]\n ? unknown\n : Invalid<\"the member is not one of this view's Messages\">\n\ntype TextHoleCheck<M, Fixed> = [keyof Rest<M, Fixed>] extends [never]\n ? Invalid<'the member has no field left for the event to fill'>\n : true extends IsUnion<keyof Rest<M, Fixed>>\n ? Invalid<'the member leaves more than one field for the event to fill: fix the others'>\n : Rest<M, Fixed>[keyof Rest<M, Fixed>] extends string\n ? string extends Rest<M, Fixed>[keyof Rest<M, Fixed>]\n ? unknown\n : Invalid<'the field the event fills must be a string'>\n : Invalid<'the field the event fills must be a string'>\n\ntype KeyHoleCheck<M, Fixed> = [keyof Rest<M, Fixed>] extends ['key' | 'modifiers']\n ? ['key' | 'modifiers'] extends [keyof Rest<M, Fixed>]\n ? unknown\n : Invalid<'the member must leave exactly key and modifiers for the event to fill'>\n : Invalid<'the member must leave exactly key and modifiers for the event to fill'>\n\n/**\n * Foldkit's attribute of one tag, as its own builder returns it, so an\n * element that refuses some attributes (a `textarea`, `InnerHTML`) takes it.\n */\ntype Tagged<Message, Tag extends string> = Extract<Attribute<Message>, { readonly _tag: Tag }>\n\n/** `OnInput` and `OnChange`: a closure, or a member whose one string field the event fills. */\nexport interface TextHole<Message, Tag extends string> {\n (toMessage: (value: string) => Message): Tagged<Message, Tag>\n <M extends AnyMemberSchema, const Fixed extends Fixable<M> = {}>(\n member: M & ProducesMessage<M, Message> & TextHoleCheck<M, Fixed>,\n fixed?: Fixed,\n ): Tagged<Message, Tag>\n}\n\n/** `OnKeyDown` and `OnKeyUp`: a closure, or a member whose `key` and `modifiers` the event fills. */\nexport interface KeyHole<Message, Tag extends string> {\n (toMessage: (key: string, modifiers: KeyboardModifiers) => Message): Tagged<Message, Tag>\n <M extends AnyMemberSchema, const Fixed extends Fixable<M> = {}>(\n member: M & ProducesMessage<M, Message> & KeyHoleCheck<M, Fixed>,\n fixed?: Fixed,\n ): Tagged<Message, Tag>\n}\n\n/**\n * A builder a view is given: Foldkit's `HtmlBuilder`, or a Surface renderer's,\n * which leaves out Foldkit's phantom key. Its Message is what `OnClick` takes.\n */\nexport type AnyBuilder = {\n readonly OnClick: (message: never, ...rest: ReadonlyArray<never>) => unknown\n}\n\n/** The Message a builder's handlers make. */\nexport type MessageOf<Builder> = Builder extends {\n readonly OnClick: (message: infer Message, ...rest: ReadonlyArray<never>) => unknown\n}\n ? Message\n : never\n\n/**\n * The resumable builder for a view whose Messages are `Message`: its elements\n * and attributes, and the hole forms of the four value events. One shape\n * whether it wraps a view's `HtmlBuilder` or a Surface renderer's builder, so a\n * helper typed with it takes either. It keeps Foldkit's phantom Message key,\n * so a placement's view accepts it as the parent's builder.\n */\nexport type ResumableBuilder<Message> = Omit<\n HtmlBuilder<Message>,\n 'OnInput' | 'OnChange' | 'OnKeyDown' | 'OnKeyUp'\n> & {\n readonly OnInput: TextHole<Message, 'OnInput'>\n readonly OnChange: TextHole<Message, 'OnChange'>\n readonly OnKeyDown: KeyHole<Message, 'OnKeyDown'>\n readonly OnKeyUp: KeyHole<Message, 'OnKeyUp'>\n /**\n * Keeps what is typed into this field before the runtime starts: the\n * browser replays it as the field's `OnInput` Message (else its\n * `OnChange`), given in the hole form, and keeps the caret. The field must\n * be an `input` that takes text, a `textarea` or a `select`.\n */\n readonly KeepTyped: () => Tagged<Message, 'Attribute'>\n}\n\ntype AnyMember = ((value: Record<string, unknown>) => unknown) & {\n readonly fields: Readonly<Record<string, unknown>>\n}\n\nconst isMember = (value: unknown): value is AnyMember =>\n typeof value === 'function' && typeof (value as { fields?: unknown }).fields === 'object'\n\nconst tagOf = (member: AnyMember): string => {\n const tag = member.fields._tag\n return Schema.isSchema(tag) && SchemaAST.isLiteral(tag.ast) && typeof tag.ast.literal === 'string'\n ? tag.ast.literal\n : 'the member'\n}\n\n/**\n * The fields a member leaves for the event to fill, given what is fixed. Only\n * `fixed`'s own keys fix a field: `in` finds `constructor` on every object.\n */\nconst holeOf = (member: AnyMember, fixed: object): ReadonlyArray<string> =>\n Object.keys(member.fields).filter(field => field !== '_tag' && !Object.hasOwn(fixed, field))\n\nconst NO_MODIFIERS: KeyboardModifiers = {\n shiftKey: false,\n ctrlKey: false,\n altKey: false,\n metaKey: false,\n}\n\n/** Each hole-form attribute, with its Message filled by a placeholder and the fields the event fills. */\nconst holes = new WeakMap<\n object,\n { readonly template: unknown; readonly hole: ReadonlyArray<string> }\n>()\n\n/** What an element is given: Foldkit's attributes, and a Submodel's wrapped ones, which carry no tag. */\ntype Item = Attribute<unknown> | ChildAttribute\n\nconst isAttribute = (item: Item): item is Attribute<unknown> => '_tag' in item\n\nconst builders = new WeakMap<object, unknown>()\n\n/** Each attribute `KeepTyped` made: a request to the element it is given, never written as it is. */\nconst keeps = new WeakSet<object>()\n\n/** A hole form's placeholder Message, or `undefined` when its field's checks refuse one. */\nconst placeholder = (make: () => unknown): unknown => {\n try {\n return make()\n } catch {\n return undefined\n }\n}\n\n/**\n * The resumable builder for a view's `h`. Use it in place of `h`; it has the\n * same elements and attributes, and the hole forms of the four value events.\n */\nexport const builder = <Builder extends AnyBuilder>(\n h: Builder,\n): ResumableBuilder<MessageOf<Builder>> => {\n const cached = builders.get(h)\n if (cached !== undefined) return cached as ResumableBuilder<MessageOf<Builder>>\n const source = h as unknown as Record<string, unknown>\n const attribute = source.Attribute as (name: string, value: string) => unknown\n\n /** The attributes with a marker for each binding, while the server renders. */\n const mark = (tag: string, given: ReadonlyArray<Item>): ReadonlyArray<unknown> => {\n const kept = given.some(item => keeps.has(item))\n const attributes = kept ? given.filter(item => !keeps.has(item)) : given\n const now = current()\n if (now?.mode !== 'collect' && now?.mode !== 'replay') return attributes\n const id = attributes.find(\n (item): item is Extract<Attribute<unknown>, { readonly _tag: 'Id' }> =>\n isAttribute(item) && item._tag === 'Id',\n )\n const element = id === undefined ? tag : `${tag}#${id.value}`\n // Foldkit chains every handler of an event, in the order the attributes\n // come, so a marker lists every binding of its event in that order.\n const tokens = new Map<string, Array<string>>()\n // The ordinal of the element's hole-form `OnInput` and `OnChange`, which `KeepTyped` replays.\n const typed = new Map<string, number>()\n for (const item of attributes) {\n if (!isAttribute(item)) continue\n const event = item._tag === 'OnCustomEvent' ? item.name : EVENT_OF[item._tag]\n if (event === undefined) continue\n // Recorded for the refusal; the render does not survive it.\n if (now.mode === 'collect' && now.region !== undefined) {\n now.inStatic.push({ region: now.region, element, event })\n }\n const recorded = holes.get(item)\n const nested = now.depth === 0 ? {} : { depth: now.depth }\n const binding: Binding | undefined = !MARKABLE.has(item._tag)\n ? undefined\n : 'message' in item\n ? {\n attribute: item._tag,\n event,\n element,\n message: now.wrap(item.message),\n ...('options' in item && item.options !== undefined ? { options: item.options } : {}),\n }\n : recorded === undefined\n ? undefined\n : {\n attribute: item._tag,\n event,\n element,\n message: now.wrap(recorded.template),\n hole: recorded.hole,\n ...nested,\n }\n const list = tokens.get(event) ?? []\n tokens.set(event, list)\n if (binding === undefined) {\n // One entry per element and event, however many handlers it chains.\n if (now.mode === 'collect' && !list.includes(UNNAMED_HANDLER)) {\n now.unnamed.push({ element, event })\n }\n list.push(UNNAMED_HANDLER)\n } else {\n if (binding.hole !== undefined && !typed.has(binding.attribute)) {\n typed.set(binding.attribute, now.bindings.length)\n }\n list.push(String(now.bindings.length))\n now.bindings.push(binding)\n }\n }\n const markers = [...tokens].map(([event, list]) =>\n attribute(`${BINDING_ATTRIBUTE}${event}`, list.join(' ')),\n )\n if (kept) {\n const ordinal = typed.get('OnInput') ?? typed.get('OnChange')\n const type = attributes.find(\n (item): item is Extract<Attribute<unknown>, { readonly _tag: 'Type' }> =>\n isAttribute(item) && item._tag === 'Type',\n )?.value\n const field =\n tag === 'textarea' ||\n tag === 'select' ||\n (tag === 'input' && (type === undefined || !UNTYPED_INPUTS.has(type.toLowerCase())))\n if (!field) {\n if (now.mode === 'collect') {\n now.unkeepable.push(\n `KeepTyped on ${type === undefined ? element : `${element} of type ${type}`}, which holds no typed value: keep an input that takes text, a textarea or a select`,\n )\n }\n } else if (ordinal === undefined) {\n if (now.mode === 'collect') {\n now.unkeepable.push(\n `KeepTyped on ${element}, which has no OnInput or OnChange given a Message member, so nothing names the Message its typing replays as`,\n )\n }\n } else markers.push(attribute(KEEP_ATTRIBUTE, String(ordinal)))\n }\n return markers.length === 0 ? attributes : [...attributes, ...markers]\n }\n\n /**\n * A form whose `OnSubmit` names a Message, while the server renders for a\n * plan with a fallback, also posts that Message: `method=\"post\"` to its own\n * URL, and a hidden input carrying the Message encoded. Posted fields named\n * as the Message's own fields override them, so a typed title reaches\n * `update` as it would through the page. A form given its own `Method` is\n * the view's, left as drawn: a search is a GET of the address the URL\n * mirror reads, and posts no Message.\n */\n const fallback = (\n tag: string,\n attributes: ReadonlyArray<Item>,\n children: unknown,\n ): { readonly attributes: ReadonlyArray<Item>; readonly children: unknown } => {\n const now = current()\n if (\n tag !== 'form' ||\n now?.mode === undefined ||\n now.mode === 'resume' ||\n now.fallback === undefined\n ) {\n return { attributes, children }\n }\n const submit = attributes.find(\n (item): item is Extract<Attribute<unknown>, { readonly _tag: 'OnSubmit' }> =>\n isAttribute(item) && item._tag === 'OnSubmit',\n )\n const method = attributes.some(item => isAttribute(item) && item._tag === 'Method')\n if (submit === undefined || method || !Array.isArray(children)) return { attributes, children }\n const encoded = now.fallback(now.wrap(submit.message))\n if (encoded === undefined) return { attributes, children }\n const make = (name: string) => source[name] as (value: string) => Attribute<unknown>\n const input = source.input as (attributes: ReadonlyArray<unknown>) => unknown\n const hidden = (name: string, value: string) =>\n input([make('Type')('hidden'), make('Name')(name), make('Value')(value)])\n return {\n attributes: [...attributes, make('Method')('post')],\n children: [\n ...children,\n hidden(FALLBACK_FIELD, encoded),\n ...(now.depth === 0 ? [] : [hidden(FALLBACK_DEPTH_FIELD, String(now.depth))]),\n ],\n }\n }\n\n const textHole =\n (name: string) =>\n (given: unknown, fixed: Record<string, unknown> = {}): unknown => {\n const make = source[name] as (toMessage: (value: string) => unknown) => object\n if (!isMember(given)) return make(given as (value: string) => unknown)\n const hole = holeOf(given, fixed)\n if (hole.length !== 1) {\n throw new Error(\n `Resume.builder: ${name}(${tagOf(given)}) leaves ${hole.length === 0 ? 'no field' : hole.join(', ')} for the event to fill; it must leave one string field`,\n )\n }\n const [field] = hole as [string]\n const made = make(value => given({ ...fixed, [field]: value }))\n const template = placeholder(() => given({ ...fixed, [field]: '' }))\n // A field whose checks refuse the empty placeholder cannot be written\n // into the page as data; left unrecorded, the handler is marked as one\n // the page cannot name, and the live page answers it.\n if (template !== undefined) holes.set(made, { template, hole })\n return made\n }\n\n const keyHole =\n (name: string) =>\n (given: unknown, fixed: Record<string, unknown> = {}): unknown => {\n const make = source[name] as (\n toMessage: (key: string, modifiers: KeyboardModifiers) => unknown,\n ) => object\n if (!isMember(given)) {\n return make(given as (key: string, modifiers: KeyboardModifiers) => unknown)\n }\n const hole = holeOf(given, fixed)\n if (hole.length !== 2 || !hole.includes('key') || !hole.includes('modifiers')) {\n throw new Error(\n `Resume.builder: ${name}(${tagOf(given)}) leaves ${hole.join(', ') || 'no field'} for the event to fill; it must leave exactly key and modifiers`,\n )\n }\n const made = make((key, modifiers) => given({ ...fixed, key, modifiers }))\n const template = placeholder(() => given({ ...fixed, key: '', modifiers: NO_MODIFIERS }))\n if (template !== undefined) holes.set(made, { template, hole })\n return made\n }\n\n /**\n * `h.submodel` with the child's root stamped with its slot, while the\n * server renders: a boundary a tool can find, which the browser takes off\n * as the page boots, with the markers.\n */\n const submodel = (config: {\n readonly slotId: string\n readonly view: unknown\n readonly toParentMessage: (message: unknown) => unknown\n }): unknown => {\n const original = source.submodel as (config: unknown) => unknown\n const now = current()\n if (now?.mode !== 'collect' && now?.mode !== 'replay') return original(config)\n const view = config.view as (...args: ReadonlyArray<unknown>) => unknown\n const stamped = (...args: ReadonlyArray<unknown>) => {\n // A binding inside dispatches the parent's Message, as Foldkit's own\n // handlers do, so it is recorded lifted through this placement.\n const outer = { wrap: now.wrap, depth: now.depth }\n now.wrap = message => outer.wrap(config.toParentMessage(message))\n now.depth = outer.depth + 1\n let out: { data?: { attrs?: Record<string, unknown> } } | null\n try {\n out = view(...args) as typeof out\n } finally {\n now.wrap = outer.wrap\n now.depth = outer.depth\n }\n if (out !== null && typeof out === 'object' && out.data !== undefined) {\n out.data.attrs = { ...out.data.attrs, [SLOT_ATTRIBUTE]: config.slotId }\n }\n return out\n }\n // The view carries Foldkit's Submodel brand as an own property; keep it.\n return original({ ...config, view: Object.assign(stamped, view) })\n }\n\n const wrapped: Record<string, unknown> = {}\n for (const [name, value] of Object.entries(source)) {\n if (name === 'submodel') wrapped[name] = submodel\n else if (name === 'OnInput' || name === 'OnChange') wrapped[name] = textHole(name)\n else if (name === 'OnKeyDown' || name === 'OnKeyUp') wrapped[name] = keyHole(name)\n else if (name === 'keyed') {\n const keyed = value as (tag: string) => (key: PropertyKey, ...rest: Array<unknown>) => unknown\n wrapped[name] =\n (tag: string) =>\n (key: PropertyKey, attributes: ReadonlyArray<Item> = [], ...rest: Array<unknown>) => {\n const posted = fallback(tag, attributes, rest[0])\n return keyed(tag)(key, mark(tag, posted.attributes), posted.children, ...rest.slice(1))\n }\n } else if (/^[a-z]/.test(name) && typeof value === 'function') {\n const element = value as (\n attributes: ReadonlyArray<unknown>,\n ...rest: Array<unknown>\n ) => unknown\n wrapped[name] = (attributes: ReadonlyArray<Item>, ...rest: Array<unknown>) => {\n const posted = fallback(name, attributes, rest[0])\n return element(mark(name, posted.attributes), posted.children, ...rest.slice(1))\n }\n } else wrapped[name] = value\n }\n wrapped.KeepTyped = () => {\n // Written so during the server's first render: an element this builder\n // builds takes it out, so one left in the markup is on an element `h`\n // built, which nothing marks, and is refused there, naming the element.\n const made = attribute(KEEP_ATTRIBUTE, current()?.mode === 'collect' ? UNPLACED_KEEP : '')\n keeps.add(made as object)\n return made\n }\n builders.set(h, wrapped)\n return wrapped as unknown as ResumableBuilder<MessageOf<Builder>>\n}\n\n/**\n * A view or renderer written against the resumable builder, as one that takes\n * the builder it is given: `Surface.rootView(Page, params, Resume.view(render))`,\n * `SurfaceView.define`, or an application's own view.\n */\nexport const view =\n <Model, Builder extends AnyBuilder, Out>(\n render: (model: Model, rh: ResumableBuilder<MessageOf<Builder>>) => Out,\n ) =>\n (model: Model, h: Builder): Out =>\n render(model, builder(h))\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { n as DecodedBinding } from "./listen-zNd0IIAT.js";
1
+ import { n as DecodedBinding } from "./listen-DaUPRKVR.js";
2
2
  import { Cause, Effect, Layer, Option, Result, Schema, Stream } from "effect";
3
3
  import { ActiveSurface, Diagnostic, Metadata, ModelPlace, ReportDiagnostic, SurfaceSource, WritableProjection } from "foldkit-surface";
4
4
  import { Html, HtmlBuilder } from "foldkit/html";
@@ -93,6 +93,8 @@ type RenderContext = {
93
93
  }>;
94
94
  /** Each element and event marked `*`: a handler the page cannot name. */
95
95
  readonly unnamed: Array<UnnamedHandler>;
96
+ /** Why each `KeepTyped` field met cannot be replayed, one line each. */
97
+ readonly unkeepable: Array<string>;
96
98
  } | {
97
99
  readonly mode: 'replay';
98
100
  readonly regions: ReadonlyMap<string, Region>;
@@ -128,6 +130,12 @@ declare const FOLDKIT_APP_ATTRIBUTE = "data-foldkit-app";
128
130
  declare const RESUME_ATTRIBUTE = "data-foldkit-plus-resume";
129
131
  /** The envelope format this package writes and reads. */
130
132
  declare const PROTOCOL = 1;
133
+ /**
134
+ * The comment a render's `styles` follow in the stamped root. Hydration
135
+ * removes children the view does not draw, so `SSR.hydrate` moves what
136
+ * follows it into the head before adopting the page.
137
+ */
138
+ declare const STYLES_MARKER = "foldkit-plus-styles";
131
139
  /**
132
140
  * JSON for a script element: `<` is escaped so `</script>` in the data ends
133
141
  * nothing. U+2028 and U+2029 are escaped too: they are fine in JSON and break a
@@ -331,6 +339,13 @@ declare const modelFrom: <Model, Fields extends Schema.Struct.Fields>(plan: Resu
331
339
  declare const resume: <Model, Fields extends Schema.Struct.Fields>(plan: ResumePlan<Model, Fields>, page: ParentNode, options?: {
332
340
  readonly route?: string | undefined;
333
341
  }) => Result.Result<Model, ResumeRefused>;
342
+ /**
343
+ * The Message telling the application the URL it is at, when the page was
344
+ * recorded for its path alone and the browser is at a query: `init` never ran
345
+ * here, so the application would otherwise never learn the query. None for
346
+ * an application without routing, or a page at no query.
347
+ */
348
+ declare const arrival: <Model, Message>(config: ResumableConfig<Model, Message>, page: ParentNode, href: string) => Option.Option<Message>;
334
349
  /** The tag a Message value carries, for naming it. */
335
350
  declare const tagOf: (message: unknown) => string;
336
351
  /**
@@ -403,7 +418,7 @@ interface Loadable {
403
418
  /** The config whose `init` returns this start, whatever arguments it is given. */
404
419
  declare const startingFrom: <Model>(config: ResumableConfig<Model>, start: {
405
420
  readonly model: Model;
406
- readonly commands?: ReadonlyArray<unknown>;
421
+ readonly commands?: ReadonlyArray<unknown> | undefined;
407
422
  }) => {
408
423
  ports?: Readonly<{
409
424
  inbound?: Readonly<Record<string, import("foldkit/port").Inbound<any, any>>>;
@@ -449,7 +464,7 @@ declare const startingFrom: <Model>(config: ResumableConfig<Model>, start: {
449
464
  lazy?: ReadonlyArray<Loadable> | undefined;
450
465
  init: () => {
451
466
  readonly model: Model;
452
- readonly commands?: ReadonlyArray<unknown>;
467
+ readonly commands?: ReadonlyArray<unknown> | undefined;
453
468
  };
454
469
  };
455
470
  /** A route as the envelope records it: the path and the query. */
@@ -471,5 +486,5 @@ declare const bindingsAndEvents: <Model, Fields extends Schema.Struct.Fields>(pl
471
486
  readonly bindings: ReadonlyArray<DecodedBinding>;
472
487
  readonly events: ReadonlyArray<string> | undefined;
473
488
  }, ResumeRefused>;
474
- export { reportingTo as $, serving as A, within as B, pathKey as C, resume as D, refuse as E, Region as F, SsrDiagnostic as G, HandlerUnnamed as H, RenderContext as I, handlerUnnamed as J, StaticRegionMissing as K, UnnamedHandler as L, staticRegion as M, tagOf as N, routeOf as O, Binding as P, pageFailed as Q, current as R, modelFrom as S, projectionsOf as T, PageContained as U, BundleUnloaded as V, PageFailed as W, otherBuild as X, noBuildId as Y, pageContained as Z, bindings as _, PROTOCOL as a, metaEntry as b, ResumableConfig as c, ResumeRefused as d, staticRegionMissing as et, RouteMatch as f, attributeOf as g, allowedTags as h, Meta as i, startingFrom as j, serializeJsonScript as k, ResumePart as l, Start as m, Loadable as n, PlanSurface as o, STATIC_ATTRIBUTE as p, bundleUnloaded as q, META_ATTRIBUTE as r, RESUME_ATTRIBUTE as s, FOLDKIT_APP_ATTRIBUTE as t, ResumePlan as u, bindingsAndEvents as v, plan as w, metaMarkup as x, codecOf as y, withContext as z };
475
- //# sourceMappingURL=shared-v1u-OEQI.d.ts.map
489
+ export { pageContained as $, routeOf as A, current as B, metaMarkup as C, projectionsOf as D, plan as E, tagOf as F, PageContained as G, within as H, Binding as I, StaticRegionMissing as J, PageFailed as K, Region as L, serving as M, startingFrom as N, refuse as O, staticRegion as P, otherBuild as Q, RenderContext as R, metaEntry as S, pathKey as T, BundleUnloaded as U, withContext as V, HandlerUnnamed as W, handlerUnnamed as X, bundleUnloaded as Y, noBuildId as Z, arrival as _, PROTOCOL as a, bindingsAndEvents as b, ResumableConfig as c, ResumeRefused as d, pageFailed as et, RouteMatch as f, allowedTags as g, Start as h, Meta as i, serializeJsonScript as j, resume as k, ResumePart as l, STYLES_MARKER as m, Loadable as n, staticRegionMissing as nt, PlanSurface as o, STATIC_ATTRIBUTE as p, SsrDiagnostic as q, META_ATTRIBUTE as r, RESUME_ATTRIBUTE as s, FOLDKIT_APP_ATTRIBUTE as t, reportingTo as tt, ResumePlan as u, attributeOf as v, modelFrom as w, codecOf as x, bindings as y, UnnamedHandler as z };
490
+ //# sourceMappingURL=shared-DbupL3vO.d.ts.map