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

package/dist/altText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"altText.js","sourceRoot":"","sources":["../src/altText.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;EAcE;AAEF,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,OAAO,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,KAAK,CAAA;AAC1D,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,QAAiC;IAC/D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IACxD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,SAAQ;QACpC,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,yDAAyD,CAAA;AAE1F;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiC;IAC/D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;IACxD,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAC1B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QAClB,CAAC,CAAC;YACE,GAAG,KAAK;YACR,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC5B,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,IAAI,iBAAiB,EAAE;gBAC7C,CAAC,CAAC,iBAAiB;SACtB;QACH,CAAC,CAAC,KAAK,CACV,CAAA;AACH,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Client entry point for the admin components the generated blocks reference,
+ * as `@forumone/throughline-design-system/client#RowSummary` in
+ * Payload's import map.
+ *
+ * Kept apart from the package root and `./generate`, which run inside
+ * `payload.config.ts`, so the config never pulls in `@payloadcms/ui`.
+ */
+export { BlockGuidance } from './admin/BlockGuidance.js';
+export type { BlockGuidanceProps } from './admin/BlockGuidance.js';
+export { BlockSummary } from './admin/BlockSummary.js';
+export type { BlockSummaryProps } from './admin/BlockSummary.js';
+export { RowSummary } from './admin/RowSummary.js';
+export type { RowSummaryProps } from './admin/RowSummary.js';
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/client.js

@@ -0,0 +1,12 @@
+/**
+ * Client entry point for the admin components the generated blocks reference,
+ * as `@forumone/throughline-design-system/client#RowSummary` in
+ * Payload's import map.
+ *
+ * Kept apart from the package root and `./generate`, which run inside
+ * `payload.config.ts`, so the config never pulls in `@payloadcms/ui`.
+ */
+export { BlockGuidance } from './admin/BlockGuidance.js';
+export { BlockSummary } from './admin/BlockSummary.js';
+export { RowSummary } from './admin/RowSummary.js';
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/contract/index.d.ts

@@ -0,0 +1,5 @@
+export * from './schema.js';
+export * from './manifest.js';
+export * from './loader.js';
+export type { LintIssue, LintOptions } from './lint.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/contract/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA"}

package/dist/contract/index.js

@@ -0,0 +1,4 @@
+export * from './schema.js';
+export * from './manifest.js';
+export * from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/contract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}

package/dist/contract/lint.d.ts

@@ -0,0 +1,38 @@
+import type { Manifest } from './manifest.js';
+export interface LintIssue {
+    severity: 'error' | 'warning';
+    component: string;
+    rule: string;
+    message: string;
+}
+export interface LintOptions {
+    /**
+     * Source of truth for Storybook story IDs. If provided, lint verifies
+     * every example's `storyId` exists in this set. Omit to skip the check
+     * (e.g. in environments that do not have Storybook output available).
+     */
+    availableStoryIds?: Set<string>;
+    /**
+     * Source of truth for token names. If provided, lint verifies every
+     * token referenced by a component's `tokens.consumes` exists in this set.
+     * Defaults to the manifest's own token table when omitted.
+     */
+    availableTokens?: Set<string>;
+}
+/**
+ * Lints a manifest against the contract's internal consistency rules.
+ * Returns an array of issues; an empty array means the manifest is clean.
+ *
+ * Errors describe unambiguous contract violations (unknown component
+ * references, unknown tokens). Warnings surface weaker signals that may
+ * still be worth addressing.
+ */
+export declare function lintManifest(manifest: Manifest, options?: LintOptions): LintIssue[];
+/** Formats lint issues as a multi-line string suitable for CI output. */
+export declare function formatLintIssues(issues: LintIssue[]): string;
+/**
+ * Throws when the manifest has any lint errors. Warnings do not throw.
+ * Use in CI to fail the build on contract violations.
+ */
+export declare function assertManifestClean(manifest: Manifest, options?: LintOptions): void;
+//# sourceMappingURL=lint.d.ts.map

package/dist/contract/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/contract/lint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,GAAG,SAAS,EAAE,CAyEvF;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAwB5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAMnF"}

package/dist/contract/lint.js

