@cat-factory/integrations 0.32.0 → 0.33.0

package/dist/modules/documents/zeplin.logic.d.ts

@@ -0,0 +1,102 @@
+import type { DocumentSourceDescriptor } from '@cat-factory/kernel';
+import { type DesignBlock, type DesignComponent, type DesignContext, type DesignToken } from './design.logic.js';
+/** Zeplin's REST API host. The PAT is sent to this host only — see {@link assertSafeZeplinUrl}. */
+export declare const ZEPLIN_API_HOST = "api.zeplin.dev";
+/** What the connect UI renders, and which credentials the provider needs. */
+export declare const ZEPLIN_DESCRIPTOR: DocumentSourceDescriptor;
+/**
+ * The Zeplin REST host is fixed, so any request/redirect must stay on `api.zeplin.dev`
+ * over https; a redirect off-host is treated as an SSRF attempt and rejected. Mirrors the
+ * per-hop guard the other host-pinned providers run. Kept pure so it is unit-testable
+ * without a network.
+ */
+export declare function assertSafeZeplinUrl(url: string): void;
+/**
+ * Resolve a Zeplin reference from raw user input into the stable composite external id
+ * this provider stores: `"<projectId>"` for a whole-project link, or
+ * `"<projectId>:<screenId>"` for a specific screen. Accepts an `app.zeplin.io`
+ * project/screen URL, a bare project id, or a `projectId:screenId` string. Returns null
+ * when no project id is found.
+ */
+export declare function parseZeplinRef(input: string): string | null;
+/** Split a composite external id back into its project id and optional screen id. */
+export declare function splitZeplinExternalId(externalId: string): {
+    projectId: string;
+    screenId?: string;
+};
+/** Build the canonical web URL stored on the imported document. */
+export declare function zeplinUrlFor(externalId: string): string;
+/** Accept either a bare array or a `{ <key>: [...] }` envelope, else an empty array. */
+export declare function unwrapArray<T>(value: unknown, key: string): T[];
+/** Accept either a bare object or a `{ <key>: {...} }` envelope, else null. */
+export declare function unwrapObject<T>(value: unknown, key: string): T | null;
+export interface ZeplinScreen {
+    id?: string;
+    name?: string;
+    description?: string;
+    image?: {
+        width?: number;
+        height?: number;
+    } | null;
+}
+export interface ZeplinComponent {
+    id?: string;
+    name?: string;
+    description?: string;
+    section?: {
+        name?: string;
+    } | null;
+}
+/** A Zeplin colour token: 0–255 channels + 0–1 alpha (Zeplin's representation). */
+interface ZeplinColor {
+    name?: string;
+    r?: number;
+    g?: number;
+    b?: number;
+    a?: number;
+}
+interface ZeplinTextStyle {
+    name?: string;
+    font_family?: string;
+    font_size?: number;
+}
+interface ZeplinSpacing {
+    name?: string;
+    value?: number;
+}
+/** The `/projects/:id/design_tokens` payload we read (lenient — verify-at-build). */
+export interface ZeplinDesignTokens {
+    colors?: ZeplinColor[];
+    text_styles?: ZeplinTextStyle[];
+    spacing?: ZeplinSpacing[];
+    measurements?: ZeplinSpacing[];
+}
+/**
+ * The single source of truth for how many screens a whole-project import pulls and
+ * renders: {@link ZeplinProvider} builds its `?limit=` query from this, and
+ * {@link zeplinScreensToBlocks} bounds the rendered blocks by it, so the fetch and the
+ * render can't drift.
+ */
+export declare const MAX_SCREENS = 40;
+/** Map Zeplin screens into source-neutral blocks (name + an optional description line). */
+export declare function zeplinScreensToBlocks(screens: ZeplinScreen[]): DesignBlock[];
+/** Map Zeplin components into source-neutral components (grouped by their section). */
+export declare function zeplinComponentsToDesign(components: ZeplinComponent[]): DesignComponent[];
+/** Map Zeplin design tokens (colours / typography / spacing) into source-neutral tokens. */
+export declare function zeplinTokens(tokens: ZeplinDesignTokens | undefined | null): DesignToken[];
+export interface ZeplinContextInput {
+    /** The composite external id (`<projectId>` or `<projectId>:<screenId>`). */
+    externalId: string;
+    /** The Zeplin project's name (from the API), used for the document title. */
+    projectName: string;
+    /** The fetched screens (the whole project, or just the one referenced). */
+    screens: ZeplinScreen[];
+    /** The project's design-system components. */
+    components: ZeplinComponent[];
+    /** The project's design tokens, or null when unavailable. */
+    designTokens?: ZeplinDesignTokens | null;
+}
+/** Assemble the fetched Zeplin pieces into the shared {@link DesignContext}. */
+export declare function buildZeplinDesignContext(input: ZeplinContextInput): DesignContext;
+export {};
+//# sourceMappingURL=zeplin.logic.d.ts.map

package/dist/modules/documents/zeplin.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zeplin.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/zeplin.logic.ts"],"names":[],"mappings":"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"}

package/dist/modules/documents/zeplin.logic.js

@@ -0,0 +1,193 @@
+import { dimensionMeta, } from './design.logic.js';
+import { assertHostPinned } from './http.js';
+// Zeplin-specific pure logic, kept out of the provider shell so it is unit-testable
+// without a live workspace: parsing/canonicalising a project+screen ref out of user input,
+// the fixed-host SSRF guard, and mapping Zeplin's screens / components / design-tokens JSON
+// into the source-neutral `DesignContext` the shared `renderDesignContext` emits. The
+// `fetch` itself (the `Authorization: Bearer` REST client) lives in `ZeplinProvider`.
+//
+// Zeplin is the design→dev *handoff* tool, so its content model is screens + a
+// design-system (components + tokens), NOT Figma's node tree — which is exactly why it
+// rides the shared `DesignContext` rather than a Figma-shaped renderer.
+/** Zeplin's REST API host. The PAT is sent to this host only — see {@link assertSafeZeplinUrl}. */
+export const ZEPLIN_API_HOST = 'api.zeplin.dev';
+/** What the connect UI renders, and which credentials the provider needs. */
+export const ZEPLIN_DESCRIPTOR = {
+    source: 'zeplin',
+    label: 'Zeplin',
+    icon: 'i-lucide-layout-template',
+    credentialFields: [
+        {
+            key: 'apiToken',
+            label: 'Personal access token',
+            secret: true,
+            placeholder: 'zeplin PAT',
+            help: 'Create a personal access token in Zeplin → Profile → Developer → Personal access tokens. It is stored sealed and shared by the workspace.',
+        },
+    ],
+    refLabel: 'Zeplin project or screen URL',
+    refPlaceholder: 'https://app.zeplin.io/project/<projectId>/screen/<screenId>',
+    // No catalogue search exposed here — import a specific project/screen by URL.
+    searchable: false,
+};
+/**
+ * The Zeplin REST host is fixed, so any request/redirect must stay on `api.zeplin.dev`
+ * over https; a redirect off-host is treated as an SSRF attempt and rejected. Mirrors the
+ * per-hop guard the other host-pinned providers run. Kept pure so it is unit-testable
+ * without a network.
+ */
+export function assertSafeZeplinUrl(url) {
+    assertHostPinned(url, ZEPLIN_API_HOST, 'Zeplin');
+}
+// ---- Ref parsing + canonical URL ------------------------------------------
+const ID = /^[A-Za-z0-9]+$/;
+/**
+ * Resolve a Zeplin reference from raw user input into the stable composite external id
+ * this provider stores: `"<projectId>"` for a whole-project link, or
+ * `"<projectId>:<screenId>"` for a specific screen. Accepts an `app.zeplin.io`
+ * project/screen URL, a bare project id, or a `projectId:screenId` string. Returns null
+ * when no project id is found.
+ */
+export function parseZeplinRef(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return null;
+    // Bare ref: a project id, optionally `:`-suffixed with a screen id.
+    if (!trimmed.includes('/') && !/zeplin\.io/i.test(trimmed)) {
+        const [project, screen, ...rest] = trimmed.split(':');
+        if (!project || !ID.test(project) || rest.length)
+            return null;
+        if (!screen)
+            return project;
+        return ID.test(screen) ? `${project}:${screen}` : project;
+    }
+    let url;
+    try {
+        url = new URL(trimmed);
+    }
+    catch {
+        return null;
+    }
+    if (!/(^|\.)zeplin\.io$/i.test(url.hostname))
+        return null;
+    const project = url.pathname.match(/\/project\/([A-Za-z0-9]+)/)?.[1];
+    if (!project)
+        return null;
+    const screen = url.pathname.match(/\/screen\/([A-Za-z0-9]+)/)?.[1];
+    return screen ? `${project}:${screen}` : project;
+}
+/** Split a composite external id back into its project id and optional screen id. */
+export function splitZeplinExternalId(externalId) {
+    const idx = externalId.indexOf(':');
+    if (idx === -1)
+        return { projectId: externalId };
+    return { projectId: externalId.slice(0, idx), screenId: externalId.slice(idx + 1) };
+}
+/** Build the canonical web URL stored on the imported document. */
+export function zeplinUrlFor(externalId) {
+    const { projectId, screenId } = splitZeplinExternalId(externalId);
+    const base = `https://app.zeplin.io/project/${projectId}`;
+    return screenId ? `${base}/screen/${screenId}` : base;
+}
+// ---- Response envelope unwrapping -----------------------------------------
+// Zeplin's REST responses are inconsistent about wrapping collections/objects in a named
+// envelope (`{ screens: [...] }` / `{ screen: {...} }`) vs returning them bare, so every
+// read normalises through these. Pure + exported so the provider shell stays a thin fetch
+// layer and the unwrap is unit-testable without a network.
+/** Accept either a bare array or a `{ <key>: [...] }` envelope, else an empty array. */
+export function unwrapArray(value, key) {
+    if (Array.isArray(value))
+        return value;
+    if (value && typeof value === 'object') {
+        const inner = value[key];
+        if (Array.isArray(inner))
+            return inner;
+    }
+    return [];
+}
+/** Accept either a bare object or a `{ <key>: {...} }` envelope, else null. */
+export function unwrapObject(value, key) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const inner = value[key];
+    if (inner && typeof inner === 'object')
+        return inner;
+    return value;
+}
+/**
+ * The single source of truth for how many screens a whole-project import pulls and
+ * renders: {@link ZeplinProvider} builds its `?limit=` query from this, and
+ * {@link zeplinScreensToBlocks} bounds the rendered blocks by it, so the fetch and the
+ * render can't drift.
+ */
+export const MAX_SCREENS = 40;
+function screenMeta(screen) {
+    return dimensionMeta(screen.image?.width, screen.image?.height);
+}
+/** Map Zeplin screens into source-neutral blocks (name + an optional description line). */
+export function zeplinScreensToBlocks(screens) {
+    return screens.slice(0, MAX_SCREENS).map((screen) => ({
+        title: screen.name?.trim() || '(unnamed screen)',
+        meta: screenMeta(screen),
+        sections: screen.description?.trim()
+            ? [{ heading: 'Description', lines: [screen.description.trim()] }]
+            : [],
+    }));
+}
+/** Map Zeplin components into source-neutral components (grouped by their section). */
+export function zeplinComponentsToDesign(components) {
+    return components
+        .filter((c) => c.name?.trim())
+        .map((c) => ({
+        name: c.name.trim(),
+        group: c.section?.name?.trim() || undefined,
+        note: c.description?.trim() || undefined,
+    }));
+}
+function colorHex(c) {
+    const to2 = (n) => Math.max(0, Math.min(255, Math.round(n ?? 0)))
+        .toString(16)
+        .padStart(2, '0');
+    const hex = `#${to2(c.r)}${to2(c.g)}${to2(c.b)}`;
+    return c.a != null && c.a < 1 ? `${hex} (a=${c.a.toFixed(2)})` : hex;
+}
+/** Map Zeplin design tokens (colours / typography / spacing) into source-neutral tokens. */
+export function zeplinTokens(tokens) {
+    if (!tokens)
+        return [];
+    const out = [];
+    for (const c of tokens.colors ?? []) {
+        if (c.name?.trim())
+            out.push({ collection: 'Colors', name: c.name.trim(), value: colorHex(c) });
+    }
+    for (const t of tokens.text_styles ?? []) {
+        if (!t.name?.trim())
+            continue;
+        const value = [t.font_family, t.font_size != null ? `${t.font_size}px` : null]
+            .filter(Boolean)
+            .join(' ');
+        out.push({ collection: 'Typography', name: t.name.trim(), value: value || '—' });
+    }
+    for (const s of [...(tokens.spacing ?? []), ...(tokens.measurements ?? [])]) {
+        if (s.name?.trim()) {
+            out.push({ collection: 'Spacing', name: s.name.trim(), value: String(s.value ?? '') });
+        }
+    }
+    return out;
+}
+/** Assemble the fetched Zeplin pieces into the shared {@link DesignContext}. */
+export function buildZeplinDesignContext(input) {
+    const { projectId, screenId } = splitZeplinExternalId(input.externalId);
+    const title = screenId && input.screens[0]?.name?.trim()
+        ? `${input.projectName || projectId} — ${input.screens[0].name.trim()}`
+        : input.projectName || projectId;
+    return {
+        title,
+        url: zeplinUrlFor(input.externalId),
+        blocks: zeplinScreensToBlocks(input.screens),
+        components: zeplinComponentsToDesign(input.components),
+        tokens: zeplinTokens(input.designTokens),
+        references: [],
+    };
+}
+//# sourceMappingURL=zeplin.logic.js.map

