@calibrate-ds/core 0.1.0

package/dist/docs/setup-storybook.js

@@ -0,0 +1,216 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+/** Walk up from dir to find a lockfile, then return the matching package manager. */
+export async function detectPackageManager(dir) {
+    let current = path.resolve(dir);
+    while (true) {
+        if (await fs.access(path.join(current, "pnpm-lock.yaml")).then(() => true).catch(() => false))
+            return "pnpm";
+        if (await fs.access(path.join(current, "yarn.lock")).then(() => true).catch(() => false))
+            return "yarn";
+        if (await fs.access(path.join(current, "package-lock.json")).then(() => true).catch(() => false))
+            return "npm";
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return "npm";
+}
+/** Check which Storybook prerequisites are satisfied in a package directory.
+ *  Walks up the directory tree so monorepos with hoisted node_modules are handled correctly. */
+export async function checkStorybookReadiness(packageRoot) {
+    // Walk up from packageRoot to find the nearest node_modules that has react / @storybook.
+    // In a monorepo, deps are hoisted to the workspace root so packages/<ui>/node_modules is empty.
+    let nodeModulesExist = false;
+    let reactInstalled = false;
+    let storybookInNm = false;
+    let current = path.resolve(packageRoot);
+    while (true) {
+        const nm = path.join(current, "node_modules");
+        const nmExists = await fs.access(nm).then(() => true).catch(() => false);
+        if (nmExists) {
+            nodeModulesExist = true;
+            if (!reactInstalled)
+                reactInstalled = await fs.access(path.join(nm, "react")).then(() => true).catch(() => false);
+            if (!storybookInNm)
+                storybookInNm =
+                    await fs.access(path.join(nm, "@storybook")).then(() => true).catch(() => false) ||
+                        await fs.access(path.join(nm, "storybook")).then(() => true).catch(() => false);
+            if (reactInstalled && storybookInNm)
+                break;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    // .storybook/main.ts|js is the definitive signal that Storybook was initialized.
+    // Trust it even if node_modules are at a different level.
+    const storybookConfigExists = await fs.access(path.join(packageRoot, ".storybook", "main.ts")).then(() => true).catch(() => false) ||
+        await fs.access(path.join(packageRoot, ".storybook", "main.js")).then(() => true).catch(() => false);
+    return { nodeModulesExist, reactInstalled, storybookInstalled: storybookConfigExists || storybookInNm };
+}
+export async function detectBundler(projectRoot) {
+    const viteConfigNames = ["vite.config.ts", "vite.config.js", "vite.config.mts"];
+    // 1. Root-level vite config
+    for (const f of viteConfigNames) {
+        if (await fs.access(path.join(projectRoot, f)).then(() => true).catch(() => false)) {
+            return "vite";
+        }
+    }
+    // 2. Root package.json direct dependency
+    const rootPkg = await fs.readFile(path.join(projectRoot, "package.json"), "utf-8")
+        .then(r => JSON.parse(r)).catch(() => ({}));
+    const rootDeps = { ...rootPkg.dependencies, ...rootPkg.devDependencies };
+    if (rootDeps["vite"])
+        return "vite";
+    // 3. Workspace packages — read workspaces globs or scan packages/*/
+    const candidates = [];
+    const workspaces = Array.isArray(rootPkg.workspaces)
+        ? rootPkg.workspaces
+        : Array.isArray(rootPkg.workspaces?.packages)
+            ? rootPkg.workspaces.packages
+            : [];
+    if (workspaces.length > 0) {
+        // Resolve each workspace glob to actual directories (one level deep)
+        for (const ws of workspaces) {
+            const base = ws.replace(/\/\*$/, "");
+            const dir = path.join(projectRoot, base);
+            const subdirs = await fs.readdir(dir).catch(() => []);
+            for (const sub of subdirs) {
+                candidates.push(path.join(dir, sub));
+            }
+        }
+    }
+    else {
+        // Fallback: scan packages/* and apps/*
+        for (const top of ["packages", "apps"]) {
+            const dir = path.join(projectRoot, top);
+            const subdirs = await fs.readdir(dir).catch(() => []);
+            for (const sub of subdirs) {
+                candidates.push(path.join(dir, sub));
+            }
+        }
+    }
+    for (const pkgDir of candidates) {
+        // vite.config.* in workspace package
+        for (const f of viteConfigNames) {
+            if (await fs.access(path.join(pkgDir, f)).then(() => true).catch(() => false)) {
+                return "vite";
+            }
+        }
+        // package.json dependency in workspace package
+        const pkgJson = await fs.readFile(path.join(pkgDir, "package.json"), "utf-8")
+            .then(r => JSON.parse(r)).catch(() => ({}));
+        const deps = { ...pkgJson.dependencies, ...pkgJson.devDependencies };
+        if (deps["vite"])
+            return "vite";
+    }
+    return "webpack";
+}
+function mainTs(bundler, storiesGlob, frameworkPkg) {
+    const framework = frameworkPkg ?? (bundler === "vite"
+        ? `@storybook/react-vite`
+        : `@storybook/react-webpack5`);
+    return `import type { StorybookConfig } from "${framework}";
+
+const config: StorybookConfig = {
+    stories: [
+        "${storiesGlob}/**/*.stories.@(js|jsx|ts|tsx)",
+        "${storiesGlob}/**/*.mdx",
+    ],
+    addons: [
+        "@storybook/addon-essentials",
+        "@storybook/addon-interactions",
+        "storybook-addon-designs",
+    ],
+    framework: {
+        name: "${framework}",
+        options: {},
+    },
+    docs: {
+        autodocs: "tag",
+    },
+};
+
+export default config;
+`;
+}
+function previewTs() {
+    return `import type { Preview } from "@storybook/react";
+
+const preview: Preview = {
+    parameters: {
+        controls: {
+            matchers: {
+                color: /(background|color)$/i,
+                date: /Date$/,
+            },
+        },
+    },
+};
+
+export default preview;
+`;
+}
+/**
+ * After `storybook@latest init`, patch only the stories glob in the generated main.ts/main.js.
+ * Avoids overwriting Storybook's auto-detected framework and builder.
+ */
+export async function patchStorybookStories(projectRoot, componentsDir) {
+    const candidates = [
+        path.join(projectRoot, ".storybook", "main.ts"),
+        path.join(projectRoot, ".storybook", "main.js"),
+    ];
+    let filePath;
+    for (const c of candidates) {
+        if (await fs.access(c).then(() => true).catch(() => false)) {
+            filePath = c;
+            break;
+        }
+    }
+    if (!filePath)
+        return false;
+    let relComponents = path.relative(projectRoot, componentsDir).replace(/\\/g, "/").replace(/\/$/, "");
+    const storiesGlob = `../${relComponents}`;
+    const content = await fs.readFile(filePath, "utf-8");
+    const patched = content.replace(/stories:\s*\[[^\]]*\]/s, `stories: [\n    "${storiesGlob}/**/*.stories.@(js|jsx|ts|tsx)",\n    "${storiesGlob}/**/*.mdx",\n  ]`);
+    if (patched === content)
+        return false;
+    await fs.writeFile(filePath, patched, "utf-8");
+    return true;
+}
+export async function setupStorybook(projectRoot, componentsDir, force = false, 
+/** Override the Storybook framework package (e.g. "@storybook/vue3-vite"). Defaults to react-vite/react-webpack5. */
+frameworkPkg) {
+    const storybookDir = path.join(projectRoot, ".storybook");
+    await fs.mkdir(storybookDir, { recursive: true });
+    const bundler = await detectBundler(projectRoot);
+    // Derive the glob root relative to .storybook/ (which is at projectRoot/.storybook)
+    // componentsDir is absolute — make it relative to projectRoot, then prefix with ..
+    let relComponents = path.relative(projectRoot, componentsDir);
+    // Normalise to forward slashes and strip trailing slash
+    relComponents = relComponents.replace(/\\/g, "/").replace(/\/$/, "");
+    const storiesGlob = `../${relComponents}`;
+    const files = [
+        { name: "main.ts", content: mainTs(bundler, storiesGlob, frameworkPkg) },
+        { name: "preview.ts", content: previewTs() },
+    ];
+    const created = [];
+    const skipped = [];
+    for (const file of files) {
+        const filePath = path.join(storybookDir, file.name);
+        const exists = await fs.access(filePath).then(() => true).catch(() => false);
+        if (exists && !force) {
+            skipped.push(`.storybook/${file.name}`);
+        }
+        else {
+            await fs.writeFile(filePath, file.content, "utf-8");
+            created.push(`.storybook/${file.name}`);
+        }
+    }
+    const installHint = `npx storybook@latest init`;
+    return { created, skipped, installHint };
+}
+//# sourceMappingURL=setup-storybook.js.map

package/dist/docs/setup-storybook.js.map

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

package/dist/doctor/check-component.d.ts

@@ -0,0 +1,5 @@
+import type { ComponentContext } from "@calibrate-ds/shared-types";
+import type { ComponentDoctorResult } from "./types.js";
+export declare function checkComponent(context: ComponentContext): ComponentDoctorResult;
+export declare function gradeComponent(score: number, maxScore: number): "healthy" | "warning" | "critical";
+//# sourceMappingURL=check-component.d.ts.map

package/dist/doctor/check-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-component.d.ts","sourceRoot":"","sources":["../../src/doctor/check-component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAe,MAAM,YAAY,CAAC;AAErE,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,qBAAqB,CA+G/E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAKlG"}

package/dist/doctor/check-component.js

@@ -0,0 +1,120 @@
+export function checkComponent(context) {
+    const issues = [];
+    // 1. Layout
+    if (context.layout) {
+        const dir = context.layout.direction ?? "unknown";
+        const gap = context.layout.gap ? `, gap: ${context.layout.gap.rawValue}px` : "";
+        issues.push({ severity: "pass", check: "layout", message: "Layout defined", suggestion: "", detail: `direction: ${dir}${gap}` });
+    }
+    else {
+        issues.push({ severity: "warning", check: "layout", message: "No Auto Layout", suggestion: "Use Auto Layout in Figma to define direction, gap, and padding — this powers the layout contract" });
+    }
+    // 2. Sizing
+    if (context.size) {
+        const w = context.size.width?.rawValue ?? "?";
+        const h = context.size.height?.rawValue ?? "?";
+        issues.push({ severity: "pass", check: "sizing", message: "Sizing defined", suggestion: "", detail: `${w} × ${h}px` });
+    }
+    else {
+        issues.push({ severity: "warning", check: "sizing", message: "No sizing defined", suggestion: "Set a fixed width/height or hug constraints on the component in Figma" });
+    }
+    // 3. Token bindings
+    const tokenCount = context.tokenBindings?.length ?? 0;
+    if (tokenCount > 0) {
+        issues.push({ severity: "pass", check: "token-bindings", message: "Token bindings present", suggestion: "", detail: `${tokenCount} token${tokenCount === 1 ? "" : "s"} bound` });
+    }
+    else {
+        issues.push({ severity: "warning", check: "token-bindings", message: "No token bindings", suggestion: "Connect fills, strokes, and spacing to Figma Variables so PTB can resolve semantic design tokens" });
+    }
+    // 4. Variant axes
+    const axisCount = context.variantAxes?.length ?? 0;
+    if (axisCount > 0) {
+        const axes = context.variantAxes.map(a => `${a.name} (${a.options.slice(0, 3).join("/")}${a.options.length > 3 ? "/…" : ""})`).join(", ");
+        issues.push({ severity: "pass", check: "variants", message: "Variant axes defined", suggestion: "", detail: axes });
+    }
+    else {
+        issues.push({ severity: "info", check: "variants", message: "No variant axes", suggestion: "Add Component Set variants in Figma to capture size, type, or state dimensions" });
+    }
+    // 5. State contract
+    if (context.stateContract) {
+        const kind = context.stateContract.controller?.kind ?? "unknown";
+        issues.push({ severity: "pass", check: "state-contract", message: "State contract present", suggestion: "", detail: `controller: ${kind}` });
+    }
+    else {
+        issues.push({ severity: "warning", check: "state-contract", message: "No state contract", suggestion: "Add prototype interactions in Figma so PTB can infer state transitions and controller logic" });
+    }
+    // 6. Prototype interactions
+    const interactionCount = context.prototypeInteractionContract?.interactions?.length ?? 0;
+    if (interactionCount > 0) {
+        issues.push({ severity: "pass", check: "interactions", message: "Prototype interactions defined", suggestion: "", detail: `${interactionCount} interaction${interactionCount === 1 ? "" : "s"}` });
+    }
+    else {
+        issues.push({ severity: "info", check: "interactions", message: "No prototype interactions", suggestion: "Wire click/hover interactions in Figma prototype mode to enrich the interaction contract" });
+    }
+    // 7. Render tree
+    if (context.renderTree) {
+        issues.push({ severity: "pass", check: "render-tree", message: "Render tree captured", suggestion: "" });
+    }
+    else {
+        issues.push({ severity: "warning", check: "render-tree", message: "No render tree", suggestion: "Ensure the component has child layers in Figma so PTB can capture its node structure" });
+    }
+    // 8. Dependencies ready
+    const missing = context.dependencies?.filter(d => d.status === "missing") ?? [];
+    const external = context.dependencies?.filter(d => d.status === "external") ?? [];
+    if (missing.length > 0) {
+        issues.push({
+            severity: "critical",
+            check: "dependencies",
+            message: `${missing.length} unmanaged dependenc${missing.length === 1 ? "y" : "ies"}`,
+            suggestion: `Run: ptb implement component ${missing.map(d => d.name).join(", ")}`,
+            detail: missing.map(d => d.name).join(", "),
+        });
+    }
+    else if (external.length > 0) {
+        issues.push({
+            severity: "info",
+            check: "dependencies",
+            message: `${external.length} external dependenc${external.length === 1 ? "y" : "ies"}`,
+            suggestion: "External dependencies are fine but won't be tracked by PTB",
+            detail: external.map(d => d.name).join(", "),
+        });
+    }
+    else {
+        const total = context.dependencies?.length ?? 0;
+        issues.push({ severity: "pass", check: "dependencies", message: "All dependencies ready", suggestion: "", detail: total ? `${total} dep${total === 1 ? "" : "s"}` : "no dependencies" });
+    }
+    // 9. Description
+    if (context.component.description) {
+        const preview = context.component.description.length > 60
+            ? context.component.description.slice(0, 60) + "…"
+            : context.component.description;
+        issues.push({ severity: "pass", check: "description", message: "Description present", suggestion: "", detail: preview });
+    }
+    else {
+        issues.push({ severity: "info", check: "description", message: "No description", suggestion: "Add a description to this component in Figma (right panel → component description)" });
+    }
+    // 10. Kind explicit
+    if (!context.component.kind.inferred) {
+        issues.push({ severity: "pass", check: "kind", message: `Kind is explicit: ${context.component.kind.value}`, suggestion: "" });
+    }
+    else {
+        issues.push({ severity: "warning", check: "kind", message: `Kind inferred as "${context.component.kind.value}"`, suggestion: "Review classification rules in ptb.config.json to confirm this component's kind" });
+    }
+    const score = issues.filter(i => i.severity === "pass").length;
+    return {
+        componentId: context.component.id,
+        componentName: context.component.name,
+        score,
+        maxScore: issues.length,
+        issues,
+    };
+}
+export function gradeComponent(score, maxScore) {
+    const ratio = score / maxScore;
+    if (ratio >= 0.9)
+        return "healthy";
+    if (ratio >= 0.6)
+        return "warning";
+    return "critical";
+}
+//# sourceMappingURL=check-component.js.map

package/dist/doctor/check-component.js.map

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

package/dist/doctor/check-config.d.ts

@@ -0,0 +1,4 @@
+import type { PTBConfig } from "@calibrate-ds/shared-types";
+import type { ConfigDoctorResult } from "./types.js";
+export declare function checkConfig(config: PTBConfig): Promise<ConfigDoctorResult>;
+//# sourceMappingURL=check-config.d.ts.map

package/dist/doctor/check-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-config.d.ts","sourceRoot":"","sources":["../../src/doctor/check-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,YAAY,CAAC;AAGlE,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8DhF"}

package/dist/doctor/check-config.js

@@ -0,0 +1,65 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { resolveDSPaths } from "../filesystem/resolve-ds-paths.js";
+export async function checkConfig(config) {
+    const issues = [];
+    // Env var present
+    const token = process.env[config.designTool.accessTokenEnv];
+    if (!token) {
+        issues.push({
+            severity: "critical",
+            check: "env-var",
+            message: `${config.designTool.accessTokenEnv} is not set`,
+            suggestion: `export ${config.designTool.accessTokenEnv}=your_figma_token`,
+        });
+    }
+    else {
+        issues.push({ severity: "pass", check: "env-var", message: `${config.designTool.accessTokenEnv} is set`, suggestion: "" });
+    }
+    // Figma file key not placeholder
+    if (!config.designTool.fileKey || config.designTool.fileKey === "YOUR_FIGMA_FILE_KEY") {
+        issues.push({
+            severity: "critical",
+            check: "file-key",
+            message: "Figma file key is still the placeholder value",
+            suggestion: "Update figma.fileKey in ptb.config.json with your actual Figma file key",
+        });
+    }
+    else {
+        issues.push({ severity: "pass", check: "file-key", message: "Figma file key configured", suggestion: "" });
+    }
+    // Snapshot freshness
+    const { metadataDir } = resolveDSPaths(config);
+    const snapshotPath = path.join(metadataDir, "latest.json");
+    let snapshotAge;
+    try {
+        const stat = await fs.stat(snapshotPath);
+        snapshotAge = Math.floor((Date.now() - stat.mtimeMs) / 86_400_000);
+        if (snapshotAge > 7) {
+            issues.push({
+                severity: "warning",
+                check: "snapshot",
+                message: `Snapshot is ${snapshotAge} days old`,
+                suggestion: "Run ptb scan to refresh your design system snapshot",
+            });
+        }
+        else {
+            issues.push({
+                severity: "pass",
+                check: "snapshot",
+                message: `Snapshot is ${snapshotAge} day${snapshotAge === 1 ? "" : "s"} old`,
+                suggestion: "",
+            });
+        }
+    }
+    catch {
+        issues.push({
+            severity: "critical",
+            check: "snapshot",
+            message: "No snapshot found — design system has not been scanned yet",
+            suggestion: "Run ptb scan to fetch and save the design system from Figma",
+        });
+    }
+    return { issues, snapshotAge };
+}
+//# sourceMappingURL=check-config.js.map

package/dist/doctor/check-config.js.map

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

package/dist/doctor/check-tokens.d.ts

@@ -0,0 +1,4 @@
+import type { DesignSystemModel } from "@calibrate-ds/shared-types";
+import type { TokenDoctorResult } from "./types.js";
+export declare function checkTokens(model: DesignSystemModel): TokenDoctorResult;
+//# sourceMappingURL=check-tokens.d.ts.map

package/dist/doctor/check-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-tokens.d.ts","sourceRoot":"","sources":["../../src/doctor/check-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAoBvE"}

package/dist/doctor/check-tokens.js

@@ -0,0 +1,17 @@
+export function checkTokens(model) {
+    const allTokens = model.tokens.flatMap(c => c.tokens);
+    const tokenIds = new Set(allTokens.map(t => t.id));
+    // Unresolved = alias pointing to a token that doesn't exist in the model
+    const unresolvedTokens = allTokens.filter(t => t.aliasTargetId && !tokenIds.has(t.aliasTargetId)).length;
+    const componentCoverage = model.components
+        .map(c => ({ componentName: c.name, bindingCount: c.tokenBindings?.length ?? 0 }))
+        .sort((a, b) => b.bindingCount - a.bindingCount);
+    return {
+        totalCollections: model.tokens.length,
+        totalTokens: allTokens.length,
+        resolvedTokens: allTokens.length - unresolvedTokens,
+        unresolvedTokens,
+        componentCoverage,
+    };
+}
+//# sourceMappingURL=check-tokens.js.map

package/dist/doctor/check-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-tokens.js","sourceRoot":"","sources":["../../src/doctor/check-tokens.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,WAAW,CAAC,KAAwB;IAChD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEnD,yEAAyE;IACzE,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,CACrC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CACzD,CAAC,MAAM,CAAC;IAET,MAAM,iBAAiB,GAAG,KAAK,CAAC,UAAU;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;SACjF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IAErD,OAAO;QACH,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QACrC,WAAW,EAAE,SAAS,CAAC,MAAM;QAC7B,cAAc,EAAE,SAAS,CAAC,MAAM,GAAG,gBAAgB;QACnD,gBAAgB;QAChB,iBAAiB;KACpB,CAAC;AACN,CAAC"}

package/dist/doctor/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./check-config.js";
+export * from "./check-component.js";
+export * from "./check-tokens.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/doctor/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/doctor/index.js

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./check-config.js";
+export * from "./check-component.js";
+export * from "./check-tokens.js";
+//# sourceMappingURL=index.js.map

package/dist/doctor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/doctor/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/doctor/types.d.ts

@@ -0,0 +1,30 @@
+export type DoctorSeverity = "critical" | "warning" | "info" | "pass";
+export type DoctorIssue = {
+    severity: DoctorSeverity;
+    check: string;
+    message: string;
+    suggestion: string;
+    detail?: string;
+};
+export type ComponentDoctorResult = {
+    componentId: string;
+    componentName: string;
+    score: number;
+    maxScore: number;
+    issues: DoctorIssue[];
+};
+export type ConfigDoctorResult = {
+    issues: DoctorIssue[];
+    snapshotAge?: number;
+};
+export type TokenDoctorResult = {
+    totalCollections: number;
+    totalTokens: number;
+    resolvedTokens: number;
+    unresolvedTokens: number;
+    componentCoverage: {
+        componentName: string;
+        bindingCount: number;
+    }[];
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/doctor/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtE,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxE,CAAC"}

package/dist/doctor/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/doctor/types.js.map

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

package/dist/filesystem/ensure-dir.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Ensures a directory and its parents exist without throwing if they already do.
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+//# sourceMappingURL=ensure-dir.d.ts.map

package/dist/filesystem/ensure-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-dir.d.ts","sourceRoot":"","sources":["../../src/filesystem/ensure-dir.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9D"}

package/dist/filesystem/ensure-dir.js

@@ -0,0 +1,17 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+/**
+ * Ensures a directory and its parents exist without throwing if they already do.
+ */
+export async function ensureDir(dirPath) {
+    try {
+        const absolutePath = path.resolve(dirPath);
+        await fs.mkdir(absolutePath, { recursive: true });
+    }
+    catch (error) {
+        if (error?.code !== "EEXIST") {
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=ensure-dir.js.map

package/dist/filesystem/ensure-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-dir.js","sourceRoot":"","sources":["../../src/filesystem/ensure-dir.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC3C,IAAI,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/filesystem/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./ensure-dir.js";
+export * from "./write-text.js";
+export * from "./write-json.js";
+export * from "./resolve-ds-paths.js";
+export * from "./resolve-component-path.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/filesystem/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC"}

package/dist/filesystem/index.js

@@ -0,0 +1,6 @@
+export * from "./ensure-dir.js";
+export * from "./write-text.js";
+export * from "./write-json.js";
+export * from "./resolve-ds-paths.js";
+export * from "./resolve-component-path.js";
+//# sourceMappingURL=index.js.map

package/dist/filesystem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/filesystem/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC"}

package/dist/filesystem/resolve-component-path.d.ts

@@ -0,0 +1,10 @@
+import { PTBConfig, ComponentDefinition } from "@calibrate-ds/shared-types";
+/**
+ * Resolves the expected filesystem path for a component's generated artifact folder.
+ */
+export declare function resolveComponentFolder(component: ComponentDefinition, config: PTBConfig): string;
+/**
+ * Resolves the expected filenames for a component's generated artifacts.
+ */
+export declare function resolveComponentFiles(component: ComponentDefinition, config: PTBConfig): string[];
+//# sourceMappingURL=resolve-component-path.d.ts.map

package/dist/filesystem/resolve-component-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-component-path.d.ts","sourceRoot":"","sources":["../../src/filesystem/resolve-component-path.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAG5E;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAchG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,CAWjG"}