@nebutra/design-sync 0.1.0 → 0.1.1

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function run(argv?: string[]): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAoGA,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDxE"}

package/dist/cli/index.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+// =============================================================================
+// design-sync CLI
+// =============================================================================
+// Commands:
+//   design-sync detect        Print the resolved provider + env diagnostics
+//   design-sync healthcheck   Run the provider's healthcheck()
+//   design-sync pull          Pull design-tool → repo (DTCG JSON)
+//   design-sync push          Push repo → design-tool (defaults to dry-run)
+//
+// Flags:
+//   --dry-run        Force dry-run on push
+//   --themes a,b     Restrict to specific token sets / themes
+//   --provider X     Override DESIGN_SYNC_PROVIDER for this invocation
+//   --json           Emit machine-readable JSON instead of human text
+// =============================================================================
+import { describeEnv } from "../detect";
+import { createDesignSync } from "../factory";
+function parseArgs(argv) {
+    const [, , command = "help", ...rest] = argv;
+    let dryRun = false;
+    let json = false;
+    const themes = [];
+    let provider;
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        if (arg === "--dry-run")
+            dryRun = true;
+        else if (arg === "--json")
+            json = true;
+        else if (arg === "--themes") {
+            const next = rest[i + 1];
+            if (next) {
+                for (const t of next.split(",")) {
+                    const trimmed = t.trim();
+                    if (trimmed)
+                        themes.push(trimmed);
+                }
+                i++;
+            }
+        }
+        else if (arg === "--provider") {
+            const next = rest[i + 1];
+            if (next) {
+                provider = next.trim();
+                i++;
+            }
+        }
+    }
+    return { command, dryRun, json, themes, provider };
+}
+function emit(payload, json) {
+    if (json) {
+        process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+        return;
+    }
+    if (typeof payload === "string") {
+        process.stdout.write(`${payload}\n`);
+        return;
+    }
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+}
+function emitError(message, json) {
+    if (json) {
+        process.stderr.write(`${JSON.stringify({ ok: false, error: message })}\n`);
+    }
+    else {
+        process.stderr.write(`error: ${message}\n`);
+    }
+}
+const HELP_TEXT = `design-sync — provider-agnostic design-tool sync
+
+Usage:
+  design-sync <command> [options]
+
+Commands:
+  detect            Print the resolved provider + env diagnostics
+  healthcheck       Run the provider's healthcheck()
+  pull              Pull design-tool → repo (DTCG JSON)
+  push              Push repo → design-tool (defaults to dry-run on figma/penpot)
+  help              Show this message
+
+Options:
+  --provider <X>    Override provider (figma|penpot|git-only|memory)
+  --themes a,b      Restrict to specific token sets
+  --dry-run         Force dry-run on push
+  --json            Emit machine-readable JSON
+`;
+export async function run(argv = process.argv) {
+    const args = parseArgs(argv);
+    if (args.command === "help" || args.command === "--help" || args.command === "-h") {
+        process.stdout.write(HELP_TEXT);
+        return 0;
+    }
+    if (args.command === "detect") {
+        const env = describeEnv();
+        emit(env, args.json);
+        return 0;
+    }
+    try {
+        const provider = await createDesignSync(args.provider ? { provider: args.provider } : undefined);
+        if (args.command === "healthcheck") {
+            const status = await provider.healthcheck();
+            emit(status, args.json);
+            return status.ok ? 0 : 1;
+        }
+        if (args.command === "pull") {
+            const themes = args.themes.length > 0 ? { themes: args.themes } : {};
+            const result = await provider.pull(themes);
+            emit(args.json
+                ? result
+                : `${result.summary} (provider=${result.provider}, sets=${result.sets.length})`, args.json);
+            return 0;
+        }
+        if (args.command === "push") {
+            const opts = {};
+            if (args.themes.length > 0)
+                opts.themes = args.themes;
+            if (args.dryRun)
+                opts.dryRun = true;
+            const result = await provider.push(opts);
+            emit(args.json
+                ? result
+                : `${result.summary} (provider=${result.provider}, dryRun=${result.dryRun})`, args.json);
+            return 0;
+        }
+        emitError(`unknown command: ${args.command}\n\n${HELP_TEXT}`, args.json);
+        return 2;
+    }
+    catch (error) {
+        emitError(error.message, args.json);
+        return 1;
+    }
+}
+// Run when invoked directly (not when imported in tests).
+//
+// We treat any of the following as "invoked as CLI":
+//   - argv[1] basename matches `design-sync` (the bin entry)
+//   - argv[1] basename matches the source/dist filename (`index.ts`, `index.js`)
+//   - argv[1] is missing (e.g. `node --eval` style runners)
+//   - DESIGN_SYNC_CLI env flag is set (escape hatch for unusual runners)
+const invokedFromCli = (() => {
+    if (typeof process === "undefined")
+        return false;
+    if (process.env?.DESIGN_SYNC_CLI === "1")
+        return true;
+    const entry = Array.isArray(process.argv) ? process.argv[1] : undefined;
+    if (!entry)
+        return false;
+    const base = entry.split("/").pop() ?? entry;
+    return /^(design-sync|index\.(c|m)?[jt]sx?)$/u.test(base);
+})();
+if (invokedFromCli) {
+    run().then((code) => {
+        process.exit(code);
+    }, (error) => {
+        process.stderr.write(`fatal: ${error.message}\n`);
+        process.exit(1);
+    });
+}

