@stilhq/core 0.4.0 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # @stilhq/core
 
-Design token pipeline for Stil. Normalize, validate, and build design tokens from Figma Variables.
+Design token and component pipeline for Stil. Normalize, validate, and build design tokens and components from Figma.
 
 ## Install
 
@@ -82,6 +82,65 @@ workspace_repo/
 
 Priority: workspace config > core default
 
+## Component Processing
+
+### Basic Usage
+
+```typescript
+import { buildComponentsWithMeta, normalizeComponents } from "@stilhq/core";
+
+// Load component snapshot from Figma Plugin
+const snapshot = JSON.parse(fs.readFileSync(".stil/components/snapshots/components.json"));
+
+// Build with validation and metadata
+const { components, meta } = buildComponentsWithMeta(snapshot);
+
+// components.dist.json - valid components only
+fs.writeFileSync("components.dist.json", JSON.stringify(components, null, 2));
+
+// components.meta.json - validation warnings and stats
+fs.writeFileSync("components.meta.json", JSON.stringify(meta, null, 2));
+```
+
+### Validation Rules (v1)
+
+Components are validated with minimal rules:
+- Component must have a name
+- Component must have a variants array
+- Variant must have a name
+- Variant props are optional (warning only)
+
+**Invalid components/variants** are:
+- Excluded from `components.dist.json`
+- Recorded in `components.meta.json` with reasons
+- Displayed in Storybook Warnings panel
+- Non-fatal: CI passes even with validation issues
+
+### Component Metadata
+
+```typescript
+type ComponentMeta = {
+  unknown: {
+    invalidComponents: Array<{ name: string; reason: string; nodeId?: string }>;
+    invalidVariants: Array<{
+      component: string;
+      variant: string;
+      reason: string;
+      nodeId?: string;
+    }>;
+  };
+  warnings: string[];
+  stats: {
+    totalComponents: number;
+    validComponents: number;
+    invalidComponents: number;
+    totalVariants: number;
+    validVariants: number;
+    invalidVariants: number;
+  };
+};
+```
+
 ## Status
 
 0.x — API is not yet stable. Breaking changes may occur in minor versions.

package/dist/core/components.d.ts

@@ -0,0 +1,48 @@
+import type { ComponentItem, ComponentMeta } from "./schema";
+export type NormalizedComponent = ComponentItem;
+export type NormalizedComponentSnapshot = {
+    components: {
+        scopeLabel: string;
+        scopeKey: string;
+        generatedAt?: string;
+        stats?: {
+            total: number;
+            componentSets: number;
+            components: number;
+            variants: number;
+            variantKeys?: string[];
+        };
+        items: NormalizedComponent[];
+    };
+};
+/**
+ * Normalize component snapshot from Figma Plugin
+ * Currently a pass-through, but reserves room for future transformations
+ */
+export declare function normalizeComponents(snapshot: any): NormalizedComponentSnapshot;
+/**
+ * Validate components and collect warnings
+ * Rules (v1 minimal):
+ * - Component must have a name
+ * - Component must have variants array
+ * - Variant must have name
+ * - Variant must have props (optional warning)
+ */
+export declare function validateComponentsWithWarnings(normalized: NormalizedComponentSnapshot): {
+    valid: NormalizedComponentSnapshot;
+    meta: ComponentMeta;
+};
+/**
+ * Build component dist + meta from raw snapshot
+ * Returns both the valid components (dist) and metadata (warnings/stats)
+ */
+export declare function buildComponentsWithMeta(snapshot: any): {
+    components: NormalizedComponentSnapshot;
+    meta: ComponentMeta;
+};
+/**
+ * Simple normalize + validate without meta
+ * For cases where warnings are not needed
+ */
+export declare function buildComponents(snapshot: any): NormalizedComponentSnapshot;
+//# sourceMappingURL=components.d.ts.map

