@nac3/forge-cli 0.2.0-alpha.1

package/dist/core/target.d.ts

@@ -0,0 +1,31 @@
+export type ForgeTarget = 'responsive' | 'mobile-only' | 'desktop-only';
+export declare const FORGE_TARGETS: readonly ForgeTarget[];
+/** Feature split when target is `responsive`. desktop_only +
+ *  mobile_only + shared partitions are mutually exclusive on
+ *  the source side; the scaffolder enforces it. */
+export interface FeatureSplit {
+    desktop_only: readonly string[];
+    mobile_only: readonly string[];
+    shared: readonly string[];
+}
+export interface ResolvedTarget {
+    target: ForgeTarget | null;
+    feature_split: FeatureSplit | null;
+}
+/** Read target + feature_split from yujin.forge.json. Returns
+ *  `{ target: null }` when the file is missing or the field
+ *  is absent -- the caller (Pilot) should prompt the user. */
+export declare function resolveTarget(projectRoot: string): Promise<ResolvedTarget>;
+/** Persist target + (optional) feature_split into the project
+ *  config. Preserves other fields. */
+export declare function persistTarget(projectRoot: string, target: ForgeTarget, featureSplit?: Partial<FeatureSplit>): Promise<void>;
+/** Validate that the target value is one of the canonical
+ *  three. Returns null on invalid input. */
+export declare function normaliseTarget(v: unknown): ForgeTarget | null;
+/**
+ * Human-readable description of a target, surfaced by Pilot
+ * + the manuals. Respects the dual mode (SQ 0.8): didactico
+ * + tecnico variants. The default is didactico-friendly.
+ */
+export declare function describeTarget(target: ForgeTarget, mode?: 'didactico' | 'tecnico'): string;
+//# sourceMappingURL=target.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/core/target.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,cAAc,CAAC;AACxE,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EACD,CAAC;AAEhD;;mDAEmD;AACnD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,WAAW,EAAG,SAAS,MAAM,EAAE,CAAC;IAChC,MAAM,EAAQ,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC;AAID;;8DAE8D;AAC9D,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAehF;AAED;sCACsC;AACtC,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;4CAC4C;AAC5C,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAe9D;AAYD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,GAAE,WAAW,GAAG,SAAuB,GAAG,MAAM,CAmBvG"}

package/dist/core/target.js