package/dist/detect.d.ts

@@ -0,0 +1,21 @@
+import type { DesignSyncProviderType } from "./types";
+/**
+ * Read `DESIGN_SYNC_PROVIDER` from the environment, validate it, and return
+ * the typed value if it matches a known provider.
+ */
+export declare function readConfiguredProvider(env?: NodeJS.ProcessEnv): DesignSyncProviderType | undefined;
+/**
+ * Detect the provider from a snapshot of environment variables.
+ * Pure function — does NOT touch `process.env` directly so it is unit-testable.
+ */
+export declare function detectProvider(env?: NodeJS.ProcessEnv): DesignSyncProviderType;
+/**
+ * For diagnostics: return which env vars were detected and which are missing
+ * for each provider. Used by `healthcheck()` and the `detect` CLI command.
+ */
+export declare function describeEnv(env?: NodeJS.ProcessEnv): {
+    detected: string[];
+    missing: string[];
+    resolved: DesignSyncProviderType;
+};
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAsBtD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,GAAG,SAAS,CAOpC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,sBAAsB,CAa3F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,sBAAsB,CAAC;CAClC,CA0BA"}

package/dist/detect.js

@@ -0,0 +1,79 @@
+// =============================================================================
+// Provider Auto-Detection
+// =============================================================================
+// Resolution order (highest priority first):
+//   1. DESIGN_SYNC_PROVIDER env var (explicit)
+//   2. FIGMA_PERSONAL_ACCESS_TOKEN + FIGMA_FILE_ID  → "figma"
+//   3. PENPOT_API_URL + PENPOT_TOKEN                → "penpot"
+//   4. fallback                                      → "git-only"
+//
+// `memory` is never auto-detected; it must be requested explicitly via the
+// DESIGN_SYNC_PROVIDER env var or a config object (used in tests).
+// =============================================================================
+const VALID_PROVIDERS = new Set([
+    "figma",
+    "penpot",
+    "git-only",
+    "memory",
+]);
+/**
+ * Read `DESIGN_SYNC_PROVIDER` from the environment, validate it, and return
+ * the typed value if it matches a known provider.
+ */
+export function readConfiguredProvider(env = process.env) {
+    const raw = env.DESIGN_SYNC_PROVIDER?.trim();
+    if (!raw)
+        return undefined;
+    if (!VALID_PROVIDERS.has(raw)) {
+        return undefined;
+    }
+    return raw;
+}
+/**
+ * Detect the provider from a snapshot of environment variables.
+ * Pure function — does NOT touch `process.env` directly so it is unit-testable.
+ */
+export function detectProvider(env = process.env) {
+    const explicit = readConfiguredProvider(env);
+    if (explicit)
+        return explicit;
+    const figmaToken = env.FIGMA_PERSONAL_ACCESS_TOKEN?.trim();
+    const figmaFileId = env.FIGMA_FILE_ID?.trim();
+    if (figmaToken && figmaFileId)
+        return "figma";
+    const penpotUrl = env.PENPOT_API_URL?.trim();
+    const penpotToken = env.PENPOT_TOKEN?.trim();
+    if (penpotUrl && penpotToken)
+        return "penpot";
+    return "git-only";
+}
+/**
+ * For diagnostics: return which env vars were detected and which are missing
+ * for each provider. Used by `healthcheck()` and the `detect` CLI command.
+ */
+export function describeEnv(env = process.env) {
+    const detected = [];
+    const missing = [];
+    const known = [
+        "DESIGN_SYNC_PROVIDER",
+        "FIGMA_PERSONAL_ACCESS_TOKEN",
+        "FIGMA_FILE_ID",
+        "FIGMA_GITHUB_REPO",
+        "FIGMA_GITHUB_BRANCH",
+        "PENPOT_API_URL",
+        "PENPOT_TOKEN",
+        "PENPOT_FILE_ID",
+        "PENPOT_TEAM_ID",
+    ];
+    for (const key of known) {
+        if (env[key]?.trim())
+            detected.push(key);
+        else
+            missing.push(key);
+    }
+    return {
+        detected,
+        missing,
+        resolved: detectProvider(env),
+    };
+}

