@stilhq/core 0.6.0 → 0.6.1

package/dist/w3c/parser.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * W3C DTCG JSON parser and converter
+ *
+ * Converts between W3C Design Tokens format and flat TokenItem arrays.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseW3CTokens = parseW3CTokens;
+exports.toW3CDocument = toW3CDocument;
+exports.toW3CPath = toW3CPath;
+exports.fromW3CPath = fromW3CPath;
+exports.toChangeSetTokenItem = toChangeSetTokenItem;
+const VALID_W3C_TYPES = new Set([
+    "color",
+    "dimension",
+    "fontFamily",
+    "fontWeight",
+    "duration",
+    "cubicBezier",
+    "number",
+    "strokeStyle",
+    "border",
+    "transition",
+    "shadow",
+    "gradient",
+    "typography",
+    "fontStyle",
+]);
+/**
+ * Check if a value looks like a W3C token value node (has $value)
+ */
+function isTokenValue(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "$value" in node);
+}
+/**
+ * Parse W3C DTCG JSON into a flat array of parsed tokens.
+ *
+ * Handles:
+ * - Nested groups with dot-separated keys
+ * - $type inheritance from parent groups
+ * - alias references ({color.primary} syntax) preserved as-is
+ * - $extensions passed through
+ */
+function parseW3CTokens(doc) {
+    const result = [];
+    walkGroup(doc, [], undefined, result);
+    return result;
+}
+function walkGroup(group, pathParts, inheritedType, result) {
+    // Check for group-level $type
+    const groupType = group.$type && VALID_W3C_TYPES.has(group.$type)
+        ? group.$type
+        : inheritedType;
+    for (const key of Object.keys(group)) {
+        if (key.startsWith("$"))
+            continue; // skip meta keys
+        const value = group[key];
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === "string")
+            continue; // skip bare strings at group level
+        const childPath = [...pathParts, key];
+        if (isTokenValue(value)) {
+            // This is a token leaf
+            const tokenType = value.$type || groupType;
+            if (!tokenType)
+                continue; // skip tokens without any type
+            result.push({
+                tokenKey: childPath.join("."),
+                $type: tokenType,
+                $value: value.$value,
+                $description: value.$description,
+                $extensions: value.$extensions,
+            });
+        }
+        else {
+            // This is a nested group
+            walkGroup(value, childPath, groupType, result);
+        }
+    }
+}
+/**
+ * Convert flat ParsedW3CToken array back to W3C DTCG document.
+ * Reconstructs nested structure from dot-separated keys.
+ */
+function toW3CDocument(tokens) {
+    const doc = {};
+    for (const token of tokens) {
+        const parts = token.tokenKey.split(".");
+        let current = doc;
+        // Navigate/create nested groups
+        for (let i = 0; i < parts.length - 1; i++) {
+            if (!current[parts[i]] || typeof current[parts[i]] !== "object") {
+                current[parts[i]] = {};
+            }
+            current = current[parts[i]];
+        }
+        // Set the leaf value
+        const leaf = {
+            $type: token.$type,
+            $value: token.$value,
+        };
+        if (token.$description) {
+            leaf.$description = token.$description;
+        }
+        if (token.$extensions) {
+            leaf.$extensions = token.$extensions;
+        }
+        current[parts[parts.length - 1]] = leaf;
+    }
+    return doc;
+}
+/**
+ * Convert dot-separated tokenKey to W3C path format (slash-separated).
+ */
+function toW3CPath(dotKey) {
+    return dotKey.replace(/\./g, "/");
+}
+/**
+ * Convert W3C path (slash-separated) to dot-separated tokenKey.
+ */
+function fromW3CPath(w3cPath) {
+    return w3cPath.replace(/\//g, ".");
+}
+/**
+ * Convert ParsedW3CToken to ChangeSetTokenItem format.
+ * Used internally when generating diffs from W3C documents.
+ */
+function toChangeSetTokenItem(parsed, before, after) {
+    const item = {
+        tokenKey: parsed.tokenKey,
+        before,
+        after,
+        changeType: "VALUE",
+    };
+    // Attach W3C metadata as optional fields
+    item.$type = parsed.$type;
+    item.$value = parsed.$value;
+    if (parsed.$description) {
+        item.$description = parsed.$description;
+    }
+    return item;
+}
+//# sourceMappingURL=parser.js.map

package/dist/w3c/parser.js.map

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

package/dist/w3c/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * W3C Design Tokens Community Group Format 1.0
+ * @see https://tr.designtokens.org/format/
+ */
+/** W3C Token Types */
+export type W3CTokenType = "color" | "dimension" | "fontFamily" | "fontWeight" | "duration" | "cubicBezier" | "number" | "strokeStyle" | "border" | "transition" | "shadow" | "gradient" | "typography" | "fontStyle";
+/** W3C Token Value */
+export interface W3CTokenValue {
+    $type: W3CTokenType;
+    $value: string | number | Record<string, unknown>;
+    $description?: string;
+    $extensions?: Record<string, unknown>;
+}
+/** W3C Token Group (nestable) */
+export interface W3CTokenGroup {
+    [key: string]: W3CTokenValue | W3CTokenGroup | string | undefined;
+    $type?: W3CTokenType;
+    $description?: string;
+}
+/** W3C Design Tokens Document */
+export interface W3CDesignTokensDocument {
+    [key: string]: W3CTokenGroup | W3CTokenValue;
+}
+/** Validation result for a single token or document */
+export interface W3CValidationResult {
+    valid: boolean;
+    path: string;
+    errors: string[];
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/w3c/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/w3c/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sBAAsB;AACtB,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,aAAa,GACb,QAAQ,GACR,aAAa,GACb,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,WAAW,CAAC;AAEhB,sBAAsB;AACtB,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;IAClE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,iCAAiC;AACjC,MAAM,WAAW,uBAAuB;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;CAC9C;AAED,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/w3c/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * W3C Design Tokens Community Group Format 1.0
+ * @see https://tr.designtokens.org/format/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/w3c/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/w3c/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/w3c/validator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * W3C DTCG format validation
+ */
+import type { W3CDesignTokensDocument, W3CTokenValue, W3CValidationResult } from "./types";
+/**
+ * Validate a single W3C token value.
+ */
+export declare function validateW3CToken(token: W3CTokenValue, path?: string): W3CValidationResult;
+/**
+ * Validate an entire W3C Design Tokens document.
+ * Walks the tree and validates each token node.
+ */
+export declare function validateW3CDocument(doc: W3CDesignTokensDocument): W3CValidationResult[];
+//# sourceMappingURL=validator.d.ts.map

package/dist/w3c/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/w3c/validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,uBAAuB,EAGvB,aAAa,EACb,mBAAmB,EACpB,MAAM,SAAS,CAAC;AA0BjB;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,MAAW,GAChB,mBAAmB,CAyCrB;AA2ED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,uBAAuB,GAC3B,mBAAmB,EAAE,CAIvB"}

package/dist/w3c/validator.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * W3C DTCG format validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateW3CToken = validateW3CToken;
+exports.validateW3CDocument = validateW3CDocument;
+const VALID_W3C_TYPES = new Set([
+    "color",
+    "dimension",
+    "fontFamily",
+    "fontWeight",
+    "duration",
+    "cubicBezier",
+    "number",
+    "strokeStyle",
+    "border",
+    "transition",
+    "shadow",
+    "gradient",
+    "typography",
+    "fontStyle",
+]);
+/**
+ * Check if a value is a W3C token node (has $value)
+ */
+function isTokenValue(node) {
+    return typeof node === "object" && node !== null && "$value" in node;
+}
+/**
+ * Validate a single W3C token value.
+ */
+function validateW3CToken(token, path = "") {
+    const errors = [];
+    const warnings = [];
+    // $value is required
+    if (token.$value === undefined || token.$value === null) {
+        errors.push(`${path}: $value is required`);
+    }
+    // $type should be valid if present
+    if (token.$type !== undefined) {
+        if (!VALID_W3C_TYPES.has(token.$type)) {
+            errors.push(`${path}: invalid $type "${token.$type}". Valid types: ${[...VALID_W3C_TYPES].join(", ")}`);
+        }
+    }
+    // Type-specific value validation
+    if (token.$type && token.$value !== undefined && token.$value !== null) {
+        const valueErrors = validateValueForType(token.$type, token.$value, path);
+        errors.push(...valueErrors);
+    }
+    // Warn about missing $type (it might be inherited from parent)
+    if (!token.$type) {
+        warnings.push(`${path}: no $type specified (may be inherited from parent group)`);
+    }
+    return {
+        valid: errors.length === 0,
+        path,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate $value against its $type
+ */
+function validateValueForType(type, value, path) {
+    const errors = [];
+    // Skip alias references
+    if (typeof value === "string" && value.startsWith("{") && value.endsWith("}")) {
+        return errors;
+    }
+    switch (type) {
+        case "color":
+            if (typeof value !== "string") {
+                errors.push(`${path}: color $value must be a string`);
+            }
+            break;
+        case "dimension":
+            if (typeof value !== "string") {
+                errors.push(`${path}: dimension $value must be a string (e.g., "16px")`);
+            }
+            break;
+        case "number":
+            if (typeof value !== "number") {
+                errors.push(`${path}: number $value must be a number`);
+            }
+            break;
+        case "fontFamily":
+            if (typeof value !== "string") {
+                errors.push(`${path}: fontFamily $value must be a string`);
+            }
+            break;
+        case "fontWeight":
+            if (typeof value !== "number" && typeof value !== "string") {
+                errors.push(`${path}: fontWeight $value must be a number or string`);
+            }
+            break;
+        case "duration":
+            if (typeof value !== "string") {
+                errors.push(`${path}: duration $value must be a string (e.g., "200ms")`);
+            }
+            break;
+        case "cubicBezier":
+            if (!Array.isArray(value)) {
+                errors.push(`${path}: cubicBezier $value must be an array of 4 numbers`);
+            }
+            break;
+        case "typography":
+        case "shadow":
+        case "border":
+        case "transition":
+        case "gradient":
+            if (typeof value !== "object") {
+                errors.push(`${path}: ${type} $value must be an object`);
+            }
+            break;
+        case "strokeStyle":
+            // Can be string or object
+            break;
+        case "fontStyle":
+            if (typeof value !== "string") {
+                errors.push(`${path}: fontStyle $value must be a string`);
+            }
+            break;
+    }
+    return errors;
+}
+/**
+ * Validate an entire W3C Design Tokens document.
+ * Walks the tree and validates each token node.
+ */
+function validateW3CDocument(doc) {
+    const results = [];
+    walkAndValidate(doc, [], undefined, results);
+    return results;
+}
+function walkAndValidate(group, pathParts, inheritedType, results) {
+    const groupType = group.$type && VALID_W3C_TYPES.has(group.$type)
+        ? group.$type
+        : inheritedType;
+    for (const key of Object.keys(group)) {
+        if (key.startsWith("$"))
+            continue;
+        const value = group[key];
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === "string")
+            continue;
+        const childPath = [...pathParts, key];
+        const pathStr = childPath.join(".");
+        if (isTokenValue(value)) {
+            // Inject inherited type if token lacks its own
+            const tokenWithType = value.$type
+                ? value
+                : Object.assign({}, value, { $type: groupType });
+            results.push(validateW3CToken(tokenWithType, pathStr));
+        }
+        else {
+            walkAndValidate(value, childPath, groupType, results);
+        }
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/w3c/validator.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stilhq/core",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Design token, component, and text QA pipeline for Stil",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -36,7 +36,8 @@
     "dist",
     "README.md",
     "LICENSE",
-    "src/config"
+    "src/config",
+    "templates"
   ],
   "devDependencies": {
     "@types/node": "^20.11.0",

package/templates/stil-quality-gate.yml

@@ -0,0 +1,122 @@
+# .github/workflows/stil-quality-gate.yml
+#
+# Stil Quality Gate — CI Merge Block
+#
+# workspace_repo にコピーして使う GitHub Actions workflow テンプレート。
+# .stil/ 配下の ChangeSet JSON を読み取り、Quality Gate を実行する。
+#
+# blocked items = CI fail（壊れた参照、key 衝突、placeholder 不一致）
+# review items = approval label 必須（requireApprovalForReview を有効化した場合）
+
+name: Stil Quality Gate
+
+on:
+  pull_request:
+    paths:
+      - '.stil/**'
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  quality-gate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install @stilhq/core
+        run: npm install @stilhq/core
+
+      - name: Check for ChangeSet files
+        id: check-changesets
+        run: |
+          if ls .stil/changesets/*.json 1>/dev/null 2>&1; then
+            echo "has_changesets=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "has_changesets=false" >> "$GITHUB_OUTPUT"
+            echo "No ChangeSet files found in .stil/changesets/"
+          fi
+
+      - name: Run Stil Quality Gate
+        if: steps.check-changesets.outputs.has_changesets == 'true'
+        id: gate
+        run: |
+          mkdir -p .stil/reports
+          npx stil-gate \
+            --changesets .stil/changesets/*.json \
+            --format gh-annotations \
+            --output .stil/reports/gate-result.json
+        continue-on-error: true
+
+      - name: Generate PR Comment
+        if: steps.check-changesets.outputs.has_changesets == 'true'
+        id: pr-comment
+        run: |
+          npx stil-gate \
+            --changesets .stil/changesets/*.json \
+            --format pr-comment > .stil/reports/pr-comment.md
+
+      - name: Comment PR with Quality Gate results
+        if: steps.check-changesets.outputs.has_changesets == 'true' && github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const commentPath = '.stil/reports/pr-comment.md';
+
+            if (!fs.existsSync(commentPath)) {
+              console.log('No PR comment file found, skipping');
+              return;
+            }
+
+            const body = fs.readFileSync(commentPath, 'utf8');
+
+            // Find existing Stil comment
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+            });
+
+            const stilComment = comments.find(c =>
+              c.body && c.body.includes('Stil Quality Gate')
+            );
+
+            if (stilComment) {
+              // Update existing comment
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: stilComment.id,
+                body,
+              });
+            } else {
+              // Create new comment
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                body,
+              });
+            }
+
+      - name: Upload Quality Gate report
+        if: steps.check-changesets.outputs.has_changesets == 'true'
+        uses: actions/upload-artifact@v4
+        with:
+          name: stil-quality-gate-report
+          path: .stil/reports/
+          retention-days: 30
+
+      - name: Fail if Quality Gate failed
+        if: steps.gate.outcome == 'failure'
+        run: |
+          echo "❌ Stil Quality Gate failed. See annotations above for details."
+          exit 1

package/templates/workspace/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+## Summary
+
+<!-- What changed and why -->
+
+## Stil Gate Report
+
+<!-- Stil will auto-post Gate results as a comment -->
+<!-- If Gate failed, explain why the change is safe: -->
+
+## Checklist
+
+- [ ] Gate passed (or failure explained above)
+- [ ] Storybook preview reviewed
+- [ ] Design team notified (if review classification)

package/templates/workspace/.github/workflows/stil-gate.yml

@@ -0,0 +1,42 @@
+# Stil Gate — Quality Gate CI for design system changes
+name: Stil Gate
+
+on:
+  pull_request:
+    paths:
+      - '.stil/**'
+
+jobs:
+  gate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run Stil Gate
+        run: npx stil gate --mode ${{ vars.STIL_GATE_MODE || 'warn' }} --ci
+        env:
+          SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
+          SUPABASE_ANON_KEY: ${{ secrets.SUPABASE_ANON_KEY }}
+          STIL_PROJECT_ID: ${{ secrets.STIL_PROJECT_ID }}
+
+      - name: Upload Gate Report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: stil-gate-report
+          path: .stil/reports/
+
+      - name: Post Gate Comment
+        if: github.event_name == 'pull_request'
+        run: npx stil gate-comment --pr ${{ github.event.pull_request.number }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
+          SUPABASE_ANON_KEY: ${{ secrets.SUPABASE_ANON_KEY }}

package/templates/workspace/.github/workflows/stil-preview.yml

@@ -0,0 +1,29 @@
+# Stil Preview — Storybook preview deployment for design system PRs
+name: Stil Preview
+
+on:
+  pull_request:
+    paths:
+      - '.stil/**'
+
+jobs:
+  preview:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build Storybook
+        run: npm run build-storybook
+
+      - name: Upload Storybook Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: storybook-preview
+          path: storybook-static/

package/templates/workspace/.stil/tokens/config/mapping.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://stil.dev/schemas/mapping.json",
+  "version": "1.0",
+  "tokens": {
+    "collections": [],
+    "excludePatterns": []
+  },
+  "components": {
+    "mappings": [],
+    "excludePatterns": []
+  },
+  "text": {
+    "locales": ["en"],
+    "excludePatterns": []
+  }
+}