package/dist/modules/documents/zeplin.logic.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/integrations",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "External-system integration domain logic for the Agent Architecture Board (GitHub, documents, tasks, environments, runners).",
   "repository": {
     "type": "git",
@@ -25,8 +25,8 @@
   },
   "dependencies": {
     "ai": "^6.0.209",
-    "@cat-factory/contracts": "0.48.0",
-    "@cat-factory/kernel": "0.49.0"
+    "@cat-factory/contracts": "0.49.0",
+    "@cat-factory/kernel": "0.50.0"
   },
   "devDependencies": {
     "typescript": "7.0.1-rc",

package/dist/modules/documents/ClaudeDesignProvider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClaudeDesignProvider.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/ClaudeDesignProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAA;AA8C5B,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAS;IACxC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;MAA2B;IAE9C,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CAMpE;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAErC;IAEK,aAAa,CACjB,WAAW,EAAE,mBAAmB,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAmB1B;IAED,0FAA0F;YAC5E,iBAAiB;IAoC/B,2FAA2F;YAC7E,SAAS;IA+BvB,yFAAyF;IACzF,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,OAAO;YAQD,GAAG;CAiBlB"}

package/dist/modules/documents/ClaudeDesignProvider.js

@@ -1,163 +0,0 @@
-import { ValidationError, } from '@cat-factory/kernel';
-import { CLAUDE_DESIGN_API_HOST, CLAUDE_DESIGN_DESCRIPTOR, DS_MANIFEST_PATH, claudeDesignUrlFor, parseClaudeDesignRef, renderClaudeDesignProject, splitClaudeDesignExternalId, } from './claudeDesign.logic.js';
-import { DocumentHttpError, createHostPinnedFetch, readCappedText } from './http.js';
-// ClaudeDesignProvider: the document-source provider for Anthropic's Claude Design. It
-// authenticates with a **per-user** personal access token (the credential is stored
-// keyed by user id, not shared across the workspace — see the descriptor's
-// `credentialScope: 'user'`), reads a design-system project's files over the REST API,
-// and renders the component inventory + design tokens to the Markdown the planner +
-// `.cat-context/` materialisation consume. All Claude-Design-specific *pure* logic (ref
-// parsing, the host-pin guard, the HTML/manifest → Markdown normalizer) lives in
-// `claudeDesign.logic.ts`; this class is the thin `fetch` shell.
-//
-// PROVISIONAL API SHAPE: the endpoint paths/headers below target the per-user-PAT read
-// the product is moving toward (today the design-system read is claude.ai-login-bound).
-// The host is pinned; re-verify the exact endpoints against the current API when the
-// credentialed read ships — they are the intended shape, not a frozen contract. The
-// normalizer they feed is solid and fully unit-tested regardless.
-const API_BASE = `https://${CLAUDE_DESIGN_API_HOST}/v1`;
-const USER_AGENT = 'cat-factory';
-/** Hard cap on the bytes read off any response body, to protect the isolate. */
-const MAX_RESPONSE_BYTES = 5_000_000;
-/** Bound how many project files we pull for a whole-project import. */
-const MAX_PROJECT_FILES = 12;
-/**
- * `fetch` pinned to the Claude Design host, following redirects by hand so the SSRF host
- * guard runs against every hop (a 302 can't chase the PAT off-host). Shared transport.
- */
-const safeFetch = createHostPinnedFetch({ host: CLAUDE_DESIGN_API_HOST, label: 'Claude Design' });
-export class ClaudeDesignProvider {
-    kind = 'claude-design';
-    descriptor = CLAUDE_DESIGN_DESCRIPTOR;
-    normalizeConnection(input) {
-        const apiToken = input.apiToken?.trim();
-        if (!apiToken) {
-            throw new ValidationError('Claude Design requires a personal access token');
-        }
-        return { credentials: { apiToken }, label: 'Claude Design' };
-    }
-    parseRef(input) {
-        return parseClaudeDesignRef(input);
-    }
-    async fetchDocument(credentials, externalId) {
-        const { projectId, filePath } = splitClaudeDesignExternalId(externalId);
-        if (!projectId) {
-            throw new DocumentHttpError(400, `Claude Design ref is missing a project id: ${externalId}`);
-        }
-        const files = filePath
-            ? [{ path: filePath, content: await this.fetchFile(credentials, projectId, filePath) }]
-            : await this.fetchProjectFiles(credentials, projectId);
-        const projectName = this.deriveName(projectId, filePath, files);
-        const body = renderClaudeDesignProject(projectName, files);
-        return {
-            externalId,
-            title: projectName,
-            url: claudeDesignUrlFor(externalId),
-            body,
-        };
-    }
-    /** List a project's files, then fetch the manifest + a bounded slice of HTML previews. */
-    async fetchProjectFiles(credentials, projectId) {
-        const listed = await this.get(credentials, `/design/projects/${encodeURIComponent(projectId)}/files`);
-        const paths = normalizePaths(listed);
-        if (paths.length === 0) {
-            throw new DocumentHttpError(404, `Claude Design project ${projectId} has no readable files`);
-        }
-        // The manifest is the authoritative index; then prefer component-preview HTML and any
-        // stylesheet (for tokens), bounded so a huge project can't stall the import.
-        const manifest = paths.filter((p) => p.endsWith(DS_MANIFEST_PATH));
-        const styles = paths.filter((p) => /\.css$/i.test(p));
-        const html = paths.filter((p) => /\.html?$/i.test(p));
-        const chosen = [...manifest, ...styles, ...html].slice(0, MAX_PROJECT_FILES);
-        const out = [];
-        for (const path of chosen) {
-            try {
-                out.push({ path, content: await this.fetchFile(credentials, projectId, path) });
-            }
-            catch {
-                // A single unreadable file shouldn't fail the whole import — skip it.
-            }
-        }
-        if (out.length === 0) {
-            throw new DocumentHttpError(502, `Claude Design project ${projectId} returned no file content`);
-        }
-        return out;
-    }
-    /** Fetch one file's textual content (raw, or unwrapped from a `{ content }` JSON body). */
-    async fetchFile(credentials, projectId, path) {
-        const url = `${API_BASE}/design/projects/${encodeURIComponent(projectId)}/files/${path
-            .split('/')
-            .map(encodeURIComponent)
-            .join('/')}`;
-        const res = await safeFetch(url, { method: 'GET', headers: this.headers(credentials) });
-        if (!res.ok) {
-            const text = await readCappedText(res, MAX_RESPONSE_BYTES, 'Claude Design').catch(() => '');
-            throw new DocumentHttpError(res.status, `Claude Design GET ${url} → ${res.status}: ${text.slice(0, 300)}`);
-        }
-        const text = await readCappedText(res, MAX_RESPONSE_BYTES, 'Claude Design');
-        // The files endpoint may return raw file bytes or a `{ content }` JSON envelope.
-        const contentType = res.headers.get('content-type') ?? '';
-        if (contentType.includes('application/json')) {
-            try {
-                const json = JSON.parse(text);
-                if (typeof json.content === 'string')
-                    return json.content;
-            }
-            catch {
-                // Not a JSON envelope after all — fall through and use the raw text.
-            }
-        }
-        return text;
-    }
-    /** Name the document: the manifest's `name`, else the file path, else the project id. */
-    deriveName(projectId, filePath, files) {
-        const manifest = files.find((f) => f.path.endsWith(DS_MANIFEST_PATH));
-        if (manifest) {
-            try {
-                const json = JSON.parse(manifest.content);
-                if (typeof json.name === 'string' && json.name.trim())
-                    return json.name.trim();
-            }
-            catch {
-                // ignore — fall through
-            }
-        }
-        if (filePath)
-            return `${projectId} — ${filePath}`;
-        return projectId;
-    }
-    headers(credentials) {
-        return {
-            authorization: `Bearer ${credentials.apiToken ?? ''}`,
-            accept: 'application/json',
-            'user-agent': USER_AGENT,
-        };
-    }
-    async get(credentials, path) {
-        const url = `${API_BASE}${path}`;
-        const res = await safeFetch(url, { method: 'GET', headers: this.headers(credentials) });
-        if (!res.ok) {
-            const text = await readCappedText(res, MAX_RESPONSE_BYTES, 'Claude Design').catch(() => '');
-            throw new DocumentHttpError(res.status, `Claude Design GET ${url} → ${res.status}: ${text.slice(0, 300)}`);
-        }
-        const text = await readCappedText(res, MAX_RESPONSE_BYTES, 'Claude Design');
-        try {
-            return JSON.parse(text);
-        }
-        catch {
-            throw new DocumentHttpError(502, `Claude Design returned an unparseable body for ${path}`);
-        }
-    }
-}
-/** Flatten the file-list response into a clean string[] of paths. */
-function normalizePaths(listed) {
-    const raw = listed.files ?? listed.paths ?? [];
-    const out = [];
-    for (const entry of raw) {
-        const path = typeof entry === 'string' ? entry : entry?.path;
-        if (typeof path === 'string' && path.trim())
-            out.push(path.trim());
-    }
-    return out;
-}
-//# sourceMappingURL=ClaudeDesignProvider.js.map

package/dist/modules/documents/ClaudeDesignProvider.js.map

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

package/dist/modules/documents/claudeDesign.logic.d.ts

@@ -1,88 +0,0 @@
-import type { DocumentSourceDescriptor } from '@cat-factory/kernel';
-/**
- * Claude Design's programmatic-read host. PROVISIONAL: today the design-system read is
- * bound to a claude.ai login; this provider targets the per-user-PAT API shape the
- * product is moving toward. The host is pinned (see {@link assertSafeClaudeDesignUrl})
- * and the exact endpoints in `ClaudeDesignProvider` should be re-verified against the
- * current API when the credentialed read ships — treat them as the intended shape, not a
- * frozen contract.
- */
-export declare const CLAUDE_DESIGN_API_HOST = "api.claude.com";
-/** Where a human opens the project (the canonical URL stored on imported documents). */
-export declare const CLAUDE_DESIGN_APP_HOST = "claude.ai";
-/** What the connect UI renders, and which credentials the provider needs. */
-export declare const CLAUDE_DESIGN_DESCRIPTOR: DocumentSourceDescriptor;
-/**
- * The Claude Design read host is fixed, so any request/redirect must stay on it over
- * https. A redirect off-host (e.g. to a link-local metadata address) is rejected as an
- * SSRF attempt. Delegates to the shared host-pin guard; throws a plain `Error` the
- * provider maps to a `DocumentHttpError`. Kept pure so it is unit-testable without a
- * network.
- */
-export declare function assertSafeClaudeDesignUrl(url: string): void;
-/**
- * Resolve a Claude Design reference from raw user input into the stable composite
- * external id this provider stores: `"<projectId>"` for a whole project, or
- * `"<projectId>::<filePath>"` for a single component/file. Accepts a
- * `claude.ai/design/<projectId>` URL (optionally `…/files/<path>` or `?file=<path>`), a
- * bare project id, or the composite form. Returns null when no project id is found.
- *
- * Deterministic (same input → same external id), which the
- * `(workspace, source, externalId)` document key relies on for de-duplication.
- */
-export declare function parseClaudeDesignRef(input: string): string | null;
-/** Split a composite external id back into its project id and optional file path. */
-export declare function splitClaudeDesignExternalId(externalId: string): {
-    projectId: string;
-    filePath?: string;
-};
-/** Build the canonical web URL stored on the imported document (matched by `getByUrl`). */
-export declare function claudeDesignUrlFor(externalId: string): string;
-/** A single component card, as recorded by Claude Design's `@dsCard` markers/manifest. */
-export interface DsCard {
-    name?: string;
-    group?: string;
-    subtitle?: string;
-    path?: string;
-}
-/** One fetched project file (path + raw textual content). */
-export interface ClaudeDesignFile {
-    path: string;
-    content: string;
-}
-/** The manifest file name Claude Design compiles its card index into. */
-export declare const DS_MANIFEST_PATH = "_ds_manifest.json";
-/**
- * Parse a `_ds_manifest.json` payload (a bare array of cards, or `{ cards: [...] }`)
- * into a lenient {@link DsCard} list. Unknown shapes yield `[]` so the caller falls
- * back to per-file HTML extraction.
- */
-export declare function parseDsManifest(json: unknown): DsCard[];
-/**
- * Read the first-line `<!-- @dsCard group="…" name="…" subtitle="…" -->` marker Claude
- * Design writes at the top of each component-preview HTML. Returns null when absent.
- */
-export declare function parseDsCardComment(html: string): DsCard | null;
-/**
- * Extract CSS custom properties (`--token: value`) from a stylesheet/HTML blob as design
- * tokens, deduped (last value wins) and sorted. These are Claude Design's design tokens —
- * the analogue of Figma variables.
- */
-export declare function extractCssTokens(content: string): string[];
-/** Strip `<script>`/`<style>` blocks and all tags, returning collapsed visible text. */
-export declare function htmlToText(html: string): string;
-/** Render a grouped component inventory from a card list (`### <group>` → `- <name>`). */
-export declare function dsCardsToMarkdown(cards: DsCard[]): string;
-/**
- * Normalize a whole Claude Design project's fetched files into the lightweight Markdown a
- * frontend agent consumes. Strategy:
- *   1. If a `_ds_manifest.json` is present, it is the authoritative component index →
- *      `### Components` grouped inventory.
- *   2. Otherwise, recover the inventory from each preview HTML's `@dsCard` marker.
- *   3. Design tokens are unioned from the CSS custom properties across all files.
- *   4. A bounded slice of visible text gives the agent a sense of the content.
- *
- * `projectName` titles the document. Pure: no network, fully unit-testable.
- */
-export declare function renderClaudeDesignProject(projectName: string, files: ClaudeDesignFile[]): string;
-//# sourceMappingURL=claudeDesign.logic.d.ts.map

package/dist/modules/documents/claudeDesign.logic.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"claudeDesign.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/claudeDesign.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAmBnE;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,mBAAmB,CAAA;AAEtD,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,cAAc,CAAA;AAEjD,6EAA6E;AAC7E,eAAO,MAAM,wBAAwB,EAAE,wBAmBtC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3D;AASD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCjE;AAWD,qFAAqF;AACrF,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAKA;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI7D;AAID,0FAA0F;AAC1F,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,sBAAsB,CAAA;AAMnD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAmBvD;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY9D;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAW1D;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAc/C;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAsBzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,MAAM,CA+ChG"}