@forumone/throughline-design-system 0.0.0 → 1.0.0-next.2

package/dist/generate/layout.js

@@ -0,0 +1,252 @@
+import { pairTitle } from './labels.js';
+/*
+How a block's fields are arranged on screen, as distinct from what they are.
+
+Everything here is presentational. An unnamed `group` and a `collapsible` hold
+their children in the same data object as their siblings, so moving a field
+into one changes where it is drawn and nothing about where it is stored: no
+migration, no change to `payload-types.ts`, and `coerce` — which walks the
+contract, not this config — never sees the difference. That is the property
+that makes it safe to rearrange every block at once.
+
+Two rules, both read off the contract rather than configured per block.
+
+**A label and its link are one thing.** A contract names a call to action as a
+pair of siblings, `ctaLabel` and `ctaHref`, because the component takes them as
+two props. Generated literally, the editor drew them as unrelated fields with
+unrelated headings: a text box captioned "Cta Label" and, below it, a group
+headed "Cta Href". So a `<prefix>Label` text field and a `<prefix>Href` or
+`<prefix>Url` link become one group headed by what they are together — "Call to
+action", "View all link" — at the position of whichever came first. A
+`<prefix>Icon` beside them joins too, since it is drawn inside the same button.
+
+**What most authors should leave alone goes behind a disclosure.** Top-level
+selects, checkboxes and numbers on a block are how it looks — heading level,
+variant, columns, aspect ratio — and every one has a default the component
+already chose well. A field the contract marks `advanced` is the same kind of
+thing in words: a screen-reader label or a status message the component
+already supplies. Both move to one collapsed "More options" section at the end
+of the block, so an author reading a block sees its content first. A field the
+contract marks `required` is never tucked away, whatever its type: a required
+field hidden behind a closed section is an error nobody can find.
+
+Only the top level gets the disclosure. Inside an array, a collapsed section per
+row would be one more click on every card, which is the cost this exists to
+remove.
+*/
+/** The data-bearing field types that set how a block looks rather than what it says. */
+const SETTING_TYPES = new Set(['select', 'boolean', 'number']);
+const LINK_SUFFIX = /^(.+)(Href|Url)$/;
+/** The label/link pairs among one level's fields, by contract index. */
+function findPairs(contract, generated) {
+    const index = new Map(contract.map((field, i) => [field.name, i]));
+    const pairs = [];
+    contract.forEach((field, i) => {
+        // An `advanced` link is one the component fills in itself —
+        // `ShareDiscussion.copyUrl` is the current page unless told otherwise — so
+        // it goes with the other defaults rather than beside the label it shares a
+        // prefix with.
+        if (field.type !== 'link' || field.advanced || !generated[i])
+            return;
+        const prefix = LINK_SUFFIX.exec(field.name)?.[1];
+        if (!prefix)
+            return;
+        const label = index.get(`${prefix}Label`);
+        if (label === undefined || contract[label]?.type !== 'text' || !generated[label])
+            return;
+        const icon = index.get(`${prefix}Icon`);
+        pairs.push({
+            prefix,
+            link: i,
+            label,
+            ...(icon !== undefined && generated[icon] ? { icon } : {}),
+        });
+    });
+    return pairs;
+}
+/**
+ * A link group drawn inside its pair: the pair's heading already names it.
+ *
+ * Its description stays on it. Payload draws a group's description only in
+ * the header a label opens, so with `label: false` nothing shows twice — and
+ * `payload-types.ts`, which carries each description as JSDoc on the field it
+ * belongs to, keeps the contract's guidance on the property it describes.
+ */
+function unheaded(link) {
+    return { ...link, label: false };
+}
+function pairGroup(pair, contract, generated) {
+    const link = generated[pair.link];
+    const label = generated[pair.label];
+    const icon = pair.icon === undefined ? null : generated[pair.icon];
+    // The link's description is about the destination, which is what the pair's
+    // heading introduces, so it moves up to sit under that heading.
+    const description = contract[pair.link]?.constraints;
+    return {
+        type: 'group',
+        label: pairTitle(pair.prefix),
+        ...(description ? { admin: { description } } : {}),
+        fields: [
+            { ...label, label: 'Label' },
+            ...(icon ? [{ ...icon, label: 'Icon' }] : []),
+            unheaded(link),
+        ],
+    };
+}
+function isSetting(field) {
+    return !field.required && (SETTING_TYPES.has(field.type) || field.advanced === true);
+}
+/**
+ * One level's generated fields, in the order and grouping an author reads them.
+ *
+ * `generated[i]` is the Payload field for `contract[i]`, or null where the
+ * contract field is not authorable. Nulls are dropped here, so the caller does
+ * not have to.
+ */
+export function arrange(contract, generated, options) {
+    const pairs = findPairs(contract, generated);
+    const pairAt = new Map();
+    const consumed = new Set();
+    for (const pair of pairs) {
+        const members = [pair.link, pair.label, ...(pair.icon === undefined ? [] : [pair.icon])];
+        pairAt.set(Math.min(...members), pair);
+        members.forEach(member => consumed.add(member));
+    }
+    const main = [];
+    const more = [];
+    contract.forEach((field, i) => {
+        const pair = pairAt.get(i);
+        if (pair) {
+            main.push(pairGroup(pair, contract, generated));
+            return;
+        }
+        const built = generated[i];
+        if (!built || consumed.has(i))
+            return;
+        (options.disclose && isSetting(field) ? more : main).push(built);
+    });
+    if (more.length === 0)
+        return main;
+    return [
+        ...main,
+        {
+            type: 'collapsible',
+            label: 'More options',
+            admin: {
+                initCollapsed: true,
+                description: 'Layout and wording the component already sets sensibly. Change them only when this block needs to differ.',
+            },
+            fields: more,
+        },
+    ];
+}
+/*
+Two more rules, for the rows of an array rather than the top of a block.
+
+**A row of a few short strings is one line.** A stat is a figure and a label,
+a fact is a label and a value, and generated literally each row was two
+full-width inputs stacked under each other — a 12-character box as wide as the
+editor, then its partner below it. When every field of a row is a single-line
+text input and there are only two or three of them, they share one line, each
+as wide as its `maxLength` is long against the others', and never narrower
+than it can be read in. A row holding anything else is left stacked: an image
+or a link beside a text box is a layout to design, not one to derive.
+
+**A row is named by what it says.** See `../admin/summary.ts`. The header
+reads the row's first one or two plain-text fields — not a setting, not an
+`advanced` field, and not the label of a call to action, which says "Read more"
+in every row it appears in.
+
+Both are drawing only. A `row` stores its children flat, exactly as the
+unnamed groups above do, and a row label is a component in the import map.
+*/
+/** How many short fields one line holds before it is easier read stacked. */
+const ONE_LINE_MAX_FIELDS = 3;
+/**
+ * An array row's fields, on one line when they are all short single-line text.
+ *
+ * Widths are each field's share of the row's combined `maxLength`, floored so
+ * a 12-character figure beside a 60-character label is still a box somebody
+ * can type into.
+ */
+export function oneLine(fields) {
+    if (fields.length < 2 || fields.length > ONE_LINE_MAX_FIELDS)
+        return fields;
+    const lengths = [];
+    for (const field of fields) {
+        if (field.type !== 'text' || typeof field.maxLength !== 'number')
+            return fields;
+        lengths.push(field.maxLength);
+    }
+    // A field whose share falls under the floor is held at it, and the rest of
+    // the line is shared among the others in proportion — repeated, because
+    // raising one can push a third under.
+    const floor = 1 / (fields.length + 2);
+    const held = new Set();
+    let shares = [];
+    for (let settled = false; !settled;) {
+        const free = lengths.reduce((sum, length, i) => (held.has(i) ? sum : sum + length), 0);
+        const room = 1 - held.size * floor;
+        shares = lengths.map((length, i) => (held.has(i) ? floor : (length / free) * room));
+        const under = shares.findIndex((share, i) => !held.has(i) && share < floor);
+        if (under === -1)
+            settled = true;
+        else
+            held.add(under);
+    }
+    const widths = shares.map(share => Math.round(share * 100));
+    // Rounding can leave the line a point over or under; the last field absorbs it.
+    widths[widths.length - 1] += 100 - widths.reduce((sum, width) => sum + width, 0);
+    return [
+        {
+            type: 'row',
+            fields: fields.map((field, i) => ({
+                ...field,
+                admin: { ...('admin' in field ? field.admin : {}), width: `${widths[i]}%` },
+            })),
+        },
+    ];
+}
+/** The most fields a row header joins. More reads as a sentence, not a name. */
+const SUMMARY_FIELDS = 2;
+/**
+ * Which of an array row's fields name it in its header, by contract name.
+ *
+ * `generated[i]` is the Payload field for `contract[i]`, as `arrange` takes
+ * it — so an omitted field, or a text field an override turned into a select,
+ * is judged by what it became rather than by what the contract says.
+ */
+export function summaryFields(contract, generated, limit = SUMMARY_FIELDS) {
+    const paired = new Set(findPairs(contract, generated).flatMap(pair => [
+        pair.label,
+        pair.link,
+        ...(pair.icon === undefined ? [] : [pair.icon]),
+    ]));
+    return contract
+        .filter((field, i) => {
+        const built = generated[i];
+        return (!paired.has(i) &&
+            !field.advanced &&
+            (built?.type === 'text' || built?.type === 'textarea'));
+    })
+        .slice(0, limit)
+        .map(field => field.name);
+}
+/** What a block's heading is called when it has one. */
+const NAME_FIELDS = new Set(['heading', 'title']);
+/**
+ * Which one field names a block in its collapsed header, by contract name.
+ *
+ * One rather than `summaryFields`' two: a block's header already carries its
+ * number and the pill naming its type, and a heading is the name a reader
+ * would give it. So the block's `heading` or `title` when it has one — an
+ * eyebrow comes first in a hero's contract and says less — and otherwise its
+ * first short text field, which for a statement or a testimonial is the text
+ * itself. `[]` for a block with no text of its own.
+ */
+export function blockSummaryFields(contract, generated) {
+    const eligible = summaryFields(contract, generated, contract.length);
+    const named = eligible.find(name => NAME_FIELDS.has(name));
+    return named ? [named] : eligible.slice(0, 1);
+}
+//# sourceMappingURL=layout.js.map

