pixelkiln 0.28.0 → 0.30.0

package/dist/index.d.ts

@@ -4782,6 +4782,26 @@ declare function portableOutputPath(file: string, manifestDir: string): string;
 declare function resolveOutputPath(recordedPath: string, manifestDir: string): string;
 /** Deterministic current destination for one provider output. */
 declare function expectedOutputPath(spec: ResolvedSpec, role: string | undefined, index: number, total: number, mediaType?: MediaType): string;
+/**
+ * One member of a set beside a stem file: `<stem>-<role><ext>`, or the stem
+ * itself for a single output. Generated outputs and a `source` for a frame
+ * set follow the same rule, so an edit's members sit where its generation's do.
+ */
+declare function memberPath(file: string, role: string | undefined, index: number, total: number, mediaType?: MediaType): string;
+/** Several PNG outputs — a frame set, a tile set — that a hand edit covers one file per member. */
+declare function isMemberSetEntry(entry: Pick<LockEntry, "outputs">): boolean;
+/** An ordered animation: the members are frames, played at the recorded fps. */
+declare function isFrameSetEntry(entry: Pick<LockEntry, "generator" | "outputs">): boolean;
+/**
+ * Whether a declared `source` for this entry names a stem with one file per
+ * member (`<stem>-<role>.png`, the rule generated outputs follow) rather than
+ * one file. A hand edit of a set is always the former; a file that exists at
+ * the source path itself is one committed image placed for the whole set, as
+ * it always was.
+ */
+declare function sourceIsStem(source: string, entry: Pick<LockEntry, "outputs">, manifestDir: string): boolean;
+/** Where a declared `source` places one output of an entry. */
+declare function sourceOutputPath(source: string, entry: Pick<LockEntry, "outputs">, index: number, manifestDir: string): string;
 /** Resolve one recorded output from the current manifest-owned destination. */
 declare function currentOutputPath(output: Pick<LockOutput, "path" | "role" | "mediaType">, spec: ResolvedSpec, index: number, total: number): string;
 /** Resolve an entry member using the complete source-set order when available. */
@@ -7036,7 +7056,9 @@ declare function packStyle(lock: Lock, styleId: string, manifestDir: string, opt
      * Manifest `source` art keyed by asset id, manifest-relative. A hand edit
      * or other post-processed file stands in for that asset's single output,
      * and an asset with a source but no lock entry is packed from it — the
-     * same rule `mount` applies. Structural sets keep their lock outputs.
+     * same rule `mount` applies. A set's hand edit is a stem: each member is
+     * packed from `<stem>-<role>.png`. A set whose source is one existing
+     * file keeps its lock outputs, as before.
      */
     sources?: Record<string, string>;
 }): PackedSheet;
@@ -7564,7 +7586,7 @@ interface GalleryOutput {
     url: string | null;
 }
 type HandEditStatus = 
-/** The edit file is byte-identical to the generated art. */
+/** The edit file has the generated art's pixels — nothing has been changed yet. */
 "same"
 /** The author changed it. */
  | "edited"
