@cellarnode/ui 0.185.1 → 0.187.0

package/dist/brand/brand-generation-api.d.ts

@@ -0,0 +1,44 @@
+import type { BrandGenerationActiveResult, BrandGenerationContext, BrandGenerationJob, BrandGenerationStartResponse } from "./brand-generation-response.js";
+/**
+ * The transport-agnostic seam of the shared generation flow. A consumer
+ * supplies one implementation; the hook never touches `fetch` for these calls.
+ * Producer wraps its generated openapi client; importer uses
+ * `createBrandGenerationClient`. Both talk to the same backend endpoints.
+ *
+ * Every method rejects on failure (the hook maps a rejection to its error
+ * kind) and resolves already-parsed values.
+ */
+export interface BrandGenerationApi {
+    /** `POST /brand-profiles/generate/`. Retry is a start with amended context. */
+    start(homepageUrl: string, context?: BrandGenerationContext): Promise<BrandGenerationStartResponse>;
+    /** `GET /brand-profiles/generate/active?includeTerminal=`. */
+    getActive(includeTerminal?: boolean): Promise<BrandGenerationActiveResult>;
+    /** `GET /brand-profiles/generate/{jobId}`. */
+    getStatus(jobId: string): Promise<BrandGenerationJob>;
+    /** `PUT /brand-profiles/generate/{jobId}/cancel`. */
+    cancel(jobId: string): Promise<BrandGenerationJob>;
+    /** `PUT /brand-profiles/generate/{jobId}/prioritize-url`. */
+    prioritizeUrl(jobId: string, url: string): Promise<BrandGenerationJob>;
+    /** `PUT /brand-profiles/generate/{jobId}/accept`. */
+    accept(jobId: string): Promise<BrandGenerationJob>;
+}
+/**
+ * How the SSE stream (`GET /brand-profiles/generate/{jobId}/stream`) is opened.
+ *
+ * - Bearer mode: pass `getAccessToken`. A `null` token means "no session
+ *   token available", which degrades to polling exactly like producer.
+ * - Cookie mode: omit `getAccessToken`; the stream is opened with
+ *   `credentials: "include"` and no Authorization header.
+ */
+export interface BrandGenerationStreamConfig {
+    /** API origin, no trailing slash needed (e.g. `http://localhost:4000`). */
+    readonly baseUrl: string;
+    readonly getAccessToken?: () => Promise<string | null>;
+    /** Defaults to the global `fetch`. */
+    readonly fetch?: typeof fetch;
+    /** Idle ms before a silent stream is abandoned for polling. Default 15000. */
+    readonly idleTimeoutMs?: number;
+    /** Status poll interval while degraded. Default 2000. */
+    readonly pollIntervalMs?: number;
+}
+//# sourceMappingURL=brand-generation-api.d.ts.map

package/dist/brand/brand-generation-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-api.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,KAAK,CACH,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACzC,8DAA8D;IAC9D,SAAS,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC3E,8CAA8C;IAC9C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtD,qDAAqD;IACrD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACnD,6DAA6D;IAC7D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvE,qDAAqD;IACrD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACpD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC"}

package/dist/brand/brand-generation-api.js

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

package/dist/brand/brand-generation-api.js.map

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

package/dist/brand/brand-generation-client.d.ts

@@ -0,0 +1,28 @@
+import type { BrandGenerationApi } from "./brand-generation-api.js";
+/** A non-2xx answer from a generation endpoint. */
+export declare class BrandGenerationRequestError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export interface BrandGenerationClientOptions {
+    /** API origin (e.g. `http://localhost:4000`). */
+    readonly baseUrl: string;
+    /** Bearer token source. Omit for cookie auth (`credentials: "include"`). */
+    readonly getAccessToken?: () => Promise<string | null>;
+    /**
+     * Defaults to the global `fetch`. Pass the consumer's authenticated fetch
+     * (the one that refreshes an expired session) here: it owns refresh. With
+     * `getAccessToken` the client additionally retries ONCE on a 401, asking
+     * `getAccessToken` for a fresh token, so a consumer whose token getter
+     * refreshes needs no custom fetch.
+     */
+    readonly fetch?: typeof fetch;
+}
+/**
+ * The shared HTTP implementation of {@link BrandGenerationApi}. It parses every
+ * response with the same strict parsers producer uses, so a wire drift fails
+ * the same way in every consumer instead of rendering a half-valid job.
+ */
+export declare function createBrandGenerationClient(options: BrandGenerationClientOptions): BrandGenerationApi;
+//# sourceMappingURL=brand-generation-client.d.ts.map

