@elytracms/core 0.0.6

package/dist/data-binding/sources.js

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { idSchema, jsonValueSchema } from '@elytracms/core/project-graph';
+import { inferredSchemaSchema } from './tokens';
+/**
+ * Data sources (EC-022). One uniform shape across the three kinds the product supports
+ * (brief §4.6, §7.5):
+ *
+ * - `rest`   an HTTP fetch source (external API)
+ * - `cms`    an internal CMS collection query (resolved by `@elytracms/core/cms-core`)
+ * - `convex` a Convex query or mutation, behind the project-owned repository adapter
+ *
+ * Every source shares the same envelope: a stable `id` (the binding `sourceId` addresses it),
+ * a human label, the kind-specific `config`, and an optional captured `sample` + inferred
+ * `schema` (EC-023). The kind-specific config differs, but resolution, sampling, inference and
+ * tokenization treat all three identically.
+ */
+/** HTTP methods permitted for a REST fetch source. */
+export const httpMethodSchema = z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']);
+/** Per-source fetch configuration for a REST source. */
+export const restConfigSchema = z.object({
+    url: z.string().min(1),
+    method: httpMethodSchema.default('GET'),
+    headers: z.record(z.string(), z.string()).default({}),
+    /** Static query parameters appended to the request. */
+    query: z.record(z.string(), z.string()).default({}),
+    /** Optional JSON request body (for POST/PUT/PATCH). */
+    body: jsonValueSchema.optional(),
+});
+export const restSourceSchema = z.object({
+    kind: z.literal('rest'),
+    id: idSchema,
+    label: z.string().min(1),
+    config: restConfigSchema,
+});
+/**
+ * Single-field sort of a CMS list query (EC-166 repeating sections). Matches
+ * the canonical AD-3 sort shape (`@elytracms/core/content`'s `SortInput` with the
+ * direction explicit); ties always break by document id ascending downstream.
+ */
+export const cmsSortSchema = z.object({
+    field: z.string().min(1),
+    direction: z.enum(['asc', 'desc']),
+});
+/** Per-source query configuration for an internal CMS collection query. */
+export const cmsConfigSchema = z.object({
+    /** Id of the CMS collection to query. */
+    collectionId: idSchema,
+    /** When set, fetch a single document by id; otherwise the query returns a list. */
+    documentId: idSchema.optional(),
+    /** Optional locale for localized content. */
+    locale: z.string().optional(),
+    /** Optional equality filters keyed by field name. */
+    filter: z.record(z.string(), jsonValueSchema).default({}),
+    /** Optional single-field sort (EC-166); absent = id order. */
+    sort: cmsSortSchema.optional(),
+    limit: z.number().int().positive().optional(),
+});
+export const cmsSourceSchema = z.object({
+    kind: z.literal('cms'),
+    id: idSchema,
+    label: z.string().min(1),
+    config: cmsConfigSchema,
+});
+/** Whether a Convex source reads (query) or writes (mutation). */
+export const convexOperationSchema = z.enum(['query', 'mutation']);
+/** Per-source query/mutation configuration for a Convex function reference. */
+export const convexConfigSchema = z.object({
+    operation: convexOperationSchema.default('query'),
+    /** Convex function reference, e.g. `posts:list` or `posts.list`. */
+    functionRef: z.string().min(1),
+    /** Arguments passed to the Convex function. */
+    args: z.record(z.string(), jsonValueSchema).default({}),
+});
+export const convexSourceSchema = z.object({
+    kind: z.literal('convex'),
+    id: idSchema,
+    label: z.string().min(1),
+    config: convexConfigSchema,
+});
+/**
+ * The captured sample (EC-023) and inferred schema are attached uniformly to any source kind.
+ * Kept separate from the kind-specific union so the discriminated union stays clean and the
+ * sample fields can be merged on after parse.
+ */
+export const sampleEnvelopeSchema = z.object({
+    /** A representative captured payload, used for inference and the binding picker preview. */
+    sample: jsonValueSchema.optional(),
+    /** Structural schema inferred from {@link sample} (EC-023). */
+    schema: inferredSchemaSchema.optional(),
+});
+/** The uniform source shape: kind-specific envelope plus the shared sample/schema fields. */
+export const dataSourceSchema = z.intersection(z.discriminatedUnion('kind', [restSourceSchema, cmsSourceSchema, convexSourceSchema]), sampleEnvelopeSchema);
+/** Parse an unknown value into a {@link DataSource}, applying per-config defaults. Never throws. */
+export function parseDataSource(input) {
+    return dataSourceSchema.safeParse(input);
+}
+/**
+ * A registry of data sources addressable by stable id (EC-022). Construction de-duplicates by
+ * id (last write wins) and validates each entry; lookups are O(1). The registry is immutable —
+ * `with`/`without` return new registries — so it can be stored in the graph/editor state safely.
+ */
+export class SourceRegistry {
+    byId;
+    constructor(byId) {
+        this.byId = byId;
+    }
+    /** Build a registry from a list of sources. Each is validated via {@link dataSourceSchema}. */
+    static from(sources) {
+        const map = new Map();
+        for (const raw of sources) {
+            const source = dataSourceSchema.parse(raw);
+            map.set(source.id, source);
+        }
+        return new SourceRegistry(map);
+    }
+    /** An empty registry. */
+    static empty() {
+        return new SourceRegistry(new Map());
+    }
+    has(id) {
+        return this.byId.has(id);
+    }
+    get(id) {
+        return this.byId.get(id);
+    }
+    list() {
+        return [...this.byId.values()];
+    }
+    ids() {
+        return [...this.byId.keys()];
+    }
+    /** The set of known ids, suitable for `validateProjectGraph`'s `knownSourceIds` option. */
+    knownSourceIds() {
+        return new Set(this.byId.keys());
+    }
+    /** Return a new registry with `source` added or replacing any existing entry with the same id. */
+    with(source) {
+        const next = new Map(this.byId);
+        next.set(dataSourceSchema.parse(source).id, source);
+        return new SourceRegistry(next);
+    }
+    /** Return a new registry without the source `id` (no-op if absent). */
+    without(id) {
+        if (!this.byId.has(id))
+            return this;
+        const next = new Map(this.byId);
+        next.delete(id);
+        return new SourceRegistry(next);
+    }
+    get size() {
+        return this.byId.size;
+    }
+}
+//# sourceMappingURL=sources.js.map