@@ -0,0 +1,110 @@
+/**
+ * Lints a manifest against the contract's internal consistency rules.
+ * Returns an array of issues; an empty array means the manifest is clean.
+ *
+ * Errors describe unambiguous contract violations (unknown component
+ * references, unknown tokens). Warnings surface weaker signals that may
+ * still be worth addressing.
+ */
+export function lintManifest(manifest, options = {}) {
+    const issues = [];
+    const componentNames = new Set(Object.keys(manifest.components));
+    const tokenNames = options.availableTokens ?? new Set(manifest.tokens.map((t) => t.name));
+    const storyIds = options.availableStoryIds;
+    for (const [name, component] of Object.entries(manifest.components)) {
+        for (const sibling of component.composition.requiredSiblings) {
+            if (!componentNames.has(sibling)) {
+                issues.push({
+                    severity: 'error',
+                    component: name,
+                    rule: 'composition.requiredSiblings',
+                    message: `References unknown component "${sibling}"`,
+                });
+            }
+        }
+        for (const adjacent of component.composition.forbiddenAdjacent) {
+            if (!componentNames.has(adjacent)) {
+                issues.push({
+                    severity: 'error',
+                    component: name,
+                    rule: 'composition.forbiddenAdjacent',
+                    message: `References unknown component "${adjacent}"`,
+                });
+            }
+        }
+        for (const token of component.tokens.consumes) {
+            if (!tokenNames.has(token)) {
+                issues.push({
+                    severity: 'error',
+                    component: name,
+                    rule: 'tokens.consumes',
+                    message: `References unknown token "${token}"`,
+                });
+            }
+        }
+        if (storyIds) {
+            for (const example of component.examples) {
+                if (!storyIds.has(example.storyId)) {
+                    issues.push({
+                        severity: 'error',
+                        component: name,
+                        rule: 'examples.storyId',
+                        message: `Example "${example.label}" references unknown story "${example.storyId}"`,
+                    });
+                }
+            }
+        }
+        if (component.antiExamples.length === 0) {
+            issues.push({
+                severity: 'warning',
+                component: name,
+                rule: 'antiExamples.empty',
+                message: 'Component has no anti-examples; consider adding at least one',
+            });
+        }
+        if (component.intent.length < 50) {
+            issues.push({
+                severity: 'warning',
+                component: name,
+                rule: 'intent.brevity',
+                message: 'Intent statement is quite short; consider a more specific description',
+            });
+        }
+    }
+    return issues;
+}
+/** Formats lint issues as a multi-line string suitable for CI output. */
+export function formatLintIssues(issues) {
+    if (issues.length === 0)
+        return 'No issues found.';
+    const errors = issues.filter((i) => i.severity === 'error');
+    const warnings = issues.filter((i) => i.severity === 'warning');
+    const lines = [];
+    if (errors.length > 0) {
+        lines.push(`Errors (${errors.length}):`);
+        for (const issue of errors) {
+            lines.push(`  [${issue.component}] ${issue.rule}: ${issue.message}`);
+        }
+    }
+    if (warnings.length > 0) {
+        if (lines.length > 0)
+            lines.push('');
+        lines.push(`Warnings (${warnings.length}):`);
+        for (const issue of warnings) {
+            lines.push(`  [${issue.component}] ${issue.rule}: ${issue.message}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Throws when the manifest has any lint errors. Warnings do not throw.
+ * Use in CI to fail the build on contract violations.
+ */
+export function assertManifestClean(manifest, options) {
+    const issues = lintManifest(manifest, options);
+    const errors = issues.filter((i) => i.severity === 'error');
+    if (errors.length > 0) {
+        throw new Error(`Manifest has errors:\n${formatLintIssues(errors)}`);
+    }
+}
+//# sourceMappingURL=lint.js.map

package/dist/contract/lint.js.map

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

package/dist/contract/loader.d.ts

@@ -0,0 +1,49 @@
+import { type Manifest } from './manifest.js';
+import type { ComponentContract, ComponentCategory, ComponentGroup } from './schema.js';
+/**
+ * A validated, queryable manifest. Returned by {@link loadManifest} and
+ * {@link loadManifestFromUrl}. Consumers use the helper methods rather than
+ * poking at {@link raw} directly, which lets the implementation evolve.
+ */
+export declare class LoadedManifest {
+    readonly raw: Manifest;
+    constructor(raw: Manifest);
+    /** The design system's metadata. */
+    get designSystem(): Manifest['designSystem'];
+    /** The contract version this manifest satisfies. */
+    get contractVersion(): Manifest['contractVersion'];
+    /** Full contract for a component by name, or `undefined` if absent. */
+    getComponent(name: string): ComponentContract | undefined;
+    /** Like {@link getComponent} but throws when the component is missing. */
+    requireComponent(name: string): ComponentContract;
+    /** Every component name in declaration order. */
+    listComponents(): string[];
+    /** Every component whose category matches. */
+    listByCategory(category: ComponentCategory | string): ComponentContract[];
+    /** Every distinct category present, sorted alphabetically. */
+    listCategories(): string[];
+    /**
+     * Every component filed under a shelf. Matches on the resolved group, so a
+     * component with no `group` is found by its category.
+     */
+    listByGroup(group: ComponentGroup | string): ComponentContract[];
+    /** Every distinct resolved group present, sorted alphabetically. */
+    listGroups(): string[];
+    /** Token definition by name, or `undefined` if absent. */
+    getToken(name: string): {
+        name: string;
+        value: string;
+        category: string;
+    } | undefined;
+}
+/**
+ * Loads a manifest from a plain object. Validates against {@link ManifestSchema}
+ * and throws on any validation error with a readable, line-by-line message.
+ */
+export declare function loadManifest(input: unknown): LoadedManifest;
+/**
+ * Fetches a manifest from a URL and loads it. Useful when a design system
+ * serves its manifest via HTTP rather than bundling into the consumer.
+ */
+export declare function loadManifestFromUrl(url: string, init?: RequestInit): Promise<LoadedManifest>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/contract/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/contract/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,eAAe,CAAA;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEvF;;;;GAIG;AACH,qBAAa,cAAc;aACG,GAAG,EAAE,QAAQ;gBAAb,GAAG,EAAE,QAAQ;IAEzC,oCAAoC;IACpC,IAAI,YAAY,IAAI,QAAQ,CAAC,cAAc,CAAC,CAE3C;IAED,oDAAoD;IACpD,IAAI,eAAe,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAEjD;IAED,uEAAuE;IACvE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIzD,0EAA0E;IAC1E,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAQjD,iDAAiD;IACjD,cAAc,IAAI,MAAM,EAAE;IAI1B,8CAA8C;IAC9C,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,GAAG,iBAAiB,EAAE;IAIzE,8DAA8D;IAC9D,cAAc,IAAI,MAAM,EAAE;IAQ1B;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,iBAAiB,EAAE;IAIhE,oEAAoE;IACpE,UAAU,IAAI,MAAM,EAAE;IAQtB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM;;;;;CAGtB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAS3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,cAAc,CAAC,CAOzB"}

package/dist/contract/loader.js

@@ -0,0 +1,95 @@
+import { ManifestSchema } from './manifest.js';
+import { groupOf } from './schema.js';
+/**
+ * A validated, queryable manifest. Returned by {@link loadManifest} and
+ * {@link loadManifestFromUrl}. Consumers use the helper methods rather than
+ * poking at {@link raw} directly, which lets the implementation evolve.
+ */
+export class LoadedManifest {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    /** The design system's metadata. */
+    get designSystem() {
+        return this.raw.designSystem;
+    }
+    /** The contract version this manifest satisfies. */
+    get contractVersion() {
+        return this.raw.contractVersion;
+    }
+    /** Full contract for a component by name, or `undefined` if absent. */
+    getComponent(name) {
+        return this.raw.components[name];
+    }
+    /** Like {@link getComponent} but throws when the component is missing. */
+    requireComponent(name) {
+        const component = this.getComponent(name);
+        if (!component) {
+            throw new Error(`Component "${name}" not found in manifest`);
+        }
+        return component;
+    }
+    /** Every component name in declaration order. */
+    listComponents() {
+        return Object.keys(this.raw.components);
+    }
+    /** Every component whose category matches. */
+    listByCategory(category) {
+        return Object.values(this.raw.components).filter((c) => c.category === category);
+    }
+    /** Every distinct category present, sorted alphabetically. */
+    listCategories() {
+        const categories = new Set();
+        for (const component of Object.values(this.raw.components)) {
+            categories.add(component.category);
+        }
+        return Array.from(categories).sort();
+    }
+    /**
+     * Every component filed under a shelf. Matches on the resolved group, so a
+     * component with no `group` is found by its category.
+     */
+    listByGroup(group) {
+        return Object.values(this.raw.components).filter((c) => groupOf(c) === group);
+    }
+    /** Every distinct resolved group present, sorted alphabetically. */
+    listGroups() {
+        const groups = new Set();
+        for (const component of Object.values(this.raw.components)) {
+            groups.add(groupOf(component));
+        }
+        return Array.from(groups).sort();
+    }
+    /** Token definition by name, or `undefined` if absent. */
+    getToken(name) {
+        return this.raw.tokens.find((t) => t.name === name);
+    }
+}
+/**
+ * Loads a manifest from a plain object. Validates against {@link ManifestSchema}
+ * and throws on any validation error with a readable, line-by-line message.
+ */
+export function loadManifest(input) {
+    const result = ManifestSchema.safeParse(input);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join('.') || '(root)'}: ${i.message}`)
+            .join('\n');
+        throw new Error(`Invalid manifest:\n${issues}`);
+    }
+    return new LoadedManifest(result.data);
+}
+/**
+ * Fetches a manifest from a URL and loads it. Useful when a design system
+ * serves its manifest via HTTP rather than bundling into the consumer.
+ */
+export async function loadManifestFromUrl(url, init) {
+    const response = await fetch(url, init);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch manifest from ${url}: HTTP ${response.status}`);
+    }
+    const json = (await response.json());
+    return loadManifest(json);
+}
+//# sourceMappingURL=loader.js.map

package/dist/contract/loader.js.map

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