@@ -0,0 +1,121 @@
+/**
+ * Forge build target resolver (SQ 0.10).
+ *
+ * Target enumerates how a project is meant to be consumed:
+ *
+ *   responsive   -- web that adapts from desktop to mobile breakpoints.
+ *   mobile-only  -- React Native (Expo) single-target.
+ *   desktop-only -- Electron / web-only (no mobile breakpoints).
+ *
+ * Resolved per-project from `yujin.forge.json::target` -- there
+ * is no env or CLI override for this one because target is a
+ * structural property of the codebase, not a runtime knob.
+ *
+ * The Pilot install flow (sec 0.10) is required to ask the
+ * user for this value at first run; this module exposes the
+ * resolver + persistor + feature_split shape that callers
+ * (scaffolder, sec 0.10 test, manuals) consume.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+export const FORGE_TARGETS = ['responsive', 'mobile-only', 'desktop-only'];
+const PROJECT_CONFIG = 'yujin.forge.json';
+/** Read target + feature_split from yujin.forge.json. Returns
+ *  `{ target: null }` when the file is missing or the field
+ *  is absent -- the caller (Pilot) should prompt the user. */
+export async function resolveTarget(projectRoot) {
+    const cfgPath = path.join(projectRoot, PROJECT_CONFIG);
+    let parsed;
+    try {
+        const raw = await fs.readFile(cfgPath, 'utf-8');
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return { target: null, feature_split: null };
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        return { target: null, feature_split: null };
+    }
+    const target = normaliseTarget(parsed.target);
+    const fs2 = normaliseFeatureSplit(parsed.feature_split);
+    return { target, feature_split: fs2 };
+}
+/** Persist target + (optional) feature_split into the project
+ *  config. Preserves other fields. */
+export async function persistTarget(projectRoot, target, featureSplit) {
+    const cfgPath = path.join(projectRoot, PROJECT_CONFIG);
+    let cfg = {};
+    try {
+        const raw = await fs.readFile(cfgPath, 'utf-8');
+        cfg = JSON.parse(raw);
+        if (!cfg || typeof cfg !== 'object')
+            cfg = {};
+    }
+    catch { /* fresh */ }
+    cfg.target = target;
+    if (featureSplit !== undefined) {
+        cfg.feature_split = {
+            desktop_only: Array.isArray(featureSplit.desktop_only) ? featureSplit.desktop_only : [],
+            mobile_only: Array.isArray(featureSplit.mobile_only) ? featureSplit.mobile_only : [],
+            shared: Array.isArray(featureSplit.shared) ? featureSplit.shared : [],
+        };
+    }
+    await fs.writeFile(cfgPath, JSON.stringify(cfg, null, 2), 'utf-8');
+}
+/** Validate that the target value is one of the canonical
+ *  three. Returns null on invalid input. */
+export function normaliseTarget(v) {
+    if (typeof v !== 'string')
+        return null;
+    const lower = v.trim().toLowerCase();
+    /* Accept short aliases too. */
+    const map = {
+        'responsive': 'responsive',
+        'mobile-only': 'mobile-only',
+        'desktop-only': 'desktop-only',
+        'mobile': 'mobile-only',
+        'desktop': 'desktop-only',
+        'both': 'responsive',
+        'web': 'responsive',
+        'rn': 'mobile-only',
+    };
+    return map[lower] ?? null;
+}
+function normaliseFeatureSplit(v) {
+    if (!v || typeof v !== 'object')
+        return null;
+    const fs2 = v;
+    return {
+        desktop_only: Array.isArray(fs2.desktop_only) ? fs2.desktop_only.filter((x) => typeof x === 'string') : [],
+        mobile_only: Array.isArray(fs2.mobile_only) ? fs2.mobile_only.filter((x) => typeof x === 'string') : [],
+        shared: Array.isArray(fs2.shared) ? fs2.shared.filter((x) => typeof x === 'string') : [],
+    };
+}
+/**
+ * Human-readable description of a target, surfaced by Pilot
+ * + the manuals. Respects the dual mode (SQ 0.8): didactico
+ * + tecnico variants. The default is didactico-friendly.
+ */
+export function describeTarget(target, mode = 'didactico') {
+    if (mode === 'tecnico') {
+        switch (target) {
+            case 'responsive':
+                return 'responsive (web desktop + mobile breakpoints, Vite/Next + React Native sharing)';
+            case 'mobile-only':
+                return 'mobile-only (Expo RN single-target, no web build)';
+            case 'desktop-only':
+                return 'desktop-only (Electron or web-only, no mobile breakpoints)';
+        }
+    }
+    switch (target) {
+        case 'responsive':
+            return 'La app la va a usar la gente en su computadora Y en su celular.';
+        case 'mobile-only':
+            return 'La app la va a usar la gente solo en su celular.';
+        case 'desktop-only':
+            return 'La app la va a usar la gente solo en su computadora.';
+    }
+}
+//# sourceMappingURL=target.js.map

package/dist/core/target.js.map

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

package/dist/deploy/aws.d.ts

@@ -0,0 +1,43 @@
+export interface AwsDeployConfig {
+    region: string;
+    cluster: string;
+    service: string;
+    /** Image URI -- e.g. `123.dkr.ecr.us-east-1.amazonaws.com/myapp:tag`. */
+    image: string;
+    /** Optional task definition family override; defaults to
+     *  `<service>-task`. */
+    task_family?: string;
+}
+export interface DeployPlan {
+    cloud: 'aws';
+    config: AwsDeployConfig;
+    steps: string[];
+    /** Friendly summary surfaced in didactico mode. */
+    summary: string;
+}
+export interface DeployResult {
+    ok: boolean;
+    cloud: 'aws';
+    message: string;
+    /** Underlying SDK error if ok=false. */
+    detail?: string;
+    /** Newly published task definition ARN (when ok). */
+    task_definition_arn?: string;
+}
+/** Read aws_access_key_id + aws_secret_access_key from the
+ *  vault. Returns null when either is missing. */
+export declare function resolveAwsCredentials(): Promise<{
+    accessKeyId: string;
+    secretAccessKey: string;
+} | null>;
+/** Read deploys.aws from yujin.forge.json. */
+export declare function readDeployConfig(projectRoot: string): Promise<AwsDeployConfig | null>;
+/** Compute the plan WITHOUT making any AWS API call. */
+export declare function planDeploy(config: AwsDeployConfig): DeployPlan;
+/** Execute the plan. Lazily imports @aws-sdk/* so the build
+ *  doesn't pay the cost for users that never deploy. */
+export declare function applyDeploy(plan: DeployPlan, creds: {
+    accessKeyId: string;
+    secretAccessKey: string;
+}): Promise<DeployResult>;
+//# sourceMappingURL=aws.d.ts.map

package/dist/deploy/aws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws.d.ts","sourceRoot":"","sources":["../../src/deploy/aws.ts"],"names":[],"mappings":"AAgCA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAQ,MAAM,CAAC;IACrB,OAAO,EAAO,MAAM,CAAC;IACrB,OAAO,EAAO,MAAM,CAAC;IACrB,yEAAyE;IACzE,KAAK,EAAS,MAAM,CAAC;IACrB;4BACwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;kDACkD;AAClD,wBAAsB,qBAAqB,IAAI,OAAO,CAAC;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,IAAI,CAAC,CAaR;AAED,8CAA8C;AAC9C,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAgB3F;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,UAAU,CAgB9D;AAED;wDACwD;AACxD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC,YAAY,CAAC,CAwFvB"}

package/dist/deploy/aws.js