package/dist/data-binding/sources.js.map

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

package/dist/data-binding/tokens.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import type { JsonValue } from '@elytracms/core/project-graph';
+/**
+ * Build a JSON Pointer token from a sequence of object keys / array indices.
+ * `tokenFromPath([])` is the root pointer `"/"`; `tokenFromPath(['items', 0, 'title'])` is
+ * `"/items/0/title"`.
+ */
+export declare function tokenFromPath(path: ReadonlyArray<string | number>): string;
+/**
+ * Parse a JSON Pointer token into its reference segments. The root pointer (`""` or `"/"`)
+ * yields an empty array. Returns `undefined` for syntactically invalid tokens (a non-empty
+ * pointer that does not begin with `/`).
+ */
+export declare function pathFromToken(token: string): string[] | undefined;
+/** Outcome of resolving a token against a payload. `found` distinguishes a real `null`/`undefined` from a miss. */
+export type TokenResolution = {
+    found: true;
+    value: JsonValue;
+} | {
+    found: false;
+};
+/**
+ * Resolve a JSON Pointer token to a value within a payload. Numeric segments index arrays;
+ * string segments index objects. A miss (unknown key, out-of-range index, or traversal
+ * through a primitive) yields `{ found: false }` rather than throwing.
+ */
+export declare function resolveToken(payload: JsonValue, token: string): TokenResolution;
+/**
+ * An inferred schema/shape for a sample payload (EC-023). This is a lightweight structural
+ * description — not a Zod schema — used to drive the binding picker and to enumerate the
+ * stable tokens a source exposes.
+ */
+export type InferredSchema = {
+    kind: 'string';
+} | {
+    kind: 'number';
+} | {
+    kind: 'boolean';
+} | {
+    kind: 'null';
+} | {
+    kind: 'array';
+    element: InferredSchema;
+} | {
+    kind: 'object';
+    properties: Record<string, InferredSchema>;
+} | {
+    kind: 'unknown';
+};
+export declare const inferredSchemaSchema: z.ZodType<InferredSchema>;
+/**
+ * Infer a structural schema from a sample payload (EC-023). Arrays infer their element shape
+ * by merging across elements so heterogeneous samples still produce a usable union-ish shape;
+ * an empty array yields an `unknown` element.
+ */
+export declare function inferSchema(sample: JsonValue): InferredSchema;
+/**
+ * Enumerate the stable leaf+branch tokens exposed by an inferred schema. Object properties
+ * recurse; arrays expose a representative `0` index so a single concrete item is addressable
+ * (e.g. for previewing a repeater item shape). The root token (`"/"`) is included.
+ */
+export declare function tokensForSchema(schema: InferredSchema): string[];

