kerfjs 5.0.0-beta.115 → 5.0.0-beta.117

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/ai/manifest.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "kerfjsVersion": "5.0.0-beta.115",
2
+ "kerfjsVersion": "5.0.0-beta.117",
3
3
  "files": [
4
4
  {
5
5
  "name": "skill",
package/dist/html.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/utils/parseTemplate.ts","../src/html.ts"],"names":[],"mappings":"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","file":"html.js","sourcesContent":["/**\n * Static-parts parser for the `kerfjs/html` tagged template (`html\\`\\``).\n *\n * Parses a template's static string chunks ONCE into a `ParsedTemplate`:\n * the (possibly trimmed) chunks plus an ordered hole-descriptor list that\n * classifies each `${…}` hole as a TEXT hole (a child position) or an ATTR\n * hole (a complete attribute value, `attr=${v}` / `attr=\"${v}\"`). The\n * renderer in `src/html.ts` caches the parse per template-strings-array\n * identity, so repeated renders of the same call site skip this entirely.\n *\n * The state machine is deliberately small and strict: it tracks only\n * text / inside-open-tag / inside-comment modes and quote state. Holes in\n * any position it can't prove safe — tag names, attribute names, partial\n * attribute values, comments — THROW with an actionable message rather\n * than guessing. Static chunks are author-written markup and pass through\n * verbatim (the same trust model as JSX tag/attribute names).\n */\n\nexport interface AttrHole {\n kind: 'attr';\n /** The attribute name scanned from the preceding static chunk, verbatim. */\n name: string;\n /** The surrounding quote character, or null for an unquoted `attr=${v}`. */\n quote: '\"' | \"'\" | null;\n /** The element's tag name, lowercased, for sink-aware URL screening. */\n tag: string;\n}\n\nexport interface TextHole {\n kind: 'text';\n}\n\nexport type TemplateHole = AttrHole | TextHole;\n\nexport interface ParsedTemplate {\n /**\n * Static chunks with attr-hole scaffolding (`name=`, quotes) stripped —\n * the renderer re-emits the whole ` name=\"value\"` via the JSX attribute\n * renderer. Always `holes.length + 1` entries.\n */\n chunks: string[];\n holes: TemplateHole[];\n /**\n * Per-chunk offset of the `>` that closes the element tag open at the\n * chunk's start, or -1. Only chunks that follow an attr hole can start\n * inside a tag; the renderer uses this to inject the bound-attribute\n * marker (`data-kfb` / `data-kfbrow`) for signal attribute holes.\n */\n tagClose: number[];\n}\n\nconst TEXT_HOLE: TextHole = { kind: 'text' };\n\n/** Matches a chunk tail of `name=` optionally followed by an opening quote. */\nconst ATTR_TAIL = /(\\s*)([^\\s\"'<>/=]+)=([\"'])?$/;\n\n/** Keep the actionable end of a malformed attribute without echoing an entire template. */\nconst PARTIAL_VALUE_DIAGNOSTIC_TAIL_LENGTH = 30;\n\nfunction holeError(detail: string): Error {\n return new Error(`html\\`\\`: ${detail}`);\n}\n\nfunction partialValueError(tail: string): Error {\n return holeError(\n `partial attribute values are not supported (near ${JSON.stringify(tail.slice(-PARTIAL_VALUE_DIAGNOSTIC_TAIL_LENGTH))}) — ` +\n 'a hole must be the COMPLETE attribute value: attr=${v} or attr=\"${v}\". ' +\n 'For class=\"a ${b}\"-style composition, build the full string first ' +\n '(a plain template literal, or computed(() => `a ${b.value}`) for a bound attribute).',\n );\n}\n\nexport function parseTemplate(strings: readonly string[]): ParsedTemplate {\n const chunks: string[] = new Array(strings.length);\n const holes: TemplateHole[] = new Array(strings.length - 1);\n const tagClose: number[] = new Array<number>(strings.length).fill(-1);\n let mode: 'text' | 'tag' | 'comment' = 'text';\n let quote: '\"' | \"'\" | null = null;\n let tagName = '';\n\n for (let i = 0; i < strings.length; i++) {\n let s = strings[i];\n // A quoted attr hole (`attr=\"${v}\"`) must be immediately closed by its\n // quote — the renderer emits the full quoted attribute itself, so the\n // author's closing quote is consumed here.\n if (i > 0) {\n const prev = holes[i - 1];\n if (prev.kind === 'attr' && prev.quote !== null) {\n if (s[0] !== prev.quote) throw partialValueError(strings[i - 1]);\n s = s.slice(1);\n }\n }\n\n const startedInTag = mode === 'tag';\n for (let j = 0; j < s.length; j++) {\n const ch = s[j];\n if (mode === 'text') {\n if (ch === '<') {\n if (s.startsWith('<!--', j)) {\n mode = 'comment';\n j += 3;\n } else if (j + 1 < s.length && /[a-zA-Z!/?]/.test(s[j + 1])) {\n mode = 'tag';\n tagName = (\n /^[a-zA-Z][^\\s/>]*/.exec(s.slice(j + 1))?.[0] ?? ''\n ).toLowerCase();\n }\n }\n } else if (mode === 'tag') {\n if (quote !== null) {\n if (ch === quote) quote = null;\n } else if (ch === '\"' || ch === \"'\") {\n quote = ch;\n } else if (ch === '>') {\n if (startedInTag && tagClose[i] === -1) tagClose[i] = j;\n mode = 'text';\n }\n } else if (ch === '-' && s.startsWith('-->', j)) {\n mode = 'text';\n j += 2;\n }\n }\n\n // Classify the hole that follows this chunk (no hole after the last one).\n if (i < strings.length - 1) {\n if (mode === 'comment') {\n throw holeError(\n 'holes inside HTML comments are not supported — move the ${…} hole outside the <!-- --> comment.',\n );\n }\n if (mode === 'text') {\n if (/<\\/?$/.test(s)) {\n throw holeError(\n 'tag-name holes (`<${…}>`) are not supported — write tag names statically. ' +\n 'For a literal \"<\" before a hole, escape it as &lt;.',\n );\n }\n holes[i] = TEXT_HOLE;\n } else {\n const m = ATTR_TAIL.exec(s);\n if (quote !== null) {\n // Inside a quoted attribute value: only valid if the quote opened\n // as the chunk's very last character (i.e. the hole IS the value).\n if (m === null || m[3] === undefined) throw partialValueError(s);\n holes[i] = {\n kind: 'attr',\n name: m[2],\n quote: m[3] as '\"' | \"'\",\n tag: tagName,\n };\n s = s.slice(0, s.length - m[0].length);\n quote = null;\n } else if (m !== null && m[3] === undefined) {\n // Unquoted `attr=${v}`: the next static chunk must resume with an\n // attribute delimiter, or the template may simply end there.\n const next = strings[i + 1];\n const validNext =\n next.length > 0\n ? /^[\\s>/]/.test(next)\n : i + 1 === strings.length - 1;\n if (!validNext) throw partialValueError(s);\n holes[i] = { kind: 'attr', name: m[2], quote: null, tag: tagName };\n s = s.slice(0, s.length - m[0].length);\n } else if (/<\\/?$/.test(s)) {\n // The tag opened as the chunk's last characters (`</${…}`).\n throw holeError(\n 'tag-name holes (`<${…}>`) are not supported — write tag names statically. ' +\n 'For a literal \"<\" before a hole, escape it as &lt;.',\n );\n } else {\n throw holeError(\n 'a hole inside a tag must be a complete attribute value — attr=${…} or attr=\"${…}\". ' +\n 'Tag-name and attribute-name holes are not supported; write those statically.',\n );\n }\n }\n }\n chunks[i] = s;\n }\n return { chunks, holes, tagClose };\n}\n","/**\n * `html` — tagged-template authoring at the `kerfjs/html` subpath, so\n * \"no build step\" is literally true: a CDN / importmap consumer can author\n * kerf UIs without a JSX transform.\n *\n * import { html } from 'kerfjs/html';\n * html`<div class=\"${cls}\">Count: ${count}</div>`\n * html`<ul>${each(items.value, (i) => html`<li id=\"${i.id}\">${i.label}</li>`)}</ul>`\n *\n * A thin front-end over the exact machinery JSX uses — the runtime paths are\n * IDENTICAL. Text holes go through the JSX child pipeline (`_toSegment`):\n * SafeHtml/list-segment passthrough (so `each()` composes and the keyed\n * reconciler owns its rows), string escaping, number stringify, boolean /\n * nullish → nothing, signal → fine-grained text binding, DOM-node and\n * unsupported-type errors. Attribute holes go through the JSX attribute\n * branch: signal → `_assertEmittableAttrName` + `bindAttr` (grouped into one\n * marker attribute per element); anything else → the JSX attribute renderer\n * (booleans, SafeHtml, URL screening, `on*` / malformed-name rejection).\n * `mount()` / `morph()` / the reconcilers need zero changes.\n *\n * Unlike JSX, NO camelCase attribute aliasing is applied — template authors\n * write real HTML attribute names (`class`, not `className`).\n *\n * Hole contract (enforced by the parser in `utils/parseTemplate.ts`): holes\n * are allowed in text/child positions and as a COMPLETE attribute value\n * (`attr=${v}` or `attr=\"${v}\"`). Tag-name holes, attribute-name holes,\n * partial attribute values (`class=\"a ${b}\"`), and holes inside comments\n * throw. Static chunks are author-written markup and pass through verbatim\n * (same trust model as JSX tags/attrs).\n *\n * Perf: the parse runs once per template call site — the tagged-template\n * strings array has stable identity, so a `WeakMap` keyed on it caches the\n * `ParsedTemplate`. Rendering is a chunk walk with string concatenation,\n * the same cost shape as the JSX runtime.\n */\n\nimport { bindAttr, bindMarkerAttr, isSignal } from './bindings.js';\nimport {\n _assertEmittableAttrName,\n _renderAttrVerbatim,\n _toSegment,\n SafeHtml,\n} from './jsx-runtime.js';\nimport type { ReadonlySignal, Signal } from './reactive.js';\nimport { mergeChildSegments, type Segment } from './segment.js';\nimport { type ParsedTemplate, parseTemplate } from './utils/parseTemplate.js';\n\n/**\n * Values accepted in `html\\`\\`` holes — the same set JSX accepts for\n * children (text holes) and attribute values (attr holes), including a\n * signal/`computed` itself for a fine-grained binding.\n */\nexport type HtmlValue =\n | SafeHtml\n | string\n | number\n | boolean\n | null\n | undefined\n | ReadonlySignal<unknown>\n | readonly HtmlValue[];\n\nconst PARSE_CACHE = new WeakMap<TemplateStringsArray, ParsedTemplate>();\n\n// Module-level mutable counter, sanctioned as observability-only state (see\n// CLAUDE.md design rule 5): it feeds the `_parseCount()` test hook that pins\n// the parse-once-per-callsite cache behavior and never influences rendering.\nlet parseCount = 0;\n\n/** Test hook: number of template parses performed (cache misses) so far. */\nexport function _parseCount(): number {\n return parseCount;\n}\n\nfunction getParsed(strings: TemplateStringsArray): ParsedTemplate {\n let parsed = PARSE_CACHE.get(strings);\n if (parsed === undefined) {\n parsed = parseTemplate(strings);\n parseCount++;\n PARSE_CACHE.set(strings, parsed);\n }\n return parsed;\n}\n\nexport function html(\n strings: TemplateStringsArray,\n ...values: HtmlValue[]\n): SafeHtml {\n const { chunks, holes, tagClose } = getParsed(strings);\n const parts: Segment[] = [];\n let buf = '';\n // Signal-attr binding ids for the currently-open element; flushed as one\n // marker attribute (`data-kfb` / `data-kfbrow`) at the tag's closing `>`,\n // mirroring the per-element grouping in `jsx()`.\n let pendingBindIds: string[] | null = null;\n\n for (let i = 0; i < chunks.length; i++) {\n let chunk = chunks[i];\n if (pendingBindIds !== null && tagClose[i] !== -1) {\n const off = tagClose[i];\n chunk = `${chunk.slice(0, off)} ${bindMarkerAttr()}=\"${pendingBindIds.join(',')}\"${chunk.slice(off)}`;\n pendingBindIds = null;\n }\n buf += chunk;\n if (i === holes.length) break;\n\n const hole = holes[i];\n const value = values[i];\n if (hole.kind === 'text') {\n const seg = _toSegment(value);\n if (seg.kind === 'static') {\n buf += seg.html;\n } else {\n parts.push({ kind: 'static', html: buf });\n buf = '';\n parts.push(seg);\n }\n } else if (isSignal(value)) {\n // Same contract as the `jsx()` signal-attribute branch: reject `on*` /\n // malformed names unconditionally (a signal's value changes over time),\n // then register the binding — or snapshot outside a mount render.\n _assertEmittableAttrName(hole.name, hole.name, false);\n const id = bindAttr(hole.name, value as Signal<unknown>);\n if (id !== null) {\n (pendingBindIds ??= []).push(id);\n } else {\n buf += _renderAttrVerbatim(\n hole.name,\n (value as Signal<unknown>).value,\n hole.tag,\n );\n }\n } else {\n buf += _renderAttrVerbatim(hole.name, value, hole.tag);\n }\n }\n if (buf !== '' || parts.length === 0)\n parts.push({ kind: 'static', html: buf });\n return new SafeHtml(mergeChildSegments(parts));\n}\n"]}
1
+ {"version":3,"sources":["../src/utils/parseTemplate.ts","../src/html.ts"],"names":[],"mappings":"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","file":"html.js","sourcesContent":["/**\n * Static-parts parser for the `kerfjs/html` tagged template (`html\\`\\``).\n *\n * Parses a template's static string chunks ONCE into a `ParsedTemplate`:\n * the (possibly trimmed) chunks plus an ordered hole-descriptor list that\n * classifies each `${…}` hole as a TEXT hole (a child position) or an ATTR\n * hole (a complete attribute value, `attr=${v}` / `attr=\"${v}\"`). The\n * renderer in `src/html.ts` caches the parse per template-strings-array\n * identity, so repeated renders of the same call site skip this entirely.\n *\n * The state machine is deliberately small and strict: it tracks only\n * text / inside-open-tag / inside-comment modes and quote state. Holes in\n * any position it can't prove safe — tag names, attribute names, partial\n * attribute values, comments — THROW with an actionable message rather\n * than guessing. Static chunks are author-written markup and pass through\n * verbatim (the same trust model as JSX tag/attribute names).\n */\n\nexport interface AttrHole {\n kind: 'attr';\n /** The attribute name scanned from the preceding static chunk, verbatim. */\n name: string;\n /** The surrounding quote character, or null for an unquoted `attr=${v}`. */\n quote: '\"' | \"'\" | null;\n /** The element's tag name, lowercased, for sink-aware URL screening. */\n tag: string;\n}\n\nexport interface TextHole {\n kind: 'text';\n}\n\nexport type TemplateHole = AttrHole | TextHole;\n\nexport interface ParsedTemplate {\n /**\n * Static chunks with attr-hole scaffolding (`name=`, quotes) stripped —\n * the renderer re-emits the whole ` name=\"value\"` via the JSX attribute\n * renderer. Always `holes.length + 1` entries.\n */\n chunks: string[];\n holes: TemplateHole[];\n /**\n * Per-chunk offset of the `>` that closes the element tag open at the\n * chunk's start, or -1. Only chunks that follow an attr hole can start\n * inside a tag; the renderer uses this to inject the bound-attribute\n * marker (`data-kfb` / `data-kfbrow`) for signal attribute holes.\n */\n tagClose: number[];\n}\n\nconst TEXT_HOLE: TextHole = { kind: 'text' };\n\n/** Matches a chunk tail of `name=` optionally followed by an opening quote. */\nconst ATTR_TAIL = /(\\s*)([^\\s\"'<>/=]+)=([\"'])?$/;\n\n/** Keep the actionable end of a malformed attribute without echoing an entire template. */\nconst PARTIAL_VALUE_DIAGNOSTIC_TAIL_LENGTH = 30;\n\nfunction holeError(detail: string): Error {\n return new Error(`html\\`\\`: ${detail}`);\n}\n\nfunction partialValueError(tail: string): Error {\n return holeError(\n `partial attribute values are not supported (near ${JSON.stringify(tail.slice(-PARTIAL_VALUE_DIAGNOSTIC_TAIL_LENGTH))}) — ` +\n 'a hole must be the COMPLETE attribute value: attr=${v} or attr=\"${v}\". ' +\n 'For class=\"a ${b}\"-style composition, build the full string first ' +\n '(a plain template literal, or computed(() => `a ${b.value}`) for a bound attribute).',\n );\n}\n\nexport function parseTemplate(strings: readonly string[]): ParsedTemplate {\n const chunks: string[] = new Array(strings.length);\n const holes: TemplateHole[] = new Array(strings.length - 1);\n const tagClose: number[] = new Array<number>(strings.length).fill(-1);\n let mode: 'text' | 'tag' | 'comment' = 'text';\n let quote: '\"' | \"'\" | null = null;\n let tagName = '';\n\n for (let i = 0; i < strings.length; i++) {\n let s = strings[i];\n // A quoted attr hole (`attr=\"${v}\"`) must be immediately closed by its\n // quote — the renderer emits the full quoted attribute itself, so the\n // author's closing quote is consumed here.\n if (i > 0) {\n const prev = holes[i - 1];\n if (prev.kind === 'attr' && prev.quote !== null) {\n if (s[0] !== prev.quote) throw partialValueError(strings[i - 1]);\n s = s.slice(1);\n }\n }\n\n const startedInTag = mode === 'tag';\n for (let j = 0; j < s.length; j++) {\n const ch = s[j];\n if (mode === 'text') {\n if (ch === '<') {\n if (s.startsWith('<!--', j)) {\n mode = 'comment';\n j += 3;\n } else if (j + 1 < s.length && /[a-zA-Z!/?]/.test(s[j + 1])) {\n mode = 'tag';\n tagName = (\n /^[a-zA-Z][^\\s/>]*/.exec(s.slice(j + 1))?.[0] ?? ''\n ).toLowerCase();\n }\n }\n } else if (mode === 'tag') {\n if (quote !== null) {\n if (ch === quote) quote = null;\n } else if (ch === '\"' || ch === \"'\") {\n quote = ch;\n } else if (ch === '>') {\n if (startedInTag && tagClose[i] === -1) tagClose[i] = j;\n mode = 'text';\n }\n } else if (ch === '-' && s.startsWith('-->', j)) {\n mode = 'text';\n j += 2;\n }\n }\n\n // Classify the hole that follows this chunk (no hole after the last one).\n if (i < strings.length - 1) {\n if (mode === 'comment') {\n throw holeError(\n 'holes inside HTML comments are not supported — move the ${…} hole outside the <!-- --> comment.',\n );\n }\n if (mode === 'text') {\n if (/<\\/?$/.test(s)) {\n throw holeError(\n 'tag-name holes (`<${…}>`) are not supported — write tag names statically. ' +\n 'For a literal \"<\" before a hole, escape it as &lt;.',\n );\n }\n holes[i] = TEXT_HOLE;\n } else {\n const m = ATTR_TAIL.exec(s);\n if (quote !== null) {\n // Inside a quoted attribute value: only valid if the quote opened\n // as the chunk's very last character (i.e. the hole IS the value).\n if (m === null || m[3] === undefined) throw partialValueError(s);\n holes[i] = {\n kind: 'attr',\n name: m[2],\n quote: m[3] as '\"' | \"'\",\n tag: tagName,\n };\n s = s.slice(0, s.length - m[0].length);\n quote = null;\n } else if (m !== null && m[3] === undefined) {\n // Unquoted `attr=${v}`: the next static chunk must resume with an\n // attribute delimiter, or the template may simply end there.\n const next = strings[i + 1];\n const validNext =\n next.length > 0\n ? /^[\\s>/]/.test(next)\n : i + 1 === strings.length - 1;\n if (!validNext) throw partialValueError(s);\n holes[i] = { kind: 'attr', name: m[2], quote: null, tag: tagName };\n s = s.slice(0, s.length - m[0].length);\n } else if (/<\\/?$/.test(s)) {\n // The tag opened as the chunk's last characters (`</${…}`).\n throw holeError(\n 'tag-name holes (`<${…}>`) are not supported — write tag names statically. ' +\n 'For a literal \"<\" before a hole, escape it as &lt;.',\n );\n } else {\n throw holeError(\n 'a hole inside a tag must be a complete attribute value — attr=${…} or attr=\"${…}\". ' +\n 'Tag-name and attribute-name holes are not supported; write those statically.',\n );\n }\n }\n }\n chunks[i] = s;\n }\n return { chunks, holes, tagClose };\n}\n","/**\n * `html` — tagged-template authoring at the `kerfjs/html` subpath, so\n * \"no build step\" is literally true: a CDN / importmap consumer can author\n * kerf UIs without a JSX transform.\n *\n * import { html } from 'kerfjs/html';\n * html`<div class=\"${cls}\">Count: ${count}</div>`\n * html`<ul>${each(items.value, (i) => html`<li id=\"${i.id}\">${i.label}</li>`)}</ul>`\n *\n * A thin front-end over the exact machinery JSX uses — the runtime paths are\n * IDENTICAL. Text holes go through the JSX child pipeline (`_toSegment`):\n * SafeHtml/list-segment passthrough (so `each()` composes and the keyed\n * reconciler owns its rows), string escaping, number stringify, boolean /\n * nullish → nothing, signal → fine-grained text binding, DOM-node and\n * unsupported-type errors. Attribute holes go through the JSX attribute\n * branch: signal → `_assertEmittableAttrName` + `bindAttr` (grouped into one\n * marker attribute per element); anything else → the JSX attribute renderer\n * (booleans, SafeHtml, URL screening, `on*` / malformed-name rejection).\n * `mount()` / `morph()` / the reconcilers need zero changes.\n *\n * Unlike JSX, NO camelCase attribute aliasing is applied — template authors\n * write real HTML attribute names (`class`, not `className`).\n *\n * Hole contract (enforced by the parser in `utils/parseTemplate.ts`): holes\n * are allowed in text/child positions and as a COMPLETE attribute value\n * (`attr=${v}` or `attr=\"${v}\"`). Tag-name holes, attribute-name holes,\n * partial attribute values (`class=\"a ${b}\"`), and holes inside comments\n * throw. Static chunks are author-written markup and pass through verbatim\n * (same trust model as JSX tags/attrs).\n *\n * Perf: the parse runs once per template call site — the tagged-template\n * strings array has stable identity, so a `WeakMap` keyed on it caches the\n * `ParsedTemplate`. Rendering is a chunk walk with string concatenation,\n * the same cost shape as the JSX runtime.\n */\n\nimport { bindAttr, bindMarkerAttr, isSignal } from './bindings.js';\nimport {\n _assertEmittableAttrName,\n _renderAttrVerbatim,\n _toSegment,\n SafeHtml,\n} from './jsx-runtime.js';\nimport type { ReadonlySignal, Signal } from './reactive.js';\nimport { mergeChildSegments, type Segment } from './segment.js';\nimport { type ParsedTemplate, parseTemplate } from './utils/parseTemplate.js';\n\n/**\n * Values accepted in `html\\`\\`` holes — the same set JSX accepts for\n * children (text holes) and attribute values (attr holes), including a\n * signal/`computed` itself for a fine-grained binding.\n */\nexport type HtmlValue =\n | SafeHtml\n | string\n | number\n | boolean\n | null\n | undefined\n | ReadonlySignal<unknown>\n | readonly HtmlValue[];\n\nconst PARSE_CACHE = new WeakMap<TemplateStringsArray, ParsedTemplate>();\n\n// Module-level mutable counter, sanctioned as observability-only state (see\n// AGENTS.md design rule 5): it feeds the `_parseCount()` test hook that pins\n// the parse-once-per-callsite cache behavior and never influences rendering.\nlet parseCount = 0;\n\n/** Test hook: number of template parses performed (cache misses) so far. */\nexport function _parseCount(): number {\n return parseCount;\n}\n\nfunction getParsed(strings: TemplateStringsArray): ParsedTemplate {\n let parsed = PARSE_CACHE.get(strings);\n if (parsed === undefined) {\n parsed = parseTemplate(strings);\n parseCount++;\n PARSE_CACHE.set(strings, parsed);\n }\n return parsed;\n}\n\nexport function html(\n strings: TemplateStringsArray,\n ...values: HtmlValue[]\n): SafeHtml {\n const { chunks, holes, tagClose } = getParsed(strings);\n const parts: Segment[] = [];\n let buf = '';\n // Signal-attr binding ids for the currently-open element; flushed as one\n // marker attribute (`data-kfb` / `data-kfbrow`) at the tag's closing `>`,\n // mirroring the per-element grouping in `jsx()`.\n let pendingBindIds: string[] | null = null;\n\n for (let i = 0; i < chunks.length; i++) {\n let chunk = chunks[i];\n if (pendingBindIds !== null && tagClose[i] !== -1) {\n const off = tagClose[i];\n chunk = `${chunk.slice(0, off)} ${bindMarkerAttr()}=\"${pendingBindIds.join(',')}\"${chunk.slice(off)}`;\n pendingBindIds = null;\n }\n buf += chunk;\n if (i === holes.length) break;\n\n const hole = holes[i];\n const value = values[i];\n if (hole.kind === 'text') {\n const seg = _toSegment(value);\n if (seg.kind === 'static') {\n buf += seg.html;\n } else {\n parts.push({ kind: 'static', html: buf });\n buf = '';\n parts.push(seg);\n }\n } else if (isSignal(value)) {\n // Same contract as the `jsx()` signal-attribute branch: reject `on*` /\n // malformed names unconditionally (a signal's value changes over time),\n // then register the binding — or snapshot outside a mount render.\n _assertEmittableAttrName(hole.name, hole.name, false);\n const id = bindAttr(hole.name, value as Signal<unknown>);\n if (id !== null) {\n (pendingBindIds ??= []).push(id);\n } else {\n buf += _renderAttrVerbatim(\n hole.name,\n (value as Signal<unknown>).value,\n hole.tag,\n );\n }\n } else {\n buf += _renderAttrVerbatim(hole.name, value, hole.tag);\n }\n }\n if (buf !== '' || parts.length === 0)\n parts.push({ kind: 'static', html: buf });\n return new SafeHtml(mergeChildSegments(parts));\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "kerfjs",
3
- "version": "5.0.0-beta.115",
3
+ "version": "5.0.0-beta.117",
4
4
  "description": "Tiny reactive UI framework — fine-grained signals + DOM morphing + JSX. Apply the smallest possible cut to update your DOM.",
5
5
  "type": "module",
6
6
  "sideEffects": [
package/setup/cli.mjs CHANGED
@@ -29,6 +29,8 @@ try {
29
29
  Options:
30
30
  --root <path> Workspace root (default: current directory)
31
31
  --package <name> Select a workspace package by name or relative path
32
+ --guidance-source <path>
33
+ Use shared workspace guidance, e.g. AGENTS.md
32
34
  --core | --ui Choose a mode when it cannot be detected
33
35
  --resolve <id>=<choice>
34
36
  Resolve one conflict with keep or kerf (repeatable)
@@ -48,6 +50,7 @@ Options:
48
50
  const noInstall = args.includes('--no-install');
49
51
  const root = take('--root');
50
52
  const packageSelector = take('--package');
53
+ const guidanceSource = take('--guidance-source');
51
54
  const resolutions = {};
52
55
  for (const entry of takeAll('--resolve')) {
53
56
  const index = entry.lastIndexOf('=');
@@ -74,6 +77,7 @@ Options:
74
77
  package: packageSelector,
75
78
  mode: ui ? 'ui' : core ? 'core' : undefined,
76
79
  resolutions,
80
+ guidanceSource,
77
81
  });
78
82
  console.log(formatSetupPlan(plan));
79
83
  if (plan.conflicts.length) {
package/setup/index.d.mts CHANGED
@@ -28,6 +28,7 @@ export function planKerfSetup(options?: {
28
28
  package?: string;
29
29
  mode?: 'core' | 'ui';
30
30
  version?: string;
31
+ guidanceSource?: string;
31
32
  resolutions?: Record<string, 'keep' | 'kerf'>;
32
33
  }): Promise<KerfSetupPlan>;
33
34
  export function formatSetupPlan(plan: KerfSetupPlan): string;
package/setup/index.mjs CHANGED
@@ -43,6 +43,7 @@ const exists = async (path) => {
43
43
 
44
44
  const portable = (root, path) =>
45
45
  relative(root, path).replaceAll('\\', '/') || '.';
46
+ const shellArg = (value) => `'${value.replaceAll("'", "'\\''")}'`;
46
47
  const contained = (root, path) => {
47
48
  const offset = relative(root, path);
48
49
  return (
@@ -482,7 +483,7 @@ function mergeEslintConfig(source, mode) {
482
483
  };
483
484
  }
484
485
 
485
- function profileTemplate(packageName, catalogPath) {
486
+ function profileTemplate(packageName, catalogPath, selectionPath) {
486
487
  return {
487
488
  $schema:
488
489
  'https://raw.githubusercontent.com/brianwestphal/kerf/main/ui/ai/application-ui-profile.schema.json',
@@ -491,6 +492,9 @@ function profileTemplate(packageName, catalogPath) {
491
492
  catalogs: [
492
493
  {
493
494
  package: packageName,
495
+ ...(selectionPath
496
+ ? { selection: { path: selectionPath, schemaVersion: 1 } }
497
+ : {}),
494
498
  composition: { path: catalogPath, schemaVersion: 1 },
495
499
  },
496
500
  ],
@@ -643,6 +647,7 @@ export async function planKerfSetup({
643
647
  mode: requestedMode,
644
648
  version,
645
649
  resolutions = {},
650
+ guidanceSource,
646
651
  } = {}) {
647
652
  root = resolve(root);
648
653
  const selected = await selectPackage(root, selector, requestedMode);
@@ -666,6 +671,32 @@ export async function planKerfSetup({
666
671
  priorState.packagePath === packageKey ? priorState : {};
667
672
  const priorPackageState =
668
673
  priorState.packages?.[packageKey] ?? legacyPackageState;
674
+ guidanceSource ??= priorPackageState.guidanceSource;
675
+ if (guidanceSource) {
676
+ const sourcePath = resolve(root, guidanceSource);
677
+ if (!sourcePath.startsWith(`${root}/`))
678
+ throw new Error(
679
+ 'Shared guidance source must be inside the workspace root.',
680
+ );
681
+ const actualSourcePath = await realpath(sourcePath).catch(() => null);
682
+ if (
683
+ actualSourcePath &&
684
+ !actualSourcePath.startsWith(`${await realpath(root)}/`)
685
+ )
686
+ throw new Error(
687
+ 'Shared guidance source must resolve inside the workspace root.',
688
+ );
689
+ const source = await readText(sourcePath);
690
+ if (
691
+ !source ||
692
+ !/\bkerf(?:js)?\b/i.test(source) ||
693
+ !/(?:kerf:check|npm run check)/i.test(source)
694
+ )
695
+ throw new Error(
696
+ 'Shared guidance source must exist and describe Kerf and a project check command.',
697
+ );
698
+ guidanceSource = portable(root, sourcePath);
699
+ }
669
700
  if (
670
701
  priorPackageState.package &&
671
702
  priorPackageState.package !== (selected.manifest.name ?? packageKey)
@@ -720,6 +751,33 @@ export async function planKerfSetup({
720
751
  continue;
721
752
  const destination = resolve(root, file.dest);
722
753
  const bundled = await readFile(resolve(packageRoot, file.bundle), 'utf8');
754
+ if (file.name === 'skill' && guidanceSource) {
755
+ const sourcePath = resolve(root, guidanceSource);
756
+ const importPath = relative(dirname(destination), sourcePath).replaceAll(
757
+ '\\',
758
+ '/',
759
+ );
760
+ const shared = `---\nname: kerf-app\ndescription: Use the shared workspace guidance for Kerf application work.\n---\n\n@${importPath}\n`;
761
+ const current = await readText(destination);
762
+ knownResolutionIds.add(file.dest);
763
+ if (current !== null && current !== shared && !resolutions[file.dest]) {
764
+ activeConflictIds.add(file.dest);
765
+ conflicts.push({
766
+ id: file.dest,
767
+ message: 'shared guidance import differs from existing skill',
768
+ });
769
+ } else if (
770
+ current === null ||
771
+ current === shared ||
772
+ resolutions[file.dest] === 'kerf'
773
+ ) {
774
+ await addAction(destination, shared, 'canonical');
775
+ managedAfter[file.dest] = { sha256: sha256(shared) };
776
+ } else {
777
+ activeConflictIds.add(file.dest);
778
+ }
779
+ continue;
780
+ }
723
781
  const merged = mergeCanonical(
724
782
  await readText(destination),
725
783
  bundled,
@@ -750,10 +808,18 @@ export async function planKerfSetup({
750
808
  nextManifest.scripts ??= {};
751
809
  nextManifest.devDependencies ??= {};
752
810
  nextManifest.dependencies ??= {};
811
+ const packageDoctorConfig = resolve(
812
+ selected.directory,
813
+ '.kerf-ui-doctor.json',
814
+ );
753
815
  const workspaceDoctorArgs =
754
816
  selected.directory === root
755
817
  ? ''
756
- : ` --root ${portable(selected.directory, root)} --package ${nextManifest.name}`;
818
+ : ` --root ${portable(selected.directory, root)} --package ${nextManifest.name}${
819
+ (await exists(packageDoctorConfig))
820
+ ? ` --config ${shellArg(portable(root, packageDoctorConfig))}`
821
+ : ''
822
+ }`;
757
823
  addMapValues(
758
824
  nextManifest.scripts,
759
825
  mode === 'ui'
@@ -1009,27 +1075,53 @@ export async function planKerfSetup({
1009
1075
  currentProfileSource === null
1010
1076
  ? undefined
1011
1077
  : JSON.parse(currentProfileSource);
1012
- const catalogRelative = portable(
1013
- root,
1014
- resolve(selected.directory, 'component-composition.json'),
1015
- );
1078
+ const profileCatalogPath = (configuredPath) => {
1079
+ const relative = portable(
1080
+ root,
1081
+ resolve(selected.directory, configuredPath),
1082
+ );
1083
+ return relative.startsWith('.') ? relative : `./${relative}`;
1084
+ };
1016
1085
  const profile = mergeProfile(
1017
1086
  currentProfile,
1018
1087
  profileTemplate(
1019
1088
  nextManifest.name,
1020
- catalogRelative.startsWith('.')
1021
- ? catalogRelative
1022
- : `./${catalogRelative}`,
1089
+ profileCatalogPath(nextManifest.kerfComponentCatalog.output),
1090
+ nextManifest.kerfComponentCatalog.selectionOutput
1091
+ ? profileCatalogPath(
1092
+ nextManifest.kerfComponentCatalog.selectionOutput,
1093
+ )
1094
+ : undefined,
1023
1095
  ),
1024
1096
  context,
1025
1097
  );
1026
1098
  await addAction(profilePath, stableJson(profile), 'json');
1027
- const metadataPath = resolve(selected.directory, 'kerf.components.json');
1028
- if (!(await exists(metadataPath)))
1099
+ const metadataPath = resolve(
1100
+ selected.directory,
1101
+ nextManifest.kerfComponentCatalog.source,
1102
+ );
1103
+ if (nextManifest.kerfComponentCatalog.selectionOutput) {
1104
+ const metadata = await readJson(metadataPath);
1105
+ if (
1106
+ !metadata ||
1107
+ typeof metadata.description !== 'string' ||
1108
+ !metadata.description.trim()
1109
+ )
1110
+ throw new Error(
1111
+ `${portable(root, metadataPath)}: selectionOutput requires an authored metadata source with a nonempty description. Add the source and description before running setup.`,
1112
+ );
1113
+ } else if (!(await exists(metadataPath)))
1029
1114
  await addAction(metadataPath, stableJson(metadataTemplate()), 'json');
1030
1115
  generatedPaths.push(
1031
1116
  resolve(selected.directory, nextManifest.kerfComponentCatalog.output),
1032
1117
  );
1118
+ if (nextManifest.kerfComponentCatalog.selectionOutput)
1119
+ generatedPaths.push(
1120
+ resolve(
1121
+ selected.directory,
1122
+ nextManifest.kerfComponentCatalog.selectionOutput,
1123
+ ),
1124
+ );
1033
1125
  }
1034
1126
 
1035
1127
  for (const [id, resolution] of Object.entries(requestedResolutions)) {
@@ -1057,6 +1149,9 @@ export async function planKerfSetup({
1057
1149
  mode: priorState.mode,
1058
1150
  package: priorState.package,
1059
1151
  packagePath: priorState.packagePath,
1152
+ ...(priorState.guidanceSource
1153
+ ? { guidanceSource: priorState.guidanceSource }
1154
+ : {}),
1060
1155
  managed: priorState.managed ?? {},
1061
1156
  resolutions: priorState.resolutions ?? {},
1062
1157
  },
@@ -1066,6 +1161,7 @@ export async function planKerfSetup({
1066
1161
  mode,
1067
1162
  package: nextManifest.name ?? packageKey,
1068
1163
  packagePath: packageKey,
1164
+ ...(guidanceSource ? { guidanceSource } : {}),
1069
1165
  managed: managedAfter,
1070
1166
  resolutions: Object.fromEntries(
1071
1167
  [...activeConflictIds]
@@ -24,6 +24,7 @@
24
24
  ],
25
25
  "properties": {
26
26
  "mode": { "enum": ["core", "ui"] },
27
+ "guidanceSource": { "type": "string", "minLength": 1 },
27
28
  "package": { "type": "string", "minLength": 1 },
28
29
  "packagePath": { "type": "string", "minLength": 1 },
29
30
  "managed": {