@12ui/design 0.2.0

package/dist/conversion-outputs.js

@@ -0,0 +1,84 @@
+import { CONVERSION_PROJECT_OUTPUTS, } from './project-profiles.js';
+export const CONVERSION_FIXED_EXPORT_OUTPUTS = [
+    'svg',
+    'png',
+    'jpg',
+    'webp',
+    'pdf',
+    'psd',
+    'pptx',
+    'sketch',
+];
+export { CONVERSION_PROJECT_OUTPUTS } from './project-profiles.js';
+export const CONVERSION_OUTPUTS = [
+    'layerdoc',
+    'html',
+    'html_fixed',
+    ...CONVERSION_FIXED_EXPORT_OUTPUTS,
+    ...CONVERSION_PROJECT_OUTPUTS,
+];
+export const LAYERDOC_INPUT_OUTPUTS = [
+    'layerdoc',
+    'html',
+    'html_fixed',
+    ...CONVERSION_FIXED_EXPORT_OUTPUTS,
+    ...CONVERSION_PROJECT_OUTPUTS,
+];
+export const CONVERSION_OUTPUT_FORMATS = {
+    layerdoc: {
+        mediaType: 'application/vnd.12ui.layerdoc+json;version=2',
+        extension: 'json',
+        filenameSuffix: 'layerdoc.json',
+        label: 'LayerDoc',
+        layout: 'document',
+    },
+    html: {
+        mediaType: 'text/html;profile="12ui-responsive-v1"',
+        extension: 'html',
+        filenameSuffix: 'html',
+        label: 'Responsive HTML',
+        layout: 'responsive',
+    },
+    html_fixed: {
+        mediaType: 'text/html;profile="12ui-fixed-v1"',
+        extension: 'html',
+        filenameSuffix: 'html',
+        label: 'Fixed HTML',
+        layout: 'fixed',
+    },
+    svg: { mediaType: 'image/svg+xml', extension: 'svg', filenameSuffix: 'svg', label: 'SVG', layout: 'fixed' },
+    png: { mediaType: 'image/png', extension: 'png', filenameSuffix: 'png', label: 'PNG', layout: 'fixed' },
+    jpg: { mediaType: 'image/jpeg', extension: 'jpg', filenameSuffix: 'jpg', label: 'JPG', layout: 'fixed' },
+    webp: { mediaType: 'image/webp', extension: 'webp', filenameSuffix: 'webp', label: 'WebP', layout: 'fixed' },
+    pdf: { mediaType: 'application/pdf', extension: 'pdf', filenameSuffix: 'pdf', label: 'PDF', layout: 'fixed' },
+    psd: { mediaType: 'image/vnd.adobe.photoshop', extension: 'psd', filenameSuffix: 'psd', label: 'PSD', layout: 'fixed' },
+    pptx: {
+        mediaType: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+        extension: 'pptx',
+        filenameSuffix: 'pptx',
+        label: 'PowerPoint',
+        layout: 'fixed',
+    },
+    sketch: { mediaType: 'application/zip', extension: 'sketch', filenameSuffix: 'sketch', label: 'Sketch', layout: 'fixed' },
+    web_project: {
+        mediaType: 'application/vnd.12ui.web-project+zip;version=1',
+        extension: 'zip',
+        filenameSuffix: 'web-project.zip',
+        label: 'Web project',
+        layout: 'project',
+    },
+    app_project: {
+        mediaType: 'application/vnd.12ui.app-project+zip;version=1',
+        extension: 'zip',
+        filenameSuffix: 'app-project.zip',
+        label: 'App project',
+        layout: 'project',
+    },
+};
+const formatPropertyMap = (key) => Object.fromEntries(CONVERSION_OUTPUTS.map((output) => [output, CONVERSION_OUTPUT_FORMATS[output][key]]));
+export const CONVERSION_OUTPUT_MEDIA_TYPES = formatPropertyMap('mediaType');
+export const CONVERSION_OUTPUT_EXTENSIONS = formatPropertyMap('extension');
+export const CONVERSION_OUTPUT_FILENAME_SUFFIXES = formatPropertyMap('filenameSuffix');
+export const isConversionOutput = (value) => (typeof value === 'string' && CONVERSION_OUTPUTS.includes(value));
+export const isLayerDocInputOutput = (value) => (typeof value === 'string' && LAYERDOC_INPUT_OUTPUTS.includes(value));
+//# sourceMappingURL=conversion-outputs.js.map

package/dist/conversion-outputs.js.map

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

package/dist/conversion-problems.d.ts

