@uibot/creation-kit 0.0.0-stage → 0.2.0

package/dist/client.d.ts

@@ -0,0 +1,81 @@
+import type { CreationContent, CreationDesignPreferences, CreationDomain, CreationProject, CreationProjectCreateInput, CreationProjectSummary, CreationRunInput } from "@uibot/contracts";
+/**
+ * Typed client for the creation HTTP contract served by `@uibot/application`'s
+ * `createUIBotStudioCreationHandler` (ADR 0012: headless logic ships in a package,
+ * hosts only supply transport). Studio and InfoOS call the same routes; the host
+ * passes a `fetch` that adds its own base path, credentials and tenant headers.
+ */
+export interface CreationClientOptions {
+    /** Route base the handler is mounted on, e.g. `/api/studio/creation`. */
+    base: string;
+    /** Host fetch (auth, tenant, cookies). Defaults to `globalThis.fetch`. */
+    fetch?: (url: string, init: RequestInit) => Promise<Response>;
+    /**
+     * Path of the configuration route relative to `base`. The handler serves it at `base` itself
+     * (`""`, the default); a host proxy that needs a named segment (Studio uses `/configuration`)
+     * overrides it.
+     */
+    configurationPath?: string;
+}
+export interface CreationConfiguration {
+    domains: CreationDomain[];
+    generation: {
+        ready: boolean;
+        modelId: string;
+        reconciliationAvailable?: boolean;
+    };
+}
+export interface CreationProjectList {
+    projects: CreationProjectSummary[];
+    issues?: Array<{
+        projectId: string;
+        code: string;
+        message: string;
+    }>;
+}
+export interface CreationSourceInput {
+    kind: "reference" | "brand";
+    title: string;
+    content: string;
+    design?: CreationDesignPreferences;
+    /** Required with `design` on a brand source: project version the change is based on. */
+    expectedVersion?: number;
+}
+export interface CreationArtifactInput {
+    kind: string;
+    title: string;
+    source: CreationContent;
+}
+export interface CreationRevisionInput {
+    /** Current tip the edit is based on; a stale value fails with `revision-conflict`. */
+    expectedRevisionId: string | null;
+    source: CreationContent;
+    /** Restore-as-new-revision: the historical revision this source was copied from. */
+    restoredFrom?: string;
+}
+/** Error returned by the creation handler (`{ error: { code, message } }`). */
+export declare class CreationApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(code: string, message: string, status: number);
+}
+export interface CreationClient {
+    /** Low-level request for routes this client does not wrap yet (path is relative to `base`). */
+    request<T>(path: string, init?: {
+        method?: string;
+        body?: unknown;
+        signal?: AbortSignal;
+    }): Promise<T>;
+    getConfiguration(signal?: AbortSignal): Promise<CreationConfiguration>;
+    listProjects(signal?: AbortSignal): Promise<CreationProjectList>;
+    createProject(input: CreationProjectCreateInput): Promise<CreationProject>;
+    getProject(projectId: string, signal?: AbortSignal): Promise<CreationProject>;
+    addSource(projectId: string, input: CreationSourceInput): Promise<CreationProject>;
+    appendArtifact(projectId: string, input: CreationArtifactInput): Promise<CreationProject>;
+    saveRevision(projectId: string, artifactId: string, input: CreationRevisionInput): Promise<CreationProject>;
+    startRun(projectId: string, input: CreationRunInput): Promise<CreationProject>;
+    cancelRun(projectId: string, runId: string): Promise<CreationProject>;
+    resumeRun(projectId: string, runId: string): Promise<CreationProject>;
+}
+export declare function creationProjectPath(projectId: string): string;
+export declare function createCreationClient(options: CreationClientOptions): CreationClient;

package/dist/client.js

@@ -0,0 +1 @@
+class d extends Error{code;status;constructor(o,c,p){super(c);this.code=o;this.status=p;this.name="CreationApiError"}}function C(o){return`/projects/${encodeURIComponent(o)}`}function l(o){let c=o.base.replace(/\/$/,""),p=o.fetch??((e,t)=>globalThis.fetch(e,t));async function n(e,t={}){let u=t.method??(t.body===void 0?"GET":"POST"),i=await p(`${c}${e}`,{method:u,headers:{accept:"application/json",...t.body===void 0?{}:{"content-type":"application/json"}},...t.body===void 0?{}:{body:JSON.stringify(t.body)},...t.signal?{signal:t.signal}:{}}),g=await i.text(),s=null;if(g)try{s=JSON.parse(g)}catch{s=null}if(!i.ok){let a=s?.error;throw new d(typeof a?.code==="string"?a.code:"request-failed",typeof a?.message==="string"?a.message:`Request failed (${i.status})`,i.status)}if(s===null)throw new d("invalid-response","Empty or non-JSON response",i.status);return s}let r=C;return{request:n,getConfiguration:(e)=>n(o.configurationPath??"",{method:"GET",...e?{signal:e}:{}}),listProjects:(e)=>n("/projects",{method:"GET",...e?{signal:e}:{}}),createProject:(e)=>n("/projects",{body:e}),getProject:(e,t)=>n(r(e),{method:"GET",...t?{signal:t}:{}}),addSource:(e,t)=>n(`${r(e)}/sources`,{body:t}),appendArtifact:(e,t)=>n(`${r(e)}/artifacts`,{body:t}),saveRevision:(e,t,u)=>n(`${r(e)}/artifacts/${encodeURIComponent(t)}/revisions`,{body:u}),startRun:(e,t)=>n(`${r(e)}/runs`,{body:t}),cancelRun:(e,t)=>n(`${r(e)}/runs/${encodeURIComponent(t)}/cancel`,{body:{}}),resumeRun:(e,t)=>n(`${r(e)}/runs/${encodeURIComponent(t)}/resume`,{body:{}})}}export{d as CreationApiError,l as createCreationClient,C as creationProjectPath};

package/dist/cn.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from "clsx";
+/** Class-name helper shared by kind packages (same semantics as the host's `cn`). */
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/contract.d.ts

@@ -0,0 +1,162 @@
+import type { ComponentType, LazyExoticComponent, ReactNode } from "react";
+import type { ArtifactExportFormat, CreationArtifact, CreationContent, CreationProject, CreationRevision, CreationSourceFormat } from "@uibot/contracts";
+/** Bumped only on a breaking change to the plugin contract; checked at registration. */
+export declare const CREATION_KIT_API: 1;
+export type CreationLocale = "zh" | "en";
+export interface LocalizedText {
+    zh: string;
+    en: string;
+}
+/** Project-level assets the host knows how to pin to artifact revisions. */
+export type CreationAssetSlot = "brand" | "theme";
+export interface CreationKindPlugin {
+    /** Unique plugin id, e.g. "logo". */
+    id: string;
+    version: string;
+    kitApi: typeof CREATION_KIT_API;
+    /** Workbench-style task kinds (no server domain required). */
+    kinds?: CreationTaskKindContribution[];
+    /** Editors resolved by `CreationDomain.editors[format]`. */
+    editors?: CreationEditorContribution[];
+    /** Read-only artifact views, e.g. slide-by-slide navigation. */
+    views?: CreationArtifactViewContribution[];
+    projectAssets?: CreationProjectAssetContribution[];
+}
+export interface CreationTaskKindContribution {
+    /** Value of the `?kind=` route parameter. Must not collide with a server artifactKind. */
+    kind: string;
+    label: LocalizedText;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    order?: number;
+    /** Shown in the conversation pane before any activity. */
+    emptyChat?: LocalizedText;
+    /** Composer placeholder while this kind is selected; the host's generic prompt otherwise. */
+    placeholder?: LocalizedText;
+    layout?: {
+        viewportClassName?: string;
+        frameClassName?: string;
+    };
+    /** Consumes this kind's own route parameters; invalid values are dropped. */
+    parseSearch?(raw: Record<string, unknown>): Record<string, string>;
+    /** Project-context menu entry that starts this kind from an existing project. */
+    menu?: {
+        title: LocalizedText;
+        description: LocalizedText;
+    };
+    /** Opens a project asset dialog straight from route parameters (e.g. a pre-selected draft). */
+    initialAsset?(search: Record<string, string>): {
+        slot: CreationAssetSlot;
+        draft: unknown;
+    } | null;
+    Workbench: CreationComponent<CreationWorkbenchProps>;
+}
+export type CreationComponent<P> = ComponentType<P> | LazyExoticComponent<ComponentType<P>>;
+export interface CreationWorkbenchProps {
+    project: CreationProject;
+    locale: CreationLocale;
+    /** Hidden workbenches stay mounted so in-progress work survives kind switches. */
+    active: boolean;
+    /** Host-owned slot where the workbench renders its composer controls. */
+    composerTarget: HTMLElement | null;
+    kindPicker: ReactNode;
+    initialIntent?: string;
+    /** Route parameters from `parseSearch`. */
+    search: Record<string, string>;
+    selection: {
+        artifactId: string;
+        revisionId: string;
+    } | null;
+    onBusyChange(busy: boolean): void;
+    onFocusComposer(): void;
+    /** Mirrors workbench activity into the conversation pane. */
+    onActivity(role: "user" | "assistant", text: string): void;
+    /** Opens the host dialog for a project asset slot, optionally with a draft. */
+    openProjectAsset(slot: CreationAssetSlot, draft?: unknown, options?: {
+        returnFocusId?: string;
+    }): void;
+    /** Receives the updated project after any write. */
+    onProject(project: CreationProject): void;
+}
+export interface CreationEditorContribution {
+    /** Matches `CreationDomain.editors[format]`. */
+    id: string;
+    format: CreationSourceFormat;
+    label: LocalizedText;
+    Editor: CreationComponent<CreationEditorProps>;
+}
+export interface CreationEditorProps {
+    source: CreationContent;
+    locale: CreationLocale;
+    toolbarTarget?: HTMLElement | null;
+    onDirtyChange(dirty: boolean): void;
+    /** The host owns CAS, brand restoration and revision commit. */
+    onSave(content: string): Promise<void>;
+}
+export interface CreationViewContext {
+    artifactKind: string;
+    format: CreationSourceFormat;
+    content: string;
+}
+export interface CreationArtifactViewContribution {
+    id: string;
+    label: LocalizedText;
+    match(ctx: CreationViewContext): boolean;
+    View: CreationComponent<CreationArtifactViewProps>;
+}
+export interface CreationArtifactViewProps {
+    content: string;
+    title: string;
+    locale: CreationLocale;
+    active: boolean;
+}
+export interface CreationProjectAssetContribution {
+    slot: CreationAssetSlot;
+    label: LocalizedText;
+    /** Task kind that creates a new asset, e.g. brand → "logo". */
+    createKind?: string;
+    /** Entry shown in the project-context menu, whether or not the asset exists yet. */
+    summary(project: CreationProject, locale: CreationLocale): ProjectAssetSummary;
+    /** Short state shown on the context-menu trigger, e.g. "Brand saved". */
+    status(project: CreationProject, locale: CreationLocale): string;
+    /** Title of the dialog hosting `Panel`. */
+    dialog: {
+        title: LocalizedText;
+        description: LocalizedText;
+        settingsLabel: LocalizedText;
+    };
+    revisionBadge?(project: CreationProject, revision: CreationRevision, locale: CreationLocale): string | null;
+    exportConstraint?(revision: CreationRevision): {
+        formats?: ArtifactExportFormat[];
+        note?: LocalizedText;
+    } | null;
+    Panel: CreationComponent<ProjectAssetPanelProps>;
+}
+export interface ProjectAssetSummary {
+    title: string;
+    subtitle: string;
+    ariaLabel: string;
+    thumbnailUrl?: string;
+}
+/** Outcome shown by the host after the asset panel saves or applies something. */
+export interface ProjectAssetReceipt {
+    message: string;
+    artifactId?: string;
+    revisionId?: string;
+}
+export interface ProjectAssetPanelProps {
+    project: CreationProject;
+    selection: {
+        artifact?: CreationArtifact;
+        revision?: CreationRevision;
+        dirty: boolean;
+    };
+    draft?: unknown;
+    locale: CreationLocale;
+    onProject(project: CreationProject): void;
+    onReceipt(receipt: ProjectAssetReceipt): void;
+    onApplied(artifactId: string, revisionId: string): void;
+    /** Starts the task kind that creates this asset (`createKind`), closing the dialog. */
+    onCreateKind?(): void;
+}

package/dist/deck-plugin.d.ts

@@ -0,0 +1,3 @@
+import { type CreationKindPlugin } from "./contract.js";
+/** Built-in plugin: slide-by-slide viewing for presentation artifacts. */
+export declare const presentationDeckPlugin: CreationKindPlugin;

package/dist/deck-viewer.d.ts

@@ -0,0 +1,7 @@
+import type { CreationArtifactViewProps } from "./contract.js";
+/**
+ * Read-only slide viewer: one sandboxed iframe per slide, keyboard stepping
+ * (←/→/Space/PageUp/PageDown/Home/End, N notes, F fullscreen), a numbered strip, speaker
+ * notes and print-to-PDF. Shortcuts ignore editable targets and only listen while `active`.
+ */
+export declare function DeckViewer({ content, locale, active }: CreationArtifactViewProps): import("react").JSX.Element;

package/dist/deck.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Slide-deck helpers for presentation artifacts.
+ *
+ * Presentation artifacts are one HTML document whose slides are top-level
+ * `<section data-slide>` elements (the `presentation` domain contract), with that slide's
+ * speaker notes in an `<aside data-notes>`. Older Canvas decks used `<section class="slide">`
+ * with `<aside class="notes">`; both shapes are accepted. This module splits the document
+ * into one standalone document per slide so a viewer can render and step through them.
+ * Pure string work: no DOM, so it is testable and safe to run anywhere.
+ */
+export interface DeckSlide {
+    /** Standalone HTML doc (head + just-this-slide body) for srcdoc. */
+    html: string;
+    /** Speaker notes plain text, if any. */
+    notes: string;
+    /** Slide id from data-slide / data-slide-id, or the 1-based index. */
+    id: string;
+    /** Best-effort section background for the thumbnail strip. */
+    bg?: string;
+}
+export interface DeckParsed {
+    isDeck: boolean;
+    slides: DeckSlide[];
+    head: string;
+    bodyClass: string;
+    bodyStyle: string;
+    title: string;
+}
+/** Cheap test: does the document contain at least one slide section? */
+export declare function isDeck(html: string): boolean;
+/** Parse a full deck HTML document into per-slide standalone documents. */
+export declare function parseDeck(fullHtml: string): DeckParsed;
+/**
+ * Trusted print-window shell: `@page` CSS, one empty sandboxed iframe per slide and the
+ * `window.print()` trigger. It takes only a count, so no AI-authored text can reach it.
+ */
+export declare function buildPrintShellHtml(slideCount: number): string;
+/**
+ * Open a print window (one slide per page) so the browser can "Save as PDF". Returns false
+ * when the popup is blocked.
+ *
+ * Deck HTML is AI-authored and may carry scripts. The popup is same-origin with Studio, so
+ * its document only ever receives `buildPrintShellHtml`'s trusted markup; each slide's
+ * standalone document is assigned through the iframe `srcdoc` DOM property into a
+ * `sandbox="allow-scripts"` frame (no `allow-same-origin`), and the opener reference is cut.
+ */
+export declare function printDeckToPdf(parsed: DeckParsed, open?: (url: string, target: string) => Window | null): boolean;

package/dist/errors.d.ts

@@ -0,0 +1,2 @@
+/** HTTP status carried by a host request error (e.g. Studio's `StudioApiError`), if any. */
+export declare function creationErrorStatus(error: unknown): number | undefined;

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./contract.js";
+export * from "./registry.js";
+export * from "./transport.js";
+export * from "./cn.js";
+export * from "./errors.js";
+export * from "./locale.js";
+export * from "./ui.js";
+export * from "./deck.js";
+export * from "./deck-plugin.js";
+export { DeckViewer } from "./deck-viewer.js";
+export * from "./client.js";

package/dist/index.js

@@ -0,0 +1,17 @@
+var v=1;var I=/^[a-z][a-z0-9-]{0,39}$/;function R(e,c,r,t){if(c.has(r))throw Error(`Duplicate creation ${e} "${r}" (plugin ${t})`);c.add(r)}function xe(e){let c=new Set,r=new Map,t=new Map,l=new Set,a=[],n=new Map;for(let o of e){if(o.kitApi!==v)throw Error(`Creation plugin "${o.id}" targets kit API ${String(o.kitApi)}, expected ${v}`);R("plugin",c,o.id,o.id);for(let i of o.kinds??[]){if(!I.test(i.kind))throw Error(`Invalid creation kind "${i.kind}" (plugin ${o.id})`);if(r.has(i.kind))throw Error(`Duplicate creation kind "${i.kind}" (plugin ${o.id})`);r.set(i.kind,i)}for(let i of o.editors??[]){let p=`${i.id}:${i.format}`;if(t.has(p))throw Error(`Duplicate creation editor "${p}" (plugin ${o.id})`);t.set(p,i)}for(let i of o.views??[])R("view",l,i.id,o.id),a.push(i);for(let i of o.projectAssets??[]){if(n.has(i.slot))throw Error(`Duplicate creation asset slot "${i.slot}" (plugin ${o.id})`);n.set(i.slot,i)}}let f=[...r.values()].sort((o,i)=>(o.order??100)-(i.order??100)||o.kind.localeCompare(i.kind));return{plugins:e,taskKind:(o)=>o?r.get(o):void 0,taskKinds:()=>[...f],kindOptions(o,i,p){let g=o.map((d)=>({value:d.artifactKind,label:p?.(d)??d.title,disabled:!d.enabled})),C=new Set(g.map((d)=>d.value));for(let d of f){if(C.has(d.kind)){console.error(`Creation workbench kind "${d.kind}" shadows a server domain and is hidden`);continue}g.push({value:d.kind,label:d.label[i]})}return g},label:(o,i,p)=>r.get(o)?.label[i]??p??o,editor:(o,i)=>o?t.get(`${o}:${i}`):void 0,views:(o)=>a.filter((i)=>i.match(o)),projectAssets:()=>[...n.values()],projectAsset:(o)=>n.get(o),parseRouteSearch(o){let i=typeof o.kind==="string"&&I.test(o.kind)?o.kind:void 0,p={};for(let g of f){if(!g.parseSearch)continue;Object.assign(p,g.parseSearch(o))}return{...i?{kind:i}:{},extra:p}}}}import{createContext as M,useContext as H}from"react";import{jsx as q}from"react/jsx-runtime";var U=M(null);function Pe(e){return q(U.Provider,{value:e.transport,children:e.children})}function he(){let e=H(U);if(!e)throw Error("useCreationTransport requires a CreationTransportProvider");return e}import{clsx as _}from"clsx";import{twMerge as G}from"tailwind-merge";function De(...e){return G(_(e))}function je(e){if(!(e instanceof Error))return;let{status:c}=e;return typeof c==="number"?c:void 0}import{createContext as J,useContext as W}from"react";import{jsx as Y}from"react/jsx-runtime";var N=J("en");function Ue(e){return Y(N.Provider,{value:e.locale,children:e.children})}function Ne(){return W(N)}import{createContext as X,useContext as Z}from"react";import{jsx as L}from"react/jsx-runtime";var E=X(null);function Oe(e){return L(E.Provider,{value:e.primitives,children:e.children})}function Q(){let e=Z(E);if(!e)throw Error("Creation UI primitives require a CreationUiProvider");return e}function s(e,c){let r=(t)=>{let l=e(Q());return L(l,{...t})};return r.displayName=c,r}var Ke=s((e)=>e.Button,"Button"),Ve=s((e)=>e.Badge,"Badge"),ze=s((e)=>e.Label,"Label"),Fe=s((e)=>e.Input,"Input"),Be=s((e)=>e.Textarea,"Textarea"),Me=s((e)=>e.Checkbox,"Checkbox"),He=s((e)=>e.Collapsible,"Collapsible"),qe=s((e)=>e.CollapsibleTrigger,"CollapsibleTrigger"),_e=s((e)=>e.CollapsibleContent,"CollapsibleContent"),Ge=s((e)=>e.ScrollArea,"ScrollArea"),Je=s((e)=>e.ScrollBar,"ScrollBar"),We=s((e)=>e.Select,"Select"),Ye=s((e)=>e.SelectTrigger,"SelectTrigger"),Xe=s((e)=>e.SelectValue,"SelectValue"),Ze=s((e)=>e.SelectContent,"SelectContent"),Qe=s((e)=>e.SelectItem,"SelectItem"),et=s((e)=>e.Tabs,"Tabs"),tt=s((e)=>e.TabsList,"TabsList"),ot=s((e)=>e.TabsTrigger,"TabsTrigger"),nt=s((e)=>e.TabsContent,"TabsContent"),rt=s((e)=>e.Tooltip,"Tooltip"),it=s((e)=>e.TooltipProvider,"TooltipProvider"),at=s((e)=>e.TooltipTrigger,"TooltipTrigger"),st=s((e)=>e.TooltipContent,"TooltipContent"),lt=s((e)=>e.Popover,"Popover"),ct=s((e)=>e.PopoverTrigger,"PopoverTrigger"),pt=s((e)=>e.PopoverContent,"PopoverContent"),dt=s((e)=>e.Dialog,"Dialog"),ut=s((e)=>e.DialogTrigger,"DialogTrigger"),gt=s((e)=>e.DialogContent,"DialogContent"),Ct=s((e)=>e.DialogHeader,"DialogHeader"),mt=s((e)=>e.DialogFooter,"DialogFooter"),ft=s((e)=>e.DialogTitle,"DialogTitle"),bt=s((e)=>e.DialogDescription,"DialogDescription"),xt=s((e)=>e.Prompt,"Prompt");var w=/<(\/?)section\b[^>]*>/gi;function T(e,c){let r=new RegExp(`\\b${c}(?:\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s>]+)))?`,"i").exec(e);if(!r)return;return r[1]??r[2]??r[3]??""}function ee(e){if(T(e,"data-slide")!==void 0)return!0;return/\bslide\b/i.test(T(e,"class")??"")}function k(e,c){return e.exec(c)?.[1]??""}function te(e){return e.replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#39;/g,"'")}function O(e){return te(e.replace(/<[^>]+>/g," ")).replace(/\s+/g," ").trim()}function K(e){let c=[];w.lastIndex=0;let r=0,t=-1;for(let l=w.exec(e);l;l=w.exec(e)){if(l[1]==="/"){if(r===0)continue;if(r-=1,r===0&&t>=0)c.push(e.slice(t,l.index+l[0].length)),t=-1;continue}if(r===0){if(!ee(l[0]))continue;t=l.index}r+=1}return c}function V(e){return Boolean(e)&&K(e).length>0}var oe=/<aside\b([^>]*)>([\s\S]*?)<\/aside>/i;function ne(e){let c="";return{slide:e.replace(oe,(t,l,a)=>{if(!(T(`<aside ${l}>`,"data-notes")!==void 0||/\bnotes\b/i.test(T(`<aside ${l}>`,"class")??"")))return t;return c=O(a),""}),notes:c}}function z(e){let c=K(e);if(c.length===0)return{isDeck:!1,slides:[],head:"",bodyClass:"",bodyStyle:"",title:"deck"};let r=k(/<head\b[^>]*>([\s\S]*?)<\/head>/i,e),t=`<body ${k(/<body\b([^>]*)>/i,e)}>`,l=T(t,"class")??"",a=T(t,"style")??"",n=O(k(/<title\b[^>]*>([\s\S]*?)<\/title>/i,r))||"deck",f=new Set;return{isDeck:!0,slides:c.map((i,p)=>{let g=k(/(<section\b[^>]*>)/i,i),C=T(g,"data-slide")||T(g,"data-slide-id")||String(p+1),d=f.has(C)?`${C}-${p+1}`:C;f.add(d);let x=k(/background(?:-color)?\s*:\s*([^;"']+)/i,T(g,"style")??"").trim()||void 0,{slide:m,notes:u}=ne(i);return{html:`<!DOCTYPE html><html><head>${r}
+<style>
+  html, body { margin:0; padding:0; }
+  body { display:flex; align-items:center; justify-content:center; min-height:100vh; }
+  .slide, [data-slide] { transform-origin: center center !important; }
+</style></head><body class="${l}" style="${a}">${m}</body></html>`,notes:u,id:d,...x?{bg:x}:{}}}),head:r,bodyClass:l,bodyStyle:a,title:n}}function re(e){return`<!DOCTYPE html><html><head>
+<style>
+  @page { size: 1280px 720px; margin: 0; }
+  html, body { margin:0; padding:0; }
+  .page { width: 1280px; height: 720px; overflow: hidden; page-break-after: always; }
+  .page:last-child { page-break-after: auto; }
+  .page iframe.slide { display:block; width:100%; height:100%; border:0; }
+</style></head><body>
+${Array.from({length:e},(r,t)=>`<div class="page"><iframe class="slide" data-slide-index="${t}" sandbox="allow-scripts"></iframe></div>`).join(`
+`)}
+<script>window.onload=()=>setTimeout(()=>window.print(),300)</script>
+</body></html>`}function F(e,c=(r,t)=>window.open(r,t)){let r=c("","_blank");if(!r)return!1;r.opener=null,r.document.write(re(e.slides.length)),r.document.close();let t=r.document.querySelectorAll("iframe.slide");return e.slides.forEach((l,a)=>{let n=t[a];if(n)n.srcdoc=l.html}),!0}import{ChevronLeft as ie,ChevronRight as ae,FileDown as se,Maximize2 as le,StickyNote as ce}from"lucide-react";import{useEffect as B,useMemo as pe,useRef as de,useState as S}from"react";import{jsx as b,jsxs as y}from"react/jsx-runtime";var ue={empty:"No slides found (each slide must be a <section data-slide>).",prev:"Previous slide",next:"Next slide",notes:"Notes",notesTitle:"Speaker notes (N)",notesHeading:"Speaker notes",present:"Present",presentTitle:"Full screen (F)",pdfTitle:"Print to PDF",blocked:"The popup was blocked. Allow popups for this site and try again.",page:"Slide"},ge={empty:"未检测到幻灯片（每页需为 <section data-slide>）。",prev:"上一页",next:"下一页",notes:"备注",notesTitle:"演讲者备注（N）",notesHeading:"演讲者备注",present:"放映",presentTitle:"全屏放映（F）",pdfTitle:"打印为 PDF",blocked:"弹窗被拦截，请允许本站弹出窗口后重试。",page:"第"},Ce={en:ue,zh:ge},D="inline-flex items-center gap-1 rounded-md border px-2 py-1 text-xs";function A({content:e,locale:c,active:r}){let t=Ce[c],l=pe(()=>z(e),[e]),[a,n]=S(0),[f,o]=S(!1),[i,p]=S(""),g=de(null),C=l.slides.length,d=Math.min(a,Math.max(0,C-1)),x=l.slides[d];if(B(()=>n(0),[e]),B(()=>{if(!r||C===0)return;let m=(u)=>{let P=u.target;if(P&&(P.tagName==="INPUT"||P.tagName==="TEXTAREA"||P.isContentEditable))return;if(u.key==="ArrowRight"||u.key==="PageDown"||u.key===" ")u.preventDefault(),n((h)=>Math.min(h+1,C-1));else if(u.key==="ArrowLeft"||u.key==="PageUp")u.preventDefault(),n((h)=>Math.max(h-1,0));else if(u.key==="Home")n(0);else if(u.key==="End")n(C-1);else if(u.key.toLowerCase()==="n")o((h)=>!h);else if(u.key.toLowerCase()==="f")if(document.fullscreenElement)document.exitFullscreen();else g.current?.requestFullscreen?.()};return window.addEventListener("keydown",m),()=>window.removeEventListener("keydown",m)},[r,C]),!x)return b("div",{className:"flex h-full items-center justify-center p-6 text-sm text-muted-foreground",children:t.empty});return y("div",{ref:g,className:"flex h-full min-h-72 flex-col bg-muted/30",children:[y("div",{className:"relative min-h-0 flex-1",children:[b("iframe",{title:`slide-${x.id}`,srcDoc:x.html,sandbox:"allow-scripts",className:"h-full w-full border-0 bg-white"},x.id),b("button",{type:"button",onClick:()=>n((m)=>Math.max(m-1,0)),disabled:d===0,className:"absolute left-2 top-1/2 -translate-y-1/2 rounded-full border bg-background/80 p-1.5 shadow backdrop-blur disabled:opacity-30","aria-label":t.prev,children:b(ie,{className:"size-4"})}),b("button",{type:"button",onClick:()=>n((m)=>Math.min(m+1,C-1)),disabled:d===C-1,className:"absolute right-2 top-1/2 -translate-y-1/2 rounded-full border bg-background/80 p-1.5 shadow backdrop-blur disabled:opacity-30","aria-label":t.next,children:b(ae,{className:"size-4"})}),y("div",{className:"absolute bottom-2 left-1/2 -translate-x-1/2 rounded-full bg-foreground/80 px-2.5 py-0.5 text-xs tabular-nums text-background",children:[d+1," / ",C]}),f&&x.notes&&y("div",{className:"absolute inset-x-3 bottom-10 max-h-[40%] overflow-y-auto rounded-md border bg-background/95 p-3 text-sm shadow-lg",children:[b("div",{className:"mb-1 text-[10px] font-medium uppercase tracking-wide text-muted-foreground",children:t.notesHeading}),x.notes]})]}),i&&b("p",{role:"status",className:"border-t bg-background px-3 py-1 text-xs text-destructive",children:i}),y("div",{className:"flex items-center gap-2 border-t bg-background px-3 py-2",children:[b("div",{className:"flex min-w-0 flex-1 gap-1.5 overflow-x-auto",children:l.slides.map((m,u)=>b("button",{type:"button",onClick:()=>n(u),"aria-label":`${t.page} ${u+1}`,"aria-current":u===d?"true":void 0,...m.bg?{style:{background:m.bg}}:{},className:`flex size-7 shrink-0 items-center justify-center rounded border text-[11px] tabular-nums ${u===d?"border-primary ring-2 ring-primary/30":"text-muted-foreground hover:border-foreground/30"}`,children:u+1},m.id))}),y("button",{type:"button",onClick:()=>o((m)=>!m),className:`${D} ${f?"border-primary bg-primary/10 text-primary":"text-muted-foreground hover:bg-accent"}`,title:t.notesTitle,children:[b(ce,{className:"size-3.5"}),t.notes]}),y("button",{type:"button",onClick:()=>{if(!document.fullscreenElement)g.current?.requestFullscreen?.()},className:`${D} text-muted-foreground hover:bg-accent`,title:t.presentTitle,children:[b(le,{className:"size-3.5"}),t.present]}),y("button",{type:"button",onClick:()=>p(F(l)?"":t.blocked),className:`${D} text-muted-foreground hover:bg-accent`,title:t.pdfTitle,children:[b(se,{className:"size-3.5"}),"PDF"]})]})]})}var It={id:"presentation-deck",version:"1.0.0",kitApi:v,views:[{id:"slides",label:{zh:"幻灯片",en:"Slides"},match:(e)=>e.artifactKind==="presentation"&&e.format==="html"&&V(e.content),View:A}]};class j extends Error{code;status;constructor(e,c,r){super(c);this.code=e;this.status=r;this.name="CreationApiError"}}function me(e){return`/projects/${encodeURIComponent(e)}`}function Ut(e){let c=e.base.replace(/\/$/,""),r=e.fetch??((a,n)=>globalThis.fetch(a,n));async function t(a,n={}){let f=n.method??(n.body===void 0?"GET":"POST"),o=await r(`${c}${a}`,{method:f,headers:{accept:"application/json",...n.body===void 0?{}:{"content-type":"application/json"}},...n.body===void 0?{}:{body:JSON.stringify(n.body)},...n.signal?{signal:n.signal}:{}}),i=await o.text(),p=null;if(i)try{p=JSON.parse(i)}catch{p=null}if(!o.ok){let g=p?.error;throw new j(typeof g?.code==="string"?g.code:"request-failed",typeof g?.message==="string"?g.message:`Request failed (${o.status})`,o.status)}if(p===null)throw new j("invalid-response","Empty or non-JSON response",o.status);return p}let l=me;return{request:t,getConfiguration:(a)=>t(e.configurationPath??"",{method:"GET",...a?{signal:a}:{}}),listProjects:(a)=>t("/projects",{method:"GET",...a?{signal:a}:{}}),createProject:(a)=>t("/projects",{body:a}),getProject:(a,n)=>t(l(a),{method:"GET",...n?{signal:n}:{}}),addSource:(a,n)=>t(`${l(a)}/sources`,{body:n}),appendArtifact:(a,n)=>t(`${l(a)}/artifacts`,{body:n}),saveRevision:(a,n,f)=>t(`${l(a)}/artifacts/${encodeURIComponent(n)}/revisions`,{body:f}),startRun:(a,n)=>t(`${l(a)}/runs`,{body:n}),cancelRun:(a,n)=>t(`${l(a)}/runs/${encodeURIComponent(n)}/cancel`,{body:{}}),resumeRun:(a,n)=>t(`${l(a)}/runs/${encodeURIComponent(n)}/resume`,{body:{}})}}export{Ve as Badge,Ke as Button,v as CREATION_KIT_API,Me as Checkbox,He as Collapsible,_e as CollapsibleContent,qe as CollapsibleTrigger,j as CreationApiError,Ue as CreationLocaleProvider,Pe as CreationTransportProvider,Oe as CreationUiProvider,A as DeckViewer,dt as Dialog,gt as DialogContent,bt as DialogDescription,mt as DialogFooter,Ct as DialogHeader,ft as DialogTitle,ut as DialogTrigger,Fe as Input,ze as Label,lt as Popover,pt as PopoverContent,ct as PopoverTrigger,xt as Prompt,Ge as ScrollArea,Je as ScrollBar,We as Select,Ze as SelectContent,Qe as SelectItem,Ye as SelectTrigger,Xe as SelectValue,et as Tabs,nt as TabsContent,tt as TabsList,ot as TabsTrigger,Be as Textarea,rt as Tooltip,st as TooltipContent,it as TooltipProvider,at as TooltipTrigger,re as buildPrintShellHtml,De as cn,Ut as createCreationClient,xe as createCreationKindRegistry,je as creationErrorStatus,me as creationProjectPath,V as isDeck,z as parseDeck,It as presentationDeckPlugin,F as printDeckToPdf,Ne as useCreationLocale,he as useCreationTransport};

package/dist/locale.d.ts

@@ -0,0 +1,8 @@
+import { type ReactNode } from "react";
+import type { CreationLocale } from "./contract.js";
+/** Host-owned locale; kind packages never read Studio's locale store. */
+export declare function CreationLocaleProvider(props: {
+    locale: CreationLocale;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useCreationLocale(): CreationLocale;

package/dist/registry.d.ts

@@ -0,0 +1,25 @@
+import type { CreationDomain, CreationSourceFormat } from "@uibot/contracts";
+import { type CreationArtifactViewContribution, type CreationAssetSlot, type CreationEditorContribution, type CreationKindPlugin, type CreationLocale, type CreationProjectAssetContribution, type CreationTaskKindContribution, type CreationViewContext } from "./contract.js";
+export interface CreationKindOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface CreationKindRegistry {
+    plugins: readonly CreationKindPlugin[];
+    taskKind(kind: string | undefined): CreationTaskKindContribution | undefined;
+    taskKinds(): CreationTaskKindContribution[];
+    /** Server domains first, then workbench kinds. A workbench kind that shadows a domain is hidden. */
+    kindOptions(domains: readonly CreationDomain[], locale: CreationLocale, domainLabel?: (domain: CreationDomain) => string): CreationKindOption[];
+    label(kind: string, locale: CreationLocale, fallback?: string): string;
+    editor(id: string | undefined, format: CreationSourceFormat): CreationEditorContribution | undefined;
+    views(ctx: CreationViewContext): CreationArtifactViewContribution[];
+    projectAssets(): CreationProjectAssetContribution[];
+    projectAsset(slot: CreationAssetSlot): CreationProjectAssetContribution | undefined;
+    /** Splits route search into a syntactically valid `kind` and each kind's own parameters. */
+    parseRouteSearch(raw: Record<string, unknown>): {
+        kind?: string;
+        extra: Record<string, string>;
+    };
+}
+export declare function createCreationKindRegistry(plugins: readonly CreationKindPlugin[]): CreationKindRegistry;

package/dist/testing.d.ts

@@ -0,0 +1,13 @@
+import { type ReactNode } from "react";
+import { type CreationLocale, type CreationUiPrimitives } from "@uibot/creation-kit";
+/**
+ * Unstyled stand-ins for the host's UI primitives: every slot renders a plain element that
+ * forwards its props. Enough for markup-level tests of kind components; interactive widgets
+ * (menus, dialogs) belong in host integration tests with the real component library.
+ */
+export declare function createPlainUi(): CreationUiPrimitives;
+/** Wraps children with plain UI primitives and a locale, the minimum a kind component needs. */
+export declare function PlainKitProviders(props: {
+    locale?: CreationLocale;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/testing.js

@@ -0,0 +1,17 @@
+import{createElement as Pe}from"react";var h=1;var j=/^[a-z][a-z0-9-]{0,39}$/;function I(e,c,n,t){if(c.has(n))throw Error(`Duplicate creation ${e} "${n}" (plugin ${t})`);c.add(n)}function we(e){let c=new Set,n=new Map,t=new Map,l=new Set,a=[],r=new Map;for(let o of e){if(o.kitApi!==h)throw Error(`Creation plugin "${o.id}" targets kit API ${String(o.kitApi)}, expected ${h}`);I("plugin",c,o.id,o.id);for(let i of o.kinds??[]){if(!j.test(i.kind))throw Error(`Invalid creation kind "${i.kind}" (plugin ${o.id})`);if(n.has(i.kind))throw Error(`Duplicate creation kind "${i.kind}" (plugin ${o.id})`);n.set(i.kind,i)}for(let i of o.editors??[]){let p=`${i.id}:${i.format}`;if(t.has(p))throw Error(`Duplicate creation editor "${p}" (plugin ${o.id})`);t.set(p,i)}for(let i of o.views??[])I("view",l,i.id,o.id),a.push(i);for(let i of o.projectAssets??[]){if(r.has(i.slot))throw Error(`Duplicate creation asset slot "${i.slot}" (plugin ${o.id})`);r.set(i.slot,i)}}let C=[...n.values()].sort((o,i)=>(o.order??100)-(i.order??100)||o.kind.localeCompare(i.kind));return{plugins:e,taskKind:(o)=>o?n.get(o):void 0,taskKinds:()=>[...C],kindOptions(o,i,p){let g=o.map((d)=>({value:d.artifactKind,label:p?.(d)??d.title,disabled:!d.enabled})),m=new Set(g.map((d)=>d.value));for(let d of C){if(m.has(d.kind)){console.error(`Creation workbench kind "${d.kind}" shadows a server domain and is hidden`);continue}g.push({value:d.kind,label:d.label[i]})}return g},label:(o,i,p)=>n.get(o)?.label[i]??p??o,editor:(o,i)=>o?t.get(`${o}:${i}`):void 0,views:(o)=>a.filter((i)=>i.match(o)),projectAssets:()=>[...r.values()],projectAsset:(o)=>r.get(o),parseRouteSearch(o){let i=typeof o.kind==="string"&&j.test(o.kind)?o.kind:void 0,p={};for(let g of C){if(!g.parseSearch)continue;Object.assign(p,g.parseSearch(o))}return{...i?{kind:i}:{},extra:p}}}}import{createContext as _,useContext as G}from"react";import{jsx as J}from"react/jsx-runtime";var U=_(null);function Ae(e){return J(U.Provider,{value:e.transport,children:e.children})}function Re(){let e=G(U);if(!e)throw Error("useCreationTransport requires a CreationTransportProvider");return e}import{clsx as W}from"clsx";import{twMerge as Y}from"tailwind-merge";function Le(...e){return Y(W(e))}function $e(e){if(!(e instanceof Error))return;let{status:c}=e;return typeof c==="number"?c:void 0}import{createContext as X,useContext as Z}from"react";import{jsx as Q}from"react/jsx-runtime";var N=X("en");function L(e){return Q(N.Provider,{value:e.locale,children:e.children})}function Ve(){return Z(N)}import{createContext as ee,useContext as te}from"react";import{jsx as K}from"react/jsx-runtime";var E=ee(null);function O(e){return K(E.Provider,{value:e.primitives,children:e.children})}function oe(){let e=te(E);if(!e)throw Error("Creation UI primitives require a CreationUiProvider");return e}function s(e,c){let n=(t)=>{let l=e(oe());return K(l,{...t})};return n.displayName=c,n}var Me=s((e)=>e.Button,"Button"),He=s((e)=>e.Badge,"Badge"),qe=s((e)=>e.Label,"Label"),_e=s((e)=>e.Input,"Input"),Ge=s((e)=>e.Textarea,"Textarea"),Je=s((e)=>e.Checkbox,"Checkbox"),We=s((e)=>e.Collapsible,"Collapsible"),Ye=s((e)=>e.CollapsibleTrigger,"CollapsibleTrigger"),Xe=s((e)=>e.CollapsibleContent,"CollapsibleContent"),Ze=s((e)=>e.ScrollArea,"ScrollArea"),Qe=s((e)=>e.ScrollBar,"ScrollBar"),et=s((e)=>e.Select,"Select"),tt=s((e)=>e.SelectTrigger,"SelectTrigger"),ot=s((e)=>e.SelectValue,"SelectValue"),nt=s((e)=>e.SelectContent,"SelectContent"),rt=s((e)=>e.SelectItem,"SelectItem"),it=s((e)=>e.Tabs,"Tabs"),at=s((e)=>e.TabsList,"TabsList"),st=s((e)=>e.TabsTrigger,"TabsTrigger"),lt=s((e)=>e.TabsContent,"TabsContent"),ct=s((e)=>e.Tooltip,"Tooltip"),pt=s((e)=>e.TooltipProvider,"TooltipProvider"),dt=s((e)=>e.TooltipTrigger,"TooltipTrigger"),ut=s((e)=>e.TooltipContent,"TooltipContent"),gt=s((e)=>e.Popover,"Popover"),Ct=s((e)=>e.PopoverTrigger,"PopoverTrigger"),mt=s((e)=>e.PopoverContent,"PopoverContent"),ft=s((e)=>e.Dialog,"Dialog"),bt=s((e)=>e.DialogTrigger,"DialogTrigger"),xt=s((e)=>e.DialogContent,"DialogContent"),Pt=s((e)=>e.DialogHeader,"DialogHeader"),yt=s((e)=>e.DialogFooter,"DialogFooter"),Tt=s((e)=>e.DialogTitle,"DialogTitle"),vt=s((e)=>e.DialogDescription,"DialogDescription"),ht=s((e)=>e.Prompt,"Prompt");var w=/<(\/?)section\b[^>]*>/gi;function P(e,c){let n=new RegExp(`\\b${c}(?:\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s>]+)))?`,"i").exec(e);if(!n)return;return n[1]??n[2]??n[3]??""}function ne(e){if(P(e,"data-slide")!==void 0)return!0;return/\bslide\b/i.test(P(e,"class")??"")}function k(e,c){return e.exec(c)?.[1]??""}function re(e){return e.replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#39;/g,"'")}function V(e){return re(e.replace(/<[^>]+>/g," ")).replace(/\s+/g," ").trim()}function z(e){let c=[];w.lastIndex=0;let n=0,t=-1;for(let l=w.exec(e);l;l=w.exec(e)){if(l[1]==="/"){if(n===0)continue;if(n-=1,n===0&&t>=0)c.push(e.slice(t,l.index+l[0].length)),t=-1;continue}if(n===0){if(!ne(l[0]))continue;t=l.index}n+=1}return c}function F(e){return Boolean(e)&&z(e).length>0}var ie=/<aside\b([^>]*)>([\s\S]*?)<\/aside>/i;function ae(e){let c="";return{slide:e.replace(ie,(t,l,a)=>{if(!(P(`<aside ${l}>`,"data-notes")!==void 0||/\bnotes\b/i.test(P(`<aside ${l}>`,"class")??"")))return t;return c=V(a),""}),notes:c}}function B(e){let c=z(e);if(c.length===0)return{isDeck:!1,slides:[],head:"",bodyClass:"",bodyStyle:"",title:"deck"};let n=k(/<head\b[^>]*>([\s\S]*?)<\/head>/i,e),t=`<body ${k(/<body\b([^>]*)>/i,e)}>`,l=P(t,"class")??"",a=P(t,"style")??"",r=V(k(/<title\b[^>]*>([\s\S]*?)<\/title>/i,n))||"deck",C=new Set;return{isDeck:!0,slides:c.map((i,p)=>{let g=k(/(<section\b[^>]*>)/i,i),m=P(g,"data-slide")||P(g,"data-slide-id")||String(p+1),d=C.has(m)?`${m}-${p+1}`:m;C.add(d);let x=k(/background(?:-color)?\s*:\s*([^;"']+)/i,P(g,"style")??"").trim()||void 0,{slide:f,notes:u}=ae(i);return{html:`<!DOCTYPE html><html><head>${n}
+<style>
+  html, body { margin:0; padding:0; }
+  body { display:flex; align-items:center; justify-content:center; min-height:100vh; }
+  .slide, [data-slide] { transform-origin: center center !important; }
+</style></head><body class="${l}" style="${a}">${f}</body></html>`,notes:u,id:d,...x?{bg:x}:{}}}),head:n,bodyClass:l,bodyStyle:a,title:r}}function se(e){return`<!DOCTYPE html><html><head>
+<style>
+  @page { size: 1280px 720px; margin: 0; }
+  html, body { margin:0; padding:0; }
+  .page { width: 1280px; height: 720px; overflow: hidden; page-break-after: always; }
+  .page:last-child { page-break-after: auto; }
+  .page iframe.slide { display:block; width:100%; height:100%; border:0; }
+</style></head><body>
+${Array.from({length:e},(n,t)=>`<div class="page"><iframe class="slide" data-slide-index="${t}" sandbox="allow-scripts"></iframe></div>`).join(`
+`)}
+<script>window.onload=()=>setTimeout(()=>window.print(),300)</script>
+</body></html>`}function M(e,c=(n,t)=>window.open(n,t)){let n=c("","_blank");if(!n)return!1;n.opener=null,n.document.write(se(e.slides.length)),n.document.close();let t=n.document.querySelectorAll("iframe.slide");return e.slides.forEach((l,a)=>{let r=t[a];if(r)r.srcdoc=l.html}),!0}import{ChevronLeft as le,ChevronRight as ce,FileDown as pe,Maximize2 as de,StickyNote as ue}from"lucide-react";import{useEffect as H,useMemo as ge,useRef as Ce,useState as S}from"react";import{jsx as b,jsxs as y}from"react/jsx-runtime";var me={empty:"No slides found (each slide must be a <section data-slide>).",prev:"Previous slide",next:"Next slide",notes:"Notes",notesTitle:"Speaker notes (N)",notesHeading:"Speaker notes",present:"Present",presentTitle:"Full screen (F)",pdfTitle:"Print to PDF",blocked:"The popup was blocked. Allow popups for this site and try again.",page:"Slide"},fe={empty:"未检测到幻灯片（每页需为 <section data-slide>）。",prev:"上一页",next:"下一页",notes:"备注",notesTitle:"演讲者备注（N）",notesHeading:"演讲者备注",present:"放映",presentTitle:"全屏放映（F）",pdfTitle:"打印为 PDF",blocked:"弹窗被拦截，请允许本站弹出窗口后重试。",page:"第"},be={en:me,zh:fe},D="inline-flex items-center gap-1 rounded-md border px-2 py-1 text-xs";function A({content:e,locale:c,active:n}){let t=be[c],l=ge(()=>B(e),[e]),[a,r]=S(0),[C,o]=S(!1),[i,p]=S(""),g=Ce(null),m=l.slides.length,d=Math.min(a,Math.max(0,m-1)),x=l.slides[d];if(H(()=>r(0),[e]),H(()=>{if(!n||m===0)return;let f=(u)=>{let T=u.target;if(T&&(T.tagName==="INPUT"||T.tagName==="TEXTAREA"||T.isContentEditable))return;if(u.key==="ArrowRight"||u.key==="PageDown"||u.key===" ")u.preventDefault(),r((v)=>Math.min(v+1,m-1));else if(u.key==="ArrowLeft"||u.key==="PageUp")u.preventDefault(),r((v)=>Math.max(v-1,0));else if(u.key==="Home")r(0);else if(u.key==="End")r(m-1);else if(u.key.toLowerCase()==="n")o((v)=>!v);else if(u.key.toLowerCase()==="f")if(document.fullscreenElement)document.exitFullscreen();else g.current?.requestFullscreen?.()};return window.addEventListener("keydown",f),()=>window.removeEventListener("keydown",f)},[n,m]),!x)return b("div",{className:"flex h-full items-center justify-center p-6 text-sm text-muted-foreground",children:t.empty});return y("div",{ref:g,className:"flex h-full min-h-72 flex-col bg-muted/30",children:[y("div",{className:"relative min-h-0 flex-1",children:[b("iframe",{title:`slide-${x.id}`,srcDoc:x.html,sandbox:"allow-scripts",className:"h-full w-full border-0 bg-white"},x.id),b("button",{type:"button",onClick:()=>r((f)=>Math.max(f-1,0)),disabled:d===0,className:"absolute left-2 top-1/2 -translate-y-1/2 rounded-full border bg-background/80 p-1.5 shadow backdrop-blur disabled:opacity-30","aria-label":t.prev,children:b(le,{className:"size-4"})}),b("button",{type:"button",onClick:()=>r((f)=>Math.min(f+1,m-1)),disabled:d===m-1,className:"absolute right-2 top-1/2 -translate-y-1/2 rounded-full border bg-background/80 p-1.5 shadow backdrop-blur disabled:opacity-30","aria-label":t.next,children:b(ce,{className:"size-4"})}),y("div",{className:"absolute bottom-2 left-1/2 -translate-x-1/2 rounded-full bg-foreground/80 px-2.5 py-0.5 text-xs tabular-nums text-background",children:[d+1," / ",m]}),C&&x.notes&&y("div",{className:"absolute inset-x-3 bottom-10 max-h-[40%] overflow-y-auto rounded-md border bg-background/95 p-3 text-sm shadow-lg",children:[b("div",{className:"mb-1 text-[10px] font-medium uppercase tracking-wide text-muted-foreground",children:t.notesHeading}),x.notes]})]}),i&&b("p",{role:"status",className:"border-t bg-background px-3 py-1 text-xs text-destructive",children:i}),y("div",{className:"flex items-center gap-2 border-t bg-background px-3 py-2",children:[b("div",{className:"flex min-w-0 flex-1 gap-1.5 overflow-x-auto",children:l.slides.map((f,u)=>b("button",{type:"button",onClick:()=>r(u),"aria-label":`${t.page} ${u+1}`,"aria-current":u===d?"true":void 0,...f.bg?{style:{background:f.bg}}:{},className:`flex size-7 shrink-0 items-center justify-center rounded border text-[11px] tabular-nums ${u===d?"border-primary ring-2 ring-primary/30":"text-muted-foreground hover:border-foreground/30"}`,children:u+1},f.id))}),y("button",{type:"button",onClick:()=>o((f)=>!f),className:`${D} ${C?"border-primary bg-primary/10 text-primary":"text-muted-foreground hover:bg-accent"}`,title:t.notesTitle,children:[b(ue,{className:"size-3.5"}),t.notes]}),y("button",{type:"button",onClick:()=>{if(!document.fullscreenElement)g.current?.requestFullscreen?.()},className:`${D} text-muted-foreground hover:bg-accent`,title:t.presentTitle,children:[b(de,{className:"size-3.5"}),t.present]}),y("button",{type:"button",onClick:()=>p(M(l)?"":t.blocked),className:`${D} text-muted-foreground hover:bg-accent`,title:t.pdfTitle,children:[b(pe,{className:"size-3.5"}),"PDF"]})]})]})}var Et={id:"presentation-deck",version:"1.0.0",kitApi:h,views:[{id:"slides",label:{zh:"幻灯片",en:"Slides"},match:(e)=>e.artifactKind==="presentation"&&e.format==="html"&&F(e.content),View:A}]};class R extends Error{code;status;constructor(e,c,n){super(c);this.code=e;this.status=n;this.name="CreationApiError"}}function xe(e){return`/projects/${encodeURIComponent(e)}`}function Ot(e){let c=e.base.replace(/\/$/,""),n=e.fetch??((a,r)=>globalThis.fetch(a,r));async function t(a,r={}){let C=r.method??(r.body===void 0?"GET":"POST"),o=await n(`${c}${a}`,{method:C,headers:{accept:"application/json",...r.body===void 0?{}:{"content-type":"application/json"}},...r.body===void 0?{}:{body:JSON.stringify(r.body)},...r.signal?{signal:r.signal}:{}}),i=await o.text(),p=null;if(i)try{p=JSON.parse(i)}catch{p=null}if(!o.ok){let g=p?.error;throw new R(typeof g?.code==="string"?g.code:"request-failed",typeof g?.message==="string"?g.message:`Request failed (${o.status})`,o.status)}if(p===null)throw new R("invalid-response","Empty or non-JSON response",o.status);return p}let l=xe;return{request:t,getConfiguration:(a)=>t(e.configurationPath??"",{method:"GET",...a?{signal:a}:{}}),listProjects:(a)=>t("/projects",{method:"GET",...a?{signal:a}:{}}),createProject:(a)=>t("/projects",{body:a}),getProject:(a,r)=>t(l(a),{method:"GET",...r?{signal:r}:{}}),addSource:(a,r)=>t(`${l(a)}/sources`,{body:r}),appendArtifact:(a,r)=>t(`${l(a)}/artifacts`,{body:r}),saveRevision:(a,r,C)=>t(`${l(a)}/artifacts/${encodeURIComponent(r)}/revisions`,{body:C}),startRun:(a,r)=>t(`${l(a)}/runs`,{body:r}),cancelRun:(a,r)=>t(`${l(a)}/runs/${encodeURIComponent(r)}/cancel`,{body:{}}),resumeRun:(a,r)=>t(`${l(a)}/runs/${encodeURIComponent(r)}/resume`,{body:{}})}}import{jsx as q}from"react/jsx-runtime";var ye={Button:"button",Input:"input",Label:"label",Textarea:"textarea",DialogTitle:"h2",DialogDescription:"p"},Te=new Set(["asChild","viewportProps","showCloseButton","sideOffset","align","side"]);function ve(){let e=new Map;return new Proxy({},{get(c,n){let t=e.get(n);if(!t){let l=ye[n]??"div";t=(a)=>{let r={};for(let[C,o]of Object.entries(a))if(!Te.has(C))r[C]=o;return Pe(l,r)},t.displayName=n,e.set(n,t)}return t}})}function Qt(e){return q(O,{primitives:ve(),children:q(L,{locale:e.locale??"en",children:e.children})})}export{Qt as PlainKitProviders,ve as createPlainUi};

package/dist/transport.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from "react";
+/** Host-owned HTTP seam: kind packages never hardcode URLs or fetch directly. */
+export interface CreationHostTransport {
+    request<T>(base: string, path: string, init?: {
+        method?: string;
+        body?: unknown;
+        signal?: AbortSignal;
+    }): Promise<T>;
+    url(base: string, path: string): string;
+}
+export declare function CreationTransportProvider(props: {
+    transport: CreationHostTransport;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useCreationTransport(): CreationHostTransport;

package/dist/ui.d.ts

@@ -0,0 +1,301 @@
+import { type ComponentProps, type ComponentType, type ReactNode } from "react";
+import type { PromptInputProps } from "@uibot/ai-chat";
+/**
+ * UI primitives are owned by the host (Studio's shadcn components) and injected, so kind
+ * packages never import radix and Studio keeps a single copy of every primitive. Each prop
+ * type lists only what kinds use; the host assigns its own component to the slot, so the
+ * compiler checks the host satisfies this contract.
+ */
+type Dom<T extends keyof React.JSX.IntrinsicElements> = Omit<ComponentProps<T>, "dir"> & {
+    dir?: "ltr" | "rtl";
+};
+export type ButtonVariant = "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+export type ButtonSize = "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg";
+export interface UiButtonProps extends Dom<"button"> {
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    asChild?: boolean;
+}
+export interface UiBadgeProps extends Dom<"div"> {
+    variant?: "default" | "secondary" | "destructive" | "outline";
+}
+type CheckedState = boolean | "indeterminate";
+export interface UiCheckboxProps extends Omit<Dom<"button">, "defaultValue" | "defaultChecked"> {
+    checked?: CheckedState;
+    defaultChecked?: CheckedState;
+    onCheckedChange?(checked: CheckedState): void;
+    required?: boolean;
+    name?: string;
+    value?: string;
+}
+export interface UiCollapsibleProps extends Dom<"div"> {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?(open: boolean): void;
+    disabled?: boolean;
+}
+export interface UiTriggerProps extends Dom<"button"> {
+    asChild?: boolean;
+}
+export interface UiScrollAreaProps extends Dom<"div"> {
+    viewportProps?: Dom<"div"> & Record<`data-${string}`, string | undefined>;
+}
+export interface UiScrollBarProps extends Dom<"div"> {
+    orientation?: "vertical" | "horizontal";
+}
+export interface UiSelectProps {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?(value: string): void;
+    open?: boolean;
+    onOpenChange?(open: boolean): void;
+    disabled?: boolean;
+    required?: boolean;
+    name?: string;
+    children?: ReactNode;
+}
+export interface UiSelectTriggerProps extends Dom<"button"> {
+    size?: "sm" | "default";
+}
+export interface UiSelectValueProps extends Dom<"span"> {
+    placeholder?: ReactNode;
+}
+export interface UiSelectContentProps extends Dom<"div"> {
+    position?: "item-aligned" | "popper";
+    align?: "start" | "center" | "end";
+    sideOffset?: number;
+}
+export interface UiSelectItemProps extends Dom<"div"> {
+    value: string;
+    disabled?: boolean;
+    textValue?: string;
+}
+export interface UiTabsProps extends Omit<Dom<"div">, "defaultValue"> {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?(value: string): void;
+    orientation?: "horizontal" | "vertical";
+}
+export interface UiTabsListProps extends Dom<"div"> {
+    variant?: "default" | "line";
+}
+export interface UiTabsTriggerProps extends Dom<"button"> {
+    value: string;
+}
+export interface UiTabsContentProps extends Dom<"div"> {
+    value: string;
+    forceMount?: true;
+}
+export interface UiOverlayRootProps {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?(open: boolean): void;
+    children?: ReactNode;
+}
+export interface UiTooltipProviderProps {
+    delayDuration?: number;
+    children: ReactNode;
+}
+export interface UiTooltipRootProps extends UiOverlayRootProps {
+    delayDuration?: number;
+}
+export interface UiFloatingContentProps extends Dom<"div"> {
+    side?: "top" | "right" | "bottom" | "left";
+    align?: "start" | "center" | "end";
+    sideOffset?: number;
+}
+export interface UiDialogContentProps extends Omit<Dom<"div">, "title"> {
+    showCloseButton?: boolean;
+    onCloseAutoFocus?(event: Event): void;
+    onOpenAutoFocus?(event: Event): void;
+    onEscapeKeyDown?(event: KeyboardEvent): void;
+}
+export interface CreationUiPrimitives {
+    Button: ComponentType<UiButtonProps>;
+    Badge: ComponentType<UiBadgeProps>;
+    Label: ComponentType<Dom<"label">>;
+    Input: ComponentType<Dom<"input">>;
+    Textarea: ComponentType<Dom<"textarea">>;
+    Checkbox: ComponentType<UiCheckboxProps>;
+    Collapsible: ComponentType<UiCollapsibleProps>;
+    CollapsibleTrigger: ComponentType<UiTriggerProps>;
+    CollapsibleContent: ComponentType<Dom<"div"> & {
+        forceMount?: true;
+    }>;
+    ScrollArea: ComponentType<UiScrollAreaProps>;
+    ScrollBar: ComponentType<UiScrollBarProps>;
+    Select: ComponentType<UiSelectProps>;
+    SelectTrigger: ComponentType<UiSelectTriggerProps>;
+    SelectValue: ComponentType<UiSelectValueProps>;
+    SelectContent: ComponentType<UiSelectContentProps>;
+    SelectItem: ComponentType<UiSelectItemProps>;
+    Tabs: ComponentType<UiTabsProps>;
+    TabsList: ComponentType<UiTabsListProps>;
+    TabsTrigger: ComponentType<UiTabsTriggerProps>;
+    TabsContent: ComponentType<UiTabsContentProps>;
+    Tooltip: ComponentType<UiTooltipRootProps>;
+    TooltipProvider: ComponentType<UiTooltipProviderProps>;
+    TooltipTrigger: ComponentType<UiTriggerProps>;
+    TooltipContent: ComponentType<UiFloatingContentProps>;
+    Popover: ComponentType<UiOverlayRootProps>;
+    PopoverTrigger: ComponentType<UiTriggerProps>;
+    PopoverContent: ComponentType<UiFloatingContentProps>;
+    Dialog: ComponentType<UiOverlayRootProps>;
+    DialogTrigger: ComponentType<UiTriggerProps>;
+    DialogContent: ComponentType<UiDialogContentProps>;
+    DialogHeader: ComponentType<Dom<"div">>;
+    DialogFooter: ComponentType<Dom<"div">>;
+    DialogTitle: ComponentType<Dom<"h2">>;
+    DialogDescription: ComponentType<Dom<"p">>;
+    /** The host's chat prompt (ai-chat `PromptInput` with Studio styling). */
+    Prompt: ComponentType<PromptInputProps>;
+}
+export declare function CreationUiProvider(props: {
+    primitives: CreationUiPrimitives;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare const Button: {
+    (props: UiButtonProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Badge: {
+    (props: UiBadgeProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Label: {
+    (props: Dom<"label">): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Input: {
+    (props: Dom<"input">): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Textarea: {
+    (props: Dom<"textarea">): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Checkbox: {
+    (props: UiCheckboxProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Collapsible: {
+    (props: UiCollapsibleProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const CollapsibleTrigger: {
+    (props: UiTriggerProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const CollapsibleContent: {
+    (props: Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "dir"> & {
+        dir?: "ltr" | "rtl";
+    } & {
+        forceMount?: true;
+    }): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const ScrollArea: {
+    (props: UiScrollAreaProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const ScrollBar: {
+    (props: UiScrollBarProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Select: {
+    (props: UiSelectProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const SelectTrigger: {
+    (props: UiSelectTriggerProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const SelectValue: {
+    (props: UiSelectValueProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const SelectContent: {
+    (props: UiSelectContentProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const SelectItem: {
+    (props: UiSelectItemProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Tabs: {
+    (props: UiTabsProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const TabsList: {
+    (props: UiTabsListProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const TabsTrigger: {
+    (props: UiTabsTriggerProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const TabsContent: {
+    (props: UiTabsContentProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Tooltip: {
+    (props: UiTooltipRootProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const TooltipProvider: {
+    (props: UiTooltipProviderProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const TooltipTrigger: {
+    (props: UiTriggerProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const TooltipContent: {
+    (props: UiFloatingContentProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Popover: {
+    (props: UiOverlayRootProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const PopoverTrigger: {
+    (props: UiTriggerProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const PopoverContent: {
+    (props: UiFloatingContentProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Dialog: {
+    (props: UiOverlayRootProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const DialogTrigger: {
+    (props: UiTriggerProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const DialogContent: {
+    (props: UiDialogContentProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const DialogHeader: {
+    (props: Dom<"div">): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const DialogFooter: {
+    (props: Dom<"div">): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const DialogTitle: {
+    (props: Dom<"h2">): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const DialogDescription: {
+    (props: Dom<"p">): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const Prompt: {
+    (props: PromptInputProps): import("react").JSX.Element;
+    displayName: string;
+};
+export {};

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@uibot/creation-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Foundj/uibot.git",
+    "directory": "packages/creation-kit"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.spec.d.ts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "^19",
+    "react-dom": "^19"
+  },
+  "dependencies": {
+    "@uibot/contracts": "^0.2.0",
+    "@uibot/ai-chat": "^0.2.0",
+    "lucide-react": "^1.56.0",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.7.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && bun build --minify ./src/index.ts ./src/testing.tsx ./src/client.ts --outdir ./dist --format esm --target browser --packages external && bun x tsc -p tsconfig.json",
+    "typecheck": "bun x tsc -p tsconfig.json --noEmit",
+    "test": "bun test"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.