@refrakt-md/runes 0.38.0 → 0.40.0

package/dist/lib/slots.js

@@ -0,0 +1,448 @@
+/**
+ * The slot declaration — SPEC-143.
+ *
+ * A rune whose every output slot comes from exactly one resolved field, wrapped
+ * but not restructured (D4), states that as data on `createContentModelSchema`
+ * instead of writing a `transform`:
+ *
+ * ```ts
+ * emits: {
+ *   rune: 'work',
+ *   tag: 'article',
+ *   properties: { id: '', status: 'draft' },
+ *   slots: {
+ *     title: { as: 'region', el: 'header' },
+ *     blurb: { from: 'description', as: 'region', omitWhenEmpty: true },
+ *     body:  { from: 'sections', as: 'region' },
+ *   },
+ * },
+ * ```
+ *
+ * `makeSlotTransform` turns that into an ordinary transform function — a closure
+ * over the declaration, built once when the schema is constructed — and the
+ * schema calls it at the same single call site a hand-written transform uses.
+ * Nothing downstream can tell the two apart, which is what makes the
+ * byte-identical migration gate (D7) a property of the construction rather than
+ * a hope.
+ *
+ * What the declaration may say, and nothing more (D2): a slot's name, the field
+ * (or attribute) it comes from, whether it is a single `value` or a `region` of
+ * nodes with a boundary element, and whether it is omitted when empty. It
+ * cannot nest one slot in another, order slots, or create containers — those
+ * belong to the engine's `layout`. Every value is data (D9), so the declaration
+ * round-trips through JSON unchanged.
+ */
+import Markdoc from '@markdoc/markdoc';
+import { createComponentRenderable } from './component.js';
+import { fieldMetas } from './field-metas.js';
+import { selectStructuralModel } from './resolver.js';
+const { Tag } = Markdoc;
+/** The closed vocabulary of section roles — mirrors `SectionRole`. */
+const SECTION_ROLES = [
+    'header',
+    'preamble',
+    'title',
+    'description',
+    'body',
+    'footer',
+    'media',
+];
+const EMITS_KEYS = new Set(['rune', 'tag', 'property', 'properties', 'slots']);
+const SLOT_KEYS = new Set(['from', 'as', 'el', 'omitWhenEmpty', 'role']);
+/** Keys that would make a slot structural. Named so the refusal can say why (D2). */
+const STRUCTURE_KEYS = new Set([
+    'slots',
+    'children',
+    'nest',
+    'nested',
+    'into',
+    'parent',
+    'wrap',
+    'wrapper',
+    'container',
+    'group',
+    'order',
+    'position',
+    'before',
+    'after',
+    'layout',
+]);
+const ELEMENT = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+const SLOT_NAME = /^[a-z][a-zA-Z0-9]*(-[a-zA-Z0-9]+)*$/;
+const RUNE_NAME = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+/**
+ * Reject anything that would not survive `JSON.parse(JSON.stringify(…))`
+ * unchanged — a function above all (D9), but also `undefined`, a non-finite
+ * number, or a class instance such as a `RegExp`.
+ */
+function assertPlainData(value, path, fail) {
+    if (typeof value === 'function') {
+        fail(`${path} is a function. The declaration is data only (SPEC-143 D9).`);
+    }
+    if (value === undefined) {
+        fail(`${path} is undefined, which does not survive a JSON round-trip — omit the key.`);
+    }
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            fail(`${path} is not a finite number.`);
+        return;
+    }
+    if (Array.isArray(value)) {
+        value.forEach((v, i) => assertPlainData(v, `${path}[${i}]`, fail));
+        return;
+    }
+    if (typeof value === 'object') {
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== Object.prototype && proto !== null) {
+            fail(`${path} is a ${proto?.constructor?.name ?? 'class'} instance, not plain data.`);
+        }
+        for (const [k, v] of Object.entries(value)) {
+            assertPlainData(v, `${path}.${k}`, fail);
+        }
+        return;
+    }
+    fail(`${path} has unsupported type ${typeof value}.`);
+}
+/**
+ * Every field the content model can resolve, across conditional branches. A
+ * model given as a function of attributes is sampled with no attributes —
+ * enough for a model that only varies its details, which is every model this
+ * declaration supports.
+ */
+function collectFields(model) {
+    const fields = new Map();
+    const unsupported = new Set();
+    const visit = (m) => {
+        if ('when' in m) {
+            m.when.forEach((b) => visit(b.model));
+            visit(m.default);
+            return;
+        }
+        const s = m;
+        if (s.type === 'sequence' || s.type === 'sections') {
+            for (const f of s.fields ?? []) {
+                const prev = fields.get(f.name);
+                fields.set(f.name, { greedy: !!f.greedy || !!prev?.greedy, sections: false });
+            }
+            if (s.type === 'sections')
+                fields.set('sections', { greedy: true, sections: true });
+        }
+        else {
+            unsupported.add(s.type);
+        }
+    };
+    visit(typeof model === 'function' ? model({}) : model);
+    return { fields, unsupported };
+}
+/**
+ * Check a declaration against the rune's content model and normalise it.
+ * Throws, naming the rune and the offending slot, rather than applying any part
+ * of a declaration it cannot honour.
+ */
+export function validateEmits(emits, contentModel) {
+    const runeLabel = emits && typeof emits === 'object' && typeof emits.rune === 'string'
+        ? `"${emits.rune}"`
+        : '(unnamed)';
+    const fail = (msg) => {
+        throw new Error(`Rune ${runeLabel}: invalid \`emits\` declaration — ${msg}`);
+    };
+    if (!emits || typeof emits !== 'object' || Array.isArray(emits))
+        fail('must be an object.');
+    assertPlainData(emits, 'emits', fail);
+    for (const key of Object.keys(emits)) {
+        if (!EMITS_KEYS.has(key)) {
+            fail(STRUCTURE_KEYS.has(key)
+                ? `\`${key}\` would declare structure. The declaration names slots only; nesting, ordering and containers are \`layout\`'s (SPEC-143 D2).`
+                : `unknown key \`${key}\` (expected ${[...EMITS_KEYS].join(', ')}).`);
+        }
+    }
+    if (typeof emits.rune !== 'string' || !RUNE_NAME.test(emits.rune)) {
+        fail('`rune` must be the kebab-case rune name.');
+    }
+    if (typeof emits.tag !== 'string' || !ELEMENT.test(emits.tag)) {
+        fail('`tag` must be an element name.');
+    }
+    if (emits.property !== undefined && typeof emits.property !== 'string') {
+        fail('`property` must be a string.');
+    }
+    const propertyKeys = new Set();
+    if (emits.properties !== undefined) {
+        if (typeof emits.properties !== 'object' || Array.isArray(emits.properties)) {
+            fail('`properties` must be an object.');
+        }
+        for (const [key, entry] of Object.entries(emits.properties)) {
+            propertyKeys.add(key);
+            if (typeof entry === 'string')
+                continue;
+            const ok = entry &&
+                typeof entry === 'object' &&
+                Array.isArray(entry.from) &&
+                entry.from.every((s) => typeof s === 'string' && /^(attrs|file)\.\S+$/.test(s)) &&
+                typeof entry.default === 'string' &&
+                Object.keys(entry).every((k) => k === 'from' || k === 'default');
+            if (!ok) {
+                fail(`property \`${key}\` must be a default string or { from: ["attrs.<name>" | "file.<name>", …], default: string }.`);
+            }
+        }
+    }
+    if (!emits.slots || typeof emits.slots !== 'object' || Array.isArray(emits.slots)) {
+        fail('`slots` must be an object of slot entries.');
+    }
+    const slotNames = Object.keys(emits.slots);
+    if (slotNames.length === 0)
+        fail('`slots` declares no slot.');
+    const { fields, unsupported } = collectFields(contentModel);
+    const normalized = [];
+    for (const name of slotNames) {
+        const where = `slot \`${name}\``;
+        if (!SLOT_NAME.test(name))
+            fail(`${where}: not a valid data-name.`);
+        if (propertyKeys.has(name)) {
+            fail(`${where} is also a property. Properties and slots share one flat namespace (ADR-008), and the two would carry one name on two nodes.`);
+        }
+        const raw = emits.slots[name];
+        const decl = typeof raw === 'string' ? { as: raw } : raw;
+        if (!decl || typeof decl !== 'object' || Array.isArray(decl)) {
+            fail(`${where} must be "value", "region" or a slot declaration.`);
+        }
+        for (const key of Object.keys(decl)) {
+            if (SLOT_KEYS.has(key))
+                continue;
+            fail(STRUCTURE_KEYS.has(key)
+                ? `${where}: \`${key}\` would nest, order or contain slots. A slot is flat — that is \`layout\`'s job (SPEC-143 D2).`
+                : `${where}: unknown key \`${key}\` (expected ${[...SLOT_KEYS].join(', ')}).`);
+        }
+        if (decl.as !== 'value' && decl.as !== 'region') {
+            fail(`${where}: \`as\` must be "value" or "region".`);
+        }
+        if (decl.el !== undefined && (typeof decl.el !== 'string' || !ELEMENT.test(decl.el))) {
+            fail(`${where}: \`el\` must be a single element name — a slot has one boundary, never a nested one (SPEC-143 D2).`);
+        }
+        if (decl.omitWhenEmpty !== undefined && typeof decl.omitWhenEmpty !== 'boolean') {
+            fail(`${where}: \`omitWhenEmpty\` must be a boolean.`);
+        }
+        if (decl.role !== undefined && !SECTION_ROLES.includes(decl.role)) {
+            fail(`${where}: \`role\` must be one of ${SECTION_ROLES.join(', ')}.`);
+        }
+        const from = decl.from ?? name;
+        if (typeof from !== 'string' || from === '')
+            fail(`${where}: \`from\` must be a string.`);
+        const slot = {
+            name,
+            kind: decl.as,
+            el: decl.el,
+            omitWhenEmpty: decl.omitWhenEmpty ?? false,
+            role: decl.role,
+        };
+        if (from.startsWith('attrs.')) {
+            slot.attr = from.slice('attrs.'.length);
+            if (!slot.attr)
+                fail(`${where}: \`from\` names no attribute.`);
+            if (decl.as !== 'value') {
+                fail(`${where}: an attribute is one value; it cannot be a region.`);
+            }
+        }
+        else {
+            if (from.includes('.')) {
+                fail(`${where}: \`from\` is a content field name or "attrs.<name>", not "${from}".`);
+            }
+            const info = fields.get(from);
+            if (!info) {
+                const known = [...fields.keys()];
+                fail(unsupported.size > 0 && known.length === 0
+                    ? `${where}: the content model is ${[...unsupported].join(' / ')}, which the slot declaration does not read. Keep a \`transform\` (SPEC-143 D3).`
+                    : `${where}: \`from: "${from}"\` names no field of the content model (fields: ${known.join(', ') || 'none'}).`);
+            }
+            slot.field = from;
+            if (decl.as === 'value') {
+                if (info.greedy) {
+                    fail(`${where}: field \`${from}\` can resolve to several nodes, and a value slot names every node it emits — that is two nodes carrying data-name="${name}". Declare it \`as: "region"\`.`);
+                }
+                if (decl.el !== undefined) {
+                    fail(`${where}: a value read from a field is already one node; there is nothing to wrap. Declare it \`as: "region"\` to give it a boundary.`);
+                }
+            }
+        }
+        normalized.push(slot);
+    }
+    return normalized;
+}
+function isRole(name) {
+    return name !== undefined && SECTION_ROLES.includes(name);
+}
+/**
+ * The `sections` join table a declaration implies — slot name → section role.
+ * A slot's role is the one it states, else its own name when that is a role,
+ * else its source field's name when that is one.
+ */
+export function slotSections(emits) {
+    const out = {};
+    for (const [name, raw] of Object.entries(emits.slots)) {
+        const decl = typeof raw === 'string' ? { as: raw } : raw;
+        const from = decl.from ?? name;
+        const role = decl.role ?? (isRole(name) ? name : isRole(from) ? from : undefined);
+        if (role)
+            out[name] = role;
+    }
+    return out;
+}
+function asNodes(value) {
+    if (Array.isArray(value))
+        return value;
+    if (value != null)
+        return [value];
+    return [];
+}
+function render(value, config) {
+    return Markdoc.transform(asNodes(value), config);
+}
+/** Heading text → `data-name` slug, for a section with no canonical slug. */
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * One resolved section entry (a `sections` model without `emitTag`) as a
+ * `<section>` named by its slug: its heading, then its resolved fields.
+ *
+ * The slug is the entry's own identity — the known section's language-stable
+ * `$canonicalSlug` (SPEC-035), else the heading text slugified — and a known
+ * section's heading carries `data-known-section` so a table of contents can
+ * pick the known sections out. A top-level thematic break in the body is the
+ * author's separator between thoughts, not content, and is dropped.
+ */
+function renderSectionEntry(entry, config) {
+    const heading = entry.$heading ?? '';
+    const canonicalName = entry.$canonicalName;
+    const slug = entry.$canonicalSlug ?? slugify(heading);
+    const children = [];
+    const headingNode = entry.$headingNode;
+    if (headingNode) {
+        const renderedHeading = render([headingNode], config);
+        const first = renderedHeading[0];
+        if (canonicalName && Tag.isTag(first)) {
+            first.attributes['data-known-section'] = canonicalName;
+        }
+        children.push(...renderedHeading);
+    }
+    for (const [key, value] of Object.entries(entry)) {
+        if (key.startsWith('$'))
+            continue;
+        children.push(...render(value, config).filter((n) => !(Tag.isTag(n) && n.name === 'hr')));
+    }
+    return new Tag('section', { 'data-name': slug }, children);
+}
+/**
+ * Build the transform a declaration describes. Called once, when the schema is
+ * constructed; the closure it returns has the signature of a hand-written
+ * transform and is called where one would be.
+ */
+export function makeSlotTransform(emits, contentModel) {
+    const slots = validateEmits(emits, contentModel);
+    const { rune, tag, property, properties } = emits;
+    return (resolved, attrs, config, node) => {
+        // D5 — whether sections arrive as resolved entries or as emitted child
+        // runes is the content model's `emitTag`; read it, per instance, from the
+        // branch the resolver actually took.
+        let structural;
+        const sectionsEmitTag = () => {
+            structural ??= selectStructuralModel(node.children, typeof contentModel === 'function' ? contentModel(attrs) : contentModel, attrs);
+            return structural.type === 'sections' ? structural.emitTag : undefined;
+        };
+        const refs = {};
+        const children = [];
+        for (const slot of slots) {
+            let out;
+            if (slot.attr !== undefined) {
+                const value = attrs[slot.attr];
+                if (slot.omitWhenEmpty && (value == null || value === ''))
+                    continue;
+                out = new Tag(slot.el ?? 'span', {}, [value ?? '']);
+            }
+            else {
+                const field = slot.field;
+                let nodes;
+                if (field === 'sections' && sectionsEmitTag() === undefined) {
+                    nodes = asNodes(resolved.sections).map((entry) => renderSectionEntry(entry, config));
+                }
+                else {
+                    nodes = render(resolved[field], config);
+                }
+                if (slot.kind === 'value') {
+                    if (nodes.length === 0)
+                        continue;
+                    const only = nodes[0];
+                    if (nodes.length > 1 || !Tag.isTag(only)) {
+                        throw new Error(`Rune "${rune}": value slot \`${slot.name}\` rendered ${nodes.length} node(s), not one element. A value slot names exactly one node.`);
+                    }
+                    out = only;
+                }
+                else {
+                    if (nodes.length === 0 && slot.omitWhenEmpty)
+                        continue;
+                    out = new Tag(slot.el ?? 'div', {}, nodes);
+                }
+            }
+            refs[slot.name] = out;
+            children.push(out);
+        }
+        return createComponentRenderable({
+            rune,
+            tag: tag,
+            property,
+            properties: properties ? fieldMetas(attrs, config, properties) : undefined,
+            refs,
+            children,
+        });
+    };
+}
+/**
+ * A declaration with every default made explicit — what the generated transform
+ * will actually do, which is the thing a reviewer needs and the declaration's
+ * terseness hides.
+ */
+export function describeSlots(emits, contentModel) {
+    const roles = slotSections(emits);
+    let emitTag;
+    if (contentModel) {
+        const m = typeof contentModel === 'function' ? contentModel({}) : contentModel;
+        const s = 'when' in m ? m.default : m;
+        if ('type' in s && s.type === 'sections')
+            emitTag = s.emitTag;
+    }
+    return Object.entries(emits.slots).map(([name, raw]) => {
+        const decl = typeof raw === 'string' ? { as: raw } : raw;
+        const from = decl.from ?? name;
+        const fromAttr = from.startsWith('attrs.');
+        const el = decl.as === 'region' ? (decl.el ?? 'div') : fromAttr ? (decl.el ?? 'span') : undefined;
+        return {
+            name,
+            from,
+            as: decl.as,
+            ...(el ? { el } : {}),
+            omitWhenEmpty: decl.omitWhenEmpty ?? false,
+            ...(roles[name] ? { role: roles[name] } : {}),
+            ...(from === 'sections' && contentModel
+                ? { sections: emitTag ? 'child runes' : 'entries' }
+                : {}),
+        };
+    });
+}
+/** One line per slot, for the text surfaces. */
+export function formatSlotLine(slot) {
+    const parts = [slot.as];
+    if (slot.el)
+        parts.push(`<${slot.el}>`);
+    if (slot.omitWhenEmpty)
+        parts.push('omitted when empty');
+    if (slot.role)
+        parts.push(`role: ${slot.role}`);
+    if (slot.sections)
+        parts.push(`sections arrive as ${slot.sections}`);
+    return `${slot.name} <- ${slot.from}  (${parts.join(', ')})`;
+}
+//# sourceMappingURL=slots.js.map

package/dist/lib/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../../src/lib/slots.ts"],"names":[],"mappings":"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"}

package/dist/plugins.d.ts

@@ -114,4 +114,7 @@ export declare function discoverPluginFixtureManifest(npmPackageName: string): P
  * back to the first parsed). Backward-compatible with bare `<rune>.md` files.
  */
 export declare function discoverPluginFixtures(npmPackageName: string): Promise<Record<string, string>>;
+/** Validate a loaded Plugin has required fields. Each rune entry carries
+ *  exactly one of `transform` or `template` (SPEC-153 D11). */
+export declare function validatePlugin(pkg: Plugin, npmName: string): void;
 //# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"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"}

package/dist/plugins.js

@@ -1,5 +1,7 @@
 import { selectLocaleBundle } from '@refrakt-md/transform';
 import { defineRune, runeTagMap } from './rune.js';
+import { checkComposedCatalog, composedPluginRune } from './composed-rune.js';
+import { compositionFor, composedTypeName } from './lib/composition.js';
 /** Reserved namespace names that cannot be used by user config or plugins. */
 const RESERVED_FILE_ROOT_NAMESPACES = new Set(['site']);
 /** Validate that a file-root namespace name is allowed. Throws on reserved
@@ -34,6 +36,23 @@ export async function loadPlugin(npmPackageName) {
     const runes = {};
     const fixtures = {};
     for (const [runeName, entry] of Object.entries(pkg.runes)) {
+        if (entry.template !== undefined) {
+            // SPEC-153 D11 — a composed rune: its schema and its block-less
+            // config are both built from the definition.
+            const composed = composedPluginRune(runeName, entry);
+            runes[runeName] = defineRune({
+                ...composed.rune,
+                name: runeName,
+                schema: composed.rune.schema,
+                description: entry.description ?? composed.rune.description,
+                aliases: entry.aliases ?? composed.rune.aliases,
+                seoType: entry.seoType,
+                authoringHints: entry.authoringHints,
+            });
+            if (entry.fixture)
+                fixtures[runeName] = entry.fixture;
+            continue;
+        }
         runes[runeName] = defineRune({
             name: runeName,
             schema: entry.transform,
@@ -198,6 +217,13 @@ export function mergePlugins(loaded, coreRuneNames, prefer) {
                 themeRunes[key] = value;
             }
         }
+        // SPEC-145 D2a — a composed rune's config is generated from its
+        // definition, never hand-written beside it.
+        for (const rune of Object.values(loadedPkg.runes)) {
+            const info = compositionFor(rune.schema);
+            if (info?.config && info.typeName)
+                themeRunes[info.typeName] = info.config;
+        }
         if (loadedPkg.pkg.theme?.icons) {
             for (const [group, icons] of Object.entries(loadedPkg.pkg.theme.icons)) {
                 themeIcons[group] = { ...themeIcons[group], ...icons };
@@ -209,6 +235,10 @@ export function mergePlugins(loaded, coreRuneNames, prefer) {
             }
         }
     }
+    // SPEC-145 — the composition checks that need every rune: cycles (by name),
+    // a composed type placed over a peer type (D9), a placed rune missing its
+    // required parent (D12). Here, at assembly, rather than at render.
+    checkComposedCatalog(runes, themeRunes);
     const extensions = {};
     for (const loadedPkg of loaded) {
         if (loadedPkg.pkg.extends) {
@@ -390,7 +420,9 @@ export async function discoverPluginFixtureManifest(npmPackageName) {
         }
     }
     catch {
-        // Plugin not resolvable via require (e.g., workspace link) — skip file fixtures
+        // `<pkg>/package.json` did not resolve — the package is not installed, or it declares an
+        // `exports` map without a `./package.json` entry (ERR_PACKAGE_PATH_NOT_EXPORTED). A
+        // workspace link resolves fine. Skip file fixtures.
     }
     return manifest;
 }
@@ -436,8 +468,9 @@ function isPlugin(value) {
         typeof obj.runes === 'object' &&
         obj.runes !== null);
 }
-/** Validate a loaded Plugin has required fields */
-function validatePlugin(pkg, npmName) {
+/** Validate a loaded Plugin has required fields. Each rune entry carries
+ *  exactly one of `transform` or `template` (SPEC-153 D11). */
+export function validatePlugin(pkg, npmName) {
     if (!pkg.name) {
         throw new Error(`Plugin "${npmName}" has an empty name field`);
     }
@@ -448,9 +481,25 @@ function validatePlugin(pkg, npmName) {
         throw new Error(`Plugin "${npmName}" defines no runes`);
     }
     for (const [name, entry] of Object.entries(pkg.runes)) {
+        if (entry.template !== undefined) {
+            if (entry.transform !== undefined) {
+                throw new Error(`Plugin "${npmName}" rune "${name}" carries both a \`transform\` and a composition \`template\`. ` +
+                    `A rune has exactly one emit path (SPEC-145 D5, SPEC-153 D11): drop the transform to compose, or the template to build its own output.`);
+            }
+            if (typeof entry.template !== 'string') {
+                throw new Error(`Plugin "${npmName}" rune "${name}" has an invalid template. ` +
+                    `Expected a composed rune definition: YAML frontmatter and a Markdoc template, as one string.`);
+            }
+            const configKey = composedTypeName(name);
+            if (pkg.theme?.runes?.[configKey] !== undefined) {
+                throw new Error(`Plugin "${npmName}" rune "${name}" is composed but also has a hand-written theme config (\`theme.runes.${configKey}\`). ` +
+                    `A composed rune's config is generated from its definition, and it has no block and ships no CSS (SPEC-145 D2, D2a).`);
+            }
+            continue;
+        }
         if (!entry.transform || typeof entry.transform !== 'object') {
             throw new Error(`Plugin "${npmName}" rune "${name}" has an invalid transform. ` +
-                `Expected a Markdoc Schema object (created via createContentModelSchema()).`);
+                `Expected a Markdoc Schema object (created via createContentModelSchema()), or a composition \`template\`.`);
         }
     }
 }