@@ -0,0 +1,3 @@
+export declare const CONVERSION_PROBLEM_CODES: readonly ["invalid_request", "source_pipeline_stale", "missing_api_key", "insufficient_scope", "not_found", "idempotency_conflict", "expired", "payload_too_large", "unsupported_media_type", "image_decode_failed", "image_dimensions_exceeded", "layerdoc_invalid", "export_unsupported", "export_too_complex", "rate_limited", "conversion_parked", "provider_unavailable", "service_unavailable"];
+export type ConversionProblemCode = typeof CONVERSION_PROBLEM_CODES[number];
+//# sourceMappingURL=conversion-problems.d.ts.map

package/dist/conversion-problems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-problems.d.ts","sourceRoot":"","sources":["../src/conversion-problems.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,uYAmB3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC"}

package/dist/conversion-problems.js

@@ -0,0 +1,21 @@
+export const CONVERSION_PROBLEM_CODES = [
+    'invalid_request',
+    'source_pipeline_stale',
+    'missing_api_key',
+    'insufficient_scope',
+    'not_found',
+    'idempotency_conflict',
+    'expired',
+    'payload_too_large',
+    'unsupported_media_type',
+    'image_decode_failed',
+    'image_dimensions_exceeded',
+    'layerdoc_invalid',
+    'export_unsupported',
+    'export_too_complex',
+    'rate_limited',
+    'conversion_parked',
+    'provider_unavailable',
+    'service_unavailable',
+];
+//# sourceMappingURL=conversion-problems.js.map

package/dist/conversion-problems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-problems.js","sourceRoot":"","sources":["../src/conversion-problems.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,iBAAiB;IACjB,uBAAuB;IACvB,iBAAiB;IACjB,oBAAoB;IACpB,WAAW;IACX,sBAAsB;IACtB,SAAS;IACT,mBAAmB;IACnB,wBAAwB;IACxB,qBAAqB;IACrB,2BAA2B;IAC3B,kBAAkB;IAClB,oBAAoB;IACpB,oBAAoB;IACpB,cAAc;IACd,mBAAmB;IACnB,sBAAsB;IACtB,qBAAqB;CACb,CAAC"}

package/dist/corpus-client.d.ts

