@bettercms-ai/kit 3.1.29 → 3.2.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/dist/context.d.ts +11 -0
- package/dist/context.js.map +1 -1
- package/dist/controls/media.js +5 -0
- package/dist/controls/media.js.map +1 -1
- package/dist/controls/rich-text/blocks.js +1 -1
- package/dist/controls/rich-text/control.d.ts +2 -1
- package/dist/controls/rich-text/control.js +21 -8
- package/dist/controls/rich-text/control.js.map +1 -1
- package/dist/controls/rich-text/editor.js +1 -1
- package/dist/engine/frame.js +1 -1
- package/dist/engine/frame.js.map +1 -1
- package/dist/engine/held.d.ts +82 -0
- package/dist/engine/held.js +190 -0
- package/dist/engine/held.js.map +1 -0
- package/dist/engine/kit-field.d.ts +9 -3
- package/dist/engine/kit-field.js +38 -12
- package/dist/engine/kit-field.js.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/schema/types.d.ts +9 -0
- package/dist/schema/types.js.map +1 -1
- package/dist/styles.css +1 -1
- package/dist/ui/controls.js +4 -2
- package/dist/ui/controls.js.map +1 -1
- package/dist/ui/input.js +43 -0
- package/dist/ui/input.js.map +1 -1
- package/package.json +2 -2
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"control.js","names":[],"sources":["../../../src/controls/rich-text/control.tsx"],"sourcesContent":["/**\n * Rich text field (V2 HEAD controls/richtext.tsx, CPO D49).\n * - The editor stays in place: the document variant is the full editor in the column, the panel variant (inspector)\n * the same editor height-capped.\n * - Expanding (the toolbar's expand button, ⌘↵, or the expand icon in the field's label row at rest) opens the shared\n * ExpandedEditorModal: breadcrumb \"Section › Item › Field\", word count, Done. Esc closes and focus returns.\n *\n * STORAGE. The editor edits HTML; the stored value stays what production stores for the field, through the host's\n * codec (KitServices.richText, see ./codec.ts):\n * - read: stored value → the HTML the editor opens on (+ what the field accepts)\n * - write: edited HTML → the stored value, in the surface's own shape; a write that would drop something is refused,\n * named, and nothing is stored\n * - probe: a value the editor cannot carry unchanged (open → no edit → write ≠ stored) is not opened here at all: the\n * host's own control edits it (LegacyFallback), with the reason above it. Opening never writes.\n */\nimport * as React from \"react\";\nimport { IconArrowsMaximize } from \"@tabler/icons-react\";\nimport { cn } from \"../../lib/cn\";\nimport { useForm, useKitEnv, useKitServices } from \"../../context\";\nimport { resolveFrames } from \"../../lib/frames\";\nimport { pathKey } from \"../../lib/path\";\nimport type { ControlProps } from \"../../types\";\nimport { Tooltip } from \"../../ui/overlay\";\nimport { LegacyFallback } from \"../../engine/kit-field\";\nimport { FieldCommentRequest } from \"../../engine/field-shell\";\nimport type { KitRichTextCodec, RichTextRead } from \"./codec\";\nimport { editorRoundTrip } from \"./dom\";\nimport { RichTextEditor } from \"./editor\";\nimport { paragraphsHtml, plainParagraphs, usePlainRichText } from \"./plain\";\nimport { Textarea } from \"../../ui/input\";\nimport { TEXT_FOCUS } from \"../text\";\nimport { UnknownValueNote } from \"../unknown-value\";\n\n/* ── which rich-text field (docKey) has its full editor open — shared with the label-row action ── */\nlet openKey: string | null = null;\nconst subs = new Set<() => void>();\nexport function setFullEditor(key: string | null) {\n openKey = key;\n subs.forEach((s) => s());\n}\nfunction useFullEditorKey() {\n return React.useSyncExternalStore(\n (cb) => {\n subs.add(cb);\n return () => subs.delete(cb);\n },\n () => openKey,\n () => openKey,\n );\n}\n\n/* ── fields whose value went to the host's own control: the label-row expand button is not theirs to draw ── */\nconst handedOff = new Set<string>();\nfunction setHandedOff(key: string, on: boolean) {\n if (handedOff.has(key) === on) return;\n if (on) handedOff.add(key);\n else handedOff.delete(key);\n subs.forEach((s) => s());\n}\nfunction useHandedOff(key: string) {\n return React.useSyncExternalStore(\n (cb) => {\n subs.add(cb);\n return () => subs.delete(cb);\n },\n () => handedOff.has(key),\n () => handedOff.has(key),\n );\n}\n\n/** The expanded editor's breadcrumb: the form's frames (root › drilled items) and this field. */\nfunction useExpandCrumbs(fieldTitle: string): string[] {\n const form = useForm();\n const env = useKitEnv();\n if (!form) return [env.docTitle, fieldTitle].filter(Boolean) as string[];\n const { frames } = resolveFrames(form.schema, form.value, form.path, form.resolveSchema);\n const titles = frames.filter((f) => f.kind !== \"history\").map((f, i) => (i === 0 ? env.docTitle || f.title : f.title));\n return [...titles, fieldTitle];\n}\n\n/** A stored block array, or the `{ content }` / `{ format, value }` envelope around one, holding a pull quote block. */\nconst holdsPullQuote = (seed: unknown): boolean =>\n Array.isArray(seed)\n ? seed.some((b) => !!b && typeof b === \"object\" && (b as { _type?: unknown })._type === \"pullQuote\")\n : !!seed && typeof seed === \"object\" && holdsPullQuote((seed as { content?: unknown; value?: unknown }).content ?? (seed as { value?: unknown }).value);\n\n/** What the control decided for one stored value. */\ntype Opened =\n | { ok: true; read: RichTextRead; html: string }\n | { ok: false; reason: string };\n\n/**\n * Open a stored value: read it, then prove the editor carries it unchanged (load → serialize → write === stored).\n * A codec that throws, or a value that does not survive, is handed to the host's own control with the reason.\n */\nexport function openValue(codec: KitRichTextCodec, value: unknown, at: Parameters<KitRichTextCodec[\"read\"]>[1]): Opened {\n let read: RichTextRead;\n try {\n read = codec.read(value, at);\n } catch (err) {\n return { ok: false, reason: `the stored text could not be read (${err instanceof Error ? err.message : String(err)})` };\n }\n // a pull quote (V2 D55 article block) opens as the editor's pull-quote island, but only when the codec renders the\n // stored block as its markup in a field that offers it: a codec that renders nothing for it, or a field with no place\n // for one (a single paragraph), would lose it, so the standard editor edits it\n if (holdsPullQuote(read.seed) && (!/data-rt=\"pullquote\"/.test(read.html) || !read.features.includes(\"pullquote\")))\n return { ok: false, reason: \"it holds a pull quote, which the standard editor edits\" };\n // tables and pull quotes are islands (V2 TableBlock, PullQuote); the probe below proves they survive unchanged\n const html = editorRoundTrip(read.html);\n try {\n const back = codec.write(html, at, value);\n if (back.losses.length) return { ok: false, reason: `this editor would drop ${back.losses.join(\", \")}` };\n if (!codec.same(back.value, read.seed)) return { ok: false, reason: \"it holds formatting this editor cannot keep\" };\n } catch (err) {\n return { ok: false, reason: `the text could not be checked (${err instanceof Error ? err.message : String(err)})` };\n }\n return { ok: true, read, html };\n}\n\nexport function RichTextControl(props: ControlProps) {\n const { richText } = useKitServices();\n if (!richText) return <LegacyFallback {...props} />;\n return <CodecRichText codec={richText} {...props} />;\n}\n\nfunction CodecRichText({ codec, field, value, onChange, readOnly, path, id, invalid }: ControlProps & { codec: KitRichTextCodec }) {\n const env = useKitEnv();\n /* GAP-004: with no comments panel (env.onComment), the field's own comments popover takes the selected words */\n const requestComment = React.useContext(FieldCommentRequest);\n const docKey = `${env.docId}:${pathKey(path)}`;\n const open = useFullEditorKey() === docKey;\n const crumbs = useExpandCrumbs(field.title);\n const plainScope = usePlainRichText();\n const at = React.useMemo(() => ({ field, path }), [field, path]);\n // the components this field may embed (More components): a hook with one identity for the form's life, so calling it\n // only when the host provides it keeps the hook order fixed\n const { useInsertableComponents } = useKitServices();\n const insertable = useInsertableComponents?.(at);\n /* our own last write: its value comes back as `value`, and the editor keeps the HTML it emitted (no reload, no probe).\n Compared by content (NEW-RT5): a host hands it back as a new object (the dock re-reads its stored values), and the\n reload that followed replaced the body under an open footnote popover or block form after its first keystroke */\n const mine = React.useRef<{ value: unknown; html: string } | null>(null);\n const [refusal, setRefusal] = React.useState<string | null>(null);\n const opened = React.useMemo<Opened>(() => {\n if (mine.current && (mine.current.value === value || codec.same(mine.current.value, value))) {\n try {\n return { ok: true, read: codec.read(value, at), html: mine.current.html };\n } catch {\n /* judged afresh below, which names the failure */\n }\n }\n return openValue(codec, value, at);\n // `at` changes identity with the field object; the field's content is what matters\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [codec, value, JSON.stringify(field), pathKey(path)]);\n\n // close when this field goes away (block deselected, drilled elsewhere)\n React.useEffect(\n () => () => {\n if (openKey === docKey) setFullEditor(null);\n setHandedOff(docKey, false);\n },\n [docKey],\n );\n React.useLayoutEffect(() => {\n setHandedOff(docKey, !opened.ok);\n if (!opened.ok && openKey === docKey) setFullEditor(null);\n }, [docKey, opened.ok]);\n\n if (!opened.ok)\n return (\n <div className=\"flex min-w-0 flex-col gap-1.5\">\n <p role=\"note\" data-slot=\"kit-richtext-handoff\" className=\"rounded-kit-md bg-kit-subtle px-2.5 py-1.5 text-kit-xs text-kit-fg-2\">\n Edited with the standard editor: {opened.reason}.\n </p>\n <LegacyFallback field={field} value={value} onChange={onChange} readOnly={readOnly} path={path} id={id} invalid={invalid} />\n </div>\n );\n\n const { read, html } = opened;\n const write = (next: string) => {\n let res;\n try {\n res = codec.write(next, at, value);\n } catch (err) {\n setRefusal(`Not saved: the text could not be stored (${err instanceof Error ? err.message : String(err)}). Undo the last change with ⌘Z; leaving the field puts back the saved text.`);\n return;\n }\n if (res.losses.length) {\n setRefusal(`Not saved: this field cannot keep ${res.losses.join(\", \")}. Undo the last change with ⌘Z; leaving the field puts back the saved text.`);\n return;\n }\n setRefusal(null);\n if (codec.same(res.value, value)) return;\n mine.current = { value: res.value, html: next };\n onChange(res.value);\n };\n\n // The Values popover (PlainRichTextScope): plain paragraphs are V2's growing textarea (its `text` control), written\n // back through the same codec, one `<p>` per line. Anything richer keeps the editor below.\n const plain = plainScope && !read.losses.length ? plainParagraphs(html) : null;\n if (plain !== null)\n return (\n <div className=\"flex min-w-0 flex-col gap-1.5\">\n <Textarea\n id={id}\n rows={3}\n value={plain}\n readOnly={readOnly}\n aria-invalid={invalid || !!refusal}\n placeholder={field.placeholder}\n onChange={(e) => write(paragraphsHtml(e.target.value))}\n className={cn(TEXT_FOCUS, \"leading-5\")}\n />\n {refusal ? (\n <p role=\"alert\" className=\"text-kit-xs text-kit-danger-fg\">\n {refusal}\n </p>\n ) : null}\n </div>\n );\n\n /* V2 richtext.tsx:57: the editor sits in a plain <div>; the dash-only notes keep the 6px gap as their own margin */\n return (\n <div>\n {read.losses.length ? (\n <p role=\"status\" className=\"mb-1.5 rounded-kit-md bg-kit-warning-soft px-2.5 py-1.5 text-kit-xs text-kit-warning-fg\">\n Saved by an earlier editor. Editing here would drop {read.losses.join(\", \")}. Nothing changes until you edit.\n </p>\n ) : null}\n {read.undeclared?.length && codec.remap ? (\n <div className=\"mb-1.5\">\n <UnknownValueNote\n items={read.undeclared}\n onRemap={(key, to) => onChange(codec.remap!(value, at, key, to))}\n onRemove={(key) => onChange(codec.remap!(value, at, key, null))}\n readOnly={readOnly}\n />\n </div>\n ) : null}\n <RichTextEditor\n value={html}\n onChange={write}\n readOnly={readOnly}\n placeholder={field.placeholder}\n docKey={docKey}\n id={id}\n invalid={invalid || !!refusal}\n features={read.features}\n references={read.references}\n single={read.single}\n allowNewTab={read.newTab}\n components={insertable && !read.single && !readOnly ? insertable : undefined}\n variant={env.variant === \"document\" ? \"document\" : \"panel\"}\n maxHeight={env.variant === \"document\" ? undefined : 320}\n expandCrumbs={crumbs}\n expandedOpen={open}\n onExpandedOpenChange={(o) => setFullEditor(o ? docKey : null)}\n // select words → Comment in the toolbar: the host's comment popover opens on this field, quoting them\n onComment={\n env.onComment ? (quote) => env.onComment?.(path, field, quote) : requestComment ? (quote, around) => requestComment({ quote, ...around }) : undefined\n }\n // the field's popover sits under the field, behind the expanded editor's focus trap: no Comment in there\n commentInPlace={!env.onComment && !!requestComment}\n />\n {refusal ? (\n <p role=\"alert\" className=\"mt-1.5 text-kit-xs text-kit-danger-fg\">\n {refusal}\n </p>\n ) : null}\n </div>\n );\n}\n\n/** Label-row action (at rest): the field's toolbar holds the same button while it's open. */\nfunction readsPlain(codec: KitRichTextCodec, value: unknown, field: ControlProps[\"field\"], path: ControlProps[\"path\"]) {\n try {\n const read = codec.read(value, { field, path });\n return !read.losses.length && plainParagraphs(editorRoundTrip(read.html)) !== null;\n } catch {\n return false; // the control names the failure itself\n }\n}\n\nexport function RichTextExpandAction({ path, field, value }: ControlProps) {\n const env = useKitEnv();\n const { richText } = useKitServices();\n const handed = useHandedOff(`${env.docId}:${pathKey(path)}`);\n const plainScope = usePlainRichText();\n // the host's own control (no codec, or a value handed to it) has its own full-screen button\n if (env.variant === \"document\" || !richText || handed) return null;\n // drawn as a plain textarea (V2's `text` control has no ⤢)\n if (plainScope && readsPlain(richText, value, field, path)) return null;\n return (\n <Tooltip content=\"Expand editor\" shortcut=\"⌘↵\">\n <button\n type=\"button\"\n aria-label={`Expand ${field.title}`}\n onClick={() => setFullEditor(`${env.docId}:${pathKey(path)}`)}\n className={cn(\n \"-my-0.5 hidden size-6 items-center justify-center rounded-kit-md text-kit-fg-3 hover:bg-kit-hover hover:text-kit-fg\",\n \"group-hover/field:inline-flex group-focus-within/field:!hidden [@media(pointer:coarse)]:inline-flex\",\n )}\n >\n <IconArrowsMaximize className=\"size-3.5\" stroke={1.5} aria-hidden />\n </button>\n </Tooltip>\n );\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"control.js","names":[],"sources":["../../../src/controls/rich-text/control.tsx"],"sourcesContent":["/**\n * Rich text field (V2 HEAD controls/richtext.tsx, CPO D49).\n * - The editor stays in place: the document variant is the full editor in the column, the panel variant (inspector)\n * the same editor height-capped.\n * - Expanding (the toolbar's expand button, ⌘↵, or the expand icon in the field's label row at rest) opens the shared\n * ExpandedEditorModal: breadcrumb \"Section › Item › Field\", word count, Done. Esc closes and focus returns.\n *\n * STORAGE. The editor edits HTML; the stored value stays what production stores for the field, through the host's\n * codec (KitServices.richText, see ./codec.ts):\n * - read: stored value → the HTML the editor opens on (+ what the field accepts)\n * - write: edited HTML → the stored value, in the surface's own shape; a write that would drop something is refused,\n * named, and nothing is stored\n * - probe: a value the editor cannot carry unchanged (open → no edit → write ≠ stored) is not opened here at all: it\n * is HELD (read-only, its HTML shown, the reason above it; kit 3.2.0), or, while the host still provides\n * KitServices.LegacyControl (removed in 4.0.0), the host's own control edits it. Opening never writes.\n */\nimport * as React from \"react\";\nimport { IconArrowsMaximize } from \"@tabler/icons-react\";\nimport { cn } from \"../../lib/cn\";\nimport { useForm, useKitEnv, useKitServices } from \"../../context\";\nimport { resolveFrames } from \"../../lib/frames\";\nimport { pathKey } from \"../../lib/path\";\nimport type { ControlProps } from \"../../types\";\nimport { Tooltip } from \"../../ui/overlay\";\nimport { LegacyFallback } from \"../../engine/kit-field\";\nimport { HeldValue } from \"../../engine/held\";\nimport { FieldCommentRequest } from \"../../engine/field-shell\";\nimport type { KitRichTextCodec, RichTextRead } from \"./codec\";\nimport { editorRoundTrip } from \"./dom\";\nimport { RichTextEditor } from \"./editor\";\nimport { paragraphsHtml, plainParagraphs, usePlainRichText } from \"./plain\";\nimport { Textarea } from \"../../ui/input\";\nimport { TEXT_FOCUS } from \"../text\";\nimport { UnknownValueNote } from \"../unknown-value\";\n\n/* ── which rich-text field (docKey) has its full editor open — shared with the label-row action ── */\nlet openKey: string | null = null;\nconst subs = new Set<() => void>();\nexport function setFullEditor(key: string | null) {\n openKey = key;\n subs.forEach((s) => s());\n}\nfunction useFullEditorKey() {\n return React.useSyncExternalStore(\n (cb) => {\n subs.add(cb);\n return () => subs.delete(cb);\n },\n () => openKey,\n () => openKey,\n );\n}\n\n/* ── fields whose value went to the host's own control: the label-row expand button is not theirs to draw ── */\nconst handedOff = new Set<string>();\nfunction setHandedOff(key: string, on: boolean) {\n if (handedOff.has(key) === on) return;\n if (on) handedOff.add(key);\n else handedOff.delete(key);\n subs.forEach((s) => s());\n}\nfunction useHandedOff(key: string) {\n return React.useSyncExternalStore(\n (cb) => {\n subs.add(cb);\n return () => subs.delete(cb);\n },\n () => handedOff.has(key),\n () => handedOff.has(key),\n );\n}\n\n/** The expanded editor's breadcrumb: the form's frames (root › drilled items) and this field. */\nfunction useExpandCrumbs(fieldTitle: string): string[] {\n const form = useForm();\n const env = useKitEnv();\n if (!form) return [env.docTitle, fieldTitle].filter(Boolean) as string[];\n const { frames } = resolveFrames(form.schema, form.value, form.path, form.resolveSchema);\n const titles = frames.filter((f) => f.kind !== \"history\").map((f, i) => (i === 0 ? env.docTitle || f.title : f.title));\n return [...titles, fieldTitle];\n}\n\n/** A stored block array, or the `{ content }` / `{ format, value }` envelope around one, holding a pull quote block. */\nconst holdsPullQuote = (seed: unknown): boolean =>\n Array.isArray(seed)\n ? seed.some((b) => !!b && typeof b === \"object\" && (b as { _type?: unknown })._type === \"pullQuote\")\n : !!seed && typeof seed === \"object\" && holdsPullQuote((seed as { content?: unknown; value?: unknown }).content ?? (seed as { value?: unknown }).value);\n\n/** What the control decided for one stored value. */\ntype Opened =\n | { ok: true; read: RichTextRead; html: string }\n | { ok: false; reason: string; /** the HTML the codec read, when it could: what a held field shows */ html?: string };\n\n/**\n * Open a stored value: read it, then prove the editor carries it unchanged (load → serialize → write === stored).\n * A codec that throws, or a value that does not survive, is handed to the host's own control with the reason.\n */\nexport function openValue(codec: KitRichTextCodec, value: unknown, at: Parameters<KitRichTextCodec[\"read\"]>[1]): Opened {\n let read: RichTextRead;\n try {\n read = codec.read(value, at);\n } catch (err) {\n return { ok: false, reason: `the stored text could not be read (${err instanceof Error ? err.message : String(err)})` };\n }\n // a pull quote (V2 D55 article block) opens as the editor's pull-quote island, but only when the codec renders the\n // stored block as its markup in a field that offers it: a codec that renders nothing for it, or a field with no place\n // for one (a single paragraph), would lose it, so the standard editor edits it\n if (holdsPullQuote(read.seed) && (!/data-rt=\"pullquote\"/.test(read.html) || !read.features.includes(\"pullquote\")))\n return { ok: false, reason: \"it holds a pull quote, which the standard editor edits\", html: read.html };\n // tables and pull quotes are islands (V2 TableBlock, PullQuote); the probe below proves they survive unchanged\n const html = editorRoundTrip(read.html);\n try {\n const back = codec.write(html, at, value);\n if (back.losses.length) return { ok: false, reason: `this editor would drop ${back.losses.join(\", \")}`, html: read.html };\n if (!codec.same(back.value, read.seed)) return { ok: false, reason: \"it holds formatting this editor cannot keep\", html: read.html };\n } catch (err) {\n return { ok: false, reason: `the text could not be checked (${err instanceof Error ? err.message : String(err)})`, html: read.html };\n }\n return { ok: true, read, html };\n}\n\nexport function RichTextControl(props: ControlProps) {\n const { richText } = useKitServices();\n if (!richText) return <LegacyFallback {...props} />;\n return <CodecRichText codec={richText} {...props} />;\n}\n\nfunction CodecRichText({ codec, field, value, onChange, readOnly, path, id, invalid }: ControlProps & { codec: KitRichTextCodec }) {\n const env = useKitEnv();\n /* GAP-004: with no comments panel (env.onComment), the field's own comments popover takes the selected words */\n const requestComment = React.useContext(FieldCommentRequest);\n const docKey = `${env.docId}:${pathKey(path)}`;\n const open = useFullEditorKey() === docKey;\n const crumbs = useExpandCrumbs(field.title);\n const plainScope = usePlainRichText();\n const at = React.useMemo(() => ({ field, path }), [field, path]);\n // the components this field may embed (More components): a hook with one identity for the form's life, so calling it\n // only when the host provides it keeps the hook order fixed\n const { useInsertableComponents, LegacyControl } = useKitServices();\n const insertable = useInsertableComponents?.(at);\n /* our own last write: its value comes back as `value`, and the editor keeps the HTML it emitted (no reload, no probe).\n Compared by content (NEW-RT5): a host hands it back as a new object (the dock re-reads its stored values), and the\n reload that followed replaced the body under an open footnote popover or block form after its first keystroke */\n const mine = React.useRef<{ value: unknown; html: string } | null>(null);\n const [refusal, setRefusal] = React.useState<string | null>(null);\n const opened = React.useMemo<Opened>(() => {\n if (mine.current && (mine.current.value === value || codec.same(mine.current.value, value))) {\n try {\n return { ok: true, read: codec.read(value, at), html: mine.current.html };\n } catch {\n /* judged afresh below, which names the failure */\n }\n }\n return openValue(codec, value, at);\n // `at` changes identity with the field object; the field's content is what matters\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [codec, value, JSON.stringify(field), pathKey(path)]);\n\n // close when this field goes away (block deselected, drilled elsewhere)\n React.useEffect(\n () => () => {\n if (openKey === docKey) setFullEditor(null);\n setHandedOff(docKey, false);\n },\n [docKey],\n );\n React.useLayoutEffect(() => {\n setHandedOff(docKey, !opened.ok);\n if (!opened.ok && openKey === docKey) setFullEditor(null);\n }, [docKey, opened.ok]);\n\n // kit 3.2.0: with no host control to hand it to, the value is held (shown read-only with the reason, never written)\n if (!opened.ok && !LegacyControl) return <HeldValue field={field} value={value} id={id} reason={opened.reason} html={opened.html} />;\n if (!opened.ok)\n return (\n <div className=\"flex min-w-0 flex-col gap-1.5\">\n <p role=\"note\" data-slot=\"kit-richtext-handoff\" className=\"rounded-kit-md bg-kit-subtle px-2.5 py-1.5 text-kit-xs text-kit-fg-2\">\n Edited with the standard editor: {opened.reason}.\n </p>\n <LegacyFallback field={field} value={value} onChange={onChange} readOnly={readOnly} path={path} id={id} invalid={invalid} />\n </div>\n );\n\n const { read, html } = opened;\n const write = (next: string) => {\n let res;\n try {\n res = codec.write(next, at, value);\n } catch (err) {\n setRefusal(`Not saved: the text could not be stored (${err instanceof Error ? err.message : String(err)}). Undo the last change with ⌘Z; leaving the field puts back the saved text.`);\n return;\n }\n if (res.losses.length) {\n setRefusal(`Not saved: this field cannot keep ${res.losses.join(\", \")}. Undo the last change with ⌘Z; leaving the field puts back the saved text.`);\n return;\n }\n setRefusal(null);\n if (codec.same(res.value, value)) return;\n mine.current = { value: res.value, html: next };\n onChange(res.value);\n };\n\n // The Values popover (PlainRichTextScope): plain paragraphs are V2's growing textarea (its `text` control), written\n // back through the same codec, one `<p>` per line. Anything richer keeps the editor below.\n const plain = plainScope && !read.losses.length ? plainParagraphs(html) : null;\n if (plain !== null)\n return (\n <div className=\"flex min-w-0 flex-col gap-1.5\">\n <Textarea\n id={id}\n rows={3}\n value={plain}\n readOnly={readOnly}\n aria-invalid={invalid || !!refusal}\n placeholder={field.placeholder}\n onChange={(e) => write(paragraphsHtml(e.target.value))}\n className={cn(TEXT_FOCUS, \"leading-5\")}\n />\n {refusal ? (\n <p role=\"alert\" className=\"text-kit-xs text-kit-danger-fg\">\n {refusal}\n </p>\n ) : null}\n </div>\n );\n\n /* V2 richtext.tsx:57: the editor sits in a plain <div>; the dash-only notes keep the 6px gap as their own margin */\n return (\n <div>\n {read.losses.length ? (\n <p role=\"status\" className=\"mb-1.5 rounded-kit-md bg-kit-warning-soft px-2.5 py-1.5 text-kit-xs text-kit-warning-fg\">\n Saved by an earlier editor. Editing here would drop {read.losses.join(\", \")}. Nothing changes until you edit.\n </p>\n ) : null}\n {read.undeclared?.length && codec.remap ? (\n <div className=\"mb-1.5\">\n <UnknownValueNote\n items={read.undeclared}\n onRemap={(key, to) => onChange(codec.remap!(value, at, key, to))}\n onRemove={(key) => onChange(codec.remap!(value, at, key, null))}\n readOnly={readOnly}\n />\n </div>\n ) : null}\n <RichTextEditor\n value={html}\n onChange={write}\n readOnly={readOnly}\n placeholder={field.placeholder}\n docKey={docKey}\n id={id}\n invalid={invalid || !!refusal}\n features={read.features}\n references={read.references}\n single={read.single}\n allowNewTab={read.newTab}\n components={insertable && !read.single && !readOnly ? insertable : undefined}\n variant={env.variant === \"document\" ? \"document\" : \"panel\"}\n maxHeight={env.variant === \"document\" ? undefined : 320}\n expandCrumbs={crumbs}\n expandedOpen={open}\n onExpandedOpenChange={(o) => setFullEditor(o ? docKey : null)}\n // select words → Comment in the toolbar: the host's comment popover opens on this field, quoting them\n onComment={\n env.onComment ? (quote) => env.onComment?.(path, field, quote) : requestComment ? (quote, around) => requestComment({ quote, ...around }) : undefined\n }\n // the field's popover sits under the field, behind the expanded editor's focus trap: no Comment in there\n commentInPlace={!env.onComment && !!requestComment}\n />\n {refusal ? (\n <p role=\"alert\" className=\"mt-1.5 text-kit-xs text-kit-danger-fg\">\n {refusal}\n </p>\n ) : null}\n </div>\n );\n}\n\n/** Label-row action (at rest): the field's toolbar holds the same button while it's open. */\nfunction readsPlain(codec: KitRichTextCodec, value: unknown, field: ControlProps[\"field\"], path: ControlProps[\"path\"]) {\n try {\n const read = codec.read(value, { field, path });\n return !read.losses.length && plainParagraphs(editorRoundTrip(read.html)) !== null;\n } catch {\n return false; // the control names the failure itself\n }\n}\n\nexport function RichTextExpandAction({ path, field, value }: ControlProps) {\n const env = useKitEnv();\n const { richText } = useKitServices();\n const handed = useHandedOff(`${env.docId}:${pathKey(path)}`);\n const plainScope = usePlainRichText();\n // the host's own control (no codec, or a value handed to it) has its own full-screen button\n if (env.variant === \"document\" || !richText || handed) return null;\n // drawn as a plain textarea (V2's `text` control has no ⤢)\n if (plainScope && readsPlain(richText, value, field, path)) return null;\n return (\n <Tooltip content=\"Expand editor\" shortcut=\"⌘↵\">\n <button\n type=\"button\"\n aria-label={`Expand ${field.title}`}\n onClick={() => setFullEditor(`${env.docId}:${pathKey(path)}`)}\n className={cn(\n \"-my-0.5 hidden size-6 items-center justify-center rounded-kit-md text-kit-fg-3 hover:bg-kit-hover hover:text-kit-fg\",\n \"group-hover/field:inline-flex group-focus-within/field:!hidden [@media(pointer:coarse)]:inline-flex\",\n )}\n >\n <IconArrowsMaximize className=\"size-3.5\" stroke={1.5} aria-hidden />\n </button>\n </Tooltip>\n );\n}\n"],"mappings":"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"}
|
|
@@ -6,8 +6,8 @@ import { Menu, MenuContent, MenuItem, MenuRadioGroup, MenuRadioItem, MenuSeparat
|
|
|
6
6
|
import { Input, Textarea } from "../../ui/input.js";
|
|
7
7
|
import { LinkPopoverBody } from "../link.js";
|
|
8
8
|
import { ExpandedEditorModal } from "../../ui/expanded-editor-modal.js";
|
|
9
|
-
import { COMPONENT_INSERT_TOAST } from "../component-services.js";
|
|
10
9
|
import { closestBlock, createIsland, defaultModel, editingHost, esc, hydrate, isEmptyHtml, ownsMenu, placeCaret, rangeRect, rid, sanitize, serialize, textBeforeCaret, topBlock } from "./dom.js";
|
|
10
|
+
import { COMPONENT_INSERT_TOAST } from "../component-services.js";
|
|
11
11
|
import { eventKey } from "../../lib/key-event.js";
|
|
12
12
|
import { ALL_FEATURES } from "./codec.js";
|
|
13
13
|
import { createOutlineStore, outlineOf } from "./toc.js";
|
package/dist/engine/frame.js
CHANGED
|
@@ -112,7 +112,7 @@ function FrameView({ frame, parentTitle }) {
|
|
|
112
112
|
title: frame.title
|
|
113
113
|
}), TableFrame ? /* @__PURE__ */ jsx(TableFrame, { frame }) : /* @__PURE__ */ jsx("p", {
|
|
114
114
|
role: "note",
|
|
115
|
-
"data-kit-
|
|
115
|
+
"data-kit-note": "table",
|
|
116
116
|
className: "text-kit-sm text-kit-fg-3",
|
|
117
117
|
children: "This table's rows and columns are edited in the table itself."
|
|
118
118
|
})]
|
package/dist/engine/frame.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"frame.js","names":[],"sources":["../../src/engine/frame.tsx"],"sourcesContent":["/**\n * FrameView — what the panel shows for the current breadcrumb: the root fields, a drilled object / array item /\n * slot block (with \"2 of 4\" stepper, variant switcher and per-slot layout settings), the one button screen,\n * or a field's history as a stacked panel. Port of V2 engine/frame.tsx.\n *\n * FrameStage + useFrameNavigation — V2 schema-form's drill-in stage (direction-aware slide, scroll memory per frame,\n * focus on the entering frame, Esc / ⌥↑↓). Exported here so SchemaForm wires them without re-deriving the motion.\n *\n * FrameSlots — the frame draws other lanes' pieces (FieldList / FieldSection from grouping, ButtonScreen from link,\n * TableFrame from table). They arrive through context so this file never imports a module that does not exist yet;\n * a missing slot falls back to a plain field list (FieldList), the raw value (ButtonScreen, through\n * FallbackControl), a named note (TableFrame) or nothing (FieldSection). SchemaForm always hands ButtonScreen and TableFrame.\n */\nimport * as React from \"react\";\nimport { AnimatePresence, motion, useReducedMotion } from \"framer-motion\";\nimport { IconArrowDown, IconArrowUp, IconCopy, IconDots, IconTrash } from \"@tabler/icons-react\";\nimport { IconButton } from \"../ui/button\";\nimport { Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger, Tooltip } from \"../ui/overlay\";\nimport { Segmented } from \"../ui/controls\";\nimport { fitsSegmented } from \"../ui/choice-switch\";\nimport { Select } from \"../ui/select\";\nimport { resolveFieldAccess, useForm, useKitEnv, useKitServices } from \"../context\";\nimport { cn } from \"../lib/cn\";\nimport { HISTORY_SEGMENT, type FieldGroup, type FieldPath, type FieldSchema, type Fieldset } from \"../schema/types\";\nimport type { Frame } from \"../lib/frames\";\nimport { frameKeyOf, isObj, newKey } from \"../lib/path\";\nimport { condCtx, isHidden, itemSchemaFor, previewOf } from \"../lib/schema\";\nimport { Thumb } from \"./bits\";\nimport { FallbackControl, KitField } from \"./kit-field\";\n\n/* ── Slots (other lanes) ───────────────────────────────────────────── */\nexport interface FrameFieldListProps {\n fields: FieldSchema[];\n fieldsets?: Fieldset[];\n groups?: FieldGroup[];\n basePath: FieldPath;\n memoryKey: string;\n}\nexport interface FrameSlots {\n /** grouping lane: engine/field-list.tsx `FieldList` */\n FieldList?: React.ComponentType<FrameFieldListProps>;\n /** grouping lane: engine/grouping.tsx `FieldSection` (the slot-settings section of a slot block) */\n FieldSection?: React.ComponentType<{ title: string; description?: string; collapsible?: boolean; children: React.ReactNode }>;\n /** link lane: controls/link.tsx `ButtonScreen` + `normLink` (the \"button\" frame) */\n ButtonScreen?: React.ComponentType<{ value: unknown; onChange: (v: unknown) => void; title: string; readOnly?: boolean }>;\n normLink?: (v: unknown) => { label?: string };\n /** table lane: controls/table.tsx `TableFrame` (tableRow / tableColumn frames) */\n TableFrame?: React.ComponentType<{ frame: Frame }>;\n}\nconst SlotsCtx = React.createContext<FrameSlots>({});\nexport const FrameSlotsProvider = SlotsCtx.Provider;\nexport const useFrameSlots = () => React.useContext(SlotsCtx);\n\n/** Stand-in until the grouping lane's FieldList lands: the frame's visible fields in schema order. */\nfunction PlainFieldList({ fields, basePath }: FrameFieldListProps) {\n const form = useForm()!;\n const raw = basePath.length ? form.getAt(basePath) : form.value;\n const parent = isObj(raw) ? raw : {};\n const cc = condCtx(form, basePath);\n const shown = fields.filter((f) => !isHidden(f, parent, cc));\n return (\n <div className=\"flex flex-col gap-5\">\n {shown.map((f) => (\n <div key={f.name} className=\"min-w-0\">\n <KitField field={f} path={[...basePath, f.name]} parent={parent} />\n </div>\n ))}\n {shown.length === 0 ? <p className=\"py-6 text-center text-kit-sm text-kit-fg-3\">No fields here yet.</p> : null}\n </div>\n );\n}\n\n/** A button frame outside SchemaForm (no ButtonScreen slot) edits the button's raw value (FallbackControl), never an empty body. */\nfunction RawButtonScreen({ frame }: { frame: Frame }) {\n const form = useForm()!;\n const id = React.useId();\n const field = frame.field ?? { name: String(frame.path.at(-1) ?? \"button\"), title: frame.title, type: \"button\" as const };\n return <FallbackControl field={field} value={form.getAt(frame.path)} onChange={(n) => form.setAt(frame.path, n)} id={id} path={frame.path} />;\n}\n\n/** The button frame: header (the button's label) + the kit ButtonScreen, read-only when the lens can't edit the field. */\nfunction ButtonFrame({ frame, parentTitle }: { frame: Frame; parentTitle?: string }) {\n const form = useForm()!;\n const env = useKitEnv();\n const slots = useFrameSlots();\n const v = form.getAt(frame.path);\n const ButtonScreen = slots.ButtonScreen;\n const readOnly = frame.field ? resolveFieldAccess(frame.field, env).readOnly : !!env.readOnly;\n return (\n <div className=\"flex flex-col gap-5\">\n <FrameHeader frame={frame} context={parentTitle ? `${frame.title} in ${parentTitle}` : frame.title} title={slots.normLink?.(v).label || frame.title} />\n {ButtonScreen ? <ButtonScreen value={v} onChange={(n) => form.setAt(frame.path, n)} title={frame.title} readOnly={readOnly} /> : <RawButtonScreen frame={frame} />}\n </div>\n );\n}\n\n/* ── FrameView ─────────────────────────────────────────────────────── */\nexport function FrameView({ frame, parentTitle }: { frame: Frame; parentTitle?: string }) {\n const form = useForm()!;\n const slots = useFrameSlots();\n const FieldList = slots.FieldList ?? PlainFieldList;\n if (frame.kind === \"history\") return null; // D61: a field's history is the host's one History panel (onFieldHistory)\n if (frame.kind === \"button\") return <ButtonFrame frame={frame} parentTitle={parentTitle} />;\n // D50: a table row or column drills exactly like an array item: the same header (title, n of N, ↑ ↓ ⋯), its cells below\n if (frame.kind === \"tableRow\" || frame.kind === \"tableColumn\") {\n const it = frame.item!;\n const TableFrame = slots.TableFrame;\n return (\n <div className=\"flex flex-col gap-5\">\n <FrameHeader frame={frame} context={`${it.itemSchema?.title} ${it.index + 1} of ${it.count} in ${frame.field?.title ?? \"the table\"}`} title={frame.title} />\n {TableFrame ? (\n <TableFrame frame={frame} />\n ) : (\n /* Only the kit table control opens a row or column frame; until it is ported the table is the host's control,\n which edits rows in place. A path restored into one says so instead of drawing an empty body. */\n <p role=\"note\" data-kit-legacy=\"table\" className=\"text-kit-sm text-kit-fg-3\">\n This table's rows and columns are edited in the table itself.\n </p>\n )}\n </div>\n );\n }\n if (frame.kind === \"root\") return <FieldList fields={frame.fields} fieldsets={frame.fieldsets} groups={frame.groups} basePath={[]} memoryKey=\"root\" />;\n const it = frame.item;\n const block = it?.block;\n const variants = block?.variants ?? [];\n const raw = form.getAt(frame.path);\n const cur = isObj(raw) ? raw : {};\n const FieldSection = slots.FieldSection;\n return (\n <div className=\"flex flex-col gap-5\">\n <FrameHeader frame={frame} context={frameContext(frame, parentTitle)} title={frame.title} />\n {block && variants.length > 1 ? (\n <div className=\"flex flex-col gap-1.5\">\n <span className=\"text-kit-sm font-medium text-kit-fg-2\">Layout</span>\n {fitsSegmented(variants.map((v) => v.name)) ? (\n <Segmented\n aria-label=\"Layout\"\n value={String(cur._variant ?? variants[0].id)}\n onChange={(v) => form.setAt([...frame.path, \"_variant\"], v)}\n items={variants.map((v) => ({ value: v.id, label: v.name }))}\n className=\"w-full [&>button]:flex-1\"\n />\n ) : (\n <Select\n aria-label=\"Variant\"\n value={String(cur._variant ?? variants[0].id)}\n onValueChange={(v) => form.setAt([...frame.path, \"_variant\"], v)}\n options={variants.map((v) => ({ value: v.id, label: v.name, description: v.description }))}\n />\n )}\n </div>\n ) : null}\n <FieldList fields={frame.fields} fieldsets={frame.fieldsets} groups={frame.groups} basePath={frame.path} memoryKey={`f:${frame.kind}:${it?.block?.name ?? it?.itemSchema?.name ?? frame.field?.name ?? \"\"}`} />\n {it?.slotField?.slotSettings?.length && FieldSection ? (\n <FieldSection title={`Layout in ${it.slotField.title.toLowerCase()}`} description=\"How this block sits in its parent. The block's own content is above.\" collapsible={false}>\n <FieldList fields={it.slotField.slotSettings} basePath={[...frame.path, \"_settings\"]} memoryKey={`slotset:${it.slotField.name}`} />\n </FieldSection>\n ) : null}\n </div>\n );\n}\n\n/**\n * The context line under a drilled frame's title: \"Tier 1 of 3 in Tiers\" for an item (the item noun is the item\n * schema's title, which the adapter reads back from prod `ui.itemLabel`), \"Address in Author\" for an object.\n */\nexport function frameContext(frame: Frame, parentTitle?: string): string {\n const it = frame.item;\n if (it) {\n const noun = (frame.kind === \"block\" ? it.block?.title : it.itemSchema?.title) ?? \"Item\";\n const owner = (frame.kind === \"block\" ? it.slotField?.title : frame.field?.title) ?? \"the list\";\n return `${noun} ${it.index + 1} of ${it.count} in ${owner}`;\n }\n return parentTitle ? `${frame.field?.title ?? \"Group\"} in ${parentTitle}` : \"Group\";\n}\n\n/**\n * CPO D43 — the drilled frame's header answers \"what am I editing, and where does it live?\":\n * [media?] Starter [↑] [↓] [⋯]\n * Tier 1 of 3 in Tiers\n * The big title lives HERE only; the breadcrumb above is the path (its current crumb is small, D38). Prev / next are\n * labelled icon buttons whose tooltips name the sibling (\"Previous tier: Starter\"). No eyebrow, no duplicate counter.\n * Title 14/24 semibold (owner call). The native title= on the truncating h2 is V2 parity (kit-engine deviation from\n * the dashboard's no-title rule, see run ledger #32).\n */\nexport function FrameHeader({ frame, context, title }: { frame: Frame; context: string; title: string }) {\n const form = useForm()!;\n const { toast } = useKitServices();\n const it = frame.item;\n const media = it ? previewOf(it.block ?? it.itemSchema, form.getAt(frame.path), it.index).media : undefined;\n const step = (d: -1 | 1) => {\n if (!it) return;\n const n = it.index + d;\n if (n < 0 || n >= it.count) return;\n form.navigate([...it.arrayPath, n]);\n };\n const listRaw = it ? form.getAt(it.arrayPath) : undefined;\n const list = Array.isArray(listRaw) ? listRaw : [];\n const noun = (it?.block?.title ?? it?.itemSchema?.title ?? \"item\").toLowerCase();\n /* NEW-Q49-POLYSIBLING: in a mixed list a neighbour is named and previewed by its OWN type, not the current item's\n (a photo post's URL read as \"Next store review: https://…\") */\n const schemaAt = (i: number) => {\n const v = list[i];\n if (frame.kind === \"item\" && frame.field) return itemSchemaFor(frame.field, v) ?? it?.itemSchema;\n if (frame.kind === \"block\") return (isObj(v) && typeof v._type === \"string\" ? form.resolveSchema?.(v._type) : undefined) ?? it?.block;\n return it?.block ?? it?.itemSchema;\n };\n const nounAt = (i: number) => (it?.titleAt ? noun : (schemaAt(i)?.title ?? \"item\").toLowerCase());\n const sibling = (i: number) =>\n it && i >= 0 && i < it.count ? (it.titleAt ? it.titleAt(i) : previewOf(schemaAt(i), list[i], i, schemaAt(i)?.title).title) : \"\";\n const prev = it ? sibling(it.index - 1) : \"\";\n const next = it ? sibling(it.index + 1) : \"\";\n const prevNoun = it ? nounAt(it.index - 1) : noun;\n const nextNoun = it ? nounAt(it.index + 1) : noun;\n /* NEW-Q22-ROWLIMIT: the list's own bounds hold here as on its row menu (array.tsx): a duplicate past the maximum or a\n remove below the minimum only left a held, unsavable list */\n const bounds = frame.kind === \"item\" || frame.kind === \"block\" ? frame.field?.validation : undefined;\n const atMax = bounds?.max != null && list.length >= bounds.max;\n const atMin = bounds?.min != null && list.length <= bounds.min;\n /* NEW-Q48-ITEMACTIONS: a read-only list (a locked section, a viewer) offers no Duplicate / Remove: the host drops the\n write, so the menu only announced a change that never happened */\n const env = useKitEnv();\n const readOnly = frame.field ? resolveFieldAccess(frame.field, env).readOnly : !!env.readOnly;\n /* Duplicate / Remove move to another frame: the menu must not hand focus back to its trigger in the exiting frame\n (it unmounts, focus would drop to <body>); the stage focuses the entering frame instead */\n const moved = React.useRef(false);\n return (\n <div className=\"flex items-start gap-2.5 outline-none\" data-frame-header tabIndex={-1}>\n {media ? <Thumb media={media} size={36} /> : null}\n <div className=\"min-w-0 flex-1\">\n <h2 className=\"truncate text-kit-base font-semibold leading-6 text-kit-fg\" title={title}>\n {title}\n </h2>\n <p className=\"truncate text-kit-xs leading-4 text-kit-fg-3\">{context}</p>\n </div>\n {it ? (\n <div className=\"-mr-1 flex shrink-0 items-center gap-0.5 pt-0.5\">\n <IconButton\n label={prev ? `Previous ${prevNoun}: ${prev}` : `No previous ${noun}`}\n tooltip={prev ? `Previous ${prevNoun}: ${prev}` : `First ${noun}`}\n size=\"sm\"\n disabled={it.index === 0}\n onClick={() => step(-1)}\n >\n <IconArrowUp stroke={1.5} />\n </IconButton>\n <IconButton\n label={next ? `Next ${nextNoun}: ${next}` : `No next ${noun}`}\n tooltip={next ? `Next ${nextNoun}: ${next}` : `Last ${noun}`}\n size=\"sm\"\n disabled={it.index >= it.count - 1}\n onClick={() => step(1)}\n >\n <IconArrowDown stroke={1.5} />\n </IconButton>\n {readOnly ? null : (\n <Menu>\n <Tooltip content={`${title} actions`}>\n <MenuTrigger\n render={\n <IconButton label={`${title} actions`} tooltip={false} size=\"sm\">\n <IconDots stroke={1.5} />\n </IconButton>\n }\n />\n </Tooltip>\n <MenuContent align=\"end\" className=\"w-48\" finalFocus={() => !moved.current}>\n <MenuItem\n icon={<IconCopy stroke={1.5} />}\n disabled={atMax}\n onClick={() => {\n moved.current = true;\n const copy = isObj(list[it.index]) ? { ...(structuredClone(list[it.index]) as object), _key: newKey() } : list[it.index];\n form.setAt(it.arrayPath, [...list.slice(0, it.index + 1), copy, ...list.slice(it.index + 1)]);\n form.navigate([...it.arrayPath, it.index + 1]);\n toast?.success(\"Duplicated\", { description: \"You're now editing the copy.\" });\n }}\n >\n {atMax ? \"Duplicate · limit reached\" : \"Duplicate\"}\n </MenuItem>\n <MenuSeparator />\n <MenuItem\n danger\n icon={<IconTrash stroke={1.5} />}\n disabled={atMin}\n onClick={() => {\n moved.current = true;\n const prevList = list;\n form.navigate(parentFramePath(it.arrayPath));\n form.setAt(it.arrayPath, list.filter((_, j) => j !== it.index));\n toast?.(`“${title}” removed`, { action: { label: \"Undo\", onClick: () => form.setAt(it.arrayPath, prevList) }, duration: 10_000 });\n }}\n >\n {atMin ? `Remove · at least ${bounds?.min} required` : \"Remove\"}\n </MenuItem>\n </MenuContent>\n </Menu>\n )}\n </div>\n ) : null}\n </div>\n );\n}\n/** The frame that owns an array: drop the array field name (and the item index above it, if any). */\nconst parentFramePath = (arrayPath: FieldPath): FieldPath => arrayPath.slice(0, -1);\n\n/* ── Stage: direction-aware slide, scroll memory, focus, keys (V2 schema-form) ───────────────── */\n/** The title shown as `parentTitle` for the current frame (the root crumb's label for depth 1). */\nexport function parentTitleOf(frames: Frame[], rootLabel: string): string | undefined {\n if (frames.length < 2) return undefined;\n return frames.length === 2 ? rootLabel : frames[frames.length - 2].title;\n}\n\n/** Floating layers (Base UI popups carry these roles); keys and focus coming from one belong to that layer. */\nconst LAYER = \"[role=dialog],[role=menu],[role=listbox]\";\n\n/** Slide direction for a frame change: deeper → 1, shallower → −1, a sibling step → by index. */\nexport function frameDirection(prev: { depth: number; index: number; key: string }, frames: Frame[], key: string): 0 | 1 | -1 {\n if (prev.key === key) return 0;\n const cur = frames[frames.length - 1];\n if (frames.length > prev.depth) return 1;\n if (frames.length < prev.depth) return -1;\n return (cur.item?.index ?? 0) >= prev.index ? 1 : -1;\n}\n\n/**\n * The drill-in stack's behaviour. `root` wraps the form (keys bubble to it), `scroller` is the scrolling element (or\n * null when the host scrolls). Returns the current frame, its key, the slide direction and the form's onKeyDown.\n */\nexport function useFrameNavigation({\n frames,\n navigate,\n root,\n scroller,\n}: {\n frames: Frame[];\n navigate: (path: FieldPath) => void;\n root: React.RefObject<HTMLElement | null>;\n scroller: React.RefObject<HTMLElement | null>;\n}) {\n const current = frames[frames.length - 1];\n const frameKey = frameKeyOf(current.path);\n const prev = React.useRef({ depth: frames.length, index: current.item?.index ?? 0, key: frameKey });\n const dir = frameDirection(prev.current, frames, frameKey);\n const dirRef = React.useRef<number>(1);\n if (dir) dirRef.current = dir;\n\n const scrollMem = React.useRef(new Map<string, number>());\n React.useLayoutEffect(() => {\n const was = prev.current.key;\n if (was === frameKey) return;\n if (scroller.current) scrollMem.current.set(was, scroller.current.scrollTop);\n prev.current = { depth: frames.length, index: current.item?.index ?? 0, key: frameKey };\n const el = scroller.current;\n if (el) el.scrollTop = scrollMem.current.get(frameKey) ?? 0;\n const active = document.activeElement;\n /* a move started from a portalled menu (FrameHeader ⋯ → Duplicate / Remove) leaves focus in that layer, outside root */\n const layer = active && active !== document.body ? active.closest(LAYER) : null;\n const fromLayer = !!layer && !layer.contains(root.current);\n if (root.current && (active === document.body || root.current.contains(active) || fromLayer)) {\n // the exiting frame is still mounted during its exit animation — focus the ENTERING one\n const target = root.current.querySelector<HTMLElement>(`[data-frame-body=\"${CSS.escape(frameKey)}\"]`);\n target?.focus({ preventScroll: true });\n }\n });\n\n const onKeyDown = (e: React.KeyboardEvent) => {\n if (e.defaultPrevented) return;\n const t = e.target as HTMLElement;\n // ignore keys from floating layers opened by this form; a form INSIDE a dialog still handles its own keys\n // (V2 also listed Radix's popper wrapper; Base UI popups carry these roles themselves)\n const layer = t.closest(LAYER);\n if (layer && root.current && !layer.contains(root.current)) return;\n if (e.key === \"Escape\" && frames.length > 1 && !t.isContentEditable) {\n e.preventDefault();\n e.stopPropagation();\n navigate(frames[frames.length - 2].path);\n return;\n }\n const it = current.item;\n if (it && (e.key === \"ArrowUp\" || e.key === \"ArrowDown\")) {\n const typing = t.matches(\"input,textarea,select\") || t.isContentEditable;\n if (e.altKey || (!typing && t.matches(\"[data-frame-body],[data-frame-header]\"))) {\n const n = it.index + (e.key === \"ArrowUp\" ? -1 : 1);\n if (n >= 0 && n < it.count) {\n e.preventDefault();\n navigate([...it.arrayPath, n]);\n }\n }\n }\n };\n\n return { current, frameKey, dir: dirRef.current, onKeyDown };\n}\n\nconst EASE: [number, number, number, number] = [0.22, 1, 0.36, 1];\n\n/**\n * The frame body with V2's slide: 24px along the travel direction + fade, 220ms, ease [0.22, 1, 0.36, 1]; reduced\n * motion keeps only the fade. `before` renders inside the root frame above its fields (the synced-from note).\n */\nexport function FrameStage({\n frames,\n frameKey,\n dir,\n rootLabel,\n variant,\n before,\n review,\n}: {\n frames: Frame[];\n frameKey: string;\n dir: number;\n rootLabel: string;\n variant: \"panel\" | \"document\";\n before?: React.ReactNode;\n /** D61 Review changes is on: the clip leaves 16px on the left for the change bars */\n review?: boolean;\n}) {\n const reduce = useReducedMotion();\n const current = frames[frames.length - 1];\n return (\n // the drill slide is clipped sideways; with Review changes on (D61) the clip leaves 16px on the left for the change bars\n <div className=\"relative\" style={review ? { clipPath: \"inset(-100vh 0 -100vh -16px)\" } : { overflowX: \"clip\" }}>\n <AnimatePresence mode=\"popLayout\" initial={false} custom={dir}>\n <motion.div\n key={frameKey}\n custom={dir}\n variants={{\n enter: (d: number) => ({ x: reduce ? 0 : d * 24, opacity: 0 }),\n center: { x: 0, opacity: 1 },\n exit: (d: number) => ({ x: reduce ? 0 : d * -24, opacity: 0 }),\n }}\n initial=\"enter\"\n animate=\"center\"\n exit=\"exit\"\n transition={{ duration: 0.22, ease: EASE }}\n data-frame-body={frameKey}\n tabIndex={-1}\n className={cn(\"outline-none focus-visible:shadow-none\", variant === \"document\" ? \"py-1\" : \"px-4 py-4\")}\n >\n {current.kind === \"root\" ? before : null}\n <FrameView frame={current} parentTitle={parentTitleOf(frames, rootLabel)} />\n </motion.div>\n </AnimatePresence>\n </div>\n );\n}\n\nexport { HISTORY_SEGMENT };\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"frame.js","names":[],"sources":["../../src/engine/frame.tsx"],"sourcesContent":["/**\n * FrameView — what the panel shows for the current breadcrumb: the root fields, a drilled object / array item /\n * slot block (with \"2 of 4\" stepper, variant switcher and per-slot layout settings), the one button screen,\n * or a field's history as a stacked panel. Port of V2 engine/frame.tsx.\n *\n * FrameStage + useFrameNavigation — V2 schema-form's drill-in stage (direction-aware slide, scroll memory per frame,\n * focus on the entering frame, Esc / ⌥↑↓). Exported here so SchemaForm wires them without re-deriving the motion.\n *\n * FrameSlots — the frame draws other lanes' pieces (FieldList / FieldSection from grouping, ButtonScreen from link,\n * TableFrame from table). They arrive through context so this file never imports a module that does not exist yet;\n * a missing slot falls back to a plain field list (FieldList), the raw value (ButtonScreen, through\n * FallbackControl), a named note (TableFrame) or nothing (FieldSection). SchemaForm always hands ButtonScreen and TableFrame.\n */\nimport * as React from \"react\";\nimport { AnimatePresence, motion, useReducedMotion } from \"framer-motion\";\nimport { IconArrowDown, IconArrowUp, IconCopy, IconDots, IconTrash } from \"@tabler/icons-react\";\nimport { IconButton } from \"../ui/button\";\nimport { Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger, Tooltip } from \"../ui/overlay\";\nimport { Segmented } from \"../ui/controls\";\nimport { fitsSegmented } from \"../ui/choice-switch\";\nimport { Select } from \"../ui/select\";\nimport { resolveFieldAccess, useForm, useKitEnv, useKitServices } from \"../context\";\nimport { cn } from \"../lib/cn\";\nimport { HISTORY_SEGMENT, type FieldGroup, type FieldPath, type FieldSchema, type Fieldset } from \"../schema/types\";\nimport type { Frame } from \"../lib/frames\";\nimport { frameKeyOf, isObj, newKey } from \"../lib/path\";\nimport { condCtx, isHidden, itemSchemaFor, previewOf } from \"../lib/schema\";\nimport { Thumb } from \"./bits\";\nimport { FallbackControl, KitField } from \"./kit-field\";\n\n/* ── Slots (other lanes) ───────────────────────────────────────────── */\nexport interface FrameFieldListProps {\n fields: FieldSchema[];\n fieldsets?: Fieldset[];\n groups?: FieldGroup[];\n basePath: FieldPath;\n memoryKey: string;\n}\nexport interface FrameSlots {\n /** grouping lane: engine/field-list.tsx `FieldList` */\n FieldList?: React.ComponentType<FrameFieldListProps>;\n /** grouping lane: engine/grouping.tsx `FieldSection` (the slot-settings section of a slot block) */\n FieldSection?: React.ComponentType<{ title: string; description?: string; collapsible?: boolean; children: React.ReactNode }>;\n /** link lane: controls/link.tsx `ButtonScreen` + `normLink` (the \"button\" frame) */\n ButtonScreen?: React.ComponentType<{ value: unknown; onChange: (v: unknown) => void; title: string; readOnly?: boolean }>;\n normLink?: (v: unknown) => { label?: string };\n /** table lane: controls/table.tsx `TableFrame` (tableRow / tableColumn frames) */\n TableFrame?: React.ComponentType<{ frame: Frame }>;\n}\nconst SlotsCtx = React.createContext<FrameSlots>({});\nexport const FrameSlotsProvider = SlotsCtx.Provider;\nexport const useFrameSlots = () => React.useContext(SlotsCtx);\n\n/** Stand-in until the grouping lane's FieldList lands: the frame's visible fields in schema order. */\nfunction PlainFieldList({ fields, basePath }: FrameFieldListProps) {\n const form = useForm()!;\n const raw = basePath.length ? form.getAt(basePath) : form.value;\n const parent = isObj(raw) ? raw : {};\n const cc = condCtx(form, basePath);\n const shown = fields.filter((f) => !isHidden(f, parent, cc));\n return (\n <div className=\"flex flex-col gap-5\">\n {shown.map((f) => (\n <div key={f.name} className=\"min-w-0\">\n <KitField field={f} path={[...basePath, f.name]} parent={parent} />\n </div>\n ))}\n {shown.length === 0 ? <p className=\"py-6 text-center text-kit-sm text-kit-fg-3\">No fields here yet.</p> : null}\n </div>\n );\n}\n\n/** A button frame outside SchemaForm (no ButtonScreen slot) edits the button's raw value (FallbackControl), never an empty body. */\nfunction RawButtonScreen({ frame }: { frame: Frame }) {\n const form = useForm()!;\n const id = React.useId();\n const field = frame.field ?? { name: String(frame.path.at(-1) ?? \"button\"), title: frame.title, type: \"button\" as const };\n return <FallbackControl field={field} value={form.getAt(frame.path)} onChange={(n) => form.setAt(frame.path, n)} id={id} path={frame.path} />;\n}\n\n/** The button frame: header (the button's label) + the kit ButtonScreen, read-only when the lens can't edit the field. */\nfunction ButtonFrame({ frame, parentTitle }: { frame: Frame; parentTitle?: string }) {\n const form = useForm()!;\n const env = useKitEnv();\n const slots = useFrameSlots();\n const v = form.getAt(frame.path);\n const ButtonScreen = slots.ButtonScreen;\n const readOnly = frame.field ? resolveFieldAccess(frame.field, env).readOnly : !!env.readOnly;\n return (\n <div className=\"flex flex-col gap-5\">\n <FrameHeader frame={frame} context={parentTitle ? `${frame.title} in ${parentTitle}` : frame.title} title={slots.normLink?.(v).label || frame.title} />\n {ButtonScreen ? <ButtonScreen value={v} onChange={(n) => form.setAt(frame.path, n)} title={frame.title} readOnly={readOnly} /> : <RawButtonScreen frame={frame} />}\n </div>\n );\n}\n\n/* ── FrameView ─────────────────────────────────────────────────────── */\nexport function FrameView({ frame, parentTitle }: { frame: Frame; parentTitle?: string }) {\n const form = useForm()!;\n const slots = useFrameSlots();\n const FieldList = slots.FieldList ?? PlainFieldList;\n if (frame.kind === \"history\") return null; // D61: a field's history is the host's one History panel (onFieldHistory)\n if (frame.kind === \"button\") return <ButtonFrame frame={frame} parentTitle={parentTitle} />;\n // D50: a table row or column drills exactly like an array item: the same header (title, n of N, ↑ ↓ ⋯), its cells below\n if (frame.kind === \"tableRow\" || frame.kind === \"tableColumn\") {\n const it = frame.item!;\n const TableFrame = slots.TableFrame;\n return (\n <div className=\"flex flex-col gap-5\">\n <FrameHeader frame={frame} context={`${it.itemSchema?.title} ${it.index + 1} of ${it.count} in ${frame.field?.title ?? \"the table\"}`} title={frame.title} />\n {TableFrame ? (\n <TableFrame frame={frame} />\n ) : (\n /* Only the kit table control opens a row or column frame; until it is ported the table is the host's control,\n which edits rows in place. A path restored into one says so instead of drawing an empty body. */\n <p role=\"note\" data-kit-note=\"table\" className=\"text-kit-sm text-kit-fg-3\">\n This table's rows and columns are edited in the table itself.\n </p>\n )}\n </div>\n );\n }\n if (frame.kind === \"root\") return <FieldList fields={frame.fields} fieldsets={frame.fieldsets} groups={frame.groups} basePath={[]} memoryKey=\"root\" />;\n const it = frame.item;\n const block = it?.block;\n const variants = block?.variants ?? [];\n const raw = form.getAt(frame.path);\n const cur = isObj(raw) ? raw : {};\n const FieldSection = slots.FieldSection;\n return (\n <div className=\"flex flex-col gap-5\">\n <FrameHeader frame={frame} context={frameContext(frame, parentTitle)} title={frame.title} />\n {block && variants.length > 1 ? (\n <div className=\"flex flex-col gap-1.5\">\n <span className=\"text-kit-sm font-medium text-kit-fg-2\">Layout</span>\n {fitsSegmented(variants.map((v) => v.name)) ? (\n <Segmented\n aria-label=\"Layout\"\n value={String(cur._variant ?? variants[0].id)}\n onChange={(v) => form.setAt([...frame.path, \"_variant\"], v)}\n items={variants.map((v) => ({ value: v.id, label: v.name }))}\n className=\"w-full [&>button]:flex-1\"\n />\n ) : (\n <Select\n aria-label=\"Variant\"\n value={String(cur._variant ?? variants[0].id)}\n onValueChange={(v) => form.setAt([...frame.path, \"_variant\"], v)}\n options={variants.map((v) => ({ value: v.id, label: v.name, description: v.description }))}\n />\n )}\n </div>\n ) : null}\n <FieldList fields={frame.fields} fieldsets={frame.fieldsets} groups={frame.groups} basePath={frame.path} memoryKey={`f:${frame.kind}:${it?.block?.name ?? it?.itemSchema?.name ?? frame.field?.name ?? \"\"}`} />\n {it?.slotField?.slotSettings?.length && FieldSection ? (\n <FieldSection title={`Layout in ${it.slotField.title.toLowerCase()}`} description=\"How this block sits in its parent. The block's own content is above.\" collapsible={false}>\n <FieldList fields={it.slotField.slotSettings} basePath={[...frame.path, \"_settings\"]} memoryKey={`slotset:${it.slotField.name}`} />\n </FieldSection>\n ) : null}\n </div>\n );\n}\n\n/**\n * The context line under a drilled frame's title: \"Tier 1 of 3 in Tiers\" for an item (the item noun is the item\n * schema's title, which the adapter reads back from prod `ui.itemLabel`), \"Address in Author\" for an object.\n */\nexport function frameContext(frame: Frame, parentTitle?: string): string {\n const it = frame.item;\n if (it) {\n const noun = (frame.kind === \"block\" ? it.block?.title : it.itemSchema?.title) ?? \"Item\";\n const owner = (frame.kind === \"block\" ? it.slotField?.title : frame.field?.title) ?? \"the list\";\n return `${noun} ${it.index + 1} of ${it.count} in ${owner}`;\n }\n return parentTitle ? `${frame.field?.title ?? \"Group\"} in ${parentTitle}` : \"Group\";\n}\n\n/**\n * CPO D43 — the drilled frame's header answers \"what am I editing, and where does it live?\":\n * [media?] Starter [↑] [↓] [⋯]\n * Tier 1 of 3 in Tiers\n * The big title lives HERE only; the breadcrumb above is the path (its current crumb is small, D38). Prev / next are\n * labelled icon buttons whose tooltips name the sibling (\"Previous tier: Starter\"). No eyebrow, no duplicate counter.\n * Title 14/24 semibold (owner call). The native title= on the truncating h2 is V2 parity (kit-engine deviation from\n * the dashboard's no-title rule, see run ledger #32).\n */\nexport function FrameHeader({ frame, context, title }: { frame: Frame; context: string; title: string }) {\n const form = useForm()!;\n const { toast } = useKitServices();\n const it = frame.item;\n const media = it ? previewOf(it.block ?? it.itemSchema, form.getAt(frame.path), it.index).media : undefined;\n const step = (d: -1 | 1) => {\n if (!it) return;\n const n = it.index + d;\n if (n < 0 || n >= it.count) return;\n form.navigate([...it.arrayPath, n]);\n };\n const listRaw = it ? form.getAt(it.arrayPath) : undefined;\n const list = Array.isArray(listRaw) ? listRaw : [];\n const noun = (it?.block?.title ?? it?.itemSchema?.title ?? \"item\").toLowerCase();\n /* NEW-Q49-POLYSIBLING: in a mixed list a neighbour is named and previewed by its OWN type, not the current item's\n (a photo post's URL read as \"Next store review: https://…\") */\n const schemaAt = (i: number) => {\n const v = list[i];\n if (frame.kind === \"item\" && frame.field) return itemSchemaFor(frame.field, v) ?? it?.itemSchema;\n if (frame.kind === \"block\") return (isObj(v) && typeof v._type === \"string\" ? form.resolveSchema?.(v._type) : undefined) ?? it?.block;\n return it?.block ?? it?.itemSchema;\n };\n const nounAt = (i: number) => (it?.titleAt ? noun : (schemaAt(i)?.title ?? \"item\").toLowerCase());\n const sibling = (i: number) =>\n it && i >= 0 && i < it.count ? (it.titleAt ? it.titleAt(i) : previewOf(schemaAt(i), list[i], i, schemaAt(i)?.title).title) : \"\";\n const prev = it ? sibling(it.index - 1) : \"\";\n const next = it ? sibling(it.index + 1) : \"\";\n const prevNoun = it ? nounAt(it.index - 1) : noun;\n const nextNoun = it ? nounAt(it.index + 1) : noun;\n /* NEW-Q22-ROWLIMIT: the list's own bounds hold here as on its row menu (array.tsx): a duplicate past the maximum or a\n remove below the minimum only left a held, unsavable list */\n const bounds = frame.kind === \"item\" || frame.kind === \"block\" ? frame.field?.validation : undefined;\n const atMax = bounds?.max != null && list.length >= bounds.max;\n const atMin = bounds?.min != null && list.length <= bounds.min;\n /* NEW-Q48-ITEMACTIONS: a read-only list (a locked section, a viewer) offers no Duplicate / Remove: the host drops the\n write, so the menu only announced a change that never happened */\n const env = useKitEnv();\n const readOnly = frame.field ? resolveFieldAccess(frame.field, env).readOnly : !!env.readOnly;\n /* Duplicate / Remove move to another frame: the menu must not hand focus back to its trigger in the exiting frame\n (it unmounts, focus would drop to <body>); the stage focuses the entering frame instead */\n const moved = React.useRef(false);\n return (\n <div className=\"flex items-start gap-2.5 outline-none\" data-frame-header tabIndex={-1}>\n {media ? <Thumb media={media} size={36} /> : null}\n <div className=\"min-w-0 flex-1\">\n <h2 className=\"truncate text-kit-base font-semibold leading-6 text-kit-fg\" title={title}>\n {title}\n </h2>\n <p className=\"truncate text-kit-xs leading-4 text-kit-fg-3\">{context}</p>\n </div>\n {it ? (\n <div className=\"-mr-1 flex shrink-0 items-center gap-0.5 pt-0.5\">\n <IconButton\n label={prev ? `Previous ${prevNoun}: ${prev}` : `No previous ${noun}`}\n tooltip={prev ? `Previous ${prevNoun}: ${prev}` : `First ${noun}`}\n size=\"sm\"\n disabled={it.index === 0}\n onClick={() => step(-1)}\n >\n <IconArrowUp stroke={1.5} />\n </IconButton>\n <IconButton\n label={next ? `Next ${nextNoun}: ${next}` : `No next ${noun}`}\n tooltip={next ? `Next ${nextNoun}: ${next}` : `Last ${noun}`}\n size=\"sm\"\n disabled={it.index >= it.count - 1}\n onClick={() => step(1)}\n >\n <IconArrowDown stroke={1.5} />\n </IconButton>\n {readOnly ? null : (\n <Menu>\n <Tooltip content={`${title} actions`}>\n <MenuTrigger\n render={\n <IconButton label={`${title} actions`} tooltip={false} size=\"sm\">\n <IconDots stroke={1.5} />\n </IconButton>\n }\n />\n </Tooltip>\n <MenuContent align=\"end\" className=\"w-48\" finalFocus={() => !moved.current}>\n <MenuItem\n icon={<IconCopy stroke={1.5} />}\n disabled={atMax}\n onClick={() => {\n moved.current = true;\n const copy = isObj(list[it.index]) ? { ...(structuredClone(list[it.index]) as object), _key: newKey() } : list[it.index];\n form.setAt(it.arrayPath, [...list.slice(0, it.index + 1), copy, ...list.slice(it.index + 1)]);\n form.navigate([...it.arrayPath, it.index + 1]);\n toast?.success(\"Duplicated\", { description: \"You're now editing the copy.\" });\n }}\n >\n {atMax ? \"Duplicate · limit reached\" : \"Duplicate\"}\n </MenuItem>\n <MenuSeparator />\n <MenuItem\n danger\n icon={<IconTrash stroke={1.5} />}\n disabled={atMin}\n onClick={() => {\n moved.current = true;\n const prevList = list;\n form.navigate(parentFramePath(it.arrayPath));\n form.setAt(it.arrayPath, list.filter((_, j) => j !== it.index));\n toast?.(`“${title}” removed`, { action: { label: \"Undo\", onClick: () => form.setAt(it.arrayPath, prevList) }, duration: 10_000 });\n }}\n >\n {atMin ? `Remove · at least ${bounds?.min} required` : \"Remove\"}\n </MenuItem>\n </MenuContent>\n </Menu>\n )}\n </div>\n ) : null}\n </div>\n );\n}\n/** The frame that owns an array: drop the array field name (and the item index above it, if any). */\nconst parentFramePath = (arrayPath: FieldPath): FieldPath => arrayPath.slice(0, -1);\n\n/* ── Stage: direction-aware slide, scroll memory, focus, keys (V2 schema-form) ───────────────── */\n/** The title shown as `parentTitle` for the current frame (the root crumb's label for depth 1). */\nexport function parentTitleOf(frames: Frame[], rootLabel: string): string | undefined {\n if (frames.length < 2) return undefined;\n return frames.length === 2 ? rootLabel : frames[frames.length - 2].title;\n}\n\n/** Floating layers (Base UI popups carry these roles); keys and focus coming from one belong to that layer. */\nconst LAYER = \"[role=dialog],[role=menu],[role=listbox]\";\n\n/** Slide direction for a frame change: deeper → 1, shallower → −1, a sibling step → by index. */\nexport function frameDirection(prev: { depth: number; index: number; key: string }, frames: Frame[], key: string): 0 | 1 | -1 {\n if (prev.key === key) return 0;\n const cur = frames[frames.length - 1];\n if (frames.length > prev.depth) return 1;\n if (frames.length < prev.depth) return -1;\n return (cur.item?.index ?? 0) >= prev.index ? 1 : -1;\n}\n\n/**\n * The drill-in stack's behaviour. `root` wraps the form (keys bubble to it), `scroller` is the scrolling element (or\n * null when the host scrolls). Returns the current frame, its key, the slide direction and the form's onKeyDown.\n */\nexport function useFrameNavigation({\n frames,\n navigate,\n root,\n scroller,\n}: {\n frames: Frame[];\n navigate: (path: FieldPath) => void;\n root: React.RefObject<HTMLElement | null>;\n scroller: React.RefObject<HTMLElement | null>;\n}) {\n const current = frames[frames.length - 1];\n const frameKey = frameKeyOf(current.path);\n const prev = React.useRef({ depth: frames.length, index: current.item?.index ?? 0, key: frameKey });\n const dir = frameDirection(prev.current, frames, frameKey);\n const dirRef = React.useRef<number>(1);\n if (dir) dirRef.current = dir;\n\n const scrollMem = React.useRef(new Map<string, number>());\n React.useLayoutEffect(() => {\n const was = prev.current.key;\n if (was === frameKey) return;\n if (scroller.current) scrollMem.current.set(was, scroller.current.scrollTop);\n prev.current = { depth: frames.length, index: current.item?.index ?? 0, key: frameKey };\n const el = scroller.current;\n if (el) el.scrollTop = scrollMem.current.get(frameKey) ?? 0;\n const active = document.activeElement;\n /* a move started from a portalled menu (FrameHeader ⋯ → Duplicate / Remove) leaves focus in that layer, outside root */\n const layer = active && active !== document.body ? active.closest(LAYER) : null;\n const fromLayer = !!layer && !layer.contains(root.current);\n if (root.current && (active === document.body || root.current.contains(active) || fromLayer)) {\n // the exiting frame is still mounted during its exit animation — focus the ENTERING one\n const target = root.current.querySelector<HTMLElement>(`[data-frame-body=\"${CSS.escape(frameKey)}\"]`);\n target?.focus({ preventScroll: true });\n }\n });\n\n const onKeyDown = (e: React.KeyboardEvent) => {\n if (e.defaultPrevented) return;\n const t = e.target as HTMLElement;\n // ignore keys from floating layers opened by this form; a form INSIDE a dialog still handles its own keys\n // (V2 also listed Radix's popper wrapper; Base UI popups carry these roles themselves)\n const layer = t.closest(LAYER);\n if (layer && root.current && !layer.contains(root.current)) return;\n if (e.key === \"Escape\" && frames.length > 1 && !t.isContentEditable) {\n e.preventDefault();\n e.stopPropagation();\n navigate(frames[frames.length - 2].path);\n return;\n }\n const it = current.item;\n if (it && (e.key === \"ArrowUp\" || e.key === \"ArrowDown\")) {\n const typing = t.matches(\"input,textarea,select\") || t.isContentEditable;\n if (e.altKey || (!typing && t.matches(\"[data-frame-body],[data-frame-header]\"))) {\n const n = it.index + (e.key === \"ArrowUp\" ? -1 : 1);\n if (n >= 0 && n < it.count) {\n e.preventDefault();\n navigate([...it.arrayPath, n]);\n }\n }\n }\n };\n\n return { current, frameKey, dir: dirRef.current, onKeyDown };\n}\n\nconst EASE: [number, number, number, number] = [0.22, 1, 0.36, 1];\n\n/**\n * The frame body with V2's slide: 24px along the travel direction + fade, 220ms, ease [0.22, 1, 0.36, 1]; reduced\n * motion keeps only the fade. `before` renders inside the root frame above its fields (the synced-from note).\n */\nexport function FrameStage({\n frames,\n frameKey,\n dir,\n rootLabel,\n variant,\n before,\n review,\n}: {\n frames: Frame[];\n frameKey: string;\n dir: number;\n rootLabel: string;\n variant: \"panel\" | \"document\";\n before?: React.ReactNode;\n /** D61 Review changes is on: the clip leaves 16px on the left for the change bars */\n review?: boolean;\n}) {\n const reduce = useReducedMotion();\n const current = frames[frames.length - 1];\n return (\n // the drill slide is clipped sideways; with Review changes on (D61) the clip leaves 16px on the left for the change bars\n <div className=\"relative\" style={review ? { clipPath: \"inset(-100vh 0 -100vh -16px)\" } : { overflowX: \"clip\" }}>\n <AnimatePresence mode=\"popLayout\" initial={false} custom={dir}>\n <motion.div\n key={frameKey}\n custom={dir}\n variants={{\n enter: (d: number) => ({ x: reduce ? 0 : d * 24, opacity: 0 }),\n center: { x: 0, opacity: 1 },\n exit: (d: number) => ({ x: reduce ? 0 : d * -24, opacity: 0 }),\n }}\n initial=\"enter\"\n animate=\"center\"\n exit=\"exit\"\n transition={{ duration: 0.22, ease: EASE }}\n data-frame-body={frameKey}\n tabIndex={-1}\n className={cn(\"outline-none focus-visible:shadow-none\", variant === \"document\" ? \"py-1\" : \"px-4 py-4\")}\n >\n {current.kind === \"root\" ? before : null}\n <FrameView frame={current} parentTitle={parentTitleOf(frames, rootLabel)} />\n </motion.div>\n </AnimatePresence>\n </div>\n );\n}\n\nexport { HISTORY_SEGMENT };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,IAAM,WAAW,MAAM,cAA0B,CAAC,CAAC;AACnD,IAAa,qBAAqB,SAAS;AAC3C,IAAa,sBAAsB,MAAM,WAAW,QAAQ;;AAG5D,SAAS,eAAe,EAAE,QAAQ,YAAiC;CACjE,MAAM,OAAO,QAAQ;CACrB,MAAM,MAAM,SAAS,SAAS,KAAK,MAAM,QAAQ,IAAI,KAAK;CAC1D,MAAM,SAAS,MAAM,GAAG,IAAI,MAAM,CAAC;CACnC,MAAM,KAAK,QAAQ,MAAM,QAAQ;CACjC,MAAM,QAAQ,OAAO,QAAQ,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,CAAC;CAC3D,OACE,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA,CACG,MAAM,KAAK,MACV,oBAAC,OAAD;GAAkB,WAAU;GAC1B,UAAA,oBAAC,UAAD;IAAU,OAAO;IAAG,MAAM,CAAC,GAAG,UAAU,EAAE,IAAI;IAAW;GAAS,CAAA;EAC/D,GAFK,EAAE,IAEP,CACN,GACA,MAAM,WAAW,IAAI,oBAAC,KAAD;GAAG,WAAU;GAA6C,UAAA;EAAsB,CAAA,IAAI,IACvG;;AAET;;AAGA,SAAS,gBAAgB,EAAE,SAA2B;CACpD,MAAM,OAAO,QAAQ;CACrB,MAAM,KAAK,MAAM,MAAM;CACvB,MAAM,QAAQ,MAAM,SAAS;EAAE,MAAM,OAAO,MAAM,KAAK,GAAG,EAAE,KAAK,QAAQ;EAAG,OAAO,MAAM;EAAO,MAAM;CAAkB;CACxH,OAAO,oBAAC,iBAAD;EAAwB;EAAO,OAAO,KAAK,MAAM,MAAM,IAAI;EAAG,WAAW,MAAM,KAAK,MAAM,MAAM,MAAM,CAAC;EAAO;EAAI,MAAM,MAAM;CAAO,CAAA;AAC9I;;AAGA,SAAS,YAAY,EAAE,OAAO,eAAuD;CACnF,MAAM,OAAO,QAAQ;CACrB,MAAM,MAAM,UAAU;CACtB,MAAM,QAAQ,cAAc;CAC5B,MAAM,IAAI,KAAK,MAAM,MAAM,IAAI;CAC/B,MAAM,eAAe,MAAM;CAC3B,MAAM,WAAW,MAAM,QAAQ,mBAAmB,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI;CACrF,OACE,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA,CACE,oBAAC,aAAD;GAAoB;GAAO,SAAS,cAAc,GAAG,MAAM,MAAM,MAAM,gBAAgB,MAAM;GAAO,OAAO,MAAM,WAAW,CAAC,CAAC,CAAC,SAAS,MAAM;EAAQ,CAAA,GACrJ,eAAe,oBAAC,cAAD;GAAc,OAAO;GAAG,WAAW,MAAM,KAAK,MAAM,MAAM,MAAM,CAAC;GAAG,OAAO,MAAM;GAAiB;EAAW,CAAA,IAAI,oBAAC,iBAAD,EAAwB,MAAQ,CAAA,CAC9J;;AAET;AAGA,SAAgB,UAAU,EAAE,OAAO,eAAuD;CACxF,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQ,cAAc;CAC5B,MAAM,YAAY,MAAM,aAAa;CACrC,IAAI,MAAM,SAAS,WAAW,OAAO;CACrC,IAAI,MAAM,SAAS,UAAU,OAAO,oBAAC,aAAD;EAAoB;EAAoB;CAAc,CAAA;CAE1F,IAAI,MAAM,SAAS,cAAc,MAAM,SAAS,eAAe;EAC7D,MAAM,KAAK,MAAM;EACjB,MAAM,aAAa,MAAM;EACzB,OACE,qBAAC,OAAD;GAAK,WAAU;GAAf,UAAA,CACE,oBAAC,aAAD;IAAoB;IAAO,SAAS,GAAG,GAAG,YAAY,MAAM,GAAG,GAAG,QAAQ,EAAE,MAAM,GAAG,MAAM,MAAM,MAAM,OAAO,SAAS;IAAe,OAAO,MAAM;GAAQ,CAAA,GAC1J,aACC,oBAAC,YAAD,EAAmB,MAAQ,CAAA,IAI3B,oBAAC,KAAD;IAAG,MAAK;IAAO,iBAAc;IAAQ,WAAU;IAA4B,UAAA;GAExE,CAAA,CAEF;;CAET;CACA,IAAI,MAAM,SAAS,QAAQ,OAAO,oBAAC,WAAD;EAAW,QAAQ,MAAM;EAAQ,WAAW,MAAM;EAAW,QAAQ,MAAM;EAAQ,UAAU,CAAC;EAAG,WAAU;CAAQ,CAAA;CACrJ,MAAM,KAAK,MAAM;CACjB,MAAM,QAAQ,IAAI;CAClB,MAAM,WAAW,OAAO,YAAY,CAAC;CACrC,MAAM,MAAM,KAAK,MAAM,MAAM,IAAI;CACjC,MAAM,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;CAChC,MAAM,eAAe,MAAM;CAC3B,OACE,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA;GACE,oBAAC,aAAD;IAAoB;IAAO,SAAS,aAAa,OAAO,WAAW;IAAG,OAAO,MAAM;GAAQ,CAAA;GAC1F,SAAS,SAAS,SAAS,IAC1B,qBAAC,OAAD;IAAK,WAAU;IAAf,UAAA,CACE,oBAAC,QAAD;KAAM,WAAU;KAAwC,UAAA;IAAY,CAAA,GACnE,cAAc,SAAS,KAAK,MAAM,EAAE,IAAI,CAAC,IACxC,oBAAC,WAAD;KACE,cAAW;KACX,OAAO,OAAO,IAAI,YAAY,SAAS,EAAE,CAAC,EAAE;KAC5C,WAAW,MAAM,KAAK,MAAM,CAAC,GAAG,MAAM,MAAM,UAAU,GAAG,CAAC;KAC1D,OAAO,SAAS,KAAK,OAAO;MAAE,OAAO,EAAE;MAAI,OAAO,EAAE;KAAK,EAAE;KAC3D,WAAU;IACX,CAAA,IAED,oBAAC,QAAD;KACE,cAAW;KACX,OAAO,OAAO,IAAI,YAAY,SAAS,EAAE,CAAC,EAAE;KAC5C,gBAAgB,MAAM,KAAK,MAAM,CAAC,GAAG,MAAM,MAAM,UAAU,GAAG,CAAC;KAC/D,SAAS,SAAS,KAAK,OAAO;MAAE,OAAO,EAAE;MAAI,OAAO,EAAE;MAAM,aAAa,EAAE;KAAY,EAAE;IAC1F,CAAA,CAEA;GACH,CAAA,IAAA;GACJ,oBAAC,WAAD;IAAW,QAAQ,MAAM;IAAQ,WAAW,MAAM;IAAW,QAAQ,MAAM;IAAQ,UAAU,MAAM;IAAM,WAAW,KAAK,MAAM,KAAK,GAAG,IAAI,OAAO,QAAQ,IAAI,YAAY,QAAQ,MAAM,OAAO,QAAQ;GAAO,CAAA;GAC7M,IAAI,WAAW,cAAc,UAAU,eACtC,oBAAC,cAAD;IAAc,OAAO,aAAa,GAAG,UAAU,MAAM,YAAY;IAAK,aAAY;IAAuE,aAAa;IACpK,UAAA,oBAAC,WAAD;KAAW,QAAQ,GAAG,UAAU;KAAc,UAAU,CAAC,GAAG,MAAM,MAAM,WAAW;KAAG,WAAW,WAAW,GAAG,UAAU;IAAS,CAAA;GACtH,CAAA,IACZ;EACD;;AAET;;;;;AAMA,SAAgB,aAAa,OAAc,aAA8B;CACvE,MAAM,KAAK,MAAM;CACjB,IAAI,IAAI;EACN,MAAM,QAAQ,MAAM,SAAS,UAAU,GAAG,OAAO,QAAQ,GAAG,YAAY,UAAU;EAClF,MAAM,SAAS,MAAM,SAAS,UAAU,GAAG,WAAW,QAAQ,MAAM,OAAO,UAAU;EACrF,OAAO,GAAG,KAAK,GAAG,GAAG,QAAQ,EAAE,MAAM,GAAG,MAAM,MAAM;CACtD;CACA,OAAO,cAAc,GAAG,MAAM,OAAO,SAAS,QAAQ,MAAM,gBAAgB;AAC9E;;;;;;;;;;AAWA,SAAgB,YAAY,EAAE,OAAO,SAAS,SAA2D;CACvG,MAAM,OAAO,QAAQ;CACrB,MAAM,EAAE,UAAU,eAAe;CACjC,MAAM,KAAK,MAAM;CACjB,MAAM,QAAQ,KAAK,UAAU,GAAG,SAAS,GAAG,YAAY,KAAK,MAAM,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,QAAQ,KAAA;CAClG,MAAM,QAAQ,MAAc;EAC1B,IAAI,CAAC,IAAI;EACT,MAAM,IAAI,GAAG,QAAQ;EACrB,IAAI,IAAI,KAAK,KAAK,GAAG,OAAO;EAC5B,KAAK,SAAS,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC;CACpC;CACA,MAAM,UAAU,KAAK,KAAK,MAAM,GAAG,SAAS,IAAI,KAAA;CAChD,MAAM,OAAO,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC;CACjD,MAAM,QAAQ,IAAI,OAAO,SAAS,IAAI,YAAY,SAAS,OAAA,CAAQ,YAAY;CAG/E,MAAM,YAAY,MAAc;EAC9B,MAAM,IAAI,KAAK;EACf,IAAI,MAAM,SAAS,UAAU,MAAM,OAAO,OAAO,cAAc,MAAM,OAAO,CAAC,KAAK,IAAI;EACtF,IAAI,MAAM,SAAS,SAAS,QAAQ,MAAM,CAAC,KAAK,OAAO,EAAE,UAAU,WAAW,KAAK,gBAAgB,EAAE,KAAK,IAAI,KAAA,MAAc,IAAI;EAChI,OAAO,IAAI,SAAS,IAAI;CAC1B;CACA,MAAM,UAAU,MAAe,IAAI,UAAU,QAAQ,SAAS,CAAC,CAAC,EAAE,SAAS,OAAA,CAAQ,YAAY;CAC/F,MAAM,WAAW,MACf,MAAM,KAAK,KAAK,IAAI,GAAG,QAAS,GAAG,UAAU,GAAG,QAAQ,CAAC,IAAI,UAAU,SAAS,CAAC,GAAG,KAAK,IAAI,GAAG,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,QAAS;CAC/H,MAAM,OAAO,KAAK,QAAQ,GAAG,QAAQ,CAAC,IAAI;CAC1C,MAAM,OAAO,KAAK,QAAQ,GAAG,QAAQ,CAAC,IAAI;CAC1C,MAAM,WAAW,KAAK,OAAO,GAAG,QAAQ,CAAC,IAAI;CAC7C,MAAM,WAAW,KAAK,OAAO,GAAG,QAAQ,CAAC,IAAI;CAG7C,MAAM,SAAS,MAAM,SAAS,UAAU,MAAM,SAAS,UAAU,MAAM,OAAO,aAAa,KAAA;CAC3F,MAAM,QAAQ,QAAQ,OAAO,QAAQ,KAAK,UAAU,OAAO;CAC3D,MAAM,QAAQ,QAAQ,OAAO,QAAQ,KAAK,UAAU,OAAO;CAG3D,MAAM,MAAM,UAAU;CACtB,MAAM,WAAW,MAAM,QAAQ,mBAAmB,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI;CAGrF,MAAM,QAAQ,MAAM,OAAO,KAAK;CAChC,OACE,qBAAC,OAAD;EAAK,WAAU;EAAwC,qBAAA;EAAkB,UAAU;EAAnF,UAAA;GACG,QAAQ,oBAAC,OAAD;IAAc;IAAO,MAAM;GAAK,CAAA,IAAI;GAC7C,qBAAC,OAAD;IAAK,WAAU;IAAf,UAAA,CACE,oBAAC,MAAD;KAAI,WAAU;KAAoE;KAC/E,UAAA;IACC,CAAA,GACJ,oBAAC,KAAD;KAAG,WAAU;KAAgD,UAAA;IAAW,CAAA,CACrE;;GACJ,KACC,qBAAC,OAAD;IAAK,WAAU;IAAf,UAAA;KACE,oBAAC,YAAD;MACE,OAAO,OAAO,YAAY,SAAS,IAAI,SAAS,eAAe;MAC/D,SAAS,OAAO,YAAY,SAAS,IAAI,SAAS,SAAS;MAC3D,MAAK;MACL,UAAU,GAAG,UAAU;MACvB,eAAe,KAAK,EAAE;MAEtB,UAAA,oBAAC,aAAD,EAAa,QAAQ,IAAM,CAAA;KACjB,CAAA;KACZ,oBAAC,YAAD;MACE,OAAO,OAAO,QAAQ,SAAS,IAAI,SAAS,WAAW;MACvD,SAAS,OAAO,QAAQ,SAAS,IAAI,SAAS,QAAQ;MACtD,MAAK;MACL,UAAU,GAAG,SAAS,GAAG,QAAQ;MACjC,eAAe,KAAK,CAAC;MAErB,UAAA,oBAAC,eAAD,EAAe,QAAQ,IAAM,CAAA;KACnB,CAAA;KACX,WAAW,OACZ,qBAAC,MAAD,EAAA,UAAA,CACE,oBAAC,SAAD;MAAS,SAAS,GAAG,MAAM;MACzB,UAAA,oBAAC,aAAD,EACE,QACE,oBAAC,YAAD;OAAY,OAAO,GAAG,MAAM;OAAW,SAAS;OAAO,MAAK;OAC1D,UAAA,oBAAC,UAAD,EAAU,QAAQ,IAAM,CAAA;MACd,CAAA,EAEf,CAAA;KACM,CAAA,GACT,qBAAC,aAAD;MAAa,OAAM;MAAM,WAAU;MAAO,kBAAkB,CAAC,MAAM;MAAnE,UAAA;OACE,oBAAC,UAAD;QACE,MAAM,oBAAC,UAAD,EAAU,QAAQ,IAAM,CAAA;QAC9B,UAAU;QACV,eAAe;SACb,MAAM,UAAU;SAChB,MAAM,OAAO,MAAM,KAAK,GAAG,MAAM,IAAI;UAAE,GAAI,gBAAgB,KAAK,GAAG,MAAM;UAAc,MAAM,OAAO;SAAE,IAAI,KAAK,GAAG;SAClH,KAAK,MAAM,GAAG,WAAW;UAAC,GAAG,KAAK,MAAM,GAAG,GAAG,QAAQ,CAAC;UAAG;UAAM,GAAG,KAAK,MAAM,GAAG,QAAQ,CAAC;SAAC,CAAC;SAC5F,KAAK,SAAS,CAAC,GAAG,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC;SAC7C,OAAO,QAAQ,cAAc,EAAE,aAAa,+BAA+B,CAAC;QAC9E;QAEC,UAAA,QAAQ,8BAA8B;OAC/B,CAAA;OACV,oBAAC,eAAD,CAAgB,CAAA;OAChB,oBAAC,UAAD;QACE,QAAA;QACA,MAAM,oBAAC,WAAD,EAAW,QAAQ,IAAM,CAAA;QAC/B,UAAU;QACV,eAAe;SACb,MAAM,UAAU;SAChB,MAAM,WAAW;SACjB,KAAK,SAAS,gBAAgB,GAAG,SAAS,CAAC;SAC3C,KAAK,MAAM,GAAG,WAAW,KAAK,QAAQ,GAAG,MAAM,MAAM,GAAG,KAAK,CAAC;SAC9D,QAAQ,IAAI,MAAM,YAAY;UAAE,QAAQ;WAAE,OAAO;WAAQ,eAAe,KAAK,MAAM,GAAG,WAAW,QAAQ;UAAE;UAAG,UAAU;SAAO,CAAC;QAClI;QAEC,UAAA,QAAQ,qBAAqB,QAAQ,IAAI,aAAa;OAC/C,CAAA;MACC;KACT,CAAA,CAAA,EAAA,CAAA;IAEH;GACH,CAAA,IAAA;EACD;;AAET;;AAEA,IAAM,mBAAmB,cAAoC,UAAU,MAAM,GAAG,EAAE;;AAIlF,SAAgB,cAAc,QAAiB,WAAuC;CACpF,IAAI,OAAO,SAAS,GAAG,OAAO,KAAA;CAC9B,OAAO,OAAO,WAAW,IAAI,YAAY,OAAO,OAAO,SAAS,EAAE,CAAC;AACrE;;AAGA,IAAM,QAAQ;;AAGd,SAAgB,eAAe,MAAqD,QAAiB,KAAyB;CAC5H,IAAI,KAAK,QAAQ,KAAK,OAAO;CAC7B,MAAM,MAAM,OAAO,OAAO,SAAS;CACnC,IAAI,OAAO,SAAS,KAAK,OAAO,OAAO;CACvC,IAAI,OAAO,SAAS,KAAK,OAAO,OAAO;CACvC,QAAQ,IAAI,MAAM,SAAS,MAAM,KAAK,QAAQ,IAAI;AACpD;;;;;AAMA,SAAgB,mBAAmB,EACjC,QACA,UACA,MACA,YAMC;CACD,MAAM,UAAU,OAAO,OAAO,SAAS;CACvC,MAAM,WAAW,WAAW,QAAQ,IAAI;CACxC,MAAM,OAAO,MAAM,OAAO;EAAE,OAAO,OAAO;EAAQ,OAAO,QAAQ,MAAM,SAAS;EAAG,KAAK;CAAS,CAAC;CAClG,MAAM,MAAM,eAAe,KAAK,SAAS,QAAQ,QAAQ;CACzD,MAAM,SAAS,MAAM,OAAe,CAAC;CACrC,IAAI,KAAK,OAAO,UAAU;CAE1B,MAAM,YAAY,MAAM,uBAAO,IAAI,IAAoB,CAAC;CACxD,MAAM,sBAAsB;EAC1B,MAAM,MAAM,KAAK,QAAQ;EACzB,IAAI,QAAQ,UAAU;EACtB,IAAI,SAAS,SAAS,UAAU,QAAQ,IAAI,KAAK,SAAS,QAAQ,SAAS;EAC3E,KAAK,UAAU;GAAE,OAAO,OAAO;GAAQ,OAAO,QAAQ,MAAM,SAAS;GAAG,KAAK;EAAS;EACtF,MAAM,KAAK,SAAS;EACpB,IAAI,IAAI,GAAG,YAAY,UAAU,QAAQ,IAAI,QAAQ,KAAK;EAC1D,MAAM,SAAS,SAAS;EAExB,MAAM,QAAQ,UAAU,WAAW,SAAS,OAAO,OAAO,QAAQ,KAAK,IAAI;EAC3E,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,MAAM,SAAS,KAAK,OAAO;EACzD,IAAI,KAAK,YAAY,WAAW,SAAS,QAAQ,KAAK,QAAQ,SAAS,MAAM,KAAK,YAGhF,KADoB,QAAQ,cAA2B,qBAAqB,IAAI,OAAO,QAAQ,EAAE,GACjG,CAAA,EAAQ,MAAM,EAAE,eAAe,KAAK,CAAC;CAEzC,CAAC;CAED,MAAM,aAAa,MAA2B;EAC5C,IAAI,EAAE,kBAAkB;EACxB,MAAM,IAAI,EAAE;EAGZ,MAAM,QAAQ,EAAE,QAAQ,KAAK;EAC7B,IAAI,SAAS,KAAK,WAAW,CAAC,MAAM,SAAS,KAAK,OAAO,GAAG;EAC5D,IAAI,EAAE,QAAQ,YAAY,OAAO,SAAS,KAAK,CAAC,EAAE,mBAAmB;GACnE,EAAE,eAAe;GACjB,EAAE,gBAAgB;GAClB,SAAS,OAAO,OAAO,SAAS,EAAE,CAAC,IAAI;GACvC;EACF;EACA,MAAM,KAAK,QAAQ;EACnB,IAAI,OAAO,EAAE,QAAQ,aAAa,EAAE,QAAQ,cAAc;GACxD,MAAM,SAAS,EAAE,QAAQ,uBAAuB,KAAK,EAAE;GACvD,IAAI,EAAE,UAAW,CAAC,UAAU,EAAE,QAAQ,uCAAuC,GAAI;IAC/E,MAAM,IAAI,GAAG,SAAS,EAAE,QAAQ,YAAY,KAAK;IACjD,IAAI,KAAK,KAAK,IAAI,GAAG,OAAO;KAC1B,EAAE,eAAe;KACjB,SAAS,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC;IAC/B;GACF;EACF;CACF;CAEA,OAAO;EAAE;EAAS;EAAU,KAAK,OAAO;EAAS;CAAU;AAC7D;AAEA,IAAM,OAAyC;CAAC;CAAM;CAAG;CAAM;AAAC;;;;;AAMhE,SAAgB,WAAW,EACzB,QACA,UACA,KACA,WACA,SACA,QACA,UAUC;CACD,MAAM,SAAS,iBAAiB;CAChC,MAAM,UAAU,OAAO,OAAO,SAAS;CACvC,OAEE,oBAAC,OAAD;EAAK,WAAU;EAAW,OAAO,SAAS,EAAE,UAAU,+BAA+B,IAAI,EAAE,WAAW,OAAO;EAC3G,UAAA,oBAAC,iBAAD;GAAiB,MAAK;GAAY,SAAS;GAAO,QAAQ;GACxD,UAAA,qBAAC,OAAO,KAAR;IAEE,QAAQ;IACR,UAAU;KACR,QAAQ,OAAe;MAAE,GAAG,SAAS,IAAI,IAAI;MAAI,SAAS;KAAE;KAC5D,QAAQ;MAAE,GAAG;MAAG,SAAS;KAAE;KAC3B,OAAO,OAAe;MAAE,GAAG,SAAS,IAAI,IAAI;MAAK,SAAS;KAAE;IAC9D;IACA,SAAQ;IACR,SAAQ;IACR,MAAK;IACL,YAAY;KAAE,UAAU;KAAM,MAAM;IAAK;IACzC,mBAAiB;IACjB,UAAU;IACV,WAAW,GAAG,0CAA0C,YAAY,aAAa,SAAS,WAAW;IAdvG,UAAA,CAgBG,QAAQ,SAAS,SAAS,SAAS,MACpC,oBAAC,WAAD;KAAW,OAAO;KAAS,aAAa,cAAc,QAAQ,SAAS;IAAI,CAAA,CACjE;GAjBL,GAAA,QAiBK;EACG,CAAA;CACd,CAAA;AAET"}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* HELD fields and the kit's error surfaces (kit 3.2.0).
|
|
3
|
+
*
|
|
4
|
+
* A held field is one the form cannot edit without changing what is stored: it renders read-only inside the usual
|
|
5
|
+
* FieldShell (label, help), shows the stored value as faithfully as the kit can (rich text as its HTML, scalars as text,
|
|
6
|
+
* objects and lists as a short readable summary), names why in one line, and never writes. It replaces handing the
|
|
7
|
+
* value to the host's old control (LegacyFallback, removed in 4.0.0).
|
|
8
|
+
*
|
|
9
|
+
* - `FieldSchema.held` / `KitServices.heldReason`: the host holds a field (KitField checks both before anything else)
|
|
10
|
+
* - a control that refuses a value (rich text the codec cannot carry) draws `HeldValue` in its place
|
|
11
|
+
* - a control that throws while rendering: `FieldBoundary` holds that one field; the rest of the form keeps working
|
|
12
|
+
* - a whole form that throws: the host draws `KitErrorCard` (reason, "Nothing was changed.", Retry)
|
|
13
|
+
*
|
|
14
|
+
* Markers: the value box carries `data-kit-held="<type>"`, its reason line `data-slot="kit-held-reason"`, the error card
|
|
15
|
+
* `data-kit-error`.
|
|
16
|
+
*/
|
|
17
|
+
import * as React from "react";
|
|
18
|
+
import type { FieldPath, FieldSchema } from "../schema/types";
|
|
19
|
+
/**
|
|
20
|
+
* A stored value as readable lines (never a JSON dump unless nothing else reads): a scalar is its text, a list is its
|
|
21
|
+
* count and its first items, an object its set keys by their field titles.
|
|
22
|
+
*/
|
|
23
|
+
export declare function heldLines(field: FieldSchema, value: unknown): string[];
|
|
24
|
+
export interface HeldValueProps {
|
|
25
|
+
field: FieldSchema;
|
|
26
|
+
value: unknown;
|
|
27
|
+
/** the FieldShell id: the shell's label names this box */
|
|
28
|
+
id: string;
|
|
29
|
+
/** why the field is held, as a clause or a sentence ("it holds formatting this editor cannot keep") */
|
|
30
|
+
reason: string;
|
|
31
|
+
/** rich text: the HTML the codec read for the value, when it could read it (shown read-only, sanitized) */
|
|
32
|
+
html?: string;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* The body of a held field (inside a FieldShell): the reason line, then the stored value read-only. Takes no onChange,
|
|
36
|
+
* so it cannot write.
|
|
37
|
+
*/
|
|
38
|
+
export declare function HeldValue({ field, value, id, reason, html }: HeldValueProps): import("react/jsx-runtime").JSX.Element;
|
|
39
|
+
/** A whole held field: the kit FieldShell (label, help, read-only) around HeldValue. Must be inside <SchemaForm>. */
|
|
40
|
+
export declare function HeldField({ field, path, reason, html }: {
|
|
41
|
+
field: FieldSchema;
|
|
42
|
+
path: FieldPath;
|
|
43
|
+
reason: string;
|
|
44
|
+
html?: string;
|
|
45
|
+
}): import("react/jsx-runtime").JSX.Element;
|
|
46
|
+
/**
|
|
47
|
+
* One field's error boundary: a control that throws while rendering holds that field ("this field could not be drawn:
|
|
48
|
+
* <message>") and the rest of the form keeps working. Retried once the field's schema or value changes (a schema edit,
|
|
49
|
+
* a save from elsewhere, an undo).
|
|
50
|
+
*/
|
|
51
|
+
export declare class FieldBoundary extends React.Component<{
|
|
52
|
+
field: FieldSchema;
|
|
53
|
+
path: FieldPath;
|
|
54
|
+
value: unknown;
|
|
55
|
+
children: React.ReactNode;
|
|
56
|
+
}, {
|
|
57
|
+
reason: string | null;
|
|
58
|
+
}> {
|
|
59
|
+
state: {
|
|
60
|
+
reason: string | null;
|
|
61
|
+
};
|
|
62
|
+
static getDerivedStateFromError(error: unknown): {
|
|
63
|
+
reason: string;
|
|
64
|
+
};
|
|
65
|
+
componentDidUpdate(prev: {
|
|
66
|
+
field: FieldSchema;
|
|
67
|
+
value: unknown;
|
|
68
|
+
}): void;
|
|
69
|
+
render(): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
|
|
70
|
+
}
|
|
71
|
+
export interface KitErrorCardProps {
|
|
72
|
+
/** what failed, as a sentence or a clause ("The form could not be drawn: x is undefined") */
|
|
73
|
+
reason: string;
|
|
74
|
+
/** draws the form again */
|
|
75
|
+
onRetry: () => void;
|
|
76
|
+
className?: string;
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* For a form that throws as a whole: the reason, "Nothing was changed.", and Retry. Carries `data-kit-error`. The host
|
|
80
|
+
* reports the error itself; this card only shows it.
|
|
81
|
+
*/
|
|
82
|
+
export declare function KitErrorCard({ reason, onRetry, className }: KitErrorCardProps): import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
import { isObj } from "../lib/path.js";
|
|
2
|
+
import { plainText } from "../lib/schema.js";
|
|
3
|
+
import { cn } from "../lib/cn.js";
|
|
4
|
+
import { useForm } from "../context.js";
|
|
5
|
+
import { Button } from "../ui/button.js";
|
|
6
|
+
import { FieldShell } from "./field-shell.js";
|
|
7
|
+
import { sanitize } from "../controls/rich-text/dom.js";
|
|
8
|
+
import { plainOf } from "./kit-field.js";
|
|
9
|
+
import * as React from "react";
|
|
10
|
+
import { jsx, jsxs } from "react/jsx-runtime";
|
|
11
|
+
//#region src/engine/held.tsx
|
|
12
|
+
/**
|
|
13
|
+
* HELD fields and the kit's error surfaces (kit 3.2.0).
|
|
14
|
+
*
|
|
15
|
+
* A held field is one the form cannot edit without changing what is stored: it renders read-only inside the usual
|
|
16
|
+
* FieldShell (label, help), shows the stored value as faithfully as the kit can (rich text as its HTML, scalars as text,
|
|
17
|
+
* objects and lists as a short readable summary), names why in one line, and never writes. It replaces handing the
|
|
18
|
+
* value to the host's old control (LegacyFallback, removed in 4.0.0).
|
|
19
|
+
*
|
|
20
|
+
* - `FieldSchema.held` / `KitServices.heldReason`: the host holds a field (KitField checks both before anything else)
|
|
21
|
+
* - a control that refuses a value (rich text the codec cannot carry) draws `HeldValue` in its place
|
|
22
|
+
* - a control that throws while rendering: `FieldBoundary` holds that one field; the rest of the form keeps working
|
|
23
|
+
* - a whole form that throws: the host draws `KitErrorCard` (reason, "Nothing was changed.", Retry)
|
|
24
|
+
*
|
|
25
|
+
* Markers: the value box carries `data-kit-held="<type>"`, its reason line `data-slot="kit-held-reason"`, the error card
|
|
26
|
+
* `data-kit-error`.
|
|
27
|
+
*/
|
|
28
|
+
var sentence = (s) => s.trim().replace(/[.\s]*$/, ".");
|
|
29
|
+
var noop = () => {};
|
|
30
|
+
/** The HTML a stored rich-text value carries (an HTML string, a `{ html }` / `{ format: "html", value }` envelope), or null. */
|
|
31
|
+
function storedHtml(value) {
|
|
32
|
+
if (typeof value === "string") return /<[a-z!/]/i.test(value) ? value : null;
|
|
33
|
+
if (!isObj(value)) return null;
|
|
34
|
+
if (typeof value.html === "string" && value.html) return value.html;
|
|
35
|
+
if (value.format === "html" && typeof value.value === "string") return value.value;
|
|
36
|
+
return null;
|
|
37
|
+
}
|
|
38
|
+
/** One list item in a few words: its own text (title, label, name, block text) or a plain count of what it holds. */
|
|
39
|
+
function itemText(v) {
|
|
40
|
+
if (v == null || v === "") return "Empty";
|
|
41
|
+
if (typeof v !== "object") return String(v);
|
|
42
|
+
const t = plainText(v);
|
|
43
|
+
if (t) return t;
|
|
44
|
+
if (Array.isArray(v)) return `${v.length} ${v.length === 1 ? "item" : "items"}`;
|
|
45
|
+
const n = Object.keys(v).filter((k) => !k.startsWith("_")).length;
|
|
46
|
+
return `${n} ${n === 1 ? "field" : "fields"}`;
|
|
47
|
+
}
|
|
48
|
+
var clip = (s, n = 120) => s.length > n ? `${s.slice(0, n - 1)}…` : s;
|
|
49
|
+
var MAX_LINES = 6;
|
|
50
|
+
/**
|
|
51
|
+
* A stored value as readable lines (never a JSON dump unless nothing else reads): a scalar is its text, a list is its
|
|
52
|
+
* count and its first items, an object its set keys by their field titles.
|
|
53
|
+
*/
|
|
54
|
+
function heldLines(field, value) {
|
|
55
|
+
if (value == null || value === "" || Array.isArray(value) && !value.length) return [];
|
|
56
|
+
if (Array.isArray(value)) return [
|
|
57
|
+
`${value.length} ${value.length === 1 ? "item" : "items"}`,
|
|
58
|
+
...value.slice(0, MAX_LINES).map((v) => clip(itemText(v))),
|
|
59
|
+
...value.length > MAX_LINES ? [`and ${value.length - MAX_LINES} more`] : []
|
|
60
|
+
];
|
|
61
|
+
if (isObj(value)) {
|
|
62
|
+
if (field.type === "richtext") {
|
|
63
|
+
const t = plainText(value);
|
|
64
|
+
return t ? [t] : [];
|
|
65
|
+
}
|
|
66
|
+
const titleOf = (k) => field.fields?.find((f) => f.name === k)?.title ?? k;
|
|
67
|
+
const lines = Object.entries(value).filter(([k, v]) => !k.startsWith("_") && v != null && v !== "" && !(Array.isArray(v) && !v.length)).map(([k, v]) => `${titleOf(k)}: ${clip(itemText(v), 80)}`);
|
|
68
|
+
if (lines.length) return lines.length > MAX_LINES ? [...lines.slice(0, MAX_LINES), `and ${lines.length - MAX_LINES} more`] : lines;
|
|
69
|
+
const raw = JSON.stringify(value);
|
|
70
|
+
return raw && raw !== "{}" ? [clip(raw, 200)] : [];
|
|
71
|
+
}
|
|
72
|
+
const t = field.type === "richtext" ? plainText(value) : plainOf(field, value) || String(value);
|
|
73
|
+
return t ? [t] : [];
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* The body of a held field (inside a FieldShell): the reason line, then the stored value read-only. Takes no onChange,
|
|
77
|
+
* so it cannot write.
|
|
78
|
+
*/
|
|
79
|
+
function HeldValue({ field, value, id, reason, html }) {
|
|
80
|
+
const rich = field.type === "richtext" ? html ?? storedHtml(value) : null;
|
|
81
|
+
const lines = rich == null ? heldLines(field, value) : [];
|
|
82
|
+
return /* @__PURE__ */ jsxs("div", {
|
|
83
|
+
"data-kit-held": field.type,
|
|
84
|
+
className: "flex min-w-0 flex-col gap-1.5",
|
|
85
|
+
children: [/* @__PURE__ */ jsxs("p", {
|
|
86
|
+
role: "note",
|
|
87
|
+
"data-slot": "kit-held-reason",
|
|
88
|
+
className: "rounded-kit-md bg-kit-subtle px-2.5 py-1.5 text-kit-xs text-kit-fg-2",
|
|
89
|
+
children: ["Shown read-only: ", sentence(reason)]
|
|
90
|
+
}), /* @__PURE__ */ jsx("div", {
|
|
91
|
+
id,
|
|
92
|
+
tabIndex: 0,
|
|
93
|
+
role: "group",
|
|
94
|
+
"aria-labelledby": `${id}-label ${id}`,
|
|
95
|
+
"aria-readonly": "true",
|
|
96
|
+
"data-slot": "kit-held-value",
|
|
97
|
+
className: cn("min-w-0 break-words rounded-kit-sm text-kit-sm leading-6 text-kit-fg focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-kit-focus-ring focus-visible:[outline-style:solid] [html[data-input-modality=pointer]_&]:focus-visible:outline-0", rich == null && "whitespace-pre-wrap"),
|
|
98
|
+
children: rich != null ? /* @__PURE__ */ jsx("div", {
|
|
99
|
+
"data-slot": "kit-held-html",
|
|
100
|
+
className: "[&_a]:underline [&_ol]:list-decimal [&_ol]:pl-5 [&_ul]:list-disc [&_ul]:pl-5",
|
|
101
|
+
dangerouslySetInnerHTML: { __html: sanitize(rich) }
|
|
102
|
+
}) : lines.length ? lines.length === 1 ? lines[0] : /* @__PURE__ */ jsx("ul", {
|
|
103
|
+
className: "flex flex-col",
|
|
104
|
+
children: lines.map((l, i) => /* @__PURE__ */ jsx("li", {
|
|
105
|
+
className: cn(i === 0 && Array.isArray(value) ? "text-kit-xs text-kit-fg-3" : void 0),
|
|
106
|
+
children: l
|
|
107
|
+
}, i))
|
|
108
|
+
}) : /* @__PURE__ */ jsx("span", {
|
|
109
|
+
className: "text-kit-fg-3",
|
|
110
|
+
children: "Empty"
|
|
111
|
+
})
|
|
112
|
+
})]
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
/** A whole held field: the kit FieldShell (label, help, read-only) around HeldValue. Must be inside <SchemaForm>. */
|
|
116
|
+
function HeldField({ field, path, reason, html }) {
|
|
117
|
+
const form = useForm();
|
|
118
|
+
const id = React.useId();
|
|
119
|
+
const value = form?.getAt(path);
|
|
120
|
+
return /* @__PURE__ */ jsx(FieldShell, {
|
|
121
|
+
field,
|
|
122
|
+
path,
|
|
123
|
+
id,
|
|
124
|
+
value,
|
|
125
|
+
onChange: noop,
|
|
126
|
+
readOnly: true,
|
|
127
|
+
children: /* @__PURE__ */ jsx(HeldValue, {
|
|
128
|
+
field,
|
|
129
|
+
value,
|
|
130
|
+
id,
|
|
131
|
+
reason,
|
|
132
|
+
html
|
|
133
|
+
})
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
/**
|
|
137
|
+
* One field's error boundary: a control that throws while rendering holds that field ("this field could not be drawn:
|
|
138
|
+
* <message>") and the rest of the form keeps working. Retried once the field's schema or value changes (a schema edit,
|
|
139
|
+
* a save from elsewhere, an undo).
|
|
140
|
+
*/
|
|
141
|
+
var FieldBoundary = class extends React.Component {
|
|
142
|
+
state = { reason: null };
|
|
143
|
+
static getDerivedStateFromError(error) {
|
|
144
|
+
return { reason: error instanceof Error ? error.message : String(error) };
|
|
145
|
+
}
|
|
146
|
+
componentDidUpdate(prev) {
|
|
147
|
+
if (this.state.reason === null) return;
|
|
148
|
+
if (prev.value !== this.props.value || JSON.stringify(prev.field) !== JSON.stringify(this.props.field)) this.setState({ reason: null });
|
|
149
|
+
}
|
|
150
|
+
render() {
|
|
151
|
+
if (this.state.reason === null) return this.props.children;
|
|
152
|
+
return /* @__PURE__ */ jsx(HeldField, {
|
|
153
|
+
field: this.props.field,
|
|
154
|
+
path: this.props.path,
|
|
155
|
+
reason: `this field could not be drawn: ${this.state.reason}`
|
|
156
|
+
});
|
|
157
|
+
}
|
|
158
|
+
};
|
|
159
|
+
/**
|
|
160
|
+
* For a form that throws as a whole: the reason, "Nothing was changed.", and Retry. Carries `data-kit-error`. The host
|
|
161
|
+
* reports the error itself; this card only shows it.
|
|
162
|
+
*/
|
|
163
|
+
function KitErrorCard({ reason, onRetry, className }) {
|
|
164
|
+
return /* @__PURE__ */ jsxs("div", {
|
|
165
|
+
role: "alert",
|
|
166
|
+
"data-kit-error": "",
|
|
167
|
+
className: cn("flex flex-col items-start gap-2 rounded-kit-lg border border-kit-line bg-kit-subtle p-3", className),
|
|
168
|
+
children: [
|
|
169
|
+
/* @__PURE__ */ jsx("p", {
|
|
170
|
+
"data-slot": "kit-error-reason",
|
|
171
|
+
className: "text-kit-sm text-kit-fg",
|
|
172
|
+
children: sentence(reason)
|
|
173
|
+
}),
|
|
174
|
+
/* @__PURE__ */ jsx("p", {
|
|
175
|
+
className: "text-kit-xs text-kit-fg-2",
|
|
176
|
+
children: "Nothing was changed."
|
|
177
|
+
}),
|
|
178
|
+
/* @__PURE__ */ jsx(Button, {
|
|
179
|
+
variant: "secondary",
|
|
180
|
+
size: "sm",
|
|
181
|
+
onClick: onRetry,
|
|
182
|
+
children: "Retry"
|
|
183
|
+
})
|
|
184
|
+
]
|
|
185
|
+
});
|
|
186
|
+
}
|
|
187
|
+
//#endregion
|
|
188
|
+
export { FieldBoundary, HeldField, HeldValue, KitErrorCard, heldLines };
|
|
189
|
+
|
|
190
|
+
//# sourceMappingURL=held.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"held.js","names":[],"sources":["../../src/engine/held.tsx"],"sourcesContent":["/**\n * HELD fields and the kit's error surfaces (kit 3.2.0).\n *\n * A held field is one the form cannot edit without changing what is stored: it renders read-only inside the usual\n * FieldShell (label, help), shows the stored value as faithfully as the kit can (rich text as its HTML, scalars as text,\n * objects and lists as a short readable summary), names why in one line, and never writes. It replaces handing the\n * value to the host's old control (LegacyFallback, removed in 4.0.0).\n *\n * - `FieldSchema.held` / `KitServices.heldReason`: the host holds a field (KitField checks both before anything else)\n * - a control that refuses a value (rich text the codec cannot carry) draws `HeldValue` in its place\n * - a control that throws while rendering: `FieldBoundary` holds that one field; the rest of the form keeps working\n * - a whole form that throws: the host draws `KitErrorCard` (reason, \"Nothing was changed.\", Retry)\n *\n * Markers: the value box carries `data-kit-held=\"<type>\"`, its reason line `data-slot=\"kit-held-reason\"`, the error card\n * `data-kit-error`.\n */\nimport * as React from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { isObj } from \"../lib/path\";\nimport { plainText } from \"../lib/schema\";\nimport type { FieldPath, FieldSchema } from \"../schema/types\";\nimport { useForm } from \"../context\";\nimport { Button } from \"../ui/button\";\nimport { sanitize } from \"../controls/rich-text/dom\";\nimport { FieldShell } from \"./field-shell\";\nimport { plainOf } from \"./kit-field\";\n\nconst sentence = (s: string) => s.trim().replace(/[.\\s]*$/, \".\");\nconst noop = () => {};\n\n/** The HTML a stored rich-text value carries (an HTML string, a `{ html }` / `{ format: \"html\", value }` envelope), or null. */\nfunction storedHtml(value: unknown): string | null {\n if (typeof value === \"string\") return /<[a-z!/]/i.test(value) ? value : null;\n if (!isObj(value)) return null;\n if (typeof value.html === \"string\" && value.html) return value.html;\n if (value.format === \"html\" && typeof value.value === \"string\") return value.value;\n return null;\n}\n\n/** One list item in a few words: its own text (title, label, name, block text) or a plain count of what it holds. */\nfunction itemText(v: unknown): string {\n if (v == null || v === \"\") return \"Empty\";\n if (typeof v !== \"object\") return String(v);\n const t = plainText(v);\n if (t) return t;\n if (Array.isArray(v)) return `${v.length} ${v.length === 1 ? \"item\" : \"items\"}`;\n const n = Object.keys(v).filter((k) => !k.startsWith(\"_\")).length;\n return `${n} ${n === 1 ? \"field\" : \"fields\"}`;\n}\n\nconst clip = (s: string, n = 120) => (s.length > n ? `${s.slice(0, n - 1)}…` : s);\nconst MAX_LINES = 6;\n\n/**\n * A stored value as readable lines (never a JSON dump unless nothing else reads): a scalar is its text, a list is its\n * count and its first items, an object its set keys by their field titles.\n */\nexport function heldLines(field: FieldSchema, value: unknown): string[] {\n if (value == null || value === \"\" || (Array.isArray(value) && !value.length)) return [];\n if (Array.isArray(value)) {\n const head = `${value.length} ${value.length === 1 ? \"item\" : \"items\"}`;\n const items = value.slice(0, MAX_LINES).map((v) => clip(itemText(v)));\n return [head, ...items, ...(value.length > MAX_LINES ? [`and ${value.length - MAX_LINES} more`] : [])];\n }\n if (isObj(value)) {\n if (field.type === \"richtext\") {\n const t = plainText(value);\n return t ? [t] : [];\n }\n const titleOf = (k: string) => field.fields?.find((f) => f.name === k)?.title ?? k;\n const lines = Object.entries(value)\n .filter(([k, v]) => !k.startsWith(\"_\") && v != null && v !== \"\" && !(Array.isArray(v) && !v.length))\n .map(([k, v]) => `${titleOf(k)}: ${clip(itemText(v), 80)}`);\n if (lines.length) return lines.length > MAX_LINES ? [...lines.slice(0, MAX_LINES), `and ${lines.length - MAX_LINES} more`] : lines;\n const raw = JSON.stringify(value);\n return raw && raw !== \"{}\" ? [clip(raw, 200)] : [];\n }\n const t = field.type === \"richtext\" ? plainText(value) : plainOf(field, value) || String(value);\n return t ? [t] : [];\n}\n\nexport interface HeldValueProps {\n field: FieldSchema;\n value: unknown;\n /** the FieldShell id: the shell's label names this box */\n id: string;\n /** why the field is held, as a clause or a sentence (\"it holds formatting this editor cannot keep\") */\n reason: string;\n /** rich text: the HTML the codec read for the value, when it could read it (shown read-only, sanitized) */\n html?: string;\n}\n\n/**\n * The body of a held field (inside a FieldShell): the reason line, then the stored value read-only. Takes no onChange,\n * so it cannot write.\n */\nexport function HeldValue({ field, value, id, reason, html }: HeldValueProps) {\n const rich = field.type === \"richtext\" ? (html ?? storedHtml(value)) : null;\n const lines = rich == null ? heldLines(field, value) : [];\n return (\n <div data-kit-held={field.type} className=\"flex min-w-0 flex-col gap-1.5\">\n <p role=\"note\" data-slot=\"kit-held-reason\" className=\"rounded-kit-md bg-kit-subtle px-2.5 py-1.5 text-kit-xs text-kit-fg-2\">\n Shown read-only: {sentence(reason)}\n </p>\n <div\n id={id}\n tabIndex={0}\n role=\"group\"\n aria-labelledby={`${id}-label ${id}`}\n aria-readonly=\"true\"\n data-slot=\"kit-held-value\"\n className={cn(\n \"min-w-0 break-words rounded-kit-sm text-kit-sm leading-6 text-kit-fg focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-kit-focus-ring focus-visible:[outline-style:solid] [html[data-input-modality=pointer]_&]:focus-visible:outline-0\",\n rich == null && \"whitespace-pre-wrap\",\n )}\n >\n {rich != null ? (\n <div data-slot=\"kit-held-html\" className=\"[&_a]:underline [&_ol]:list-decimal [&_ol]:pl-5 [&_ul]:list-disc [&_ul]:pl-5\" dangerouslySetInnerHTML={{ __html: sanitize(rich) }} />\n ) : lines.length ? (\n lines.length === 1 ? (\n lines[0]\n ) : (\n <ul className=\"flex flex-col\">\n {lines.map((l, i) => (\n <li key={i} className={cn(i === 0 && Array.isArray(value) ? \"text-kit-xs text-kit-fg-3\" : undefined)}>\n {l}\n </li>\n ))}\n </ul>\n )\n ) : (\n <span className=\"text-kit-fg-3\">Empty</span>\n )}\n </div>\n </div>\n );\n}\n\n/** A whole held field: the kit FieldShell (label, help, read-only) around HeldValue. Must be inside <SchemaForm>. */\nexport function HeldField({ field, path, reason, html }: { field: FieldSchema; path: FieldPath; reason: string; html?: string }) {\n const form = useForm();\n const id = React.useId();\n const value = form?.getAt(path);\n return (\n <FieldShell field={field} path={path} id={id} value={value} onChange={noop} readOnly>\n <HeldValue field={field} value={value} id={id} reason={reason} html={html} />\n </FieldShell>\n );\n}\n\n/**\n * One field's error boundary: a control that throws while rendering holds that field (\"this field could not be drawn:\n * <message>\") and the rest of the form keeps working. Retried once the field's schema or value changes (a schema edit,\n * a save from elsewhere, an undo).\n */\nexport class FieldBoundary extends React.Component<\n { field: FieldSchema; path: FieldPath; value: unknown; children: React.ReactNode },\n { reason: string | null }\n> {\n state = { reason: null as string | null };\n static getDerivedStateFromError(error: unknown) {\n return { reason: error instanceof Error ? error.message : String(error) };\n }\n componentDidUpdate(prev: { field: FieldSchema; value: unknown }) {\n if (this.state.reason === null) return;\n if (prev.value !== this.props.value || JSON.stringify(prev.field) !== JSON.stringify(this.props.field)) this.setState({ reason: null });\n }\n render() {\n if (this.state.reason === null) return this.props.children;\n return <HeldField field={this.props.field} path={this.props.path} reason={`this field could not be drawn: ${this.state.reason}`} />;\n }\n}\n\nexport interface KitErrorCardProps {\n /** what failed, as a sentence or a clause (\"The form could not be drawn: x is undefined\") */\n reason: string;\n /** draws the form again */\n onRetry: () => void;\n className?: string;\n}\n\n/**\n * For a form that throws as a whole: the reason, \"Nothing was changed.\", and Retry. Carries `data-kit-error`. The host\n * reports the error itself; this card only shows it.\n */\nexport function KitErrorCard({ reason, onRetry, className }: KitErrorCardProps) {\n return (\n <div role=\"alert\" data-kit-error=\"\" className={cn(\"flex flex-col items-start gap-2 rounded-kit-lg border border-kit-line bg-kit-subtle p-3\", className)}>\n <p data-slot=\"kit-error-reason\" className=\"text-kit-sm text-kit-fg\">\n {sentence(reason)}\n </p>\n <p className=\"text-kit-xs text-kit-fg-2\">Nothing was changed.</p>\n <Button variant=\"secondary\" size=\"sm\" onClick={onRetry}>\n Retry\n </Button>\n </div>\n );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,IAAM,YAAY,MAAc,EAAE,KAAK,CAAC,CAAC,QAAQ,WAAW,GAAG;AAC/D,IAAM,aAAa,CAAC;;AAGpB,SAAS,WAAW,OAA+B;CACjD,IAAI,OAAO,UAAU,UAAU,OAAO,YAAY,KAAK,KAAK,IAAI,QAAQ;CACxE,IAAI,CAAC,MAAM,KAAK,GAAG,OAAO;CAC1B,IAAI,OAAO,MAAM,SAAS,YAAY,MAAM,MAAM,OAAO,MAAM;CAC/D,IAAI,MAAM,WAAW,UAAU,OAAO,MAAM,UAAU,UAAU,OAAO,MAAM;CAC7E,OAAO;AACT;;AAGA,SAAS,SAAS,GAAoB;CACpC,IAAI,KAAK,QAAQ,MAAM,IAAI,OAAO;CAClC,IAAI,OAAO,MAAM,UAAU,OAAO,OAAO,CAAC;CAC1C,MAAM,IAAI,UAAU,CAAC;CACrB,IAAI,GAAG,OAAO;CACd,IAAI,MAAM,QAAQ,CAAC,GAAG,OAAO,GAAG,EAAE,OAAO,GAAG,EAAE,WAAW,IAAI,SAAS;CACtE,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;CAC3D,OAAO,GAAG,EAAE,GAAG,MAAM,IAAI,UAAU;AACrC;AAEA,IAAM,QAAQ,GAAW,IAAI,QAAS,EAAE,SAAS,IAAI,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,KAAK;AAC/E,IAAM,YAAY;;;;;AAMlB,SAAgB,UAAU,OAAoB,OAA0B;CACtE,IAAI,SAAS,QAAQ,UAAU,MAAO,MAAM,QAAQ,KAAK,KAAK,CAAC,MAAM,QAAS,OAAO,CAAC;CACtF,IAAI,MAAM,QAAQ,KAAK,GAGrB,OAAO;EAAC,GAFQ,MAAM,OAAO,GAAG,MAAM,WAAW,IAAI,SAAS;EAEhD,GADA,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,KAAK,MAAM,KAAK,SAAS,CAAC,CAAC,CAClD;EAAO,GAAI,MAAM,SAAS,YAAY,CAAC,OAAO,MAAM,SAAS,UAAU,MAAM,IAAI,CAAC;CAAE;CAEvG,IAAI,MAAM,KAAK,GAAG;EAChB,IAAI,MAAM,SAAS,YAAY;GAC7B,MAAM,IAAI,UAAU,KAAK;GACzB,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC;EACpB;EACA,MAAM,WAAW,MAAc,MAAM,QAAQ,MAAM,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS;EACjF,MAAM,QAAQ,OAAO,QAAQ,KAAK,CAAC,CAChC,QAAQ,CAAC,GAAG,OAAO,CAAC,EAAE,WAAW,GAAG,KAAK,KAAK,QAAQ,MAAM,MAAM,EAAE,MAAM,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CACnG,KAAK,CAAC,GAAG,OAAO,GAAG,QAAQ,CAAC,EAAE,IAAI,KAAK,SAAS,CAAC,GAAG,EAAE,GAAG;EAC5D,IAAI,MAAM,QAAQ,OAAO,MAAM,SAAS,YAAY,CAAC,GAAG,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,MAAM,SAAS,UAAU,MAAM,IAAI;EAC7H,MAAM,MAAM,KAAK,UAAU,KAAK;EAChC,OAAO,OAAO,QAAQ,OAAO,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC;CACnD;CACA,MAAM,IAAI,MAAM,SAAS,aAAa,UAAU,KAAK,IAAI,QAAQ,OAAO,KAAK,KAAK,OAAO,KAAK;CAC9F,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC;AACpB;;;;;AAiBA,SAAgB,UAAU,EAAE,OAAO,OAAO,IAAI,QAAQ,QAAwB;CAC5E,MAAM,OAAO,MAAM,SAAS,aAAc,QAAQ,WAAW,KAAK,IAAK;CACvE,MAAM,QAAQ,QAAQ,OAAO,UAAU,OAAO,KAAK,IAAI,CAAC;CACxD,OACE,qBAAC,OAAD;EAAK,iBAAe,MAAM;EAAM,WAAU;EAA1C,UAAA,CACE,qBAAC,KAAD;GAAG,MAAK;GAAO,aAAU;GAAkB,WAAU;GAArD,UAAA,CAA4H,qBACxG,SAAS,MAAM,CAChC;EACH,CAAA,GAAA,oBAAC,OAAD;GACM;GACJ,UAAU;GACV,MAAK;GACL,mBAAiB,GAAG,GAAG,SAAS;GAChC,iBAAc;GACd,aAAU;GACV,WAAW,GACT,sQACA,QAAQ,QAAQ,qBAClB;GAEC,UAAA,QAAQ,OACP,oBAAC,OAAD;IAAK,aAAU;IAAgB,WAAU;IAA+E,yBAAyB,EAAE,QAAQ,SAAS,IAAI,EAAE;GAAI,CAAA,IAC5K,MAAM,SACR,MAAM,WAAW,IACf,MAAM,KAEN,oBAAC,MAAD;IAAI,WAAU;IACX,UAAA,MAAM,KAAK,GAAG,MACb,oBAAC,MAAD;KAAY,WAAW,GAAG,MAAM,KAAK,MAAM,QAAQ,KAAK,IAAI,8BAA8B,KAAA,CAAS;KAChG,UAAA;IACC,GAFK,CAEL,CACL;GACC,CAAA,IAGN,oBAAC,QAAD;IAAM,WAAU;IAAgB,UAAA;GAAW,CAAA;EAE1C,CAAA,CACF;;AAET;;AAGA,SAAgB,UAAU,EAAE,OAAO,MAAM,QAAQ,QAAgF;CAC/H,MAAM,OAAO,QAAQ;CACrB,MAAM,KAAK,MAAM,MAAM;CACvB,MAAM,QAAQ,MAAM,MAAM,IAAI;CAC9B,OACE,oBAAC,YAAD;EAAmB;EAAa;EAAU;EAAW;EAAO,UAAU;EAAM,UAAA;EAC1E,UAAA,oBAAC,WAAD;GAAkB;GAAc;GAAW;GAAY;GAAc;EAAO,CAAA;CAClE,CAAA;AAEhB;;;;;;AAOA,IAAa,gBAAb,cAAmC,MAAM,UAGvC;CACA,QAAQ,EAAE,QAAQ,KAAsB;CACxC,OAAO,yBAAyB,OAAgB;EAC9C,OAAO,EAAE,QAAQ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;CAC1E;CACA,mBAAmB,MAA8C;EAC/D,IAAI,KAAK,MAAM,WAAW,MAAM;EAChC,IAAI,KAAK,UAAU,KAAK,MAAM,SAAS,KAAK,UAAU,KAAK,KAAK,MAAM,KAAK,UAAU,KAAK,MAAM,KAAK,GAAG,KAAK,SAAS,EAAE,QAAQ,KAAK,CAAC;CACxI;CACA,SAAS;EACP,IAAI,KAAK,MAAM,WAAW,MAAM,OAAO,KAAK,MAAM;EAClD,OAAO,oBAAC,WAAD;GAAW,OAAO,KAAK,MAAM;GAAO,MAAM,KAAK,MAAM;GAAM,QAAQ,kCAAkC,KAAK,MAAM;EAAW,CAAA;CACpI;AACF;;;;;AAcA,SAAgB,aAAa,EAAE,QAAQ,SAAS,aAAgC;CAC9E,OACE,qBAAC,OAAD;EAAK,MAAK;EAAQ,kBAAe;EAAG,WAAW,GAAG,2FAA2F,SAAS;EAAtJ,UAAA;GACE,oBAAC,KAAD;IAAG,aAAU;IAAmB,WAAU;IACvC,UAAA,SAAS,MAAM;GACf,CAAA;GACH,oBAAC,KAAD;IAAG,WAAU;IAA4B,UAAA;GAAuB,CAAA;GAChE,oBAAC,QAAD;IAAQ,SAAQ;IAAY,MAAK;IAAK,SAAS;IAAS,UAAA;GAEhD,CAAA;EACL;;AAET"}
|