package/dist/brand/brand-generation-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-client.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AASjE,mDAAmD;AACnD,qBAAa,2BAA4B,SAAQ,KAAK;IAElD,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,4BAA4B;IAC3C,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAyBD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,kBAAkB,CA+EpB"}

package/dist/brand/brand-generation-client.js

@@ -0,0 +1,107 @@
+import { BrandGenerationResponseError, parseActiveEnvelope, parseJob, parseStart, } from "./brand-generation-response.js";
+/** A non-2xx answer from a generation endpoint. */
+export class BrandGenerationRequestError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "BrandGenerationRequestError";
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function errorFields(body, fallback) {
+    if (!isRecord(body))
+        return { code: "UNKNOWN", message: fallback };
+    const nested = isRecord(body.error) ? body.error : body;
+    return {
+        code: typeof nested.code === "string" ? nested.code : "UNKNOWN",
+        message: typeof nested.message === "string"
+            ? nested.message
+            : typeof body.message === "string"
+                ? body.message
+                : fallback,
+    };
+}
+function toWireContext(context) {
+    const { focusUrls, ...rest } = context;
+    return focusUrls === undefined ? rest : { ...rest, focusUrls: [...focusUrls] };
+}
+/**
+ * The shared HTTP implementation of {@link BrandGenerationApi}. It parses every
+ * response with the same strict parsers producer uses, so a wire drift fails
+ * the same way in every consumer instead of rendering a half-valid job.
+ */
+export function createBrandGenerationClient(options) {
+    const base = options.baseUrl.replace(/\/+$/, "");
+    async function request(method, path, fallback, body) {
+        const doFetch = options.fetch ?? fetch;
+        const send = async (token) => {
+            const headers = { Accept: "application/json" };
+            if (body !== undefined)
+                headers["Content-Type"] = "application/json";
+            if (token)
+                headers.Authorization = `Bearer ${token}`;
+            return doFetch(`${base}${path}`, {
+                method,
+                headers,
+                ...(options.getAccessToken ? {} : { credentials: "include" }),
+                ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+            });
+        };
+        let response = await send(options.getAccessToken ? await options.getAccessToken() : undefined);
+        if (response.status === 401 && options.getAccessToken) {
+            // The token may have expired between read and send; ask again (a
+            // refreshing getter returns a new one) and retry exactly once.
+            response = await send(await options.getAccessToken());
+        }
+        if (response.status === 204)
+            return { status: 204, data: undefined };
+        let parsed;
+        try {
+            parsed = await response.json();
+        }
+        catch {
+            parsed = undefined;
+        }
+        if (!response.ok) {
+            const { code, message } = errorFields(parsed, fallback);
+            throw new BrandGenerationRequestError(response.status, code, message);
+        }
+        return { status: response.status, data: parsed };
+    }
+    async function job(method, path, fallback, body) {
+        const { status, data } = await request(method, path, fallback, body);
+        const parsed = parseJob(data, false);
+        if (parsed === null)
+            throw new BrandGenerationResponseError(status);
+        return parsed;
+    }
+    const jobPath = (jobId) => `/brand-profiles/generate/${encodeURIComponent(jobId)}`;
+    return {
+        async start(homepageUrl, context) {
+            const { status, data } = await request("POST", "/brand-profiles/generate/", "Failed to start brand generation", context === undefined ? { homepageUrl } : { homepageUrl, context: toWireContext(context) });
+            const start = parseStart(data);
+            if (start === null)
+                throw new BrandGenerationResponseError(status);
+            return start;
+        },
+        async getActive(includeTerminal = false) {
+            const { status, data } = await request("GET", `/brand-profiles/generate/active?includeTerminal=${includeTerminal}`, "Failed to get active brand generation");
+            if (status === 204)
+                return { job: null, eligibility: null };
+            const result = parseActiveEnvelope(data);
+            if (result === null)
+                throw new BrandGenerationResponseError(status);
+            return result;
+        },
+        getStatus: (jobId) => job("GET", jobPath(jobId), "Failed to get job status"),
+        cancel: (jobId) => job("PUT", `${jobPath(jobId)}/cancel`, "Failed to cancel brand generation"),
+        prioritizeUrl: (jobId, url) => job("PUT", `${jobPath(jobId)}/prioritize-url`, "Failed to prioritize URL", { url }),
+        accept: (jobId) => job("PUT", `${jobPath(jobId)}/accept`, "Failed to accept brand generation"),
+    };
+}
+//# sourceMappingURL=brand-generation-client.js.map

package/dist/brand/brand-generation-client.js.map

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

package/dist/brand/brand-generation-copy.d.ts

@@ -0,0 +1,44 @@
+import { type BrandProfilePageChecklistCopy } from "../components/brand-profile-page-checklist.js";
+import type { MultiStepLoaderCopy } from "../components/multi-step-loader.js";
+import type { BrandGenerationErrorKind } from "./brand-generation-keys.js";
+import type { BrandGenerationRecoveryCopy } from "./brand-generation-recovery-copy.js";
+import type { BrandPersona } from "./types.js";
+/**
+ * Every string `BrandGenerationProgress` / `BrandGenerationSurface` render.
+ * The package does not do i18n: a consumer passes already translated strings
+ * (producer through `t()`), or relies on the English defaults below.
+ */
+export interface BrandGenerationCopy {
+    readonly title: string;
+    readonly subtitle: string;
+    readonly transportDegraded: string;
+    readonly cancelAction: string;
+    readonly eligibilityUnavailable: string;
+    /** Sub-label on a re-crawl pass, e.g. "pass 2". */
+    readonly passLabel: (pass: number) => string;
+    /** Rail labels keyed by generation phase. */
+    readonly phaseLabels: Readonly<Record<"mapping" | "selecting" | "crawling" | "consolidating" | "finalizing", string>>;
+    readonly errors: Readonly<Record<BrandGenerationErrorKind, string>>;
+    readonly checklist: BrandProfilePageChecklistCopy;
+    /** Step rail: the live-region announcement and the list's accessible name. */
+    readonly stepper: Required<MultiStepLoaderCopy>;
+    /** Accessible name of the placeholder rail shown before the first phase. */
+    readonly loadingStepsLabel: string;
+    /** Merged over `DEFAULT_BRAND_GENERATION_RECOVERY_COPY`. */
+    readonly recovery: BrandGenerationRecoveryCopy;
+    /** Shown when recovering an in-progress job failed (`discoveryError`). */
+    readonly recoveryFailed: string;
+    /** Review-step actions of `BrandGenerationSurface`. */
+    readonly acceptAction: string;
+    readonly acceptingAction: string;
+    readonly dismissAction: string;
+}
+/**
+ * Default copy for a persona. Importer and distributor orgs are the "importer"
+ * persona; they read their own company website, so the wording says so. Every
+ * other string is shared, which is the point: one flow, two voices, no drift.
+ */
+export declare function defaultBrandGenerationCopy(persona?: BrandPersona): BrandGenerationCopy;
+/** Overlay a consumer's partial copy on the persona defaults. */
+export declare function resolveBrandGenerationCopy(persona: BrandPersona, copy?: Partial<BrandGenerationCopy>): BrandGenerationCopy;
+//# sourceMappingURL=brand-generation-copy.d.ts.map

package/dist/brand/brand-generation-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-copy.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAC5B,MAAM,CAAC,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,GAAG,YAAY,EAAE,MAAM,CAAC,CACtF,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC;IAClD,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IAChD,4EAA4E;IAC5E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AA2CD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,YAAyB,GACjC,mBAAmB,CAQrB;AAED,iEAAiE;AACjE,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,YAAY,EACrB,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAClC,mBAAmB,CAYrB"}

package/dist/brand/brand-generation-copy.js

@@ -0,0 +1,70 @@
+import { defaultBrandProfilePageChecklistCopy, } from "../components/brand-profile-page-checklist.js";
+const PRODUCER_COPY = {
+    title: "Generating Brand Profile",
+    subtitle: "We are analyzing your website to build a complete brand profile.",
+    transportDegraded: "Live updates degraded, refreshing every 2s",
+    cancelAction: "Cancel",
+    eligibilityUnavailable: "Generation is unavailable right now. Try again later or create your profile manually.",
+    passLabel: (pass) => `pass ${pass}`,
+    phaseLabels: {
+        mapping: "Mapping your website",
+        selecting: "Choosing pages to read",
+        crawling: "Crawling and reading pages",
+        consolidating: "Consolidating information",
+        finalizing: "Saving draft",
+    },
+    errors: {
+        start: "Could not start generation. Try again.",
+        cancel: "Could not cancel generation. Try again.",
+        prioritize: "Could not prioritize this page. Try again.",
+        accept: "Could not accept profile. Try again.",
+        resume: "Could not resume generation. Try again.",
+    },
+    checklist: defaultBrandProfilePageChecklistCopy,
+    stepper: {
+        announceLabel: (current, total, label) => `Step ${current} of ${total}: ${label}`,
+        stepsLabel: "Process steps",
+    },
+    loadingStepsLabel: "Loading steps",
+    recovery: {
+        failedHeading: "Generation Failed",
+        failedBody: "An unknown error occurred.",
+        retryAction: "Retry",
+        createManuallyAction: "Cancel",
+        cancelAction: "Cancel",
+    },
+    recoveryFailed: "Could not recover an in-progress generation. Refresh the page to try again.",
+    acceptAction: "Accept Profile",
+    acceptingAction: "Accepting...",
+    dismissAction: "Dismiss",
+};
+/**
+ * Default copy for a persona. Importer and distributor orgs are the "importer"
+ * persona; they read their own company website, so the wording says so. Every
+ * other string is shared, which is the point: one flow, two voices, no drift.
+ */
+export function defaultBrandGenerationCopy(persona = "producer") {
+    if (persona === "importer") {
+        return {
+            ...PRODUCER_COPY,
+            subtitle: "We are analyzing your company website to build a complete brand profile.",
+        };
+    }
+    return PRODUCER_COPY;
+}
+/** Overlay a consumer's partial copy on the persona defaults. */
+export function resolveBrandGenerationCopy(persona, copy) {
+    const base = defaultBrandGenerationCopy(persona);
+    if (!copy)
+        return base;
+    return {
+        ...base,
+        ...copy,
+        phaseLabels: { ...base.phaseLabels, ...copy.phaseLabels },
+        errors: { ...base.errors, ...copy.errors },
+        checklist: { ...base.checklist, ...copy.checklist },
+        stepper: { ...base.stepper, ...copy.stepper },
+        recovery: { ...base.recovery, ...copy.recovery },
+    };
+}
+//# sourceMappingURL=brand-generation-copy.js.map

package/dist/brand/brand-generation-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-copy.js","sourceRoot":"","sources":["../../src/brand/brand-generation-copy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oCAAoC,GAErC,MAAM,4CAA4C,CAAC;AAuCpD,MAAM,aAAa,GAAwB;IACzC,KAAK,EAAE,0BAA0B;IACjC,QAAQ,EAAE,kEAAkE;IAC5E,iBAAiB,EAAE,4CAA4C;IAC/D,YAAY,EAAE,QAAQ;IACtB,sBAAsB,EACpB,uFAAuF;IACzF,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,IAAI,EAAE;IACnC,WAAW,EAAE;QACX,OAAO,EAAE,sBAAsB;QAC/B,SAAS,EAAE,wBAAwB;QACnC,QAAQ,EAAE,4BAA4B;QACtC,aAAa,EAAE,2BAA2B;QAC1C,UAAU,EAAE,cAAc;KAC3B;IACD,MAAM,EAAE;QACN,KAAK,EAAE,wCAAwC;QAC/C,MAAM,EAAE,yCAAyC;QACjD,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,sCAAsC;QAC9C,MAAM,EAAE,yCAAyC;KAClD;IACD,SAAS,EAAE,oCAAoC;IAC/C,OAAO,EAAE;QACP,aAAa,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,OAAO,OAAO,KAAK,KAAK,KAAK,EAAE;QACjF,UAAU,EAAE,eAAe;KAC5B;IACD,iBAAiB,EAAE,eAAe;IAClC,QAAQ,EAAE;QACR,aAAa,EAAE,mBAAmB;QAClC,UAAU,EAAE,4BAA4B;QACxC,WAAW,EAAE,OAAO;QACpB,oBAAoB,EAAE,QAAQ;QAC9B,YAAY,EAAE,QAAQ;KACvB;IACD,cAAc,EAAE,6EAA6E;IAC7F,YAAY,EAAE,gBAAgB;IAC9B,eAAe,EAAE,cAAc;IAC/B,aAAa,EAAE,SAAS;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAwB,UAAU;IAElC,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO;YACL,GAAG,aAAa;YAChB,QAAQ,EAAE,0EAA0E;SACrF,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,0BAA0B,CACxC,OAAqB,EACrB,IAAmC;IAEnC,MAAM,IAAI,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO;QACL,GAAG,IAAI;QACP,GAAG,IAAI;QACP,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE;QACzD,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE;QAC1C,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE;QACnD,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE;QAC7C,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;KACjD,CAAC;AACJ,CAAC"}