@@ -0,0 +1,173 @@
+/**
+ * AWS deploy reference (PLAN #2 -- shipping module).
+ *
+ * Built-in. Other clouds (GCP/Azure/Fly/Render/Vercel) are
+ * NOT built-in: when the user asks `yf deploy <other>`, Forge
+ * constructs the plugin live with them in a chat session
+ * + saves it to `plugins/deploy/<cloud>.ts` of their repo.
+ *
+ * This module is the canonical example. Pattern:
+ *
+ *   - resolveCredentials(): pull aws_access_key_id +
+ *     aws_secret_access_key from the vault.
+ *   - readDeployConfig(): read `yujin.forge.json::deploys.aws`.
+ *   - planDeploy(): assemble a Plan describing what will
+ *     happen (does NOT make any API call).
+ *   - applyDeploy(plan): execute the plan via AWS SDK.
+ *
+ * The plan/apply split is what Forge uses to surface diffs
+ * to the user in tecnico mode + auto-confirm in didactico.
+ *
+ * Coverage in v1: ECS Fargate `update-service` (rolling
+ * deploy to an existing service). Provisioning (create
+ * cluster, register task definition for the first time) is
+ * left to the user's GCP/Azure plugins or future iteration.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { Vault } from '../vault/store.js';
+import { configDir } from '../license/index.js';
+/** Read aws_access_key_id + aws_secret_access_key from the
+ *  vault. Returns null when either is missing. */
+export async function resolveAwsCredentials() {
+    try {
+        const vault = await Vault.open({ configDir: configDir() });
+        if (!vault.has('aws_access_key_id') || !vault.has('aws_secret_access_key')) {
+            return null;
+        }
+        return {
+            accessKeyId: vault.get('aws_access_key_id'),
+            secretAccessKey: vault.get('aws_secret_access_key'),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Read deploys.aws from yujin.forge.json. */
+export async function readDeployConfig(projectRoot) {
+    const cfgPath = path.join(projectRoot, 'yujin.forge.json');
+    try {
+        const raw = await fs.readFile(cfgPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const aws = parsed.deploys?.aws;
+        if (!aws)
+            return null;
+        if (typeof aws.region !== 'string' || typeof aws.cluster !== 'string'
+            || typeof aws.service !== 'string' || typeof aws.image !== 'string') {
+            throw new Error('yujin.forge.json::deploys.aws missing region/cluster/service/image');
+        }
+        return aws;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+/** Compute the plan WITHOUT making any AWS API call. */
+export function planDeploy(config) {
+    const taskFamily = config.task_family ?? config.service + '-task';
+    return {
+        cloud: 'aws',
+        config,
+        steps: [
+            'Describe current task definition for family ' + taskFamily,
+            'Register a new revision with image ' + config.image,
+            'Update service ' + config.service + ' on cluster ' + config.cluster + ' to the new task def',
+            'Wait until the service stabilises (or timeout 5 min)',
+        ],
+        summary: 'Voy a desplegar la imagen ' + config.image + ' en ECS Fargate '
+            + '(cluster ' + config.cluster + ', servicio ' + config.service + ', region ' + config.region + '). '
+            + 'Es un rolling update: ECS levanta nuevos tasks con la imagen nueva y va dando de baja los viejos.',
+    };
+}
+/** Execute the plan. Lazily imports @aws-sdk/* so the build
+ *  doesn't pay the cost for users that never deploy. */
+export async function applyDeploy(plan, creds) {
+    const { ECSClient, DescribeTaskDefinitionCommand, RegisterTaskDefinitionCommand, UpdateServiceCommand, DescribeServicesCommand } = await import('@aws-sdk/client-ecs');
+    const client = new ECSClient({
+        region: plan.config.region,
+        credentials: {
+            accessKeyId: creds.accessKeyId,
+            secretAccessKey: creds.secretAccessKey,
+        },
+    });
+    const taskFamily = plan.config.task_family ?? plan.config.service + '-task';
+    try {
+        /* Step 1: pull the current task def. */
+        const current = await client.send(new DescribeTaskDefinitionCommand({
+            taskDefinition: taskFamily,
+        }));
+        const def = current.taskDefinition;
+        if (!def) {
+            return { ok: false, cloud: 'aws',
+                message: 'no task definition found for family ' + taskFamily };
+        }
+        /* Step 2: register a new revision with the new image.
+           Mutate `containerDefinitions[*].image` -- assume the
+           FIRST container is the app (Forge convention). The
+           user can override via deploys.aws.container_name in
+           a future iteration. */
+        const containers = (def.containerDefinitions ?? []).map((c, i) => ({
+            ...c,
+            image: i === 0 ? plan.config.image : c.image,
+        }));
+        const register = await client.send(new RegisterTaskDefinitionCommand({
+            family: taskFamily,
+            containerDefinitions: containers,
+            cpu: def.cpu,
+            memory: def.memory,
+            networkMode: def.networkMode,
+            requiresCompatibilities: def.requiresCompatibilities,
+            executionRoleArn: def.executionRoleArn,
+            taskRoleArn: def.taskRoleArn,
+            runtimePlatform: def.runtimePlatform,
+            volumes: def.volumes,
+        }));
+        const newArn = register.taskDefinition?.taskDefinitionArn;
+        if (!newArn) {
+            return { ok: false, cloud: 'aws',
+                message: 'register-task-definition returned no ARN' };
+        }
+        /* Step 3: update service to point to the new revision. */
+        await client.send(new UpdateServiceCommand({
+            cluster: plan.config.cluster,
+            service: plan.config.service,
+            taskDefinition: newArn,
+            forceNewDeployment: true,
+        }));
+        /* Step 4: poll service status until stable (or 5 min). */
+        const deadline = Date.now() + 5 * 60 * 1000;
+        let lastEvent = '';
+        while (Date.now() < deadline) {
+            await new Promise((r) => setTimeout(r, 5000));
+            const sv = await client.send(new DescribeServicesCommand({
+                cluster: plan.config.cluster,
+                services: [plan.config.service],
+            }));
+            const s = sv.services?.[0];
+            if (!s)
+                break;
+            if ((s.deployments ?? []).length === 1
+                && (s.runningCount ?? 0) === (s.desiredCount ?? 0)) {
+                return { ok: true, cloud: 'aws',
+                    message: 'service stable: ' + s.runningCount + '/' + s.desiredCount + ' tasks',
+                    task_definition_arn: newArn };
+            }
+            lastEvent = (s.events?.[0]?.message ?? '') + '';
+        }
+        return { ok: false, cloud: 'aws',
+            message: 'service did not stabilise within 5 min',
+            detail: lastEvent,
+            task_definition_arn: newArn };
+    }
+    catch (err) {
+        return { ok: false, cloud: 'aws',
+            message: 'AWS SDK error',
+            detail: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=aws.js.map

package/dist/deploy/aws.js.map

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

package/dist/figma/api.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Figma REST API client (read-only file fetch).
+ *
+ * The full API surface is large; we only need the single endpoint
+ * `GET /v1/files/{file_key}` which returns the document tree +
+ * published styles table.
+ *
+ * Dependency injection: the fetcher is taken as an opt so tests can
+ * swap in a stub that returns a fixture JSON without going over the
+ * network. Production paths use the global `fetch`.
+ *
+ * Reference: https://www.figma.com/developers/api#get-files-endpoint
+ *
+ * ASCII-only.
+ */
+import type { FigmaFile } from './types.js';
+export interface FetchFileOptions {
+    fileKey: string;
+    /** Personal access token. Env var fallback: FIGMA_PERSONAL_ACCESS_TOKEN. */
+    token?: string;
+    /** Subtree depth limit; `1` returns just the top-level pages. */
+    depth?: number;
+    /** Optional injected fetcher (defaults to globalThis.fetch). */
+    fetcher?: (url: string, init: {
+        headers: Record<string, string>;
+    }) => Promise<{
+        ok: boolean;
+        status: number;
+        statusText: string;
+        json(): Promise<unknown>;
+        text(): Promise<string>;
+    }>;
+}
+export declare function fetchFigmaFile(opts: FetchFileOptions): Promise<FigmaFile>;
+//# sourceMappingURL=api.d.ts.map

package/dist/figma/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/figma/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC;QAC5E,EAAE,EAAE,OAAO,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;KACzB,CAAC,CAAC;CACJ;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CA0B/E"}

package/dist/figma/api.js

@@ -0,0 +1,40 @@
+/**
+ * Figma REST API client (read-only file fetch).
+ *
+ * The full API surface is large; we only need the single endpoint
+ * `GET /v1/files/{file_key}` which returns the document tree +
+ * published styles table.
+ *
+ * Dependency injection: the fetcher is taken as an opt so tests can
+ * swap in a stub that returns a fixture JSON without going over the
+ * network. Production paths use the global `fetch`.
+ *
+ * Reference: https://www.figma.com/developers/api#get-files-endpoint
+ *
+ * ASCII-only.
+ */
+export async function fetchFigmaFile(opts) {
+    const token = opts.token || process.env.FIGMA_PERSONAL_ACCESS_TOKEN;
+    if (!token) {
+        throw new Error('Figma personal access token missing. Set FIGMA_PERSONAL_ACCESS_TOKEN or pass --token.');
+    }
+    if (!opts.fileKey) {
+        throw new Error('Figma file_key is required.');
+    }
+    const base = 'https://api.figma.com/v1/files/' + encodeURIComponent(opts.fileKey);
+    const url = opts.depth ? base + '?depth=' + opts.depth : base;
+    const fetcher = opts.fetcher
+        || ((u, init) => globalThis.fetch(u, init));
+    const resp = await fetcher(url, { headers: { 'X-Figma-Token': token } });
+    if (!resp.ok) {
+        const body = await resp.text().catch(() => '');
+        throw new Error('Figma file fetch failed: ' + resp.status + ' ' + resp.statusText
+            + (body ? ' -- ' + body.slice(0, 240) : ''));
+    }
+    const parsed = (await resp.json());
+    if (!parsed || typeof parsed !== 'object' || !parsed.document) {
+        throw new Error('Figma file response missing `document` root.');
+    }
+    return parsed;
+}
+//# sourceMappingURL=api.js.map

package/dist/figma/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/figma/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAsB;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;IACpE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;IAC3G,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,GAAG,iCAAiC,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO;WACvB,CAAC,CAAC,CAAS,EAAE,IAAyC,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAQ,CAAC,CAAC;IAClG,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU;cAC/D,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAC5C,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAc,CAAC;IAChD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/figma/decorator.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Figma -> NAC-3 decorator. Bridge between the normalised Figma
+ * tree (src/figma/normalize.ts) and emitted, NAC-3-decorated source
+ * code (React JSX or vanilla HTML).
+ *
+ * Pipeline:
+ *   1. Build a prompt describing the page + plugin slug + the list
+ *      of NormalisedElement entries with their roles + verbs.
+ *   2. Ask Claude to emit a single JSON object containing:
+ *        - decorated source per screen (the JSX or HTML the dev
+ *          downloads),
+ *        - the NAC manifest fragment,
+ *        - the CSS file with the resolved design tokens.
+ *   3. Hand the result back to the CLI wrapper which writes the
+ *      files + invokes the same nac-bridge + register wiring the
+ *      AI HTML decorator uses.
+ *
+ * The Claude call is a single DI seam (decorator? on the opts) so
+ * tests can stub the network. Mirrors the seam already used by
+ * aiDecorateFile (G4).
+ *
+ * ASCII-only.
+ */
+import type { NormalisedFile } from './types.js';
+export type Framework = 'react' | 'html' | 'vue';
+export interface DecorateInput {
+    /** Normalised model produced by normaliseFigmaFile. */
+    file: NormalisedFile;
+    /** Output framework. Default 'react'. */
+    framework?: Framework;
+    /** Plugin slug. If unset, derived from file.source.name (slugified). */
+    pluginSlug?: string;
+    /** Override the Anthropic model id. Default 'claude-sonnet-4-6'. */
+    model?: string;
+}
+export interface DecoratedScreen {
+    slug: string;
+    /** Decorated source code (one file per screen). */
+    source: string;
+    /** Suggested basename for this screen's output file. */
+    basename: string;
+}
+export interface DecorateResult {
+    framework: Framework;
+    plugin_slug: string;
+    screens: DecoratedScreen[];
+    /** NAC manifest aggregated across all screens. JSON string. */
+    manifest_json: string;
+    /** CSS file body with --color-* and --font-* design tokens. */
+    css: string;
+    meta: {
+        model: string;
+        input_tokens: number;
+        output_tokens: number;
+        cost_usd: number;
+        latency_ms: number;
+    };
+}
+export type DecorateCaller = (args: {
+    model: string;
+    systemPrompt: string;
+    userPrompt: string;
+}) => Promise<{
+    text: string;
+    input_tokens: number;
+    output_tokens: number;
+    latency_ms: number;
+}>;
+export declare function decorateFigma(input: DecorateInput, caller?: DecorateCaller): Promise<DecorateResult>;
+declare function buildUserPrompt(file: NormalisedFile, framework: Framework, pluginSlug: string): string;
+declare function derivePluginSlug(projectName: string): string;
+export { derivePluginSlug, buildUserPrompt };
+export declare function summariseDecoration(result: DecorateResult, file: NormalisedFile): string;
+//# sourceMappingURL=decorator.d.ts.map

package/dist/figma/decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.d.ts","sourceRoot":"","sources":["../../src/figma/decorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAC;AAEnE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,IAAI,EAAE,cAAc,CAAC;IACrB,yCAAyC;IACzC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,KAAK,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAyDH,wBAAsB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAyC1G;AAED,iBAAS,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyB/F;AAED,iBAAS,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGrD;AA6CD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAI7C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAiBxF"}