package/dist/generate/layout.js.map

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

package/dist/generate/selectOptionSnapshot.d.ts

@@ -0,0 +1,26 @@
+import type { ManifestLike } from './blocks.js';
+/**
+ * Every resolvable set of allowed values, keyed `Component.field.path`, plus
+ * the named unions under `#TypeName`.
+ */
+export type SelectOptionSnapshot = Record<string, readonly string[]>;
+/**
+ * Reads the design system's types once, at build time, and writes down what it
+ * found.
+ *
+ * Resolution needs a TypeScript `Program` over the whole declaration tree —
+ * seconds of work and a dependency on `typescript` being installed. Doing that
+ * when the Payload config loads would put it on every serverless cold start,
+ * for an answer that cannot change between deploys. So it happens in a script,
+ * the result is committed, and the runtime reads a small JSON object.
+ *
+ * Committing it also makes the values reviewable: rename a member of
+ * `CardVariant` and the diff says so, in the same pull request as the rename.
+ */
+export declare function collectSelectOptions(options: {
+    manifest: ManifestLike;
+    typesEntry: string;
+    /** Named unions to include regardless of any field referencing them. */
+    namedTypes?: string[];
+}): SelectOptionSnapshot;
+//# sourceMappingURL=selectOptionSnapshot.d.ts.map