@@ -0,0 +1,171 @@
+import { type ConversionConfig } from './config.js';
+export type CorpusTrack = 'r-track' | 'logo-track';
+export type CorpusAspect = 'portrait' | 'landscape' | 'square';
+export type CorpusPurpose = 'session-probes' | 'session-slots' | 'run' | 'diagnostic';
+export type CorpusQuality = {
+    overall: number;
+    aesthetics: number;
+    simplicity: number;
+    polish: number;
+};
+export type CorpusFilters = {
+    aspect?: CorpusAspect | null;
+    kind?: string | null;
+    eligibleOnly?: boolean;
+};
+export type CorpusInspirationRequest = {
+    q: string;
+    k?: number;
+    tau?: number;
+    seed?: number;
+    alpha?: number;
+    beta?: number;
+    gamma?: number;
+    arms?: string[];
+    filters?: CorpusFilters;
+};
+export type CorpusInspirationItem = {
+    id: string;
+    role: 'core' | 'stretch';
+    arm: string;
+    cell: string | null;
+    aspect: CorpusAspect;
+    relevance: number;
+    relevancePercentile: number;
+    qualityPercentile: number;
+};
+export type CorpusInspirationResponse = {
+    setId: string;
+    query: string;
+    seed: number;
+    k: number;
+    poolSize: number;
+    coverage: number;
+    truncated: boolean;
+    weightsSource: 'default:owner-elite12';
+    items: CorpusInspirationItem[];
+};
+export type CorpusRetrievalRequest = {
+    scope: CorpusTrack;
+    queries: Array<{
+        id: string;
+        brief: string;
+        direction?: string;
+        targetCount: number;
+        excludeReferenceIds?: string[];
+        preselectedReferenceIds?: string[];
+    }>;
+    minimumQuality?: Partial<CorpusQuality>;
+    context: {
+        mode: 'record' | 'ignore';
+        purpose: CorpusPurpose;
+        exposureScope: string;
+        allocationKey: string;
+    };
+};
+export type CorpusRetrievalCluster = {
+    version: string;
+    coarseId: string;
+    fineId: string;
+    fineDistance: number;
+};
+export type CorpusMatch = {
+    referenceId: string;
+    track: CorpusTrack;
+    quality: CorpusQuality;
+    aspect: CorpusAspect;
+    width: number;
+    height: number;
+    uiType: string | null;
+    variantKind: string | null;
+    logoRole: string | null;
+    markType: string | null;
+    paletteTag: string | null;
+    colorMode: string | null;
+    styleTags: string[];
+    industry: string[];
+    tags: string[];
+    description: string | null;
+    score: number;
+    allocationScore: number;
+    retrievalCluster: CorpusRetrievalCluster | null;
+    scoreBreakdown: {
+        baseSimilarity: number;
+        directionSimilarity: number | null;
+        relevance: number;
+        quality: number;
+        diversity: number;
+        referenceExposure: number;
+        fineClusterExposure: number;
+        allocation: number;
+    };
+    assets: {
+        thumb: {
+            href: string;
+        };
+        ref: {
+            href: string;
+        };
+    };
+};
+export type CorpusReference = Omit<CorpusMatch, 'score' | 'allocationScore' | 'retrievalCluster' | 'scoreBreakdown' | 'assets'>;
+export type CorpusRetrievalResponse = {
+    requestId: string;
+    releaseId: string;
+    model: 'gemini-embedding-2';
+    dimensions: 3072;
+    scope: CorpusTrack;
+    policyKind: 'direct-cosine-v1' | 'cluster-balanced-v1';
+    clusterVersion: string | null;
+    allocations: Array<{
+        id: string;
+        candidateCount: number;
+        eligibleCount: number;
+        qualityGate: {
+            requested: CorpusQuality;
+            applied: CorpusQuality;
+            relaxed: boolean;
+        };
+        results: CorpusMatch[];
+    }>;
+};
+export type CorpusStatus = {
+    status: 'ok';
+    releaseId: string;
+    model: 'gemini-embedding-2';
+    dimensions: 3072;
+    itemCount: number;
+    candidateCounts: Record<CorpusTrack, number>;
+    clusterVersion: string;
+    bundle: {
+        manifestSha256: string;
+        metadataSha256: string;
+        vectorSha256: string;
+    };
+    queryIdempotencyRevision: typeof CORPUS_QUERY_IDEMPOTENCY_REVISION;
+};
+export declare const CORPUS_QUERY_IDEMPOTENCY_REVISION: "corpus-query-idempotency-v1";
+export type CorpusClientOptions = Partial<ConversionConfig> & {
+    fetch?: typeof globalThis.fetch;
+};
+export declare class TwelveUiCorpusClient {
+    #private;
+    constructor(options?: CorpusClientOptions);
+    retrieve(input: CorpusRetrievalRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<CorpusRetrievalResponse>;
+    inspire(input: CorpusInspirationRequest, options: {
+        idempotencyKey: string;
+        signal?: AbortSignal;
+    }): Promise<CorpusInspirationResponse>;
+    status(options?: {
+        signal?: AbortSignal;
+    }): Promise<CorpusStatus>;
+    download(referenceId: string, size: 'thumb' | 'ref', options?: {
+        signal?: AbortSignal;
+    }): Promise<Uint8Array>;
+    reference(referenceId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<CorpusReference>;
+}
+//# sourceMappingURL=corpus-client.d.ts.map

package/dist/corpus-client.d.ts.map

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

package/dist/corpus-client.js

@@ -0,0 +1,85 @@
+import { readConversionConfig } from './config.js';
+import { normalizeOptionalIdempotencyKey } from './idempotency-key.js';
+export const CORPUS_QUERY_IDEMPOTENCY_REVISION = 'corpus-query-idempotency-v1';
+export class TwelveUiCorpusClient {
+    #config;
+    #fetch;
+    #queryIdempotencyPreflight;
+    #queryIdempotencyRevision;
+    constructor(options = {}) {
+        this.#config = readConversionConfig(options);
+        this.#fetch = options.fetch ?? globalThis.fetch;
+    }
+    async retrieve(input, options = {}) {
+        return await this.#json('/api/v1/corpus/retrieve', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json', 'idempotency-key': input.context.allocationKey },
+            body: JSON.stringify(input),
+            ...(options.signal ? { signal: options.signal } : {}),
+        });
+    }
+    async inspire(input, options) {
+        const idempotencyKey = normalizeOptionalIdempotencyKey(options.idempotencyKey, 'idempotencyKey');
+        if (!idempotencyKey)
+            throw new TypeError('idempotencyKey is required');
+        await this.#requireQueryIdempotency(options.signal);
+        return await this.#json('/api/v1/corpus/inspire', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json', 'idempotency-key': idempotencyKey },
+            body: JSON.stringify(input),
+            ...(options.signal ? { signal: options.signal } : {}),
+        });
+    }
+    async status(options = {}) {
+        const status = await this.#json('/api/v1/corpus/status', options.signal ? { signal: options.signal } : {});
+        this.#queryIdempotencyRevision = status.queryIdempotencyRevision;
+        return status;
+    }
+    async download(referenceId, size, options = {}) {
+        if (!/^(?:gen|logo-gen)-[A-Za-z0-9._-]{1,120}$/u.test(referenceId))
+            throw new TypeError('Corpus reference id is invalid');
+        const response = await this.#request(`/api/v1/corpus/references/${encodeURIComponent(referenceId)}/image?size=${size}`, options.signal ? { signal: options.signal } : {});
+        return new Uint8Array(await response.arrayBuffer());
+    }
+    async reference(referenceId, options = {}) {
+        if (!/^(?:gen|logo-gen)-[A-Za-z0-9._-]{1,120}$/u.test(referenceId))
+            throw new TypeError('Corpus reference id is invalid');
+        return await this.#json(`/api/v1/corpus/references/${encodeURIComponent(referenceId)}`, options.signal ? { signal: options.signal } : {});
+    }
+    async #json(path, init) {
+        const response = await this.#request(path, init);
+        return await response.json();
+    }
+    async #requireQueryIdempotency(signal) {
+        if (this.#queryIdempotencyRevision === CORPUS_QUERY_IDEMPOTENCY_REVISION)
+            return;
+        this.#queryIdempotencyPreflight ??= (async () => {
+            const status = await this.status(signal ? { signal } : {});
+            if (status.queryIdempotencyRevision !== CORPUS_QUERY_IDEMPOTENCY_REVISION) {
+                throw new Error(`12UI Worker does not support ${CORPUS_QUERY_IDEMPOTENCY_REVISION};`
+                    + ' refusing a paid corpus request');
+            }
+        })();
+        const preflight = this.#queryIdempotencyPreflight;
+        try {
+            await preflight;
+        }
+        finally {
+            if (this.#queryIdempotencyPreflight === preflight) {
+                this.#queryIdempotencyPreflight = undefined;
+            }
+        }
+    }
+    async #request(path, init) {
+        const headers = new Headers(init.headers);
+        headers.set('authorization', `Bearer ${this.#config.apiKey}`);
+        headers.set('accept', 'application/json, image/webp');
+        const response = await this.#fetch(`${this.#config.origin}${path}`, { ...init, headers });
+        if (!response.ok) {
+            const detail = await response.text().catch(() => '');
+            throw new Error(`12UI corpus request failed (${response.status}): ${detail.slice(0, 500)}`);
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=corpus-client.js.map

package/dist/corpus-client.js.map

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

package/dist/credential-setup.d.ts

@@ -0,0 +1,27 @@
+import { type TwelveUiDeviceScope } from './login-auth.js';
+export type CredentialSetupResult = {
+    credentialFile: string;
+    origin: string;
+    source: 'browser' | 'environment' | 'flag' | 'stored';
+};
+export type PreparedCredentialSetup = {
+    result: CredentialSetupResult;
+    commit: () => Promise<CredentialSetupResult>;
+    rollback: () => Promise<void>;
+};
+type CredentialSetupFetch = typeof fetch;
+export type CredentialSetupOptions = {
+    apiKey?: string;
+    origin?: string;
+    loginOrigin?: string;
+    keyName?: string;
+    onApprovalUrl?: (url: string) => void;
+    openApproval?: (url: string) => void | Promise<void>;
+    fetch?: CredentialSetupFetch;
+    forceAuthentication?: boolean;
+    requiredScopes?: readonly TwelveUiDeviceScope[];
+};
+export declare const prepareConversionCredentials: (args: CredentialSetupOptions) => Promise<PreparedCredentialSetup>;
+export declare const setUpConversionCredentials: (args: CredentialSetupOptions) => Promise<CredentialSetupResult>;
+export {};
+//# sourceMappingURL=credential-setup.d.ts.map

package/dist/credential-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-setup.d.ts","sourceRoot":"","sources":["../src/credential-setup.ts"],"names":[],"mappings":"AAQA,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC;AAEF,KAAK,oBAAoB,GAAG,OAAO,KAAK,CAAC;AAkCzC,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,MAAM,sBAAsB,KAC3B,OAAO,CAAC,uBAAuB,CA6OjC,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,MAAM,sBAAsB,KAC3B,OAAO,CAAC,qBAAqB,CAG/B,CAAC"}