@@ -7673,6 +7695,18 @@ interface GalleryItem {
      * generated file, which stays on disk as the record.
      */
     edit: GalleryOutput | null;
+    /**
+     * Every file of the edit, one per output in the same order — the edit
+     * itself for a single image, `<stem>-<role>.png` per member of a set.
+     * Empty without a source.
+     */
+    edits: GalleryOutput[];
+    /**
+     * Per member of `edits`: true where its pixels differ from the generated
+     * file. Compared by pixels, not bytes, because every editor re-encodes a
+     * PNG it merely opened and saved.
+     */
+    editChanged: boolean[];
     editStatus: HandEditStatus | null;
     /** What an in-browser save recorded beside the edit; null for edits made elsewhere. */
     editMeta: GalleryEditMeta | null;
@@ -7799,9 +7833,9 @@ declare function galleryMediaRoute(id: string): string;
 interface GalleryEditMeta {
     editor: string;
     savedAt: string;
-    /** sha256 of the generation the edit was based on, or null for untracked art. */
+    /** sha256 of the generation the edit was based on (its first member for a set), or null for untracked art. */
     basedOn: string | null;
-    /** The edit file changed since the editor saved it (another tool touched it). */
+    /** An edit file changed since the editor saved it (another tool touched it). */
     changedSince: boolean;
     /** Manifest-relative path of the layered project file kept beside the edit, if present. */
     project: string | null;
@@ -7859,6 +7893,406 @@ interface RenderGalleryOptions {
 }
 declare function renderGallery(snapshot: GallerySnapshot, opts?: RenderGalleryOptions): string;
 
+/**
+ * Hand edits never touch the generated file. The generated PNG is the
+ * provenance record — its hash is in the lockfile, `plan` verifies it, and a
+ * regeneration replaces it — so an author's touch-up lives in a sibling file
+ * that the manifest points at with `source` (or `sourceByStyle`). `mount` and
+ * `pack` place that file, quality profiles read it, and revisions start from
+ * it, while `plan` keeps reporting the generation itself as `ok`.
+ *
+ * A set — an ordered frame set, a tile set, any entry with several PNG
+ * outputs — is edited the same way, one file per member: the manifest's
+ * `source` names the stem, and each member is `<stem>-<role>.png` beside it,
+ * the rule its generated outputs already follow.
+ *
+ * The author edits with whatever they already use: `PIXELKILN_EDITOR` names
+ * the program, otherwise the file opens with the OS default.
+ */
+declare const HAND_EDIT_DIR = "edits";
+/** One file of a hand edit: the whole edit for a single image, one frame of a set. */
+interface HandEditMember {
+    /** Output role for a set member; null for a single image. */
+    role: string | null;
+    /** Absolute path of the file the author edits. */
+    path: string;
+    /** The generated file it starts from, when on disk. */
+    base: string | null;
+}
+interface HandEditStart {
+    /** Absolute path of the file the author edits; the stem for a frame set. */
+    editPath: string;
+    /** Every file of the edit, in output order. One entry for a single image. */
+    members: HandEditMember[];
+    /** Manifest-relative form recorded in the manifest. */
+    source: string;
+    /** True when any file was created now as a copy of the generated art. */
+    created: boolean;
+    /** True when the manifest was rewritten to point at it. */
+    declared: boolean;
+    /** Manifest hash after the write, for a page that quotes it on the next edit. */
+    manifestSha256: string;
+}
+/** Where a hand edit of this spec lives: an `edits/` mirror under the style's outDir. */
+declare function handEditPath(loaded: LoadedManifest, spec: ResolvedSpec): string;
+/**
+ * The generated (or untracked) art a fresh edit starts from, per member.
+ * Null when the asset is not something a hand edit covers: a GIF, a set with
+ * a GIF in it, or nothing on disk to copy.
+ */
+declare function handEditBases(spec: ResolvedSpec, lock: Lock): Array<{
+    role: string | null;
+    path: string;
+}> | null;
+/** The generated (or untracked) art a fresh single-image edit starts from, if it is on disk. */
+declare function handEditBase(spec: ResolvedSpec, lock: Lock): string | null;
+/** The files a declared `source` stands for, in output order; the source itself for a single image. */
+declare function handEditMembers(loaded: LoadedManifest, spec: ResolvedSpec, lock: Lock, editPath: string): HandEditMember[];
+/**
+ * Make (or reuse) the edit file for one asset in one style and declare it in
+ * the manifest. Idempotent: a second call finds the same file and changes
+ * nothing, so "open my edit again" and "start editing" are one action. A
+ * set gets one file per member; a member already there is kept.
+ */
+declare function startHandEdit(loaded: LoadedManifest, lock: Lock, spec: ResolvedSpec, opts?: {
+    expectedSha256?: string;
+}): Promise<HandEditStart>;
+/** Stop placing the edit. The file stays where it is; only the manifest changes. */
+declare function detachHandEdit(loaded: LoadedManifest, spec: ResolvedSpec, opts?: {
+    expectedSha256?: string;
+}): Promise<{
+    manifestSha256: string;
+    changed: boolean;
+}>;
+declare const CompanionV2Schema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    /** Editor identity the bridge reported, e.g. `pixelorama@v1.2.2-stable`. */
+    editor: z.ZodString;
+    protocol: z.ZodNumber;
+    savedAt: z.ZodString;
+    /** Basename of the layered project file beside the edit, when one was kept. */
+    project: z.ZodNullable<z.ZodString>;
+    /** One entry per file, in output order. */
+    outputs: z.ZodArray<z.ZodObject<{
+        /** Output role for a set member; null for a single image. */
+        role: z.ZodNullable<z.ZodString>;
+        /** sha256 of the generated file this member started from; null when it started from untracked art. */
+        basedOn: z.ZodNullable<z.ZodString>;
+        /** sha256 of the member as saved, so a later change by another tool is visible. */
+        sha256: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        sha256: string;
+        role: string | null;
+        basedOn: string | null;
+    }, {
+        sha256: string;
+        role: string | null;
+        basedOn: string | null;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    outputs: {
+        sha256: string;
+        role: string | null;
+        basedOn: string | null;
+    }[];
+    version: 2;
+    protocol: number;
+    project: string | null;
+    editor: string;
+    savedAt: string;
+}, {
+    outputs: {
+        sha256: string;
+        role: string | null;
+        basedOn: string | null;
+    }[];
+    version: 2;
+    protocol: number;
+    project: string | null;
+    editor: string;
+    savedAt: string;
+}>;
+declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    /** Editor identity the bridge reported, e.g. `pixelorama@v1.2.2-stable`. */
+    editor: z.ZodString;
+    protocol: z.ZodNumber;
+    savedAt: z.ZodString;
+    /** Basename of the layered project file beside the edit, when one was kept. */
+    project: z.ZodNullable<z.ZodString>;
+    /** One entry per file, in output order. */
+    outputs: z.ZodArray<z.ZodObject<{
+        /** Output role for a set member; null for a single image. */
+        role: z.ZodNullable<z.ZodString>;
+        /** sha256 of the generated file this member started from; null when it started from untracked art. */
+        basedOn: z.ZodNullable<z.ZodString>;
+        /** sha256 of the member as saved, so a later change by another tool is visible. */
+        sha256: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        sha256: string;
+        role: string | null;
+        basedOn: string | null;
+    }, {
+        sha256: string;
+        role: string | null;
+        basedOn: string | null;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    outputs: {
+        sha256: string;
+        role: string | null;
+        basedOn: string | null;
+    }[];
+    version: 2;
+    protocol: number;
+    project: string | null;
+    editor: string;
+    savedAt: string;
+}, {
+    outputs: {
+        sha256: string;
+        role: string | null;
+        basedOn: string | null;
+    }[];
+    version: 2;
+    protocol: number;
+    project: string | null;
+    editor: string;
+    savedAt: string;
+}>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    basedOn: z.ZodNullable<z.ZodString>;
+    sha256: z.ZodString;
+    editor: z.ZodString;
+    protocol: z.ZodNumber;
+    savedAt: z.ZodString;
+    project: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    sha256: string;
+    version: 1;
+    protocol: number;
+    project: string | null;
+    basedOn: string | null;
+    editor: string;
+    savedAt: string;
+}, {
+    sha256: string;
+    version: 1;
+    protocol: number;
+    project: string | null;
+    basedOn: string | null;
+    editor: string;
+    savedAt: string;
+}>]>, {
+    outputs: {
+        sha256: string;
+        role: string | null;
+        basedOn: string | null;
+    }[];
+    version: 2;
+    protocol: number;
+    project: string | null;
+    editor: string;
+    savedAt: string;
+}, {
+    outputs: {
+        sha256: string;
+        role: string | null;
+        basedOn: string | null;
+    }[];
+    version: 2;
+    protocol: number;
+    project: string | null;
+    editor: string;
+    savedAt: string;
+} | {
+    sha256: string;
+    version: 1;
+    protocol: number;
+    project: string | null;
+    basedOn: string | null;
+    editor: string;
+    savedAt: string;
+}>;
+type HandEditCompanion = z.infer<typeof CompanionV2Schema>;
+declare function handEditCompanionPath(editPath: string): string;
+/** The layered project (Pixelorama `.pxo`) kept beside the edit for re-editing. */
+declare function handEditProjectPath(editPath: string): string;
+declare function readHandEditCompanion(editPath: string): Promise<HandEditCompanion | null>;
+/** Edits bigger than this are refused before decoding; a sprite sheet is far smaller. */
+declare const MAX_HAND_EDIT_BYTES: number;
+interface HandEditSaveInput {
+    /** The flattened image, as PNG bytes. For a frame set, use `frames`. */
+    png?: Buffer;
+    /** Every frame of a set, tagged with the role it was opened under (null for one added in the editor). */
+    frames?: Array<{
+        role: string | null;
+        png: Buffer;
+    }>;
+    /** The editor's own layered project file, kept beside the edit when given. */
+    project?: Buffer;
+    editor: string;
+    protocol: number;
+    expectedSha256?: string;
+    now?: Date;
+}
+interface HandEditSave extends HandEditStart {
+    /** sha256 of the edit as saved; of the first member for a frame set. */
+    sha256: string;
+    /** Hash of the generation the edit started from; of the first member for a frame set. */
+    basedOn: string | null;
+    companion: HandEditCompanion;
+    companionPath: string;
+    projectPath: string | null;
+}
+/**
+ * Save an edit made in the in-browser editor. Every PNG must be a valid
+ * image at the asset's generated size, a set must come back with the same
+ * members it was opened with, and the files replace the edit
+ * atomically; the companion records what each was based on, and the
+ * manifest declares the edit if it does not yet — the same path
+ * `startHandEdit` takes, so the first save from the browser and
+ * `pixelkiln edit` leave the same manifest.
+ */
+declare function saveHandEdit(loaded: LoadedManifest, lock: Lock, spec: ResolvedSpec, input: HandEditSaveInput): Promise<HandEditSave>;
+/**
+ * Open a file in the author's editor. `PIXELKILN_EDITOR` may be a program
+ * name or a command with arguments (`aseprite`, `"open -a Aseprite"`); the
+ * file path is appended. Without it the OS default handler is used.
+ */
+declare function openInEditor(file: string, editor?: string | undefined): string;
+
+/**
+ * The one editor build a PixelKiln release trusts. The source of truth is
+ * `tools/pixelorama-bridge/pin.json`, written when a build is published; the
+ * bundler inlines it here so the shipped package carries the exact hashes.
+ */
+interface EditorPin {
+    /** Upstream Pixelorama tag the build was made from. */
+    pixelorama: string;
+    godot: string;
+    extensionsApi: number;
+    /** Bridge protocol version the page must speak. */
+    protocol: number;
+    /** GitHub release tag carrying the files, or null before the first publish. */
+    release: string | null;
+    files: Record<string, {
+        sha256: string;
+        bytes: number;
+    }>;
+}
+declare const EDITOR_PIN: EditorPin;
+/** Where a published build's files are downloaded from, unless overridden. */
+declare const EDITOR_RELEASE_BASE = "https://github.com/gfargo/pixelkiln/releases/download";
+
+/**
+ * The in-gallery editor is a 46 MB web build that is not part of the npm
+ * package. It is fetched once per pinned release into a user-level cache,
+ * every file verified against the hash the package carries, and served from
+ * there by the gallery. Nothing is executed at install; the browser runs the
+ * wasm, and only from files whose hashes matched.
+ *
+ * A user-level cache rather than the project's `.pixelkiln/`: the pin is per
+ * PixelKiln release, not per project, and one copy serves every project.
+ * `PIXELKILN_TOOLS_DIR` moves it; `PIXELKILN_EDITOR_URL` points downloads at
+ * a mirror or a local directory server for offline machines.
+ */
+interface EditorInstallStatus {
+    /** Release tag the package pins; null means no build has been published for this version. */
+    release: string | null;
+    dir: string;
+    /** Every pinned file is present with the right hash. */
+    installed: boolean;
+    /** Files still to fetch (missing or hash mismatch). */
+    missing: string[];
+    totalBytes: number;
+    installedBytes: number;
+}
+interface EditorInstallProgress {
+    file: string;
+    index: number;
+    count: number;
+    bytes: number;
+    totalBytes: number;
+    /** Bytes fetched so far across all files, including the part of this one. */
+    fetchedBytes: number;
+    /** `start` once per file, `progress` as its bytes arrive, `done` once it verified and landed. */
+    phase: "start" | "progress" | "done";
+}
+interface EditorInstallOptions {
+    pin?: EditorPin;
+    dir?: string;
+    /** Base URL (or `file://`-less local directory) the files are fetched from. */
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    onProgress?: (progress: EditorInstallProgress) => void;
+    signal?: AbortSignal;
+}
+interface EditorInstallResult extends EditorInstallStatus {
+    downloaded: string[];
+    skipped: string[];
+}
+declare class EditorInstallError extends Error {
+    readonly file?: string | undefined;
+    constructor(message: string, file?: string | undefined);
+}
+/** Default cache root: XDG on Linux, ~/Library/Caches on macOS, LOCALAPPDATA on Windows. */
+declare function editorToolsRoot(): string;
+/** Where one pinned release lives; the tag is part of the path so upgrades never overwrite. */
+declare function editorDir(pin?: EditorPin, root?: string): string;
+/** Download base for a pinned release; `PIXELKILN_EDITOR_URL` overrides it. */
+declare function editorBaseUrl(pin?: EditorPin): string | null;
+/** What is on disk versus what the pin expects, without touching the network. */
+declare function editorStatus(opts?: {
+    pin?: EditorPin;
+    dir?: string;
+}): Promise<EditorInstallStatus>;
+/**
+ * Fetch every pinned file that is missing or wrong, verifying each against
+ * its hash before it lands. A file that fails verification is discarded and
+ * the install fails; nothing partial is ever left under the final name.
+ */
+declare function installEditor(opts?: EditorInstallOptions): Promise<EditorInstallResult>;
+
+/**
+ * The gallery's side of the in-browser editor: it reports whether the pinned
+ * build is on disk, installs it on request, and serves its files.
+ *
+ * Serving is allowlisted twice. The release tag in the URL must be the one
+ * this package pins, and the file name must be one the pin lists; nothing
+ * else under the tools directory is reachable. A file is served only after
+ * the whole build has verified against the pinned hashes, and its size is
+ * checked again on every read, so a build that changed on disk after
+ * verification is refused rather than served.
+ */
+interface GalleryEditorStatus extends EditorInstallStatus {
+    pixelorama: string;
+    protocol: number;
+    /** Where the page loads the editor from once installed; null until then. */
+    url: string | null;
+    /** The install in flight, if any. */
+    installing: EditorInstallProgress | null;
+    /** Why the last install failed, until the next attempt. */
+    error: string | null;
+}
+interface GalleryEditorHandlers {
+    release: string | null;
+    status(): Promise<GalleryEditorStatus>;
+    /** Start an install unless one is running; returns the status right after. */
+    install(): Promise<GalleryEditorStatus>;
+    /** A verified build file, or null when it is not pinned or not installed. */
+    file(release: string, name: string): Promise<{
+        bytes: Buffer;
+        contentType: string;
+    } | null>;
+}
+interface GalleryEditorOptions extends Pick<EditorInstallOptions, "dir" | "baseUrl" | "fetch"> {
+    pin?: EditorPin;
+    onProgress?: (msg: string) => void;
+}
+declare function editorRoute(release: string, name?: string): string;
+declare function createGalleryEditorHandlers(opts?: GalleryEditorOptions): GalleryEditorHandlers;
+
 /**
  * Generation from the gallery is the CLI's `gen`, run as a background job:
  * the same `buildPlan`, the same per-provider budget and balance preflight,
@@ -8272,74 +8706,6 @@ interface GalleryEditHandlerOptions {
 /** The `edit` callback `serveGallery` expects: validate, apply, rebuild. */
 declare function createGalleryEditHandler(opts: GalleryEditHandlerOptions): (body: unknown) => Promise<GalleryBuild>;
 
