mockpit 0.0.0-stage → 1.0.0

package/dist/server/types.d.ts

@@ -0,0 +1,599 @@
+import type { Palette } from "./themes.ts";
+export interface Session {
+    id: string;
+    agent: string;
+    title: string | null;
+    cwd: string | null;
+    createdAt: string;
+    lastActiveAt: string;
+    agentSeq: number;
+    project: string | null;
+}
+export declare const SURFACE_KINDS: readonly ["html", "diff", "image", "markdown", "terminal", "mermaid", "json", "code"];
+export type SurfaceKind = (typeof SURFACE_KINDS)[number];
+export type SurfaceContentField = "html" | "markdown" | "mermaid" | "patch" | "text" | "data" | "code";
+export interface SurfaceKindMetadata {
+    contentField?: SurfaceContentField;
+    sandboxed: boolean;
+    frameClass?: string;
+}
+export declare const SURFACE_KIND_METADATA: {
+    readonly html: {
+        readonly contentField: "html";
+        readonly sandboxed: true;
+    };
+    readonly diff: {
+        readonly contentField: "patch";
+        readonly sandboxed: true;
+        readonly frameClass: "diffframe";
+    };
+    readonly image: {
+        readonly sandboxed: false;
+    };
+    readonly markdown: {
+        readonly contentField: "markdown";
+        readonly sandboxed: true;
+        readonly frameClass: "mdframe";
+    };
+    readonly terminal: {
+        readonly contentField: "text";
+        readonly sandboxed: true;
+        readonly frameClass: "termframe";
+    };
+    readonly mermaid: {
+        readonly contentField: "mermaid";
+        readonly sandboxed: true;
+        readonly frameClass: "mermaidframe";
+    };
+    readonly json: {
+        readonly contentField: "data";
+        readonly sandboxed: false;
+    };
+    readonly code: {
+        readonly contentField: "code";
+        readonly sandboxed: true;
+        readonly frameClass: "codeframe";
+    };
+};
+export declare const SURFACE_KIND_LIST: string;
+export declare const SANDBOXED_SURFACE_KINDS: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+export declare const NATIVE_SURFACE_KINDS: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+export declare const SURFACE_CONTENT_FIELDS: Partial<Record<SurfaceKind, SurfaceContentField>>;
+export declare const SURFACE_FRAME_CLASSES: Partial<Record<SurfaceKind, string>>;
+export declare function isSurfaceKind(kind: unknown): kind is SurfaceKind;
+export declare function isSandboxedSurfaceKind(kind: unknown): kind is SurfaceKind;
+export interface HtmlSurface {
+    kind: "html";
+    html: string;
+    kits?: string[];
+}
+export interface MarkdownSurface {
+    kind: "markdown";
+    markdown: string;
+}
+export interface MermaidSurface {
+    kind: "mermaid";
+    mermaid: string;
+}
+export interface DiffFile {
+    filename: string;
+    before: string;
+    after: string;
+    language?: string;
+}
+export interface DiffSurface {
+    kind: "diff";
+    patch?: string;
+    files?: DiffFile[];
+    layout?: "unified" | "split";
+}
+export interface ImageSurface {
+    kind: "image";
+    assetId: string;
+    alt?: string;
+    caption?: string;
+}
+export interface TerminalSurface {
+    kind: "terminal";
+    text: string;
+    cols?: number;
+    title?: string;
+}
+export interface JsonSurface {
+    kind: "json";
+    data: unknown;
+}
+export interface CodeSurface {
+    kind: "code";
+    code: string;
+    language?: string;
+    title?: string;
+    lineStart?: number;
+}
+export type Surface = (HtmlSurface & {
+    id?: string;
+}) | (DiffSurface & {
+    id?: string;
+}) | (ImageSurface & {
+    id?: string;
+}) | (MarkdownSurface & {
+    id?: string;
+}) | (TerminalSurface & {
+    id?: string;
+}) | (MermaidSurface & {
+    id?: string;
+}) | (JsonSurface & {
+    id?: string;
+}) | (CodeSurface & {
+    id?: string;
+});
+export interface SliderKnob {
+    type: "slider";
+    value: number;
+    min: number;
+    max: number;
+    step?: number;
+}
+export interface ToggleKnob {
+    type: "toggle";
+    value: boolean;
+}
+export type KnobOption = string | {
+    value: string;
+    label: string;
+};
+export interface SelectKnob {
+    type: "select";
+    value?: string;
+    options: KnobOption[];
+}
+export interface ColorKnob {
+    type: "color";
+    value?: string;
+    gradient?: boolean;
+    contrast?: string;
+}
+export interface TextKnob {
+    type: "text";
+    value?: string;
+    placeholder?: string;
+}
+export interface SpringKnob {
+    type: "spring";
+    stiffness?: number;
+    damping?: number;
+    mass?: number;
+    visualDuration?: number;
+    bounce?: number;
+}
+export interface EasingKnob {
+    type: "easing";
+    duration: number;
+    ease: [number, number, number, number];
+}
+export interface ImageKnob {
+    type: "image";
+    value?: string;
+    options?: KnobOption[];
+}
+export type KnobAxis = [number, number, number] | [number, number, number, number];
+export interface PadKnob {
+    type: "pad";
+    x?: KnobAxis;
+    y?: KnobAxis;
+    labels?: {
+        x?: string;
+        y?: string;
+    };
+}
+export type ExplicitKnob = SliderKnob | ToggleKnob | SelectKnob | ColorKnob | TextKnob | SpringKnob | EasingKnob | ImageKnob | PadKnob;
+export type KnobConfig = ExplicitKnob | KnobAxis | number | boolean | string;
+export type Knobs = Record<string, KnobConfig>;
+export interface PadValue {
+    x: number;
+    y: number;
+}
+export type KnobValue = number | boolean | string | PadValue | SpringKnob | EasingKnob;
+export type MockKind = "page" | "component";
+export type PostStatus = "open" | "accepted" | "archived";
+export interface AskOption {
+    id: string;
+    label: string;
+    variant?: string;
+    set?: Record<string, KnobValue>;
+}
+export type AskAnswer = string | string[];
+export interface Ask {
+    id: string;
+    text: string;
+    scope: "mock" | "state" | "part";
+    state?: string;
+    part?: string;
+    options: AskOption[];
+    multi?: boolean;
+    answer?: AskAnswer;
+    other?: string;
+    note?: string;
+    at: string;
+}
+export declare const OTHER_ID = "other";
+export interface PartCommentAnchor {
+    offset?: [number, number];
+    quote?: string;
+    selector?: string;
+    box?: number[];
+}
+export interface PartComment {
+    part: string | null;
+    state: string | null;
+    text: string;
+    anchor?: PartCommentAnchor;
+}
+export interface ReplyDecision {
+    kind: "accept" | "revise" | "drop";
+    state: string | null;
+    variant: string;
+}
+export interface Draft {
+    version: number;
+    answers: Record<string, AskAnswer>;
+    mix: Record<string, string>;
+    tuned: Record<string, KnobValue>;
+    comments: PartComment[];
+    others?: Record<string, string>;
+    notes?: Record<string, string>;
+    updatedAt: string;
+}
+export interface Reply {
+    mockId: string;
+    version: number;
+    answers: Record<string, AskAnswer>;
+    mix: Record<string, string>;
+    tuned: Record<string, KnobValue>;
+    comments: PartComment[];
+    others?: Record<string, string>;
+    notes?: Record<string, string>;
+    text?: string;
+    decision?: ReplyDecision;
+}
+export interface Mock {
+    id: string;
+    project: string;
+    slug: string;
+    title: string;
+    kind: MockKind;
+    states: string[];
+    asks: Ask[];
+    knobs: Knobs;
+    draft: Draft | null;
+    sessionId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Slot {
+    slug: string;
+    variant: string;
+    version: number;
+}
+export interface PostVersion {
+    version: number;
+    title: string;
+    surfaces: Surface[];
+    at: string;
+    from?: number;
+    prompt?: string;
+    author?: string;
+}
+export interface Post {
+    id: string;
+    sessionId: string;
+    mock: string;
+    state: string | null;
+    variant: string;
+    status: PostStatus;
+    title: string;
+    surfaces: Surface[];
+    createdAt: string;
+    updatedAt: string;
+    version: number;
+    history: PostVersion[];
+    knobs?: Knobs;
+    slots: Slot[];
+    from?: number;
+    prompt?: string;
+    author?: string;
+}
+export interface ProjectSummary {
+    name: string;
+    mocks: number;
+    open: number;
+    lastActiveAt: string;
+    sessions: number;
+}
+export interface DesignSettings {
+    detected: {
+        tailwind: boolean;
+        shadcn: boolean;
+        cssVars: number;
+        fonts: string[];
+    } | null;
+    palette: {
+        light: Palette;
+        dark: Palette;
+    } | null;
+    kit: string;
+    cssVars: string;
+    tailwindCss: string;
+    strippedImports: string[];
+    iconSets: IconSetRef[];
+    projectKits: ProjectKit[];
+    designFiles?: DesignFiles | null;
+    updatedAt: string;
+}
+export interface ProjectKit {
+    id: string;
+    href: string;
+    script?: string;
+    doc: string;
+}
+export interface DesignFiles {
+    designMd?: {
+        name: string;
+        colors: Record<string, string>;
+        typography: Record<string, Record<string, string>>;
+        rounded: Record<string, string>;
+        spacing: Record<string, string>;
+        components: Record<string, Record<string, string>>;
+        headings: string[];
+        dos: string;
+    };
+    tokens?: {
+        files: string[];
+        count: number;
+        cssVars: boolean;
+        values: Record<string, string>;
+    };
+    shadcn?: {
+        style: string;
+        baseColor: string;
+        iconLibrary: string;
+        components: string[];
+    };
+}
+export interface IconSetRef {
+    prefix: string;
+    assetId: string;
+    count: number;
+}
+export type CommentAnchor = {
+    kind: "point";
+    surfaceIndex: number;
+    surfaceId?: string;
+    surfaceKind?: SurfaceKind;
+    postVersion: number;
+    x: number;
+    y: number;
+} | {
+    kind: "rect";
+    surfaceIndex: number;
+    surfaceId?: string;
+    surfaceKind?: SurfaceKind;
+    postVersion: number;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+} | {
+    kind: "lineRange";
+    surfaceIndex: number;
+    surfaceId?: string;
+    surfaceKind?: SurfaceKind;
+    postVersion: number;
+    startLine: number;
+    endLine: number;
+    file?: string;
+} | ({
+    kind: "part";
+    part: string;
+    state: string | null;
+} & PartCommentAnchor);
+export type CommentKind = "comment" | "ask" | "reply";
+export interface Anchor {
+    ref: string;
+    shape: "pin" | "rect" | "circle";
+    box: number[];
+    surfaceIndex: number;
+    postVersion: number;
+    path?: string;
+    text?: string;
+    viewport?: number;
+}
+export interface Comment {
+    id: string;
+    seq: number;
+    sessionId: string;
+    mockId: string | null;
+    postId: string | null;
+    author: string;
+    text: string;
+    createdAt: string;
+    anchor?: CommentAnchor;
+    kind: CommentKind;
+    anchors: Anchor[];
+    postVersion: number | null;
+    viewport: number | null;
+    payload?: Reply;
+}
+export type AssetKind = "image" | "file";
+export interface Asset {
+    id: string;
+    sessionId: string;
+    kind: AssetKind;
+    contentType: string;
+    byteLength: number;
+    filename: string | null;
+    data: Uint8Array;
+    createdAt: string;
+    lastAccessedAt: string;
+}
+export interface CreateAssetInput {
+    sessionId: string;
+    kind: AssetKind;
+    contentType: string;
+    filename?: string;
+    data: Uint8Array;
+}
+export interface CreateSessionInput {
+    agent: string;
+    title?: string;
+    cwd?: string;
+    project?: string;
+    key?: string;
+}
+export interface CreateMockInput {
+    project: string;
+    slug: string;
+    title?: string;
+    kind?: MockKind;
+    states?: string[];
+    knobs?: Knobs;
+    sessionId?: string | null;
+}
+export interface UpdateMockInput {
+    title?: string;
+    kind?: MockKind;
+    states?: string[];
+    asks?: Ask[];
+    knobs?: Knobs;
+    sessionId?: string | null;
+}
+export interface CreatePostInput {
+    sessionId: string;
+    mock: string;
+    state: string | null;
+    variant?: string;
+    title?: string;
+    surfaces: Surface[];
+    knobs?: Knobs;
+    slots?: Slot[];
+    from?: number;
+    prompt?: string;
+    author?: string;
+}
+export interface UpdatePostInput {
+    title?: string;
+    surfaces?: Surface[];
+    knobs?: Knobs | null;
+    slots?: Slot[];
+    from?: number;
+    prompt?: string;
+    author?: string;
+    state?: string | null;
+}
+export interface CreateCommentInput {
+    sessionId: string;
+    mockId?: string | null;
+    postId?: string | null;
+    author: string;
+    text: string;
+    anchor?: CommentAnchor;
+    kind?: CommentKind;
+    anchors?: Anchor[];
+    postVersion?: number | null;
+    viewport?: number | null;
+    payload?: Reply;
+}
+export interface CommentQuery {
+    sessionId?: string;
+    mockId?: string;
+    postId?: string;
+    afterSeq?: number;
+}
+export interface CommitReplyInput {
+    mockId: string;
+    sessionId: string;
+    text: string;
+    payload: Reply;
+    asks: Ask[];
+    accept: string[];
+    archive: string[];
+}
+export interface PostQuery {
+    mockId?: string;
+    sessionId?: string;
+}
+export interface Store {
+    listSessions(): Promise<Session[]>;
+    getSession(id: string): Promise<Session | null>;
+    getSessionByKey(key: string): Promise<Session | null>;
+    createSession(input: CreateSessionInput): Promise<Session>;
+    renameSession(id: string, title: string): Promise<Session | null>;
+    removeSession(id: string): Promise<boolean>;
+    markAgentSeen(sessionId: string, seq: number): Promise<void>;
+    getSetting(key: string): Promise<string | null>;
+    setSetting(key: string, value: string): Promise<void>;
+    listProjects(): Promise<ProjectSummary[]>;
+    listMocks(project?: string): Promise<Mock[]>;
+    getMock(id: string): Promise<Mock | null>;
+    findMock(project: string, slug: string): Promise<Mock | null>;
+    createMock(input: CreateMockInput): Promise<Mock>;
+    updateMock(id: string, patch: UpdateMockInput): Promise<Mock | null>;
+    removeMock(id: string): Promise<boolean>;
+    putDraft(mockId: string, draft: Draft | null): Promise<Mock | null>;
+    listPosts(query?: PostQuery): Promise<Post[]>;
+    countPostsBySession(): Promise<Map<string, number>>;
+    getPost(id: string): Promise<Post | null>;
+    findPost(mockId: string, state: string | null, variant: string): Promise<Post | null>;
+    createPost(input: CreatePostInput): Promise<Post | null>;
+    updatePost(id: string, patch: UpdatePostInput): Promise<Post | null>;
+    removePost(id: string): Promise<boolean>;
+    setPostStatus(id: string, status: PostStatus): Promise<Post | null>;
+    listComments(query: CommentQuery): Promise<Comment[]>;
+    createComment(input: CreateCommentInput): Promise<Comment | null>;
+    removeComment(id: string): Promise<Comment | null>;
+    commitReply(input: CommitReplyInput): Promise<Comment | null>;
+    putAsset(input: CreateAssetInput): Promise<Asset | null>;
+    getAsset(id: string): Promise<Asset | null>;
+    touchAsset(id: string): Promise<void>;
+    listAssets(sessionId: string): Promise<Asset[]>;
+    removeAsset(id: string): Promise<boolean>;
+    isAssetReferenced(id: string): Promise<boolean>;
+}
+export type SqlStorageValue = ArrayBuffer | string | number | null;
+export interface SqlStorageCursor {
+    toArray(): Record<string, SqlStorageValue>[];
+    one(): Record<string, SqlStorageValue>;
+}
+export interface SqlStorage {
+    exec(query: string, ...bindings: SqlStorageValue[]): SqlStorageCursor;
+    transactionSync?<T>(fn: () => T): T;
+}
+export declare const HISTORY_LIMIT = 20;
+export declare function reservedAgent(name: string): string;
+export declare function stripNul<T extends string | null | undefined>(s: T): T;
+export declare const MAX_ASSET_BYTES: number;
+export declare const MAX_WORKSPACE_ASSET_BYTES: number;
+export declare const newId: () => string;
+export declare function hashAssetId(data: Uint8Array): Promise<string>;
+export declare function normalizeSurfaceIds(surfaces: Surface[]): Surface[];
+export declare const DEFAULT_PROJECT = "workspace";
+export declare const DEFAULT_VARIANT = "default";
+export declare function slugify(input: string): string;
+export declare function projectFromCwd(cwd: string | null | undefined): string | null;
+export declare const htmlSurface: (html: string, kits?: unknown) => HtmlSurface;
+export declare const askAnswered: (a: Pick<Ask, "answer" | "other" | "note">) => boolean;
+export declare const openAsks: (mock: Pick<Mock, "asks">) => Ask[];
+export declare function builtinAskCount(mock: Pick<Mock, "asks" | "states">, posts: Pick<Post, "mock" | "state" | "variant" | "status">[], mockId: string): number;
+export declare const openCount: (mock: Pick<Mock, "id" | "asks" | "states">, posts: Pick<Post, "mock" | "state" | "variant" | "status">[]) => number;
+export declare const BUILTIN_ASK_ID = "variant";
+export declare function builtinAsk(mock: Pick<Mock, "states">, posts: Pick<Post, "state" | "variant">[], id: string): Ask | undefined;
+export declare function summarizeProjects(mocks: Mock[], sessions: Session[], posts?: Post[]): ProjectSummary[];
+export declare function surfacesByteLength(surfaces: Surface[]): number;
+export declare function collectAssetIds(surfaces: Surface[], out: Set<string>): void;
+export interface EvictionCandidate {
+    id: string;
+    byteLength: number;
+    lastAccessedAt: string;
+    referenced: boolean;
+}
+export declare function selectEvictions(candidates: EvictionCandidate[], incomingBytes: number, budget: number): string[];