package/dist/factory.d.ts

@@ -0,0 +1,42 @@
+import type { DesignSyncConfig, DesignSyncProvider } from "./types";
+/**
+ * Create a design-sync provider instance.
+ *
+ * @example
+ * ```ts
+ * // Auto-detect from environment
+ * const sync = await createDesignSync();
+ *
+ * // Explicit Figma
+ * const sync = await createDesignSync({
+ *   provider: "figma",
+ *   personalAccessToken: process.env.FIGMA_PERSONAL_ACCESS_TOKEN,
+ *   fileId: "abc123",
+ * });
+ *
+ * // Explicit Penpot
+ * const sync = await createDesignSync({
+ *   provider: "penpot",
+ *   apiUrl: "https://design.penpot.app/api",
+ *   token: process.env.PENPOT_TOKEN,
+ * });
+ *
+ * // Explicit git-only (zero config)
+ * const sync = await createDesignSync({ provider: "git-only" });
+ * ```
+ */
+export declare function createDesignSync(config?: DesignSyncConfig): Promise<DesignSyncProvider>;
+/**
+ * Get or create the default (singleton) design-sync provider.
+ * Lazy initialisation avoids import-time side effects.
+ */
+export declare function getDesignSync(): Promise<DesignSyncProvider>;
+/**
+ * Replace the default design-sync provider (useful in tests).
+ */
+export declare function setDesignSync(provider: DesignSyncProvider): void;
+/**
+ * Reset the singleton — primarily for test isolation.
+ */
+export declare function resetDesignSync(): void;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAA0B,MAAM,SAAS,CAAC;AAe5F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiC7F;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAKjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAEhE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/factory.js

@@ -0,0 +1,89 @@
+import { logger } from "@nebutra/logger";
+import { detectProvider } from "./detect";
+// =============================================================================
+// Design-Sync Factory — Provider-agnostic creation
+// =============================================================================
+// The factory resolves the correct provider at runtime based on:
+//   1. Explicit config passed to `createDesignSync()`
+//   2. `DESIGN_SYNC_PROVIDER` environment variable
+//   3. Auto-detection from FIGMA_* / PENPOT_* env vars
+//
+// This lets customers switch design tools without changing application code.
+// =============================================================================
+let defaultProvider = null;
+/**
+ * Create a design-sync provider instance.
+ *
+ * @example
+ * ```ts
+ * // Auto-detect from environment
+ * const sync = await createDesignSync();
+ *
+ * // Explicit Figma
+ * const sync = await createDesignSync({
+ *   provider: "figma",
+ *   personalAccessToken: process.env.FIGMA_PERSONAL_ACCESS_TOKEN,
+ *   fileId: "abc123",
+ * });
+ *
+ * // Explicit Penpot
+ * const sync = await createDesignSync({
+ *   provider: "penpot",
+ *   apiUrl: "https://design.penpot.app/api",
+ *   token: process.env.PENPOT_TOKEN,
+ * });
+ *
+ * // Explicit git-only (zero config)
+ * const sync = await createDesignSync({ provider: "git-only" });
+ * ```
+ */
+export async function createDesignSync(config) {
+    const providerType = config?.provider ?? detectProvider();
+    logger.info("[design-sync] Creating provider", { provider: providerType });
+    switch (providerType) {
+        case "figma": {
+            const { FigmaProvider } = await import("./providers/figma");
+            const figmaConfig = config?.provider === "figma" ? config : undefined;
+            return new FigmaProvider(figmaConfig ?? { provider: "figma" });
+        }
+        case "penpot": {
+            const { PenpotProvider } = await import("./providers/penpot");
+            const penpotConfig = config?.provider === "penpot" ? config : undefined;
+            return new PenpotProvider(penpotConfig ?? { provider: "penpot" });
+        }
+        case "git-only": {
+            const { GitOnlyProvider } = await import("./providers/git-only");
+            const gitConfig = config?.provider === "git-only" ? config : undefined;
+            return new GitOnlyProvider(gitConfig ?? { provider: "git-only" });
+        }
+        case "memory": {
+            const { MemoryProvider } = await import("./providers/memory");
+            const memConfig = config?.provider === "memory" ? config : undefined;
+            return new MemoryProvider(memConfig ?? { provider: "memory" });
+        }
+        default:
+            throw new Error(`Unknown design-sync provider: ${providerType}`);
+    }
+}
+/**
+ * Get or create the default (singleton) design-sync provider.
+ * Lazy initialisation avoids import-time side effects.
+ */
+export async function getDesignSync() {
+    if (!defaultProvider) {
+        defaultProvider = await createDesignSync();
+    }
+    return defaultProvider;
+}
+/**
+ * Replace the default design-sync provider (useful in tests).
+ */
+export function setDesignSync(provider) {
+    defaultProvider = provider;
+}
+/**
+ * Reset the singleton — primarily for test isolation.
+ */
+export function resetDesignSync() {
+    defaultProvider = null;
+}