package/dist/data-binding/tokens.js

@@ -0,0 +1,150 @@
+import { z } from 'zod';
+/**
+ * Path tokens (EC-023). A token is a JSON Pointer (RFC 6901), e.g. `/items/0/title`. We use
+ * structural pointers — not UI labels — so a binding survives renaming a field's display
+ * label: only the data shape matters. The root document is the empty pointer `""` or `"/"`.
+ *
+ * Per RFC 6901, a reference token escapes `~` as `~0` and `/` as `~1` so keys containing
+ * those characters remain addressable.
+ */
+const escapeRefToken = (key) => key.replace(/~/g, '~0').replace(/\//g, '~1');
+const unescapeRefToken = (token) => token.replace(/~1/g, '/').replace(/~0/g, '~');
+/**
+ * Build a JSON Pointer token from a sequence of object keys / array indices.
+ * `tokenFromPath([])` is the root pointer `"/"`; `tokenFromPath(['items', 0, 'title'])` is
+ * `"/items/0/title"`.
+ */
+export function tokenFromPath(path) {
+    if (path.length === 0)
+        return '/';
+    return '/' + path.map((seg) => escapeRefToken(String(seg))).join('/');
+}
+/**
+ * Parse a JSON Pointer token into its reference segments. The root pointer (`""` or `"/"`)
+ * yields an empty array. Returns `undefined` for syntactically invalid tokens (a non-empty
+ * pointer that does not begin with `/`).
+ */
+export function pathFromToken(token) {
+    if (token === '' || token === '/')
+        return [];
+    if (!token.startsWith('/'))
+        return undefined;
+    return token
+        .slice(1)
+        .split('/')
+        .map(unescapeRefToken);
+}
+const isPlainObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/**
+ * Resolve a JSON Pointer token to a value within a payload. Numeric segments index arrays;
+ * string segments index objects. A miss (unknown key, out-of-range index, or traversal
+ * through a primitive) yields `{ found: false }` rather than throwing.
+ */
+export function resolveToken(payload, token) {
+    const path = pathFromToken(token);
+    if (path === undefined)
+        return { found: false };
+    let current = payload;
+    for (const segment of path) {
+        if (Array.isArray(current)) {
+            // Array index must be a non-negative integer string with no leading zeros (RFC 6901).
+            if (!/^(0|[1-9][0-9]*)$/.test(segment))
+                return { found: false };
+            const index = Number(segment);
+            if (index >= current.length)
+                return { found: false };
+            current = current[index];
+            continue;
+        }
+        if (isPlainObject(current)) {
+            if (!Object.prototype.hasOwnProperty.call(current, segment))
+                return { found: false };
+            current = current[segment];
+            continue;
+        }
+        // Cannot descend into a primitive / null.
+        return { found: false };
+    }
+    return { found: true, value: current };
+}
+export const inferredSchemaSchema = z.lazy(() => z.union([
+    z.object({ kind: z.literal('string') }),
+    z.object({ kind: z.literal('number') }),
+    z.object({ kind: z.literal('boolean') }),
+    z.object({ kind: z.literal('null') }),
+    z.object({ kind: z.literal('array'), element: inferredSchemaSchema }),
+    z.object({ kind: z.literal('object'), properties: z.record(z.string(), inferredSchemaSchema) }),
+    z.object({ kind: z.literal('unknown') }),
+]));
+const mergeSchemas = (a, b) => {
+    if (a.kind === 'unknown')
+        return b;
+    if (b.kind === 'unknown')
+        return a;
+    if (a.kind === 'array' && b.kind === 'array') {
+        return { kind: 'array', element: mergeSchemas(a.element, b.element) };
+    }
+    if (a.kind === 'object' && b.kind === 'object') {
+        const properties = { ...a.properties };
+        for (const [key, schema] of Object.entries(b.properties)) {
+            const existing = properties[key];
+            properties[key] = existing ? mergeSchemas(existing, schema) : schema;
+        }
+        return { kind: 'object', properties };
+    }
+    // Mixed primitive/array/object element types collapse to `unknown` so callers fall back gracefully.
+    return a.kind === b.kind ? a : { kind: 'unknown' };
+};
+/**
+ * Infer a structural schema from a sample payload (EC-023). Arrays infer their element shape
+ * by merging across elements so heterogeneous samples still produce a usable union-ish shape;
+ * an empty array yields an `unknown` element.
+ */
+export function inferSchema(sample) {
+    if (sample === null)
+        return { kind: 'null' };
+    switch (typeof sample) {
+        case 'string':
+            return { kind: 'string' };
+        case 'number':
+            return { kind: 'number' };
+        case 'boolean':
+            return { kind: 'boolean' };
+        default:
+            break;
+    }
+    if (Array.isArray(sample)) {
+        const element = sample.reduce((acc, item) => mergeSchemas(acc, inferSchema(item)), { kind: 'unknown' });
+        return { kind: 'array', element };
+    }
+    if (isPlainObject(sample)) {
+        const properties = {};
+        for (const [key, value] of Object.entries(sample)) {
+            properties[key] = inferSchema(value);
+        }
+        return { kind: 'object', properties };
+    }
+    return { kind: 'unknown' };
+}
+/**
+ * Enumerate the stable leaf+branch tokens exposed by an inferred schema. Object properties
+ * recurse; arrays expose a representative `0` index so a single concrete item is addressable
+ * (e.g. for previewing a repeater item shape). The root token (`"/"`) is included.
+ */
+export function tokensForSchema(schema) {
+    const tokens = [];
+    const walk = (node, path) => {
+        tokens.push(tokenFromPath(path));
+        if (node.kind === 'object') {
+            for (const [key, child] of Object.entries(node.properties)) {
+                walk(child, [...path, key]);
+            }
+        }
+        else if (node.kind === 'array') {
+            walk(node.element, [...path, 0]);
+        }
+    };
+    walk(schema, []);
+    return tokens;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/data-binding/tokens.js.map

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

package/dist/design-tokens/css.d.ts

@@ -0,0 +1,34 @@
+import type { ColorMode, ColorToken, TokenValue } from './tokens';
+/**
+ * CSS-variable emission (EC-093). Turns the typed tokens into the `:root` / `.dark` custom
+ * properties the Studio theme consumes and that an exported Next.js app can drop in verbatim.
+ * Because both the builder's `tokens.css` and the export are produced here, they never drift.
+ */
+/** Resolve a token value to a CSS value: a literal, or `var(--ref)` for an aliased role. */
+export declare function resolveTokenValue(value: TokenValue): string;
+/**
+ * Per-token colour overrides (e.g. a starter kit's brand palette). Keyed by token name; each
+ * supplies a literal colour for light and/or dark that replaces the canonical value.
+ */
+export type TokenOverrides = Record<string, {
+    light?: string;
+    dark?: string;
+}>;
+/** The CSS-variable map for one colour mode, including `--radius` for the light/base mode. */
+export declare function tokensToCssVariables(mode: ColorMode, overrides?: TokenOverrides): Record<string, string>;
+/**
+ * Emit the full token stylesheet: a `:root` block (light + `--radius`) and a `.dark` block.
+ * Deterministic and stable — suitable to write to `tokens.css` and to assert against in tests.
+ * Optional `overrides` apply a kit/brand palette on top of the canonical tokens (EC-117).
+ */
+export declare function emitTokensCss(overrides?: TokenOverrides): string;
+/** A single colour token resolved for a mode (used by the style guide). */
+export interface ResolvedColor {
+    name: string;
+    role: string;
+    /** The CSS value, with refs resolved to their concrete colour. */
+    css: string;
+    variable: string;
+}
+/** Resolve a token (following one level of ref) to a concrete colour for a mode. */
+export declare function resolveColor(token: ColorToken, mode: ColorMode): ResolvedColor;

package/dist/design-tokens/css.js

@@ -0,0 +1,51 @@
+import { colorTokens, radiusBase } from './tokens';
+/**
+ * CSS-variable emission (EC-093). Turns the typed tokens into the `:root` / `.dark` custom
+ * properties the Studio theme consumes and that an exported Next.js app can drop in verbatim.
+ * Because both the builder's `tokens.css` and the export are produced here, they never drift.
+ */
+/** Resolve a token value to a CSS value: a literal, or `var(--ref)` for an aliased role. */
+export function resolveTokenValue(value) {
+    return 'ref' in value ? `var(--${value.ref})` : value.value;
+}
+/** The CSS-variable map for one colour mode, including `--radius` for the light/base mode. */
+export function tokensToCssVariables(mode, overrides = {}) {
+    const out = {};
+    for (const token of colorTokens) {
+        const override = overrides[token.name]?.[mode];
+        out[`--${token.name}`] = override ?? resolveTokenValue(mode === 'dark' ? token.dark : token.light);
+    }
+    if (mode === 'light')
+        out['--radius'] = radiusBase;
+    return out;
+}
+function emitBlock(selector, vars) {
+    const lines = Object.entries(vars).map(([name, value]) => `  ${name}: ${value};`);
+    return `${selector} {\n${lines.join('\n')}\n}`;
+}
+/**
+ * Emit the full token stylesheet: a `:root` block (light + `--radius`) and a `.dark` block.
+ * Deterministic and stable — suitable to write to `tokens.css` and to assert against in tests.
+ * Optional `overrides` apply a kit/brand palette on top of the canonical tokens (EC-117).
+ */
+export function emitTokensCss(overrides = {}) {
+    const header = '/* GENERATED from @elytracms/design-tokens — do not edit by hand. Run `pnpm gen:tokens`. */';
+    const root = emitBlock(':root', tokensToCssVariables('light', overrides));
+    const dark = emitBlock('.dark', tokensToCssVariables('dark', overrides));
+    return `${header}\n${root}\n\n${dark}\n`;
+}
+/** Resolve a token (following one level of ref) to a concrete colour for a mode. */
+export function resolveColor(token, mode) {
+    const value = mode === 'dark' ? token.dark : token.light;
+    let css;
+    if ('ref' in value) {
+        const target = colorTokens.find((t) => t.name === value.ref);
+        const targetValue = target ? (mode === 'dark' ? target.dark : target.light) : undefined;
+        css = targetValue && 'value' in targetValue ? targetValue.value : `var(--${value.ref})`;
+    }
+    else {
+        css = value.value;
+    }
+    return { name: token.name, role: token.role, css, variable: `--${token.name}` };
+}
+//# sourceMappingURL=css.js.map

package/dist/design-tokens/css.js.map

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

package/dist/design-tokens/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @elytracms/design-tokens — the single typed source of truth for the visual system (brief §8,
+ * EC-091/092/093/094). Semantic colour roles (light/dark), radius, type and spacing scales,
+ * with deterministic CSS-variable emission and a style-guide model. The Studio theme, the
+ * CSS-variable export, and the visual style guide all derive from here — no drift.
+ */
+export declare const PACKAGE = "@elytracms/core/design-tokens";
+export * from './tokens';
+export * from './css';
+export * from './style-guide';

package/dist/design-tokens/index.js

@@ -0,0 +1,11 @@
+/**
+ * @elytracms/design-tokens — the single typed source of truth for the visual system (brief §8,
+ * EC-091/092/093/094). Semantic colour roles (light/dark), radius, type and spacing scales,
+ * with deterministic CSS-variable emission and a style-guide model. The Studio theme, the
+ * CSS-variable export, and the visual style guide all derive from here — no drift.
+ */
+export const PACKAGE = '@elytracms/core/design-tokens';
+export * from './tokens';
+export * from './css';
+export * from './style-guide';
+//# sourceMappingURL=index.js.map

package/dist/design-tokens/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/design-tokens/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,+BAA+B,CAAA;AAEtD,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,eAAe,CAAA"}

package/dist/design-tokens/style-guide.d.ts

@@ -0,0 +1,30 @@
+import type { ColorMode, ScaleStep } from './tokens';
+import type { ResolvedColor } from './css';
+/**
+ * A deterministic model for the visual style guide (EC-094). It groups the tokens into the
+ * sections the guide renders — colour swatches by role, the type scale, spacing and radius —
+ * with both light and dark resolutions so the surface is reproducible from fixtures and
+ * agent-verifiable (no live data, no randomness).
+ */
+export interface SwatchGroup {
+    title: string;
+    /** Token names in this group, in display order. */
+    tokens: string[];
+}
+/** Semantic grouping of the colour roles for the guide. */
+export declare const swatchGroups: readonly SwatchGroup[];
+export interface SwatchSection {
+    title: string;
+    swatches: ResolvedColor[];
+}
+/** Resolve every swatch group for a colour mode. */
+export declare function styleGuideSwatches(mode: ColorMode): SwatchSection[];
+export interface StyleGuideModel {
+    swatches: SwatchSection[];
+    typeScale: readonly ScaleStep[];
+    spacingScale: readonly ScaleStep[];
+    radiusScale: readonly ScaleStep[];
+    colorCount: number;
+}
+/** The full deterministic style-guide model for a colour mode. */
+export declare function styleGuideModel(mode: ColorMode): StyleGuideModel;

package/dist/design-tokens/style-guide.js

@@ -0,0 +1,31 @@
+import { colorTokens, radiusScale, spacingScale, typeScale } from './tokens';
+import { resolveColor } from './css';
+/** Semantic grouping of the colour roles for the guide. */
+export const swatchGroups = [
+    { title: 'Surfaces', tokens: ['background', 'card', 'panel', 'popover', 'muted', 'accent'] },
+    { title: 'Text', tokens: ['foreground', 'muted-foreground', 'secondary-foreground', 'accent-foreground'] },
+    { title: 'Brand', tokens: ['primary', 'primary-foreground', 'secondary', 'ring'] },
+    { title: 'Status', tokens: ['success', 'warning', 'destructive', 'info'] },
+    { title: 'Structure', tokens: ['border', 'input', 'grid-line'] },
+];
+/** Resolve every swatch group for a colour mode. */
+export function styleGuideSwatches(mode) {
+    return swatchGroups.map((group) => ({
+        title: group.title,
+        swatches: group.tokens
+            .map((name) => colorTokens.find((t) => t.name === name))
+            .filter((t) => Boolean(t))
+            .map((token) => resolveColor(token, mode)),
+    }));
+}
+/** The full deterministic style-guide model for a colour mode. */
+export function styleGuideModel(mode) {
+    return {
+        swatches: styleGuideSwatches(mode),
+        typeScale,
+        spacingScale,
+        radiusScale,
+        colorCount: colorTokens.length,
+    };
+}
+//# sourceMappingURL=style-guide.js.map

package/dist/design-tokens/style-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-guide.js","sourceRoot":"","sources":["../../src/design-tokens/style-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAiBpC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE;IAC5F,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,mBAAmB,CAAC,EAAE;IAC1G,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE;IAClF,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE;IAC1E,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE;CACjE,CAAA;AAOD,oDAAoD;AACpD,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,MAAM;aACnB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;aACvD,MAAM,CAAC,CAAC,CAAC,EAAqC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;aAC5D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;KAC7C,CAAC,CAAC,CAAA;AACL,CAAC;AAUD,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,IAAe;IAC7C,OAAO;QACL,QAAQ,EAAE,kBAAkB,CAAC,IAAI,CAAC;QAClC,SAAS;QACT,YAAY;QACZ,WAAW;QACX,UAAU,EAAE,WAAW,CAAC,MAAM;KAC/B,CAAA;AACH,CAAC"}