-/**
- * The in-gallery editor is a 46 MB web build that is not part of the npm
- * package. It is fetched once per pinned release into a user-level cache,
- * every file verified against the hash the package carries, and served from
- * there by the gallery. Nothing is executed at install; the browser runs the
- * wasm, and only from files whose hashes matched.
- *
- * A user-level cache rather than the project's `.pixelkiln/`: the pin is per
- * PixelKiln release, not per project, and one copy serves every project.
- * `PIXELKILN_TOOLS_DIR` moves it; `PIXELKILN_EDITOR_URL` points downloads at
- * a mirror or a local directory server for offline machines.
- */
-interface EditorInstallStatus {
-    /** Release tag the package pins; null means no build has been published for this version. */
-    release: string | null;
-    dir: string;
-    /** Every pinned file is present with the right hash. */
-    installed: boolean;
-    /** Files still to fetch (missing or hash mismatch). */
-    missing: string[];
-    totalBytes: number;
-    installedBytes: number;
-}
-interface EditorInstallProgress {
-    file: string;
-    index: number;
-    count: number;
-    bytes: number;
-    totalBytes: number;
-    /** Bytes fetched so far across all files, including the part of this one. */
-    fetchedBytes: number;
-    /** `start` once per file, `progress` as its bytes arrive, `done` once it verified and landed. */
-    phase: "start" | "progress" | "done";
-}
-
-/**
- * The gallery's side of the in-browser editor: it reports whether the pinned
- * build is on disk, installs it on request, and serves its files.
- *
- * Serving is allowlisted twice. The release tag in the URL must be the one
- * this package pins, and the file name must be one the pin lists; nothing
- * else under the tools directory is reachable. A file is served only after
- * the whole build has verified against the pinned hashes, and its size is
- * checked again on every read, so a build that changed on disk after
- * verification is refused rather than served.
- */
-interface GalleryEditorStatus extends EditorInstallStatus {
-    pixelorama: string;
-    protocol: number;
-    /** Where the page loads the editor from once installed; null until then. */
-    url: string | null;
-    /** The install in flight, if any. */
-    installing: EditorInstallProgress | null;
-    /** Why the last install failed, until the next attempt. */
-    error: string | null;
-}
-interface GalleryEditorHandlers {
-    release: string | null;
-    status(): Promise<GalleryEditorStatus>;
-    /** Start an install unless one is running; returns the status right after. */
-    install(): Promise<GalleryEditorStatus>;
-    /** A verified build file, or null when it is not pinned or not installed. */
-    file(release: string, name: string): Promise<{
-        bytes: Buffer;
-        contentType: string;
-    } | null>;
-}
-
 /**
  * The gallery's HTTP surface. Unlike the review server this is long-lived:
  * three GET routes, bound to loopback, running until the caller closes it
@@ -8647,4 +9013,4 @@ interface WorkspaceStatusReport {
  */
 declare function workspaceStatus(ws: Workspace, dir: string): Promise<WorkspaceStatusReport>;
 