package/dist/generate/selectOptionSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectOptionSnapshot.d.ts","sourceRoot":"","sources":["../../src/generate/selectOptionSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI/C;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAA;AAEpE;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,QAAQ,EAAE,YAAY,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB,GAAG,oBAAoB,CAiBvB"}

package/dist/generate/selectOptionSnapshot.js

@@ -0,0 +1,47 @@
+import { SelectOptionResolver } from './selectOptions.js';
+/**
+ * Reads the design system's types once, at build time, and writes down what it
+ * found.
+ *
+ * Resolution needs a TypeScript `Program` over the whole declaration tree —
+ * seconds of work and a dependency on `typescript` being installed. Doing that
+ * when the Payload config loads would put it on every serverless cold start,
+ * for an answer that cannot change between deploys. So it happens in a script,
+ * the result is committed, and the runtime reads a small JSON object.
+ *
+ * Committing it also makes the values reviewable: rename a member of
+ * `CardVariant` and the diff says so, in the same pull request as the rename.
+ */
+export function collectSelectOptions(options) {
+    const resolver = new SelectOptionResolver(options.typesEntry);
+    const snapshot = {};
+    for (const typeName of options.namedTypes ?? []) {
+        const values = resolver.resolveNamed(typeName);
+        if (values)
+            snapshot[`#${typeName}`] = values;
+    }
+    for (const component of Object.values(options.manifest.components)) {
+        walk(component.content.fields, '', path => {
+            const values = resolver.resolve(component.name, path);
+            if (values)
+                snapshot[`${component.name}.${path}`] = values;
+        });
+    }
+    return Object.fromEntries(Object.entries(snapshot).sort(([a], [b]) => a.localeCompare(b)));
+}
+/**
+ * Visits every field path, not only the `select` ones.
+ *
+ * A `text` field whose prop is a literal union is a select the contract could
+ * not express — `IntroSection.actions[].icon` is the case — so the snapshot has
+ * to carry those too or the generator cannot find them.
+ */
+function walk(fields, prefix, visit) {
+    for (const field of fields) {
+        const path = prefix ? `${prefix}.${field.name}` : field.name;
+        visit(path);
+        if (field.of)
+            walk(field.of, path, visit);
+    }
+}
+//# sourceMappingURL=selectOptionSnapshot.js.map