package/dist/brand/brand-generation-fixtures.d.ts

@@ -0,0 +1,32 @@
+import type { BrandGenerationApi } from "./brand-generation-api.js";
+import type { BrandGenerationEligibility, BrandGenerationJob, BrandGenerationJobProgress } from "./brand-generation-response.js";
+/** Fixtures for the generation flow's tests and stories. Not a public export. */
+export declare const IDLE_ELIGIBILITY: BrandGenerationEligibility;
+export declare function makeJob(overrides?: Partial<BrandGenerationJob>): BrandGenerationJob;
+export declare function makeProgress(phase: NonNullable<BrandGenerationJobProgress["phase"]>, extra?: Partial<BrandGenerationJobProgress>): BrandGenerationJobProgress;
+/** One `text/event-stream` frame for a job update. */
+export declare function sseFrame(update: Record<string, unknown>): string;
+export interface FakeStream {
+    /** The `fetch` to inject. Records every call in `calls`. */
+    readonly fetch: typeof fetch;
+    readonly calls: {
+        url: string;
+        init: RequestInit | undefined;
+    }[];
+    /** Push a frame to the open stream. */
+    push(frame: string): void;
+    /** End the open stream normally (without a terminal update). */
+    end(): void;
+    /** Error the open stream mid-read. */
+    fail(error: Error): void;
+    /** True once the consumer aborted the open request. */
+    readonly aborted: () => boolean;
+}
+/** A controllable SSE endpoint: one open stream per `fetch` call, driven by the test. */
+export declare function createFakeStream(options?: {
+    status?: number;
+    fetchError?: Error;
+}): FakeStream;
+/** A `BrandGenerationApi` whose every method is a configurable stub. */
+export declare function createFakeApi(overrides?: Partial<BrandGenerationApi>): BrandGenerationApi;
+//# sourceMappingURL=brand-generation-fixtures.d.ts.map

package/dist/brand/brand-generation-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-fixtures.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAEV,0BAA0B,EAC1B,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,6BAA6B,CAAC;AAErC,iFAAiF;AAEjF,eAAO,MAAM,gBAAgB,EAAE,0BAM9B,CAAC;AAEF,wBAAgB,OAAO,CAAC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAAG,kBAAkB,CAWvF;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,EACvD,KAAK,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAC9C,0BAA0B,CAE5B;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEhE;AAWD,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IACjE,uCAAuC;IACvC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gEAAgE;IAChE,GAAG,IAAI,IAAI,CAAC;IACZ,sCAAsC;IACtC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;CACjC;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAO,GACpD,UAAU,CAoCZ;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAAG,kBAAkB,CAW7F"}

package/dist/brand/brand-generation-fixtures.js

@@ -0,0 +1,88 @@
+/** Fixtures for the generation flow's tests and stories. Not a public export. */
+export const IDLE_ELIGIBILITY = {
+    canStart: true,
+    reason: null,
+    nextEligibleAt: null,
+    lastUsefulDraftAt: null,
+    retriesRemainingToday: 3,
+};
+export function makeJob(overrides = {}) {
+    return {
+        id: "job-1",
+        workflowId: "wf-1",
+        status: "running",
+        progress: {},
+        error: null,
+        createdAt: "2026-10-01T10:00:00.000Z",
+        updatedAt: "2026-10-01T10:00:00.000Z",
+        ...overrides,
+    };
+}
+export function makeProgress(phase, extra = {}) {
+    return { phase, ...extra };
+}
+/** One `text/event-stream` frame for a job update. */
+export function sseFrame(update) {
+    return `data: ${JSON.stringify(update)}\n\n`;
+}
+/** A closed or aborted stream rejects further writes; a test driving it after that is a no-op. */
+function safely(action) {
+    try {
+        action();
+    }
+    catch {
+        // stream already closed or errored
+    }
+}
+/** A controllable SSE endpoint: one open stream per `fetch` call, driven by the test. */
+export function createFakeStream(options = {}) {
+    const calls = [];
+    let controller = null;
+    let wasAborted = false;
+    const encoder = new TextEncoder();
+    const fakeFetch = ((input, init) => {
+        calls.push({ url: String(input), init });
+        if (options.fetchError)
+            return Promise.reject(options.fetchError);
+        init?.signal?.addEventListener("abort", () => {
+            wasAborted = true;
+            try {
+                controller?.error(new DOMException("aborted", "AbortError"));
+            }
+            catch {
+                // stream already closed
+            }
+        });
+        const body = new ReadableStream({
+            start(c) {
+                controller = c;
+            },
+        });
+        return Promise.resolve(new Response(body, {
+            status: options.status ?? 200,
+            headers: { "Content-Type": "text/event-stream" },
+        }));
+    });
+    return {
+        fetch: fakeFetch,
+        calls,
+        push: (frame) => safely(() => controller?.enqueue(encoder.encode(frame))),
+        end: () => safely(() => controller?.close()),
+        fail: (error) => safely(() => controller?.error(error)),
+        aborted: () => wasAborted,
+    };
+}
+/** A `BrandGenerationApi` whose every method is a configurable stub. */
+export function createFakeApi(overrides = {}) {
+    const idle = { job: null, eligibility: IDLE_ELIGIBILITY };
+    return {
+        start: async () => ({ jobId: "job-1", workflowId: "wf-1", reused: false }),
+        getActive: async () => idle,
+        getStatus: async () => makeJob(),
+        cancel: async () => makeJob({ status: "cancelled", outcome: "cancelled" }),
+        prioritizeUrl: async () => makeJob(),
+        accept: async () => makeJob({ status: "completed" }),
+        ...overrides,
+    };
+}
+//# sourceMappingURL=brand-generation-fixtures.js.map

package/dist/brand/brand-generation-fixtures.js.map

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

package/dist/brand/brand-generation-flow.d.ts

@@ -0,0 +1,34 @@
+import type { BrandGenerationJob } from "./brand-generation-response.js";
+interface BrandGenerationFlowInput<TProfile extends {
+    readonly status?: string;
+}, TDraft extends {
+    readonly generatedFromJobId?: string | null;
+}> {
+    readonly brandGeneration: {
+        readonly job: BrandGenerationJob | null;
+        readonly isGenerating: boolean;
+    };
+    readonly profile: TProfile | null | undefined;
+    readonly draftProfile: TDraft | null | undefined;
+    readonly profileError: boolean;
+    readonly draftError: boolean;
+}
+/**
+ * Decides whether the page is inside the generation flow (progress, recovery or
+ * draft review) or showing the settled profile. Pure, so every consumer derives
+ * the same answer from the same hook state and queries.
+ */
+export declare function deriveBrandGenerationFlow<TProfile extends {
+    readonly status?: string;
+}, TDraft extends {
+    readonly generatedFromJobId?: string | null;
+}>({ brandGeneration, profile, draftProfile, profileError, draftError, }: BrandGenerationFlowInput<TProfile, TDraft>): {
+    generatedDraftProfile: TDraft | null;
+    terminalDraftProfile: TDraft | null;
+    terminalJobOwnsDraft: boolean;
+    recoveredDraft: boolean;
+    inGenerationFlow: boolean;
+    workspaceProfile: TProfile | TDraft | null | undefined;
+};
+export {};
+//# sourceMappingURL=brand-generation-flow.d.ts.map

package/dist/brand/brand-generation-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-flow.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-flow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,UAAU,wBAAwB,CAChC,QAAQ,SAAS;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,MAAM,SAAS;IAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;IAE9D,QAAQ,CAAC,eAAe,EAAE;QACxB,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAAC;QACxC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,SAAS;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,MAAM,SAAS;IAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC9D,EACA,eAAe,EACf,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,EAAE,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC;;;;;;;EA8B5C"}

package/dist/brand/brand-generation-flow.js

