@stilhq/core 0.4.0 → 0.6.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,126 @@ 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;
+  };
+};
+```
+
+## Text QA
+
+### Basic Usage
+
+```typescript
+import { buildTextWithMeta, normalizeTextList } from "@stilhq/core";
+
+// Load text snapshot from Figma Plugin
+const snapshot = JSON.parse(fs.readFileSync(".stil/text/snapshots/textlist.json"));
+
+// Build with QA validation and metadata
+const { text, meta } = buildTextWithMeta(snapshot);
+
+// textlist.dist.json - validated text items
+fs.writeFileSync("textlist.dist.json", JSON.stringify(text, null, 2));
+
+// textlist.meta.json - QA issues/warnings/stats
+fs.writeFileSync("textlist.meta.json", JSON.stringify(meta, null, 2));
+```
+
+### QA Rules (v1)
+
+Text items are validated with the following rules:
+- **Empty text**: Text is empty or whitespace-only (Error)
+- **Duplicates**: Same text appears in multiple locations (Info)
+- **Too long**: Text exceeds 500 characters (Warning)
+- **Too short**: Single character text (Info)
+- **Invalid characters**: Contains control characters except tab/newline (Warning)
+
+**QA issues** are:
+- Recorded in `textlist.meta.json` with details
+- Displayed in Storybook QA report
+- Non-fatal: CI passes even with issues (v1 policy)
+
+### Text Metadata
+
+```typescript
+type TextMeta = {
+  issues: {
+    emptyText: Array<{ nodeId: string; nodePath?: string }>;
+    duplicates: Array<{
+      text: string;
+      count: number;
+      locations: Array<{ nodeId: string; nodePath?: string }>;
+    }>;
+    tooLong: Array<{ nodeId: string; text: string; length: number }>;
+    tooShort: Array<{ nodeId: string; text: string }>;
+    invalidChars: Array<{ nodeId: string; text: string; issue: string }>;
+  };
+  warnings: string[];
+  stats: {
+    totalItems: number;
+    validItems: number;
+    itemsWithIssues: number;
+    uniqueTexts: number;
+    emptyCount: number;
+    duplicateCount: 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,131 @@ 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 TextSnapshot = {
+    textList: {
+        scope: string;
+        generatedAt?: string;
+        stats?: {
+            processedNodes: number;
+            foundTextNodes: number;
+            elapsedMs?: number;
+        };
+        items: TextItem[];
+    };
+};
+export type TextItem = {
+    nodeId: string;
+    pageName?: string;
+    nodeName?: string;
+    text: string;
+    charCount?: number;
+    updatedAt?: string;
+    scopeKey?: string;
+    nodePath?: string;
+};
+export type TextMeta = {
+    issues: {
+        emptyText: Array<{
+            nodeId: string;
+            nodePath?: string;
+        }>;
+        duplicates: Array<{
+            text: string;
+            count: number;
+            locations: Array<{
+                nodeId: string;
+                nodePath?: string;
+            }>;
+        }>;
+        tooLong: Array<{
+            nodeId: string;
+            text: string;
+            length: number;
+            nodePath?: string;
+        }>;
+        tooShort: Array<{
+            nodeId: string;
+            text: string;
+            nodePath?: string;
+        }>;
+        invalidChars: Array<{
+            nodeId: string;
+            text: string;
+            issue: string;
+            nodePath?: string;
+        }>;
+    };
+    warnings: string[];
+    stats: {
+        totalItems: number;
+        validItems: number;
+        itemsWithIssues: number;
+        uniqueTexts: number;
+        emptyCount: number;
+        duplicateCount: 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":"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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"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"}

package/dist/core/text.d.ts

@@ -0,0 +1,45 @@
+import type { TextItem, TextMeta } from "./schema";
+export type NormalizedTextItem = TextItem;
+export type NormalizedTextSnapshot = {
+    textList: {
+        scope: string;
+        generatedAt?: string;
+        stats?: {
+            processedNodes: number;
+            foundTextNodes: number;
+            elapsedMs?: number;
+        };
+        items: NormalizedTextItem[];
+    };
+};
+/**
+ * Normalize text snapshot from Figma Plugin
+ * Currently a pass-through, but reserves room for future transformations
+ */
+export declare function normalizeTextList(snapshot: any): NormalizedTextSnapshot;
+/**
+ * Validate text and perform QA checks
+ * QA Rules (v1):
+ * - Empty text check
+ * - Duplicate detection
+ * - Length check (too long: >500, too short: 1 char)
+ * - Invalid characters (control chars except tab/newline)
+ */
+export declare function validateTextWithWarnings(normalized: NormalizedTextSnapshot): {
+    valid: NormalizedTextSnapshot;
+    meta: TextMeta;
+};
+/**
+ * Build text dist + meta from raw snapshot
+ * Returns both the valid text items (dist) and QA metadata (issues/warnings/stats)
+ */
+export declare function buildTextWithMeta(snapshot: any): {
+    text: NormalizedTextSnapshot;
+    meta: TextMeta;
+};
+/**
+ * Simple normalize + validate without meta
+ * For cases where QA reports are not needed
+ */
+export declare function buildTextList(snapshot: any): NormalizedTextSnapshot;
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/core/text.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgB,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAMjE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE1C,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE;YACN,cAAc,EAAE,MAAM,CAAC;YACvB,cAAc,EAAE,MAAM,CAAC;YACvB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,KAAK,EAAE,kBAAkB,EAAE,CAAC;KAC7B,CAAC;CACH,CAAC;AAMF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,GAAG,sBAAsB,CAgBvE;AAMD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,sBAAsB,GACjC;IAAE,KAAK,EAAE,sBAAsB,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAmJnD;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,GAAG;IAChD,IAAI,EAAE,sBAAsB,CAAC;IAC7B,IAAI,EAAE,QAAQ,CAAC;CAChB,CAWA;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,sBAAsB,CAGnE"}

package/dist/core/text.js

@@ -0,0 +1,189 @@
+"use strict";
+// text.ts - Text QA and validation
+// Follows the same pattern as token/component processing: normalize → validate → build
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeTextList = normalizeTextList;
+exports.validateTextWithWarnings = validateTextWithWarnings;
+exports.buildTextWithMeta = buildTextWithMeta;
+exports.buildTextList = buildTextList;
+// ========================================
+// Normalize
+// ========================================
+/**
+ * Normalize text snapshot from Figma Plugin
+ * Currently a pass-through, but reserves room for future transformations
+ */
+function normalizeTextList(snapshot) {
+    // Validate input structure
+    if (!snapshot || typeof snapshot !== "object") {
+        throw new Error("Invalid text snapshot: must be an object");
+    }
+    if (!snapshot.textList) {
+        throw new Error("Invalid text snapshot: missing 'textList' property");
+    }
+    if (!Array.isArray(snapshot.textList.items)) {
+        throw new Error("Invalid text snapshot: textList.items must be an array");
+    }
+    // For v1, we just validate and pass through
+    return snapshot;
+}
+// ========================================
+// QA Validation with Warnings
+// ========================================
+/**
+ * Validate text and perform QA checks
+ * QA Rules (v1):
+ * - Empty text check
+ * - Duplicate detection
+ * - Length check (too long: >500, too short: 1 char)
+ * - Invalid characters (control chars except tab/newline)
+ */
+function validateTextWithWarnings(normalized) {
+    const warnings = [];
+    const emptyText = [];
+    const duplicates = [];
+    const tooLong = [];
+    const tooShort = [];
+    const invalidChars = [];
+    let totalItems = 0;
+    let validItems = 0;
+    let itemsWithIssues = 0;
+    // Track text occurrences for duplicate detection
+    const textOccurrences = new Map();
+    const validItemsList = [];
+    for (const item of normalized.textList.items) {
+        totalItems++;
+        let itemHasIssues = false;
+        // QA Check 1: Empty text
+        if (!item.text || item.text.trim() === "") {
+            itemHasIssues = true;
+            emptyText.push({
+                nodeId: item.nodeId,
+                nodePath: item.nodePath,
+            });
+            warnings.push(`Empty text found at ${item.nodePath || item.nodeId || "unknown"}`);
+        }
+        // QA Check 2: Track for duplicate detection (do after empty check)
+        if (item.text && item.text.trim() !== "") {
+            if (!textOccurrences.has(item.text)) {
+                textOccurrences.set(item.text, []);
+            }
+            textOccurrences.get(item.text).push({
+                nodeId: item.nodeId,
+                nodePath: item.nodePath,
+            });
+        }
+        // QA Check 3: Too long (>500 characters)
+        if (item.text && item.text.length > 500) {
+            itemHasIssues = true;
+            tooLong.push({
+                nodeId: item.nodeId,
+                text: item.text.substring(0, 100) + "...", // Truncate for display
+                length: item.text.length,
+                nodePath: item.nodePath,
+            });
+            warnings.push(`Text exceeds 500 characters (${item.text.length} chars) at ${item.nodePath || item.nodeId || "unknown"}`);
+        }
+        // QA Check 4: Too short (1 character, excluding intentional spaces)
+        if (item.text && item.text.length === 1 && item.text.trim().length === 1) {
+            // This is info-level, not an error
+            tooShort.push({
+                nodeId: item.nodeId,
+                text: item.text,
+                nodePath: item.nodePath,
+            });
+            warnings.push(`Single character text "${item.text}" at ${item.nodePath || item.nodeId || "unknown"}`);
+        }
+        // QA Check 5: Invalid control characters (except \t, \n, \r)
+        if (item.text) {
+            const invalidControlChars = /[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/;
+            if (invalidControlChars.test(item.text)) {
+                itemHasIssues = true;
+                invalidChars.push({
+                    nodeId: item.nodeId,
+                    text: item.text,
+                    issue: "Contains invalid control characters (U+0000-U+001F except tab/newline)",
+                    nodePath: item.nodePath,
+                });
+                warnings.push(`Invalid control characters in text at ${item.nodePath || item.nodeId || "unknown"}`);
+            }
+        }
+        // Count valid vs issues
+        if (itemHasIssues) {
+            itemsWithIssues++;
+        }
+        else {
+            validItems++;
+        }
+        // Include all items in valid list (v1 policy: warnings only, not filtering)
+        validItemsList.push(item);
+    }
+    // Process duplicates
+    let duplicateCount = 0;
+    for (const [text, locations] of textOccurrences.entries()) {
+        if (locations.length > 1) {
+            duplicateCount += locations.length;
+            duplicates.push({
+                text,
+                count: locations.length,
+                locations,
+            });
+            warnings.push(`Duplicate text "${text}" appears ${locations.length} times`);
+        }
+    }
+    const uniqueTexts = textOccurrences.size;
+    const validSnapshot = {
+        textList: {
+            ...normalized.textList,
+            items: validItemsList,
+        },
+    };
+    const meta = {
+        issues: {
+            emptyText,
+            duplicates,
+            tooLong,
+            tooShort,
+            invalidChars,
+        },
+        warnings,
+        stats: {
+            totalItems,
+            validItems,
+            itemsWithIssues,
+            uniqueTexts,
+            emptyCount: emptyText.length,
+            duplicateCount,
+        },
+    };
+    return { valid: validSnapshot, meta };
+}
+// ========================================
+// Build with Meta
+// ========================================
+/**
+ * Build text dist + meta from raw snapshot
+ * Returns both the valid text items (dist) and QA metadata (issues/warnings/stats)
+ */
+function buildTextWithMeta(snapshot) {
+    // Step 1: Normalize
+    const normalized = normalizeTextList(snapshot);
+    // Step 2: Validate and perform QA checks
+    const { valid, meta } = validateTextWithWarnings(normalized);
+    return {
+        text: valid,
+        meta,
+    };
+}
+// ========================================
+// Convenience export (without meta)
+// ========================================
+/**
+ * Simple normalize + validate without meta
+ * For cases where QA reports are not needed
+ */
+function buildTextList(snapshot) {
+    const { text } = buildTextWithMeta(snapshot);
+    return text;
+}
+//# sourceMappingURL=text.js.map

package/dist/core/text.js.map

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

package/dist/index.d.ts

@@ -1,8 +1,12 @@
 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 { normalizeTextList, validateTextWithWarnings, buildTextList, buildTextWithMeta, } from "./core/text";
 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 { TextSnapshot, TextItem, TextMeta, } 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,EACL,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,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;AAGvB,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,QAAQ,GACT,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.buildTextWithMeta = exports.buildTextList = exports.validateTextWithWarnings = exports.normalizeTextList = 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,18 @@ 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; } });
+// Core functions - Text
+var text_1 = require("./core/text");
+Object.defineProperty(exports, "normalizeTextList", { enumerable: true, get: function () { return text_1.normalizeTextList; } });
+Object.defineProperty(exports, "validateTextWithWarnings", { enumerable: true, get: function () { return text_1.validateTextWithWarnings; } });
+Object.defineProperty(exports, "buildTextList", { enumerable: true, get: function () { return text_1.buildTextList; } });
+Object.defineProperty(exports, "buildTextWithMeta", { enumerable: true, get: function () { return text_1.buildTextWithMeta; } });
 // 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,wBAAwB;AACxB,oCAKqB;AAJnB,yGAAA,iBAAiB,OAAA;AACjB,gHAAA,wBAAwB,OAAA;AACxB,qGAAA,aAAa,OAAA;AACb,yGAAA,iBAAiB,OAAA;AAGnB,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.6.0",
+  "description": "Design token, component, and text QA pipeline for Stil",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -17,7 +17,10 @@
     "prepublishOnly": "npm run clean && npm run build"
   },
   "keywords": [
-    "design-tokens"
+    "design-tokens",
+    "design-system",
+    "components",
+    "text-qa"
   ],
   "author": "Tetsu",
   "license": "BUSL-1.1",