package/dist/generate/selectOptionSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectOptionSnapshot.js","sourceRoot":"","sources":["../../src/generate/selectOptionSnapshot.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAQzD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAKpC;IACC,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAC7D,MAAM,QAAQ,GAAyB,EAAE,CAAA;IAEzC,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;QAC9C,IAAI,MAAM;YAAE,QAAQ,CAAC,IAAI,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAA;IAC/C,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE;YACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YACrD,IAAI,MAAM;gBAAE,QAAQ,CAAC,GAAG,SAAS,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,GAAG,MAAM,CAAA;QAC5D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5F,CAAC;AAED;;;;;;GAMG;AACH,SAAS,IAAI,CAAC,MAAsB,EAAE,MAAc,EAAE,KAA6B;IACjF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;QAC5D,KAAK,CAAC,IAAI,CAAC,CAAA;QACX,IAAI,KAAK,CAAC,EAAE;YAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IAC3C,CAAC;AACH,CAAC"}

package/dist/generate/selectOptions.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Resolves the allowed values of a `select` field from the design system's own
+ * types.
+ *
+ * The manifest does not carry them. `ContentField` has no `options`, and the
+ * allowed values live in prose — `constraints: "'primary', 'secondary' or
+ * 'on-dark'."` — which is documentation, not data. `content.variants` looks
+ * like a substitute and is not: for most components it holds prose labels
+ * ("Body only", "Body with rail") or runtime states ("paused", "playing"), so
+ * mapping variants to options produces garbage more often than not.
+ *
+ * The component's own prop type is the one place the values exist as data, and
+ * it is the definition the component actually behaves according to. Reading it
+ * makes drift impossible in the direction that matters: rename a member of
+ * `CardVariant` and the generated block changes with it, which shows up as a
+ * diff in review rather than as an option that silently stopped working.
+ *
+ * The compiler API rather than a regex because the values are reached three
+ * different ways — a named alias (`type CardVariant = 'default' | 'panel'`), an
+ * inline union on the prop, and through an array element for a nested field
+ * like `Credentials.credentials.icon`. The checker resolves all three; a regex
+ * resolves the first.
+ */
+export declare class SelectOptionResolver {
+    private readonly checker;
+    private readonly source;
+    /**
+     * @param typesEntry Path to the design system's declaration entry — the file
+     *   that re-exports every component's props, e.g.
+     *   `design-system/dist/src/lib/index.d.ts`.
+     */
+    constructor(typesEntry: string);
+    /**
+     * `('Card', 'variant')` → `['default', 'panel']`.
+     * `('Credentials', 'credentials.icon')` → the icon keys.
+     *
+     * Null when the path does not resolve or the leaf is not a union of string
+     * literals — the caller decides whether that is an error or a cue to look in
+     * the overrides.
+     */
+    resolve(component: string, path: string): readonly string[] | null;
+    /**
+     * A named exported type's literal union — `resolveNamed('IconName')` gives
+     * every glyph in the global set.
+     *
+     * For fields whose prop type cannot carry the values: `ReportGrid.ctaIcon` is
+     * a `ReactNode` because the component takes a rendered glyph, while the
+     * contract, correctly, says an author picks a *name*.
+     */
+    resolveNamed(typeName: string): readonly string[] | null;
+    private propsType;
+    private exportedType;
+    private propertyType;
+    /**
+     * `Item[]` → `Item`, so a nested path can keep walking into an array's rows.
+     *
+     * Matched on the array symbol rather than on a numeric index signature. A
+     * union of string literals *has* a numeric index type — `string`, from
+     * character access — so indexing it collapses `'default' | 'panel'` to
+     * `string` and every select silently resolves to nothing.
+     */
+    private unwrapArray;
+}
+//# sourceMappingURL=selectOptions.d.ts.map

package/dist/generate/selectOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectOptions.d.ts","sourceRoot":"","sources":["../../src/generate/selectOptions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAElD;;;;OAIG;gBACS,UAAU,EAAE,MAAM;IAY9B;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI;IAalE;;;;;;;OAOG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI;IAKxD,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,YAAY;IAUpB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAKpB"}

package/dist/generate/selectOptions.js

@@ -0,0 +1,145 @@
+import ts from 'typescript';
+/**
+ * Resolves the allowed values of a `select` field from the design system's own
+ * types.
+ *
+ * The manifest does not carry them. `ContentField` has no `options`, and the
+ * allowed values live in prose — `constraints: "'primary', 'secondary' or
+ * 'on-dark'."` — which is documentation, not data. `content.variants` looks
+ * like a substitute and is not: for most components it holds prose labels
+ * ("Body only", "Body with rail") or runtime states ("paused", "playing"), so
+ * mapping variants to options produces garbage more often than not.
+ *
+ * The component's own prop type is the one place the values exist as data, and
+ * it is the definition the component actually behaves according to. Reading it
+ * makes drift impossible in the direction that matters: rename a member of
+ * `CardVariant` and the generated block changes with it, which shows up as a
+ * diff in review rather than as an option that silently stopped working.
+ *
+ * The compiler API rather than a regex because the values are reached three
+ * different ways — a named alias (`type CardVariant = 'default' | 'panel'`), an
+ * inline union on the prop, and through an array element for a nested field
+ * like `Credentials.credentials.icon`. The checker resolves all three; a regex
+ * resolves the first.
+ */
+export class SelectOptionResolver {
+    checker;
+    source;
+    /**
+     * @param typesEntry Path to the design system's declaration entry — the file
+     *   that re-exports every component's props, e.g.
+     *   `design-system/dist/src/lib/index.d.ts`.
+     */
+    constructor(typesEntry) {
+        const program = ts.createProgram([typesEntry], {
+            target: ts.ScriptTarget.ES2022,
+            module: ts.ModuleKind.ESNext,
+            moduleResolution: ts.ModuleResolutionKind.Bundler,
+            skipLibCheck: true,
+            noEmit: true,
+        });
+        this.checker = program.getTypeChecker();
+        this.source = program.getSourceFile(typesEntry);
+    }
+    /**
+     * `('Card', 'variant')` → `['default', 'panel']`.
+     * `('Credentials', 'credentials.icon')` → the icon keys.
+     *
+     * Null when the path does not resolve or the leaf is not a union of string
+     * literals — the caller decides whether that is an error or a cue to look in
+     * the overrides.
+     */
+    resolve(component, path) {
+        const propsType = this.propsType(component);
+        if (!propsType)
+            return null;
+        let current = propsType;
+        for (const segment of path.split('.')) {
+            current = this.propertyType(current, segment);
+            if (!current)
+                return null;
+            current = this.unwrapArray(current);
+        }
+        return literalUnion(current);
+    }
+    /**
+     * A named exported type's literal union — `resolveNamed('IconName')` gives
+     * every glyph in the global set.
+     *
+     * For fields whose prop type cannot carry the values: `ReportGrid.ctaIcon` is
+     * a `ReactNode` because the component takes a rendered glyph, while the
+     * contract, correctly, says an author picks a *name*.
+     */
+    resolveNamed(typeName) {
+        const type = this.exportedType(typeName);
+        return type ? literalUnion(type) : null;
+    }
+    propsType(component) {
+        return this.exportedType(`${component}Props`);
+    }
+    exportedType(name) {
+        if (!this.source)
+            return null;
+        const moduleSymbol = this.checker.getSymbolAtLocation(this.source);
+        if (!moduleSymbol)
+            return null;
+        const exported = this.checker
+            .getExportsOfModule(moduleSymbol)
+            .find(symbol => symbol.getName() === name);
+        if (!exported)
+            return null;
+        // Re-exports arrive as alias symbols; the local declaration is behind one
+        // hop. A directly-declared export has no alias to follow.
+        const symbol = exported.flags & ts.SymbolFlags.Alias ? this.checker.getAliasedSymbol(exported) : exported;
+        const declaration = symbol.declarations?.[0];
+        return declaration ? this.checker.getDeclaredTypeOfSymbol(symbol) : null;
+    }
+    propertyType(type, name) {
+        const symbol = type.getProperty(name);
+        if (!symbol)
+            return null;
+        const declaration = symbol.declarations?.[0];
+        if (!declaration)
+            return null;
+        // The declared type, not the type at the use site, so an optional prop
+        // resolves to its union rather than to `T | undefined` collapsed.
+        return this.checker.getTypeOfSymbolAtLocation(symbol, declaration);
+    }
+    /**
+     * `Item[]` → `Item`, so a nested path can keep walking into an array's rows.
+     *
+     * Matched on the array symbol rather than on a numeric index signature. A
+     * union of string literals *has* a numeric index type — `string`, from
+     * character access — so indexing it collapses `'default' | 'panel'` to
+     * `string` and every select silently resolves to nothing.
+     */
+    unwrapArray(type) {
+        const name = type.getSymbol()?.getName();
+        if (name !== 'Array' && name !== 'ReadonlyArray')
+            return type;
+        return this.checker.getTypeArguments(type)[0] ?? type;
+    }
+}
+/**
+ * The string literals in a union, or null if it is anything else.
+ *
+ * `undefined` and `null` members are dropped — a prop being optional says
+ * nothing about which values are allowed. A union with a non-literal member
+ * (`string`, a component type) returns null rather than a partial list, because
+ * a partial list would silently forbid values the component accepts.
+ */
+function literalUnion(type) {
+    const members = type.isUnion() ? type.types : [type];
+    const values = [];
+    for (const member of members) {
+        if (member.flags & (ts.TypeFlags.Undefined | ts.TypeFlags.Null))
+            continue;
+        if (member.isStringLiteral()) {
+            values.push(member.value);
+            continue;
+        }
+        return null;
+    }
+    return values.length > 0 ? values : null;
+}
+//# sourceMappingURL=selectOptions.js.map

package/dist/generate/selectOptions.js.map

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

package/dist/overrides.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The hand-authored half of the bridge.
+ *
+ * A design-system contract describes a *content model* — what an author writes.
+ * A React component has a *prop model* — what it renders from. They are the
+ * same thing 99 times out of 100, which is what makes generation worth doing,
+ * and the exceptions are few enough to enumerate. This is where they are
+ * enumerated, once, for both the generator and the renderer: a field renamed
+ * here is renamed in the Payload schema *and* in what gets passed to the
+ * component, so the two can never disagree.
+ */
+/** Where a contract's field type is not the whole story. */
+export interface FieldOverride {
+    /**
+     * Leave the field out of the CMS entirely.
+     *
+     * For fields that model runtime state rather than authored content — a
+     * form's `status`, say, which is the host's business and changes several
+     * times a minute. An author cannot usefully set it and a stored value would
+     * be wrong the moment it was read.
+     */
+    omit?: true;
+    /**
+     * The prop name to pass this field as, when it differs from the field name.
+     * `ArticleBody` is the only case today: its contract calls the body `body`
+     * and the component takes it as `children`.
+     */
+    propName?: string;
+    /**
+     * Force a treatment the contract's `type` cannot express.
+     *
+     * `videoUpload` is for a video the site hosts itself rather than embeds. The
+     * contract's `video` type means a provider URL — it is `VideoEmbed`'s
+     * YouTube/Vimeo/Wistia iframe src — and the field type enum in
+     * `@forumone/throughline-design-system/contract` has no eleventh value for "a file
+     * in the media library". So the contract says `video`, and this says which
+     * of the two kinds of video it meant: an upload field, resolved to the
+     * stored file's URL with no `srcSet` beside it, because a video has no
+     * candidate widths to choose between.
+     */
+    as?: 'icon' | 'url' | 'videoUpload';
+    /**
+     * Explicit `select` options. The manifest carries none — allowed values live
+     * in prose `constraints` — so they come from the component's own literal
+     * union type where one exists, and from here where it does not.
+     */
+    options?: readonly string[];
+}
+export interface ComponentOverride {
+    /**
+     * Keep the component out of the block palette.
+     *
+     * For components that are real parts of a page but not authorable as blocks:
+     * site chrome a template renders (`Header`, `Footer`, `Skiplink`), and
+     * anything whose props are supplied by the document rather than by a block
+     * author.
+     */
+    notABlock?: true;
+    /**
+     * The block's name in the picker, when splitting the component name reads
+     * wrong: `AtAGlance` humanizes to "At AGlance". The slug is unchanged — it
+     * is the manifest name, byte for byte, whatever the label says.
+     */
+    label?: string;
+    /** Keyed by field path — `heading`, `items.title`, `image.src`. */
+    fields?: Record<string, FieldOverride>;
+}
+export type Overrides = Record<string, ComponentOverride>;
+/** Look an override up by component and dotted field path. */
+export declare function fieldOverride(overrides: Overrides, component: string, path: string): FieldOverride | undefined;
+//# sourceMappingURL=overrides.d.ts.map

package/dist/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../src/overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,IAAI,CAAA;IACX;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;;;;OAWG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,aAAa,CAAA;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACvC;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAEzD,8DAA8D;AAC9D,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,aAAa,GAAG,SAAS,CAE3B"}