@@ -0,0 +1,34 @@
+import { isTerminalStatus } from "./brand-generation-keys.js";
+/**
+ * Decides whether the page is inside the generation flow (progress, recovery or
+ * draft review) or showing the settled profile. Pure, so every consumer derives
+ * the same answer from the same hook state and queries.
+ */
+export function deriveBrandGenerationFlow({ brandGeneration, profile, draftProfile, profileError, draftError, }) {
+    const generatedDraftProfile = draftProfile?.generatedFromJobId ? draftProfile : null;
+    const activeJob = brandGeneration.job && !isTerminalStatus(brandGeneration.job.status)
+        ? brandGeneration.job
+        : null;
+    const terminalDraftProfile = generatedDraftProfile;
+    const terminalJobOwnsDraft = brandGeneration.job?.status === "completed" &&
+        terminalDraftProfile !== null &&
+        terminalDraftProfile.generatedFromJobId === brandGeneration.job.id;
+    const recoveredDraft = brandGeneration.job === null && Boolean(generatedDraftProfile);
+    const inGenerationFlow = brandGeneration.isGenerating ||
+        Boolean(activeJob) ||
+        profile?.status === "generating" ||
+        terminalJobOwnsDraft ||
+        brandGeneration.job?.status === "failed" ||
+        brandGeneration.job?.status === "cancelled" ||
+        (brandGeneration.job?.status === "completed" && (profileError || draftError)) ||
+        recoveredDraft;
+    return {
+        generatedDraftProfile,
+        terminalDraftProfile,
+        terminalJobOwnsDraft,
+        recoveredDraft,
+        inGenerationFlow,
+        workspaceProfile: generatedDraftProfile ?? profile,
+    };
+}
+//# sourceMappingURL=brand-generation-flow.js.map

package/dist/brand/brand-generation-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-flow.js","sourceRoot":"","sources":["../../src/brand/brand-generation-flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAiB3D;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAGvC,EACA,eAAe,EACf,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,UAAU,GACiC;IAC3C,MAAM,qBAAqB,GAAG,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IACrF,MAAM,SAAS,GACb,eAAe,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC;QAClE,CAAC,CAAC,eAAe,CAAC,GAAG;QACrB,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;IACnD,MAAM,oBAAoB,GACxB,eAAe,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW;QAC3C,oBAAoB,KAAK,IAAI;QAC7B,oBAAoB,CAAC,kBAAkB,KAAK,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;IACrE,MAAM,cAAc,GAAG,eAAe,CAAC,GAAG,KAAK,IAAI,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACtF,MAAM,gBAAgB,GACpB,eAAe,CAAC,YAAY;QAC5B,OAAO,CAAC,SAAS,CAAC;QAClB,OAAO,EAAE,MAAM,KAAK,YAAY;QAChC,oBAAoB;QACpB,eAAe,CAAC,GAAG,EAAE,MAAM,KAAK,QAAQ;QACxC,eAAe,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW;QAC3C,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,IAAI,CAAC,YAAY,IAAI,UAAU,CAAC,CAAC;QAC7E,cAAc,CAAC;IAEjB,OAAO;QACL,qBAAqB;QACrB,oBAAoB;QACpB,oBAAoB;QACpB,cAAc;QACd,gBAAgB;QAChB,gBAAgB,EAAE,qBAAqB,IAAI,OAAO;KACnD,CAAC;AACJ,CAAC"}

package/dist/brand/brand-generation-keys.d.ts

@@ -0,0 +1,16 @@
+import type { BrandGenerationJobStatus } from "./brand-generation-response.js";
+declare const brandGenerationErrorKinds: readonly ["start", "cancel", "prioritize", "accept", "resume"];
+export type BrandGenerationErrorKind = (typeof brandGenerationErrorKinds)[number];
+/**
+ * TanStack Query keys owned by the shared generation flow. Namespaced under
+ * `"brand-generation"` and scoped by org so they cannot collide with a
+ * consumer's own keys (CEL-2146). Consumers must not reuse this namespace.
+ */
+export declare const brandGenerationKeys: {
+    all: readonly ["brand-generation"];
+    active: (orgId: string) => readonly ["brand-generation", string, "active"];
+    latestTerminal: (orgId: string) => readonly ["brand-generation", string, "latest-terminal"];
+};
+export declare function isTerminalStatus(status: BrandGenerationJobStatus | undefined): boolean;
+export {};
+//# sourceMappingURL=brand-generation-keys.d.ts.map