package/dist/core/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/core/components.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,aAAa,EAEb,aAAa,EACd,MAAM,UAAU,CAAC;AAMlB,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEhD,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE;YACN,KAAK,EAAE,MAAM,CAAC;YACd,aAAa,EAAE,MAAM,CAAC;YACtB,UAAU,EAAE,MAAM,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC;YACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;SACxB,CAAC;QACF,KAAK,EAAE,mBAAmB,EAAE,CAAC;KAC9B,CAAC;CACH,CAAC;AAMF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,GAAG,GACZ,2BAA2B,CAqB7B;AAMD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,2BAA2B,GACtC;IAAE,KAAK,EAAE,2BAA2B,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CA0I7D;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,GAAG,GAAG;IACtD,UAAU,EAAE,2BAA2B,CAAC;IACxC,IAAI,EAAE,aAAa,CAAC;CACrB,CAWA;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,2BAA2B,CAG1E"}

package/dist/core/components.js

@@ -0,0 +1,185 @@
+"use strict";
+// components.ts - Component snapshot processing
+// Follows the same pattern as token processing: normalize → validate → build
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeComponents = normalizeComponents;
+exports.validateComponentsWithWarnings = validateComponentsWithWarnings;
+exports.buildComponentsWithMeta = buildComponentsWithMeta;
+exports.buildComponents = buildComponents;
+// ========================================
+// Normalize
+// ========================================
+/**
+ * Normalize component snapshot from Figma Plugin
+ * Currently a pass-through, but reserves room for future transformations
+ */
+function normalizeComponents(snapshot) {
+    // Validate input structure
+    if (!snapshot || typeof snapshot !== "object") {
+        throw new Error("Invalid component snapshot: must be an object");
+    }
+    if (!snapshot.components) {
+        throw new Error("Invalid component snapshot: missing 'components' property");
+    }
+    if (!Array.isArray(snapshot.components.items)) {
+        throw new Error("Invalid component snapshot: components.items must be an array");
+    }
+    // For v1, we just validate and pass through
+    // Future versions may normalize names, extract types, etc.
+    return snapshot;
+}
+// ========================================
+// Validation with Warnings
+// ========================================
+/**
+ * Validate components and collect warnings
+ * Rules (v1 minimal):
+ * - Component must have a name
+ * - Component must have variants array
+ * - Variant must have name
+ * - Variant must have props (optional warning)
+ */
+function validateComponentsWithWarnings(normalized) {
+    const warnings = [];
+    const invalidComponents = [];
+    const invalidVariants = [];
+    let totalComponents = 0;
+    let validComponents = 0;
+    let invalidComponentsCount = 0;
+    let totalVariants = 0;
+    let validVariants = 0;
+    let invalidVariantsCount = 0;
+    const validItems = [];
+    for (const item of normalized.components.items) {
+        totalComponents++;
+        let componentIsValid = true;
+        const componentVariants = [];
+        // Check component name
+        if (!item.name || item.name.trim() === "") {
+            componentIsValid = false;
+            invalidComponents.push({
+                name: item.name || "(unnamed)",
+                reason: "Missing or empty component name",
+                nodeId: item.nodeId,
+            });
+            warnings.push(`Component ${item.nodeId || "unknown"}: Missing or empty name`);
+        }
+        // Check variants array
+        if (!Array.isArray(item.variants)) {
+            componentIsValid = false;
+            invalidComponents.push({
+                name: item.name || "(unnamed)",
+                reason: "Missing or invalid variants array",
+                nodeId: item.nodeId,
+            });
+            warnings.push(`Component "${item.name || "unknown"}": Missing or invalid variants array`);
+            continue; // Can't process variants if array is invalid
+        }
+        // Validate each variant
+        for (const variant of item.variants) {
+            totalVariants++;
+            let variantIsValid = true;
+            // Check variant name
+            if (!variant.name || variant.name.trim() === "") {
+                variantIsValid = false;
+                invalidVariants.push({
+                    component: item.name || "(unnamed)",
+                    variant: variant.name || "(unnamed)",
+                    reason: "Missing or empty variant name",
+                    nodeId: variant.nodeId,
+                });
+                warnings.push(`Component "${item.name || "unknown"}", variant ${variant.nodeId || "unknown"}: Missing or empty name`);
+            }
+            // Check props (optional warning only)
+            if (!variant.props || Object.keys(variant.props).length === 0) {
+                warnings.push(`Component "${item.name || "unknown"}", variant "${variant.name || "unknown"}": No props detected (may be intentional)`);
+            }
+            if (variantIsValid) {
+                validVariants++;
+                componentVariants.push(variant);
+            }
+            else {
+                invalidVariantsCount++;
+            }
+        }
+        // Component is valid only if it has at least one valid variant
+        if (componentIsValid && componentVariants.length > 0) {
+            validComponents++;
+            validItems.push({
+                ...item,
+                variants: componentVariants,
+                variantCount: componentVariants.length,
+            });
+        }
+        else {
+            invalidComponentsCount++;
+            if (componentVariants.length === 0 && componentIsValid) {
+                // Component structure was OK but no valid variants
+                invalidComponents.push({
+                    name: item.name,
+                    reason: "No valid variants found",
+                    nodeId: item.nodeId,
+                });
+                warnings.push(`Component "${item.name || "unknown"}": No valid variants found`);
+            }
+        }
+    }
+    const validSnapshot = {
+        components: {
+            ...normalized.components,
+            items: validItems,
+            stats: {
+                ...normalized.components.stats,
+                total: validItems.length,
+                componentSets: validItems.length,
+                components: validItems.reduce((sum, item) => sum + (item.componentIds?.length || 0), 0),
+                variants: validVariants,
+            },
+        },
+    };
+    const meta = {
+        unknown: {
+            invalidComponents,
+            invalidVariants,
+        },
+        warnings,
+        stats: {
+            totalComponents,
+            validComponents,
+            invalidComponents: invalidComponentsCount,
+            totalVariants,
+            validVariants,
+            invalidVariants: invalidVariantsCount,
+        },
+    };
+    return { valid: validSnapshot, meta };
+}
+// ========================================
+// Build with Meta
+// ========================================
+/**
+ * Build component dist + meta from raw snapshot
+ * Returns both the valid components (dist) and metadata (warnings/stats)
+ */
+function buildComponentsWithMeta(snapshot) {
+    // Step 1: Normalize
+    const normalized = normalizeComponents(snapshot);
+    // Step 2: Validate and separate valid/invalid
+    const { valid, meta } = validateComponentsWithWarnings(normalized);
+    return {
+        components: valid,
+        meta,
+    };
+}
+// ========================================
+// Convenience export (without meta)
+// ========================================
+/**
+ * Simple normalize + validate without meta
+ * For cases where warnings are not needed
+ */
+function buildComponents(snapshot) {
+    const { components } = buildComponentsWithMeta(snapshot);
+    return components;
+}
+//# sourceMappingURL=components.js.map

