@calibrate-ds/core 0.1.0

package/dist/bootstrap/generate-library-files.js

@@ -0,0 +1,97 @@
+/**
+ * Generates a minimal, clean, professional library foundation plan.
+ * This structure is extremely brownfield-safe and agnostic to app frameworks.
+ */
+export function generateLibraryFiles() {
+    const plan = {
+        directories: [
+            "packages/ui",
+            "packages/ui/src",
+            "packages/ui/src/components",
+            "packages/ui/src/tokens"
+        ],
+        files: [
+            {
+                filePath: "packages/ui/src/index.ts",
+                content: `// ----------------------------------------------------------------------------
+// ptb auto-generated design system export barrel
+// ----------------------------------------------------------------------------
+
+export * from "./components";
+export * from "./tokens";
+import "./tokens/tokens.css";
+`
+            },
+            {
+                filePath: "packages/ui/src/components/index.ts",
+                content: `// Export UI components here.
+// e.g. export * from "./Button";
+`
+            },
+            {
+                filePath: "packages/ui/src/tokens/index.ts",
+                content: `// Export Design Tokens here.
+// e.g. export * from "./Colors";
+`
+            },
+            {
+                filePath: "packages/ui/package.json",
+                content: `{
+  "name": "design-system",
+  "version": "0.1.0",
+  "description": "Library Foundation generated by Calibrate",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/react": "^18.2.0"
+  }
+}
+`
+            },
+            {
+                filePath: "packages/ui/tsconfig.json",
+                content: `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "dist",
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}
+`
+            },
+            {
+                filePath: "packages/ui/README.md",
+                content: `# Design System Library
+
+This lightweight component library core was successfully initialized by [Calibrate](https://prompt-to-both.dev).
+
+## Architecture
+
+- \`src/components\`: UI building blocks mapped to Figma prototypes.
+- \`src/tokens\`: Theme variables and foundational typography/color schemas.
+- \`src/index.ts\`: Main entry point exporter for your consuming applications.
+
+## Workflows
+Run \`ptb scan\` and \`ptb scaffold\` to synchronize your Figma file components directly into this repository cleanly.
+`
+            }
+        ]
+    };
+    return plan;
+}
+//# sourceMappingURL=generate-library-files.js.map

package/dist/bootstrap/generate-library-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-library-files.js","sourceRoot":"","sources":["../../src/bootstrap/generate-library-files.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,IAAI,GAAyB;QACjC,WAAW,EAAE;YACX,aAAa;YACb,iBAAiB;YACjB,4BAA4B;YAC5B,wBAAwB;SACzB;QACD,KAAK,EAAE;YACL;gBACE,QAAQ,EAAE,0BAA0B;gBACpC,OAAO,EAAE;;;;;;;CAOhB;aACM;YACD;gBACE,QAAQ,EAAE,qCAAqC;gBAC/C,OAAO,EAAE;;CAEhB;aACM;YACD;gBACE,QAAQ,EAAE,iCAAiC;gBAC3C,OAAO,EAAE;;CAEhB;aACM;YACD;gBACE,QAAQ,EAAE,0BAA0B;gBACpC,OAAO,EAAE;;;;;;;;;;;;;;;;;CAiBhB;aACM;YACD;gBACE,QAAQ,EAAE,2BAA2B;gBACrC,OAAO,EAAE;;;;;;;;;;;;;;;CAehB;aACM;YACD;gBACE,QAAQ,EAAE,uBAAuB;gBACjC,OAAO,EAAE;;;;;;;;;;;;CAYhB;aACM;SACF;KACF,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/bootstrap/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./generate-library-files.js";
+export * from "./write-library-bootstrap.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bootstrap/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC"}

package/dist/bootstrap/index.js

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./generate-library-files.js";
+export * from "./write-library-bootstrap.js";
+//# sourceMappingURL=index.js.map

package/dist/bootstrap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bootstrap/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC"}

