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.
- package/README.md +315 -36
- package/dist/{client-F16QT0sc.d.ts → client-XnpTQZHw.d.ts} +15 -5
- package/dist/client-XnpTQZHw.d.ts.map +1 -0
- package/dist/client.d.ts +5 -5
- package/dist/client.js +126 -54
- package/dist/client.js.map +1 -1
- package/dist/context.d.ts +1 -1
- package/dist/context.js +12 -0
- package/dist/context.js.map +1 -1
- package/dist/diagnostics.d.ts +1 -1
- package/dist/index.d.ts +83 -23
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +174 -54
- package/dist/index.js.map +1 -1
- package/dist/keep.d.ts +34 -0
- package/dist/keep.d.ts.map +1 -0
- package/dist/keep.js +80 -0
- package/dist/keep.js.map +1 -0
- package/dist/{listen-zNd0IIAT.d.ts → listen-DaUPRKVR.d.ts} +4 -2
- package/dist/listen-DaUPRKVR.d.ts.map +1 -0
- package/dist/listen.d.ts +2 -2
- package/dist/listen.js +31 -23
- package/dist/listen.js.map +1 -1
- package/dist/{resumable-BWItJsxF.d.ts → resumable-BPN_qQHU.d.ts} +33 -12
- package/dist/resumable-BPN_qQHU.d.ts.map +1 -0
- package/dist/resumable.d.ts +2 -2
- package/dist/resumable.js +51 -8
- package/dist/resumable.js.map +1 -1
- package/dist/{shared-v1u-OEQI.d.ts → shared-DbupL3vO.d.ts} +20 -5
- package/dist/shared-DbupL3vO.d.ts.map +1 -0
- package/dist/shared.d.ts +2 -2
- package/dist/shared.js +25 -2
- package/dist/shared.js.map +1 -1
- package/dist/vite.d.ts +1 -1
- package/package.json +9 -9
- package/dist/client-F16QT0sc.d.ts.map +0 -1
- package/dist/listen-zNd0IIAT.d.ts.map +0 -1
- package/dist/resumable-BWItJsxF.d.ts.map +0 -1
- 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
|
-
/**
|
|
101
|
-
const
|
|
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
|
|
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 =
|
|
147
|
+
const tokens = markers.get(node)?.get(type);
|
|
140
148
|
let stopped = false;
|
|
141
|
-
if (tokens !==
|
|
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
|
package/dist/listen.js.map
CHANGED
|
@@ -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):
|
|
43
|
-
<M extends AnyMemberSchema, const Fixed extends Fixable<M> = {}>(member: M & ProducesMessage<M, Message> & TextHoleCheck<M, Fixed>, fixed?: Fixed):
|
|
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):
|
|
48
|
-
<M extends AnyMemberSchema, const Fixed extends Fixable<M> = {}>(member: M & ProducesMessage<M, Message> & KeyHoleCheck<M, Fixed>, fixed?: Fixed):
|
|
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,
|
|
86
|
-
//# sourceMappingURL=resumable-
|
|
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"}
|
package/dist/resumable.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { a as FALLBACK_FIELD, c as
|
|
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,
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
298
|
-
*
|
|
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
|
package/dist/resumable.js.map
CHANGED
|
@@ -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-
|
|
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 {
|
|
475
|
-
//# sourceMappingURL=shared-
|
|
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
|