package/dist/core/components.js.map

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

package/dist/core/schema.d.ts

@@ -51,6 +51,67 @@ export type TokenMeta = {
         unknownTokens: number;
     };
 };
+export type ComponentSnapshot = {
+    components: {
+        scopeLabel: string;
+        scopeKey: string;
+        generatedAt?: string;
+        stats?: {
+            total: number;
+            componentSets: number;
+            components: number;
+            variants: number;
+            variantKeys?: string[];
+        };
+        items: ComponentItem[];
+    };
+};
+export type ComponentItem = {
+    nodeId: string;
+    componentSetId?: string;
+    name: string;
+    type: string;
+    pageName?: string;
+    updatedAt?: string;
+    scopeKey?: string;
+    variantKeys?: string[];
+    variantCount?: number;
+    componentIds?: string[];
+    variants: ComponentVariant[];
+};
+export type ComponentVariant = {
+    nodeId: string;
+    name: string;
+    props?: Record<string, string>;
+    propsSource?: string;
+    pageName?: string;
+    updatedAt?: string;
+    componentName?: string;
+};
+export type ComponentMeta = {
+    unknown: {
+        invalidComponents: Array<{
+            name: string;
+            reason: string;
+            nodeId?: string;
+        }>;
+        invalidVariants: Array<{
+            component: string;
+            variant: string;
+            reason: string;
+            nodeId?: string;
+        }>;
+    };
+    warnings: string[];
+    stats: {
+        totalComponents: number;
+        validComponents: number;
+        invalidComponents: number;
+        totalVariants: number;
+        validVariants: number;
+        invalidVariants: number;
+    };
+};
 export type Mapping = Record<string, string>;
 export type BuildOptions = {
     /** optional: theme.css を生成するか */

package/dist/core/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnC,CAAC;AAGF,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAGF,MAAM,MAAM,oBAAoB,GAAG,eAAe,EAAE,CAAC;AAGrD,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,eAAe,GACf,oBAAoB,GACpB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAGxB,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAGF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;CACzB,CAAC;AAIF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B,CAAC;AAGF,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAGnE,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC;CAC5C,CAAC;AAGF,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,CAAC;CACxC,CAAC;AAGF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B,CAAC;AAGF,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAGF,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAG7C,MAAM,MAAM,YAAY,GAAG;IACzB,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAGF,MAAM,WAAW,eAAe;IAC9B,IAAI,EACA,qBAAqB,GACrB,YAAY,GACZ,sBAAsB,GACtB,cAAc,GACd,eAAe,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 export { buildThemeTokens, buildThemeTokensWithMeta, writeThemeTokens, } from "./core/build";
 export { normalize, normalizeWithWarnings, normalizeFromFigmaSemantics, normalizeFromFigmaPlugin, normalizeFromFigmaPluginMulti, detectInputFormat, } from "./core/normalize";
 export { validateMapping, formatValidationErrors, printValidationErrors, } from "./core/validate";
+export { normalizeComponents, validateComponentsWithWarnings, buildComponents, buildComponentsWithMeta, } from "./core/components";
 export { loadFigmaVariables, validateFigmaVariables } from "./adapters/figma";
 export type { ThemeTokens, TokenMeta, RawTokenTree, RawTokenNode, RawTokenLeaf, RawTokenType, RawTokenSource, FigmaVariableAlias, FigmaSemanticsJson, FigmaPluginJson, FigmaPluginMultiJson, TokenInputJson, Mapping, BuildOptions, ValidationIssue, ValidationResult, } from "./core/schema";
+export type { ComponentSnapshot, ComponentItem, ComponentVariant, ComponentMeta, } from "./core/schema";
 export type { InputFormat } from "./core/normalize";
 export type { MappingValidationError } from "./core/validate";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,EACxB,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,OAAO,EACP,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,EACxB,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,eAAe,EACf,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,OAAO,EACP,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -2,8 +2,8 @@
 // @stilhq/core - Main entry point
 // 公開APIはここからのみ提供（深いパスimport禁止）
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateFigmaVariables = exports.loadFigmaVariables = exports.printValidationErrors = exports.formatValidationErrors = exports.validateMapping = exports.detectInputFormat = exports.normalizeFromFigmaPluginMulti = exports.normalizeFromFigmaPlugin = exports.normalizeFromFigmaSemantics = exports.normalizeWithWarnings = exports.normalize = exports.writeThemeTokens = exports.buildThemeTokensWithMeta = exports.buildThemeTokens = void 0;
-// Core functions
+exports.validateFigmaVariables = exports.loadFigmaVariables = exports.buildComponentsWithMeta = exports.buildComponents = exports.validateComponentsWithWarnings = exports.normalizeComponents = exports.printValidationErrors = exports.formatValidationErrors = exports.validateMapping = exports.detectInputFormat = exports.normalizeFromFigmaPluginMulti = exports.normalizeFromFigmaPlugin = exports.normalizeFromFigmaSemantics = exports.normalizeWithWarnings = exports.normalize = exports.writeThemeTokens = exports.buildThemeTokensWithMeta = exports.buildThemeTokens = void 0;
+// Core functions - Tokens
 var build_1 = require("./core/build");
 Object.defineProperty(exports, "buildThemeTokens", { enumerable: true, get: function () { return build_1.buildThemeTokens; } });
 Object.defineProperty(exports, "buildThemeTokensWithMeta", { enumerable: true, get: function () { return build_1.buildThemeTokensWithMeta; } });
@@ -19,6 +19,12 @@ var validate_1 = require("./core/validate");
 Object.defineProperty(exports, "validateMapping", { enumerable: true, get: function () { return validate_1.validateMapping; } });
 Object.defineProperty(exports, "formatValidationErrors", { enumerable: true, get: function () { return validate_1.formatValidationErrors; } });
 Object.defineProperty(exports, "printValidationErrors", { enumerable: true, get: function () { return validate_1.printValidationErrors; } });
+// Core functions - Components
+var components_1 = require("./core/components");
+Object.defineProperty(exports, "normalizeComponents", { enumerable: true, get: function () { return components_1.normalizeComponents; } });
+Object.defineProperty(exports, "validateComponentsWithWarnings", { enumerable: true, get: function () { return components_1.validateComponentsWithWarnings; } });
+Object.defineProperty(exports, "buildComponents", { enumerable: true, get: function () { return components_1.buildComponents; } });
+Object.defineProperty(exports, "buildComponentsWithMeta", { enumerable: true, get: function () { return components_1.buildComponentsWithMeta; } });
 // Adapters
 var figma_1 = require("./adapters/figma");
 Object.defineProperty(exports, "loadFigmaVariables", { enumerable: true, get: function () { return figma_1.loadFigmaVariables; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,kCAAkC;AAClC,+BAA+B;;;AAE/B,iBAAiB;AACjB,sCAIsB;AAHpB,yGAAA,gBAAgB,OAAA;AAChB,iHAAA,wBAAwB,OAAA;AACxB,yGAAA,gBAAgB,OAAA;AAElB,8CAO0B;AANxB,sGAAA,SAAS,OAAA;AACT,kHAAA,qBAAqB,OAAA;AACrB,wHAAA,2BAA2B,OAAA;AAC3B,qHAAA,wBAAwB,OAAA;AACxB,0HAAA,6BAA6B,OAAA;AAC7B,8GAAA,iBAAiB,OAAA;AAEnB,4CAIyB;AAHvB,2GAAA,eAAe,OAAA;AACf,kHAAA,sBAAsB,OAAA;AACtB,iHAAA,qBAAqB,OAAA;AAGvB,WAAW;AACX,0CAA8E;AAArE,2GAAA,kBAAkB,OAAA;AAAE,+GAAA,sBAAsB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,kCAAkC;AAClC,+BAA+B;;;AAE/B,0BAA0B;AAC1B,sCAIsB;AAHpB,yGAAA,gBAAgB,OAAA;AAChB,iHAAA,wBAAwB,OAAA;AACxB,yGAAA,gBAAgB,OAAA;AAElB,8CAO0B;AANxB,sGAAA,SAAS,OAAA;AACT,kHAAA,qBAAqB,OAAA;AACrB,wHAAA,2BAA2B,OAAA;AAC3B,qHAAA,wBAAwB,OAAA;AACxB,0HAAA,6BAA6B,OAAA;AAC7B,8GAAA,iBAAiB,OAAA;AAEnB,4CAIyB;AAHvB,2GAAA,eAAe,OAAA;AACf,kHAAA,sBAAsB,OAAA;AACtB,iHAAA,qBAAqB,OAAA;AAGvB,8BAA8B;AAC9B,gDAK2B;AAJzB,iHAAA,mBAAmB,OAAA;AACnB,4HAAA,8BAA8B,OAAA;AAC9B,6GAAA,eAAe,OAAA;AACf,qHAAA,uBAAuB,OAAA;AAGzB,WAAW;AACX,0CAA8E;AAArE,2GAAA,kBAAkB,OAAA;AAAE,+GAAA,sBAAsB,OAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stilhq/core",
-  "version": "0.4.0",
-  "description": "Design token pipeline for Stil",
+  "version": "0.5.0",
+  "description": "Design token and component pipeline for Stil",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -17,7 +17,9 @@
     "prepublishOnly": "npm run clean && npm run build"
   },
   "keywords": [
-    "design-tokens"
+    "design-tokens",
+    "design-system",
+    "components"
   ],
   "author": "Tetsu",
   "license": "BUSL-1.1",