package/dist/figma-config/index.d.ts

@@ -0,0 +1,37 @@
+import figmaPluginConfig from "./tokens-studio.config.json";
+export declare const FIGMA_TOKENS_STUDIO_CONFIG: {
+    $schema: string;
+    name: string;
+    version: string;
+    description: string;
+    syncProvider: string;
+    git: {
+        repository: string;
+        defaultBranch: string;
+        syncBranchPrefix: string;
+        tokenPath: string;
+        themesPath: string;
+        metadataPath: string;
+    };
+    format: {
+        spec: string;
+        indent: number;
+        trailingNewline: boolean;
+        useUiCompatibleTypes: boolean;
+    };
+    storage: {
+        multiFile: boolean;
+        tokenSetSeparator: string;
+    };
+    permissions: {
+        allowDestructiveSync: boolean;
+        requirePullRequest: boolean;
+        protectedSets: string[];
+    };
+    ui: {
+        language: string;
+        showThemeMatrix: boolean;
+    };
+};
+export type FigmaTokensStudioConfig = typeof figmaPluginConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/figma-config/index.ts"],"names":[],"mappings":"AAWA,OAAO,iBAAiB,MAAM,6BAA6B,CAAuB;AAElF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAoB,CAAC;AAE5D,MAAM,MAAM,uBAAuB,GAAG,OAAO,iBAAiB,CAAC"}

package/dist/figma-config/index.js

@@ -0,0 +1,12 @@
+// =============================================================================
+// Tokens Studio config — canonical copy owned by @nebutra/design-sync
+// =============================================================================
+// The original `.tokens-studio/config.json` lives at the repo root because the
+// Tokens Studio plugin pins its config-discovery path. We keep an in-package
+// canonical copy here so the figma provider can self-document and so a sync
+// CLI can scaffold the file when initialising a fresh repo.
+//
+// If the plugin's config schema changes, update both files in lock-step.
+// =============================================================================
+import figmaPluginConfig from "./tokens-studio.config.json" with { type: "json" };
+export const FIGMA_TOKENS_STUDIO_CONFIG = figmaPluginConfig;

package/dist/figma-config/tokens-studio.config.json