package/dist/brand/brand-generation-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-keys.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAG5E,QAAA,MAAM,yBAAyB,gEAAiE,CAAC;AAEjG,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;oBAEd,MAAM;4BACE,MAAM;CAC/B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,wBAAwB,GAAG,SAAS,GAAG,OAAO,CAEtF"}

package/dist/brand/brand-generation-keys.js

@@ -0,0 +1,16 @@
+const terminalStatuses = ["completed", "failed", "cancelled"];
+const brandGenerationErrorKinds = ["start", "cancel", "prioritize", "accept", "resume"];
+/**
+ * TanStack Query keys owned by the shared generation flow. Namespaced under
+ * `"brand-generation"` and scoped by org so they cannot collide with a
+ * consumer's own keys (CEL-2146). Consumers must not reuse this namespace.
+ */
+export const brandGenerationKeys = {
+    all: ["brand-generation"],
+    active: (orgId) => ["brand-generation", orgId, "active"],
+    latestTerminal: (orgId) => ["brand-generation", orgId, "latest-terminal"],
+};
+export function isTerminalStatus(status) {
+    return status !== undefined && terminalStatuses.includes(status);
+}
+//# sourceMappingURL=brand-generation-keys.js.map

package/dist/brand/brand-generation-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-keys.js","sourceRoot":"","sources":["../../src/brand/brand-generation-keys.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAwC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AACnG,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAIjG;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,CAAC,kBAAkB,CAAU;IAClC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,kBAAkB,EAAE,KAAK,EAAE,QAAQ,CAAU;IACzE,cAAc,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,kBAAkB,EAAE,KAAK,EAAE,iBAAiB,CAAU;CAC3F,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,MAA4C;IAC3E,OAAO,MAAM,KAAK,SAAS,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACnE,CAAC"}

package/dist/brand/brand-generation-progress.d.ts

@@ -0,0 +1,27 @@
+import { type BrandGenerationCopy } from "./brand-generation-copy.js";
+import type { BrandGenerationErrorKind } from "./brand-generation-keys.js";
+import type { BrandGenerationContext, BrandGenerationEligibility, BrandGenerationJob } from "./brand-generation-response.js";
+import type { BrandPersona } from "./types.js";
+export interface BrandGenerationProgressProps {
+    readonly job: BrandGenerationJob | null;
+    readonly eligibility?: BrandGenerationEligibility | null;
+    readonly transportDegraded: boolean;
+    readonly error: BrandGenerationErrorKind | null;
+    /** The homepage URL a retry starts with. Empty hides the retry action. */
+    readonly resolvedUrl: string;
+    readonly onStart: (url: string, context?: BrandGenerationContext) => void;
+    readonly onCancel: () => void;
+    readonly onReset: () => void;
+    /** Persona picks the default wording; `copy` overrides any string. */
+    readonly persona?: BrandPersona;
+    readonly copy?: Partial<BrandGenerationCopy>;
+    /** Formats the ISO dates the recovery surface shows (cooldown). Required: locale is the caller's. */
+    readonly formatDateTime: (iso: string) => string;
+    readonly idPrefix?: string;
+}
+/**
+ * Progress, failure and recovery for one brand-generation attempt. Pure
+ * presentation: state comes from `useBrandGeneration`, strings from `copy`.
+ */
+export declare function BrandGenerationProgress({ job, eligibility, transportDegraded, error, resolvedUrl, onStart, onCancel, onReset, persona, copy, formatDateTime, idPrefix, }: BrandGenerationProgressProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=brand-generation-progress.d.ts.map

package/dist/brand/brand-generation-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-progress.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-progress.tsx"],"names":[],"mappings":"AAOA,OAAO,EAA8B,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAsB5C,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAChD,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7C,qGAAqG;IACrG,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,GAAG,EACH,WAAW,EACX,iBAAiB,EACjB,KAAK,EACL,WAAW,EACX,OAAO,EACP,QAAQ,EACR,OAAO,EACP,OAAoB,EACpB,IAAI,EACJ,cAAc,EACd,QAAsC,GACvC,EAAE,4BAA4B,2CAuG9B"}