package/dist/bootstrap/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Represents a single file to be written during bootstrapping.
+ */
+export interface BootstrapFilePlan {
+    /** Relative path from the project root */
+    filePath: string;
+    /** Complete file content */
+    content: string;
+}
+/**
+ * Represents the complete plan for bootstrapping a library foundation.
+ */
+export interface LibraryBootstrapPlan {
+    /** Relative directory paths from the project root */
+    directories: string[];
+    /** Files to write */
+    files: BootstrapFilePlan[];
+}
+/**
+ * Result of the bootstrap write operation.
+ */
+export interface BootstrapWriteResult {
+    createdDirectories: string[];
+    createdFiles: string[];
+    skippedFiles: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bootstrap/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,qDAAqD;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qBAAqB;IACrB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/bootstrap/types.js

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

package/dist/bootstrap/types.js.map

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

package/dist/bootstrap/write-library-bootstrap.d.ts

@@ -0,0 +1,7 @@
+import type { LibraryBootstrapPlan, BootstrapWriteResult } from "./types.js";
+/**
+ * Safely writes the library foundation to physical disk.
+ * Skips existing files to remain 100% brownfield safe.
+ */
+export declare function writeLibraryBootstrap(rootDir: string, plan: LibraryBootstrapPlan): Promise<BootstrapWriteResult>;
+//# sourceMappingURL=write-library-bootstrap.d.ts.map

package/dist/bootstrap/write-library-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-library-bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap/write-library-bootstrap.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE7E;;;GAGG;AACH,wBAAsB,qBAAqB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAgC/B"}

package/dist/bootstrap/write-library-bootstrap.js

@@ -0,0 +1,35 @@
+import * as path from "node:path";
+import { ensureDir, writeText } from "../filesystem/index.js";
+/**
+ * Safely writes the library foundation to physical disk.
+ * Skips existing files to remain 100% brownfield safe.
+ */
+export async function writeLibraryBootstrap(rootDir, plan) {
+    const result = {
+        createdDirectories: [],
+        createdFiles: [],
+        skippedFiles: []
+    };
+    // 1. Ensure all directories exist
+    for (const dir of plan.directories) {
+        const absPath = path.resolve(rootDir, dir);
+        await ensureDir(absPath);
+        result.createdDirectories.push(dir);
+    }
+    // 2. Write files safely
+    for (const file of plan.files) {
+        const absPath = path.resolve(rootDir, file.filePath);
+        // We intentionally never overwrite during a bootstrap init phase.
+        const wasWritten = await writeText(absPath, file.content, { overwrite: false });
+        if (wasWritten) {
+            result.createdFiles.push(file.filePath);
+        }
+        else {
+            result.skippedFiles.push(file.filePath);
+        }
+    }
+    // Optional: dedup logic here if your directories array contained duplicates.
+    result.createdDirectories = Array.from(new Set(result.createdDirectories));
+    return result;
+}
+//# sourceMappingURL=write-library-bootstrap.js.map

package/dist/bootstrap/write-library-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-library-bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap/write-library-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,OAAe,EACf,IAA0B;IAE1B,MAAM,MAAM,GAAyB;QACjC,kBAAkB,EAAE,EAAE;QACtB,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE;KACnB,CAAC;IAEF,kCAAkC;IAClC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,wBAAwB;IACxB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAErD,kEAAkE;QAClE,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhF,IAAI,UAAU,EAAE,CAAC;YACb,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,kBAAkB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAE3E,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/config/config-schema.d.ts

@@ -0,0 +1,131 @@
+import { z } from "zod";
+/** @deprecated — kept for schema migration only */
+export declare const FigmaConfigSchema: z.ZodObject<{
+    fileKey: z.ZodString;
+    accessTokenEnv: z.ZodString;
+}, z.core.$strip>;
+export declare const OutputConfigSchema: z.ZodObject<{
+    componentsDir: z.ZodString;
+    tokensDir: z.ZodString;
+    metadataDir: z.ZodString;
+}, z.core.$strip>;
+export declare const FrameworkConfigSchema: z.ZodObject<{
+    name: z.ZodDefault<z.ZodString>;
+    typescript: z.ZodBoolean;
+    styling: z.ZodEnum<{
+        unstyled: "unstyled";
+        tailwind: "tailwind";
+        "css-modules": "css-modules";
+    }>;
+}, z.core.$strip>;
+export declare const GenerationConfigSchema: z.ZodObject<{
+    stories: z.ZodBoolean;
+    tests: z.ZodBoolean;
+    types: z.ZodBoolean;
+    indexFiles: z.ZodBoolean;
+    cssFiles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export declare const NamingConfigSchema: z.ZodObject<{
+    componentCase: z.ZodDefault<z.ZodEnum<{
+        PascalCase: "PascalCase";
+        "kebab-case": "kebab-case";
+        camelCase: "camelCase";
+    }>>;
+    folderCase: z.ZodDefault<z.ZodEnum<{
+        PascalCase: "PascalCase";
+        "kebab-case": "kebab-case";
+        camelCase: "camelCase";
+    }>>;
+    tokenCase: z.ZodDefault<z.ZodEnum<{
+        "kebab-case": "kebab-case";
+        camelCase: "camelCase";
+    }>>;
+}, z.core.$strip>;
+export declare const ClassificationConfigSchema: z.ZodObject<{
+    treatComponentSetsAsCanonical: z.ZodBoolean;
+    treatStandaloneComponentsAsCanonical: z.ZodBoolean;
+    treatNestedInstancesAsReferences: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const AIConfigSchema: z.ZodPipe<z.ZodTransform<any, any>, z.ZodObject<{
+    active: z.ZodString;
+    providers: z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        accessTokenEnv: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+export declare const DocsConfigSchema: z.ZodObject<{
+    tool: z.ZodEnum<{
+        storybook: "storybook";
+        docusaurus: "docusaurus";
+        none: "none";
+    }>;
+}, z.core.$strip>;
+export declare const PTBConfigSchema: z.ZodPipe<z.ZodTransform<any, any>, z.ZodObject<{
+    designTool: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        provider: z.ZodLiteral<"figma">;
+        fileKey: z.ZodString;
+        accessTokenEnv: z.ZodString;
+    }, z.core.$strip>], "provider">;
+    project: z.ZodObject<{
+        rootDir: z.ZodString;
+    }, z.core.$strip>;
+    output: z.ZodObject<{
+        componentsDir: z.ZodString;
+        tokensDir: z.ZodString;
+        metadataDir: z.ZodString;
+    }, z.core.$strip>;
+    framework: z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        typescript: z.ZodBoolean;
+        styling: z.ZodEnum<{
+            unstyled: "unstyled";
+            tailwind: "tailwind";
+            "css-modules": "css-modules";
+        }>;
+    }, z.core.$strip>;
+    generation: z.ZodObject<{
+        stories: z.ZodBoolean;
+        tests: z.ZodBoolean;
+        types: z.ZodBoolean;
+        indexFiles: z.ZodBoolean;
+        cssFiles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>;
+    naming: z.ZodObject<{
+        componentCase: z.ZodDefault<z.ZodEnum<{
+            PascalCase: "PascalCase";
+            "kebab-case": "kebab-case";
+            camelCase: "camelCase";
+        }>>;
+        folderCase: z.ZodDefault<z.ZodEnum<{
+            PascalCase: "PascalCase";
+            "kebab-case": "kebab-case";
+            camelCase: "camelCase";
+        }>>;
+        tokenCase: z.ZodDefault<z.ZodEnum<{
+            "kebab-case": "kebab-case";
+            camelCase: "camelCase";
+        }>>;
+    }, z.core.$strip>;
+    classification: z.ZodObject<{
+        treatComponentSetsAsCanonical: z.ZodBoolean;
+        treatStandaloneComponentsAsCanonical: z.ZodBoolean;
+        treatNestedInstancesAsReferences: z.ZodBoolean;
+    }, z.core.$strip>;
+    ai: z.ZodOptional<z.ZodPipe<z.ZodTransform<any, any>, z.ZodObject<{
+        active: z.ZodString;
+        providers: z.ZodRecord<z.ZodString, z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+            accessTokenEnv: z.ZodOptional<z.ZodString>;
+            baseUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    docs: z.ZodOptional<z.ZodObject<{
+        tool: z.ZodEnum<{
+            storybook: "storybook";
+            docusaurus: "docusaurus";
+            none: "none";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/config/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/config/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,mDAAmD;AACnD,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAaH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;iBAIhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;iBAMjC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;iBAI7B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAC;AAQH,eAAO,MAAM,cAAc;;;;;;;kBAuB1B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;iBAE3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsBI,CAAC"}

package/dist/config/config-schema.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+// Extracted Zod schemas for validation that map purely to our type definitions
+/** @deprecated — kept for schema migration only */
+export const FigmaConfigSchema = z.object({
+    fileKey: z.string(),
+    accessTokenEnv: z.string()
+});
+const FigmaDesignToolConfigSchema = z.object({
+    provider: z.literal("figma"),
+    fileKey: z.string(),
+    accessTokenEnv: z.string(),
+});
+// Union grows as new adapters are added (e.g. PenpotDesignToolConfigSchema)
+const DesignToolConfigSchema = z.discriminatedUnion("provider", [
+    FigmaDesignToolConfigSchema,
+]);
+export const OutputConfigSchema = z.object({
+    componentsDir: z.string(),
+    tokensDir: z.string(),
+    metadataDir: z.string()
+});
+export const FrameworkConfigSchema = z.object({
+    name: z.string().default("react"),
+    typescript: z.boolean(),
+    styling: z.enum(["unstyled", "tailwind", "css-modules"])
+});
+export const GenerationConfigSchema = z.object({
+    stories: z.boolean(),
+    tests: z.boolean(),
+    types: z.boolean(),
+    indexFiles: z.boolean(),
+    cssFiles: z.boolean().optional().default(true)
+});
+export const NamingConfigSchema = z.object({
+    componentCase: z.enum(["PascalCase", "kebab-case", "camelCase"]).default("PascalCase"),
+    folderCase: z.enum(["PascalCase", "kebab-case", "camelCase"]).default("kebab-case"),
+    tokenCase: z.enum(["camelCase", "kebab-case"]).default("camelCase")
+});
+export const ClassificationConfigSchema = z.object({
+    treatComponentSetsAsCanonical: z.boolean(),
+    treatStandaloneComponentsAsCanonical: z.boolean(),
+    treatNestedInstancesAsReferences: z.boolean()
+});
+const AIProviderEntrySchema = z.object({
+    model: z.string().optional(),
+    accessTokenEnv: z.string().optional(),
+    baseUrl: z.string().optional(),
+});
+export const AIConfigSchema = z.preprocess((raw) => {
+    // Migrate legacy format: { provider, model?, accessTokenEnv?, baseUrl? }
+    // to new format:         { active, providers: { [name]: { ... } } }
+    if (raw && raw.provider && !raw.providers) {
+        const { provider, model, accessTokenEnv, baseUrl } = raw;
+        return {
+            active: provider,
+            providers: {
+                [provider]: {
+                    ...(model ? { model } : {}),
+                    ...(accessTokenEnv ? { accessTokenEnv } : {}),
+                    ...(baseUrl ? { baseUrl } : {}),
+                }
+            }
+        };
+    }
+    return raw;
+}, z.object({
+    active: z.string(),
+    providers: z.record(z.string(), AIProviderEntrySchema),
+}));
+export const DocsConfigSchema = z.object({
+    tool: z.enum(["storybook", "docusaurus", "none"]),
+});
+export const PTBConfigSchema = z.preprocess((raw) => {
+    // Migrate legacy figma: {...} format to designTool: { provider: "figma", ... }
+    if (raw && raw.figma && !raw.designTool) {
+        const { figma, ...rest } = raw;
+        return { ...rest, designTool: { provider: "figma", ...figma } };
+    }
+    return raw;
+}, z.object({
+    designTool: DesignToolConfigSchema,
+    project: z.object({
+        rootDir: z.string()
+    }),
+    output: OutputConfigSchema,
+    framework: FrameworkConfigSchema,
+    generation: GenerationConfigSchema,
+    naming: NamingConfigSchema,
+    classification: ClassificationConfigSchema,
+    ai: AIConfigSchema.optional(),
+    docs: DocsConfigSchema.optional(),
+}));
+//# sourceMappingURL=config-schema.js.map

package/dist/config/config-schema.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./config-schema.js";
+export * from "./load-config.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,3 @@
+export * from "./config-schema.js";
+export * from "./load-config.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/config/load-config.d.ts

@@ -0,0 +1,7 @@
+import type { PTBConfig } from "@calibrate-ds/shared-types";
+/**
+ * Loads and validates ptb.config.json.
+ * Searches upwards from the given directory to find the configuration.
+ */
+export declare function loadConfig(cwd?: string): Promise<PTBConfig>;
+//# sourceMappingURL=load-config.d.ts.map

package/dist/config/load-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CA8DhF"}

package/dist/config/load-config.js

@@ -0,0 +1,63 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { PTBConfigSchema } from "./config-schema.js";
+/**
+ * Loads and validates ptb.config.json.
+ * Searches upwards from the given directory to find the configuration.
+ */
+export async function loadConfig(cwd = process.cwd()) {
+    let current = path.resolve(cwd);
+    let configPath;
+    while (true) {
+        const potentialPath = path.join(current, "ptb.config.json");
+        try {
+            await fs.access(potentialPath);
+            configPath = potentialPath;
+            break;
+        }
+        catch {
+            const parent = path.dirname(current);
+            if (parent === current)
+                break;
+            current = parent;
+        }
+    }
+    if (!configPath) {
+        throw new Error(`Config file 'ptb.config.json' not found in ${cwd} or any parent directory.`);
+    }
+    let rawConfig;
+    try {
+        rawConfig = await fs.readFile(configPath, "utf-8");
+    }
+    catch (error) {
+        throw new Error(`Failed to read config file at ${configPath}: ${error?.message || String(error)}`);
+    }
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(rawConfig);
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON in config file at ${configPath}: ${error?.message || String(error)}`);
+    }
+    const validationResult = PTBConfigSchema.safeParse(parsedJson);
+    if (!validationResult.success) {
+        const issues = validationResult.error.issues
+            .map((issue) => `- ${issue.path.join(".")}: ${issue.message}`)
+            .join("\n");
+        throw new Error(`Invalid configuration in ${configPath}:\n${issues}`);
+    }
+    const config = validationResult.data;
+    // Ensure rootDir is absolute, relative to the config file location
+    config.project.rootDir = path.resolve(path.dirname(configPath), config.project.rootDir);
+    // Warn if the accessTokenEnv value looks like a raw token rather than an env var name.
+    // Env var names are SCREAMING_SNAKE_CASE; a raw token will fail that check.
+    const envVarName = config.designTool.accessTokenEnv;
+    const looksLikeEnvVar = /^[A-Z][A-Z0-9_]*$/.test(envVarName);
+    if (!looksLikeEnvVar) {
+        console.warn(`\x1b[33m⚠\x1b[0m  Security warning: 'designTool.accessTokenEnv' in ptb.config.json looks like a raw token, not an environment variable name.\n` +
+            `   Set it to the NAME of the env var (e.g. "FIGMA_ACCESS_TOKEN"), not the token value itself.\n` +
+            `   Storing secrets in config files risks accidental exposure.`);
+    }
+    return config;
+}
+//# sourceMappingURL=load-config.js.map

package/dist/config/load-config.js.map

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

package/dist/context/compressed-context.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentDefinition, ComponentContext, CompressedContext, TokenCollection } from "@calibrate-ds/shared-types";
+export declare function buildCompressedContext(component: ComponentDefinition, context: ComponentContext, collections?: TokenCollection[]): CompressedContext | undefined;
+//# sourceMappingURL=compressed-context.d.ts.map

package/dist/context/compressed-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressed-context.d.ts","sourceRoot":"","sources":["../../src/context/compressed-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAqC,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG/J,wBAAgB,sBAAsB,CAClC,SAAS,EAAE,mBAAmB,EAC9B,OAAO,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,eAAe,EAAE,GAChC,iBAAiB,GAAG,SAAS,CAgJ/B"}