@@ -0,0 +1,34 @@
+{
+    "$schema": "https://raw.githubusercontent.com/tokens-studio/figma-plugin/main/schemas/tokens-studio-config.schema.json",
+    "name": "Nebutra Design Tokens",
+    "version": "0.1.0",
+    "description": "Bidirectional sync between Tokens Studio for Figma and packages/design-tokens (W3C DTCG). Owned by @nebutra/design-sync's figma provider.",
+    "syncProvider": "github",
+    "git": {
+        "repository": "Nebutra/Nebutra-Sailor",
+        "defaultBranch": "main",
+        "syncBranchPrefix": "tokens-studio/",
+        "tokenPath": "packages/design/design-tokens/tokens",
+        "themesPath": ".tokens-studio/themes.json",
+        "metadataPath": ".tokens-studio/metadata.json"
+    },
+    "format": {
+        "spec": "dtcg",
+        "indent": 2,
+        "trailingNewline": true,
+        "useUiCompatibleTypes": true
+    },
+    "storage": {
+        "multiFile": true,
+        "tokenSetSeparator": "/"
+    },
+    "permissions": {
+        "allowDestructiveSync": false,
+        "requirePullRequest": true,
+        "protectedSets": ["core", "semantic"]
+    },
+    "ui": {
+        "language": "en",
+        "showThemeMatrix": true
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { describeEnv, detectProvider, readConfiguredProvider } from "./detect";
+export { createDesignSync, getDesignSync, resetDesignSync, setDesignSync, } from "./factory";
+export type { FigmaTokensStudioConfig } from "./figma-config/index";
+export { FIGMA_TOKENS_STUDIO_CONFIG } from "./figma-config/index";
+export { defaultTokensDir, defaultTokensStudioDir, readTokenSets, validateDtcgTree, writeTokenSet, } from "./io";
+export { FigmaProvider } from "./providers/figma";
+export { GitOnlyProvider } from "./providers/git-only";
+export { MemoryProvider } from "./providers/memory";
+export { PenpotProvider } from "./providers/penpot";
+export type { BaseProviderConfig, DesignSyncConfig, DesignSyncProvider, DesignSyncProviderType, DesignTokenLeaf, DesignTokenSet, DesignTokenTree, FigmaProviderConfig, GitOnlyProviderConfig, HealthStatus, MemoryProviderConfig, PenpotProviderConfig, PullOptions, PullResult, PushOptions, PushResult, } from "./types";
+export { DesignTokenLeafSchema } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE/E,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+// =============================================================================
+// @nebutra/design-sync — Provider-agnostic design-tool sync
+// =============================================================================
+// Supports:
+//   - Figma + Tokens Studio  (DTCG via GitHub, plugin owns the transport)
+//   - Penpot                  (REST API, self-hostable, China-friendly)
+//   - git-only                (zero-config default — DTCG files only)
+//   - memory                  (test fixture)
+//
+// Usage:
+//   import { getDesignSync } from "@nebutra/design-sync";
+//
+//   const sync = await getDesignSync();      // auto-detect provider
+//   const result = await sync.pull();        // design-tool → repo
+//   await sync.push({ dryRun: true });       // repo → design-tool
+//   await sync.healthcheck();
+// =============================================================================
+// ── Detection helpers ───────────────────────────────────────────────────────
+export { describeEnv, detectProvider, readConfiguredProvider } from "./detect";
+// ── Factory ─────────────────────────────────────────────────────────────────
+export { createDesignSync, getDesignSync, resetDesignSync, setDesignSync, } from "./factory";
+// ── Figma config snapshot ───────────────────────────────────────────────────
+export { FIGMA_TOKENS_STUDIO_CONFIG } from "./figma-config/index";
+// ── DTCG I/O helpers (re-exported for advanced consumers) ───────────────────
+export { defaultTokensDir, defaultTokensStudioDir, readTokenSets, validateDtcgTree, writeTokenSet, } from "./io";
+// ── Providers (tree-shakable direct imports) ────────────────────────────────
+export { FigmaProvider } from "./providers/figma";
+export { GitOnlyProvider } from "./providers/git-only";
+export { MemoryProvider } from "./providers/memory";
+export { PenpotProvider } from "./providers/penpot";
+// ── Types ───────────────────────────────────────────────────────────────────
+export { DesignTokenLeafSchema } from "./types";

package/dist/io.d.ts

@@ -0,0 +1,26 @@
+import { type DesignTokenSet } from "./types";
+/**
+ * Validate that every leaf in a DTCG tree carries `$value` and `$type`.
+ * Returns a list of dot-paths that violate the contract.
+ */
+export declare function validateDtcgTree(tree: unknown, pathPrefix?: string): string[];
+/**
+ * Read all DTCG token files under `tokensDir` into memory.
+ * Each file becomes one `DesignTokenSet`.
+ */
+export declare function readTokenSets(tokensDir: string): Promise<DesignTokenSet[]>;
+/**
+ * Write a `DesignTokenSet` back to disk under `tokensDir`. Creates
+ * parent directories as needed and uses 2-space indentation with a
+ * trailing newline (matches `.tokens-studio/config.json#format`).
+ */
+export declare function writeTokenSet(tokensDir: string, set: DesignTokenSet): Promise<void>;
+/**
+ * Default tokens directory for the Nebutra-Sailor monorepo.
+ */
+export declare function defaultTokensDir(cwd?: string): string;
+/**
+ * Default Tokens Studio metadata directory for the Nebutra-Sailor monorepo.
+ */
+export declare function defaultTokensStudioDir(cwd?: string): string;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,cAAc,EAAwB,MAAM,SAAS,CAAC;AAyC3F;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,SAAK,GAAG,MAAM,EAAE,CA0BzE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA8BhF;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAE1E"}