-export { type AdoptResult, type ApproveQualityOptions, type ApprovedQualityReview, type ArtifactBundleManifest, type ArtifactBundleOptions, type ArtifactBundleResult, type ArtifactFile, type ArtifactProvenance, type ArtifactSource, type ArtifactVerification, type Asset, type AssetAudit, AssetSchema, type AuditEvaluation, type AuditThresholds, type AuditViolation, type Balance, type BalanceChange, type BalanceInfo, type BuildGalleryOptions, type BuildWorkspaceGalleryOptions, type CacheHealthOptions, type CacheHealthReport, type CandidateSelection, type ComfyUIBinding, type ComfyUIBindings, type ComfyUIFramesOptions, type ComfyUIImageInput, type ComfyUIOptions, ComfyUIProvider, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type GalleryBuild, type GalleryEditHandlerOptions, type GalleryGenerateHandlers, type GalleryItem, type GalleryMedia, type GalleryOutput, type GalleryProject, type GalleryProjectContext, type GalleryQuality, type GalleryServer, type GalleryServerOptions, type GallerySnapshot, type GalleryState, type GalleryStyle, type GenerateHandlerOptions, type GenerateJob, type GeneratePhase, GenerateRequestError, GenerateRequestSchema, type GenerateStatus, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, ManifestDriftError, type ManifestEdit, ManifestEditError, type ManifestEditResult, ManifestEditSchema, ManifestInputSchema, ManifestSchema, type MapObject, MediaType, type MountPlacement, type MountedSheet, type NormalizedTileRules, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, PIXEL_ART_FIXER_REVISION, PIXEL_ART_FIXER_URL, type PackedFrame, type PackedSheet, type PackedSource, type PendingQualityReview, type PickResult, type PixelArtFixerDetection, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type PrepareReviewOptions, type Provider, type ProviderFactory, type ProviderInputContext, type ProviderInputScalar, type ProviderInputValue, type ProviderMetadata, type ProviderMode, type ProviderOptionContext, type ProviderSubmission, type QualityBaseline, QualityBaselineSchema, type QualityCheck, type QualityProfile, type QualityProfileInspection, QualityProfileSchema, type QualityProfileState, type QualityRegressionCaseResult, type QualityRegressionReport, type QualitySnapshotResult, QualityToleranceSchema, type QualityTolerances, type RateLimit, type Recipe, type RecipeFileVerification, type RecipeModelVerification, RecipeSchema, type RecipeVerification, type RefineAudit, type RefineFrameSetOptions, type RefineFrameSetResult, type RefineOptions, type RefineQualityProfilesOptions, type RefineQualityProfilesResult, type RefineRecordOptions, type RefineResult, type RemoteAsset, type RemoteHashCacheHealth, type RenderGalleryOptions, type RenderSheetOptions, type ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedRevision, type ResolvedSpec, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type ReviewReadyInfo, type ReviewSession, type Revision, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, type SessionBudget, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, type StyleInput, StyleInputSchema, StyleSchema, type SubmissionCheckpoint, type SubmitContext, type SubmitOptions, type SubmitResult, type TilesPro, type TilesetExport, type TilesetExportOptions, type TilesetFormat, UnsupportedCapabilityError, type Workspace, type WorkspaceClaims, type WorkspaceDiagnostic, type WorkspaceProject, WorkspaceProjectSchema, type WorkspaceProjectStatus, WorkspaceSchema, type WorkspaceStatusReport, adopt, applyManifestEdit, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildGallerySnapshot, buildManifest, buildPlan, buildWorkspaceGallerySnapshot, bundledRecipeRoot, cacheFileName, candidateCount, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createGalleryEditHandler, createGenerateHandlers, createProvider, currentEntryOutputPath, currentOutputPath, detectMediaType, doctor, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, findOrphans, formatCost, galleryMediaId, galleryMediaRoute, generationCost, groupOrphansByStyle, hex, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installRecipe, isSensitiveSourceUrl, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTileRules, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pngSize, poll, portableOutputPath, prepareReview, primaryOutput, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readQualityBaseline, recipeDigest, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderGallery, renderSalvageSheet, renderSheet, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retryAfterMs, runPicker, runSalvage, saveLock, saveWorkspace, scanAssets, selectEntryOutput, serveGallery, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, specHash, spendByUnit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };
+export { type AdoptResult, type ApproveQualityOptions, type ApprovedQualityReview, type ArtifactBundleManifest, type ArtifactBundleOptions, type ArtifactBundleResult, type ArtifactFile, type ArtifactProvenance, type ArtifactSource, type ArtifactVerification, type Asset, type AssetAudit, AssetSchema, type AuditEvaluation, type AuditThresholds, type AuditViolation, type Balance, type BalanceChange, type BalanceInfo, type BuildGalleryOptions, type BuildWorkspaceGalleryOptions, type CacheHealthOptions, type CacheHealthReport, type CandidateSelection, type ComfyUIBinding, type ComfyUIBindings, type ComfyUIFramesOptions, type ComfyUIImageInput, type ComfyUIOptions, ComfyUIProvider, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, EDITOR_PIN, EDITOR_RELEASE_BASE, EditorInstallError, type EditorInstallOptions, type EditorInstallProgress, type EditorInstallResult, type EditorInstallStatus, type EditorPin, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type GalleryBuild, type GalleryEditHandlerOptions, type GalleryEditMeta, type GalleryEditorHandlers, type GalleryEditorOptions, type GalleryEditorStatus, type GalleryGenerateHandlers, type GalleryItem, type GalleryMedia, type GalleryOutput, type GalleryProject, type GalleryProjectContext, type GalleryQuality, type GalleryServer, type GalleryServerOptions, type GallerySnapshot, type GalleryState, type GalleryStyle, type GenerateHandlerOptions, type GenerateJob, type GeneratePhase, GenerateRequestError, GenerateRequestSchema, type GenerateStatus, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, HAND_EDIT_DIR, type HandEditCompanion, HandEditCompanionSchema, type HandEditMember, type HandEditSave, type HandEditSaveInput, type HandEditStart, type HandEditStatus, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_HAND_EDIT_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, ManifestDriftError, type ManifestEdit, ManifestEditError, type ManifestEditResult, ManifestEditSchema, ManifestInputSchema, ManifestSchema, type MapObject, MediaType, type MountPlacement, type MountedSheet, type NormalizedTileRules, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, PIXEL_ART_FIXER_REVISION, PIXEL_ART_FIXER_URL, type PackedFrame, type PackedSheet, type PackedSource, type PendingQualityReview, type PickResult, type PixelArtFixerDetection, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type PrepareReviewOptions, type Provider, type ProviderFactory, type ProviderInputContext, type ProviderInputScalar, type ProviderInputValue, type ProviderMetadata, type ProviderMode, type ProviderOptionContext, type ProviderSubmission, type QualityBaseline, QualityBaselineSchema, type QualityCheck, type QualityProfile, type QualityProfileInspection, QualityProfileSchema, type QualityProfileState, type QualityRegressionCaseResult, type QualityRegressionReport, type QualitySnapshotResult, QualityToleranceSchema, type QualityTolerances, type RateLimit, type Recipe, type RecipeFileVerification, type RecipeModelVerification, RecipeSchema, type RecipeVerification, type RefineAudit, type RefineFrameSetOptions, type RefineFrameSetResult, type RefineOptions, type RefineQualityProfilesOptions, type RefineQualityProfilesResult, type RefineRecordOptions, type RefineResult, type RemoteAsset, type RemoteHashCacheHealth, type RenderGalleryOptions, type RenderSheetOptions, type ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedRevision, type ResolvedSpec, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type ReviewReadyInfo, type ReviewSession, type Revision, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, type SessionBudget, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, type StyleInput, StyleInputSchema, StyleSchema, type SubmissionCheckpoint, type SubmitContext, type SubmitOptions, type SubmitResult, type TilesPro, type TilesetExport, type TilesetExportOptions, type TilesetFormat, UnsupportedCapabilityError, type Workspace, type WorkspaceClaims, type WorkspaceDiagnostic, type WorkspaceProject, WorkspaceProjectSchema, type WorkspaceProjectStatus, WorkspaceSchema, type WorkspaceStatusReport, adopt, applyManifestEdit, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildGallerySnapshot, buildManifest, buildPlan, buildWorkspaceGallerySnapshot, bundledRecipeRoot, cacheFileName, candidateCount, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createGalleryEditHandler, createGalleryEditorHandlers, createGenerateHandlers, createProvider, currentEntryOutputPath, currentOutputPath, detachHandEdit, detectMediaType, doctor, editorBaseUrl, editorDir, editorRoute, editorStatus, editorToolsRoot, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, findOrphans, formatCost, galleryMediaId, galleryMediaRoute, generationCost, groupOrphansByStyle, handEditBase, handEditBases, handEditCompanionPath, handEditMembers, handEditPath, handEditProjectPath, hex, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installEditor, installRecipe, isFrameSetEntry, isMemberSetEntry, isSensitiveSourceUrl, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, memberPath, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTileRules, openInEditor, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pngSize, poll, portableOutputPath, prepareReview, primaryOutput, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readHandEditCompanion, readQualityBaseline, recipeDigest, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderGallery, renderSalvageSheet, renderSheet, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retryAfterMs, runPicker, runSalvage, saveHandEdit, saveLock, saveWorkspace, scanAssets, selectEntryOutput, serveGallery, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, sourceIsStem, sourceOutputPath, specHash, spendByUnit, startHandEdit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };