pixelkiln 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -2576,6 +2576,18 @@ interface SiblingManifest {
     label: string;
     manifest: Manifest;
 }
+/**
+ * Loads every sibling project's manifest for `groupOrphansByStyle`'s
+ * sibling-exclusion signal, from the union of a workspace catalog's
+ * registered manifests and the conventional sibling beside each `--claims`
+ * lockfile (same directory, by the convention `--lock` defaults from
+ * `--manifest`). The two sources are meant to combine, not choose between
+ * (docs/RECOVERY.md: "`--claims` still works and unions with a workspace's
+ * claim set") — a `--claims` path passed alongside `--workspace` must still
+ * contribute its own style signal. Best-effort: a missing or malformed
+ * sibling just means no extra signal for that orphan, not an error.
+ */
+declare function loadSiblingManifests(ownManifestPath: string, workspaceManifestPaths: string[], claimPaths: string[]): Promise<SiblingManifest[]>;
 interface OrphanGroups {
     /** styleId → its matched orphans, in manifest style order. */
     matched: Map<string, Orphan[]>;
@@ -2676,4 +2688,159 @@ interface SalvageSheetContext {
  */
 declare function renderSalvageSheet(orphans: Orphan[], ctx?: SalvageSheetContext): string;
 
-export { type AdoptResult, 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 CacheHealthOptions, type CacheHealthReport, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_RATE_LIMIT, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type Generator, GeneratorSchema, type GenericTileset, type JobState, type LoadedManifest, type Lock, type LockEntry, LockEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, ManifestSchema, type MapObject, type MountPlacement, type MountedSheet, type NormalizedTileRules, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, type PackedFrame, type PackedSheet, type PackedSource, type PickResult, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type Provider, type ProviderMetadata, type RateLimit, type RemoteAsset, type RemoteHashCacheHealth, type ResolvedOutput, type ResolvedSpec, type ResolvedStyleImage, type SalvageAction, type SalvageResult, type ScannedAsset, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, StyleSchema, type SubmitOptions, type SubmitResult, type TilesPro, type TilesetExport, type TilesetExportOptions, type TilesetFormat, UnsupportedCapabilityError, adopt, applyTags, auditStyle, backoffMs, buildManifest, buildPlan, candidateCount, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, currentEntryOutputPath, currentOutputPath, doctor, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, findOrphans, formatCost, generationCost, groupOrphansByStyle, hex, idFromPrompt, imageMetadata, inspectCaches, loadClaims, loadLock, loadManifest, lockKey, matchOrphanStyle, measureBalanceChange, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeTileRules, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, pngSize, poll, portableOutputPath, primaryOutput, pushTags, remove, renderSalvageSheet, renderSheet, requireDelete, requireList, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, retryAfterMs, runPicker, runSalvage, saveLock, scanAssets, selectEntryOutput, sha256, sha256File, shouldRetry, slugify, specHash, spendByUnit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, totalSpend, upsert, validateCostEstimate, verifyArtifactBundle, withArtifactManifest, writeArtifactBundle, writeManagedArtifactBundle };
+/**
+ * One sibling project registered in a workspace catalog. Only paths and
+ * identity live here — never a credential. Each project keeps loading its own
+ * key from its own `.env`, the same as it does standalone.
+ */
+declare const WorkspaceProjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    /** Manifest path, relative to the catalog file's own directory. */
+    manifest: z.ZodString;
+    /** Lockfile path, relative to the catalog file's own directory. */
+    lock: z.ZodString;
+    provider: z.ZodDefault<z.ZodString>;
+    /** Free-form label for a shared account, e.g. distinguishing sandboxes. */
+    account: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    provider: string;
+    id: string;
+    manifest: string;
+    lock: string;
+    account?: string | undefined;
+}, {
+    id: string;
+    manifest: string;
+    lock: string;
+    provider?: string | undefined;
+    account?: string | undefined;
+}>;
+declare const WorkspaceSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    projects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        /** Manifest path, relative to the catalog file's own directory. */
+        manifest: z.ZodString;
+        /** Lockfile path, relative to the catalog file's own directory. */
+        lock: z.ZodString;
+        provider: z.ZodDefault<z.ZodString>;
+        /** Free-form label for a shared account, e.g. distinguishing sandboxes. */
+        account: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        provider: string;
+        id: string;
+        manifest: string;
+        lock: string;
+        account?: string | undefined;
+    }, {
+        id: string;
+        manifest: string;
+        lock: string;
+        provider?: string | undefined;
+        account?: string | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    version: 1;
+    projects: {
+        provider: string;
+        id: string;
+        manifest: string;
+        lock: string;
+        account?: string | undefined;
+    }[];
+}, {
+    version: 1;
+    projects?: {
+        id: string;
+        manifest: string;
+        lock: string;
+        provider?: string | undefined;
+        account?: string | undefined;
+    }[] | undefined;
+}>;
+type WorkspaceProject = z.infer<typeof WorkspaceProjectSchema>;
+type Workspace = z.infer<typeof WorkspaceSchema>;
+/**
+ * Parses a workspace catalog, rejecting anything that is not v1.
+ *
+ * Mirrors `parseLock`'s stance: no migration path, fail loudly rather than
+ * guess at a hand-edited or corrupted file's intent.
+ */
+declare function parseWorkspace(raw: unknown): Workspace;
+declare function loadWorkspace(workspacePath: string): Promise<Workspace>;
+/** Atomic write — a crash mid-save must not leave a truncated catalog. */
+declare function saveWorkspace(workspacePath: string, ws: Workspace): Promise<void>;
+/** Stored path convention: relative to the catalog's directory, forward-slash. */
+declare function toPortablePath(dir: string, absolute: string): string;
+/** Resolve a registered project's stored paths against the catalog's directory. */
+declare function resolveProject(dir: string, project: WorkspaceProject): {
+    manifestPath: string;
+    lockPath: string;
+};
+interface WorkspaceDiagnostic {
+    id: "duplicate-id" | "duplicate-lock" | "duplicate-manifest" | "missing-manifest" | "missing-lock" | "absolute-path" | "mixed-provider";
+    level: "error" | "warning";
+    message: string;
+}
+/**
+ * Checks the catalog without touching the network or any registered
+ * project's files. Duplicate ids and duplicate lock paths are errors — either
+ * would corrupt the union claim set. A duplicate manifest is only a warning,
+ * because a manifest paired with a variant `--lock` is an already-supported
+ * pattern (see `cachePathFor`). Missing files are errors: a claim set derived
+ * from a workspace that silently skipped a project is the exact hazard this
+ * catalog exists to prevent.
+ */
+declare function validateWorkspace(ws: Workspace, dir: string): WorkspaceDiagnostic[];
+
+interface WorkspaceClaims {
+    claimed: Set<string>;
+    /** Claim count contributed by each registered project. */
+    byProject: Record<string, number>;
+    lockPaths: string[];
+}
+/**
+ * The complete account-wide claim set, derived from every registered lock.
+ *
+ * Delegates the union rule itself to `loadClaims` rather than reimplementing
+ * it, so the workspace and single-project `--claims` paths cannot drift. Each
+ * lock is loaded one at a time — rather than handing `loadClaims` the whole
+ * path list at once — purely so a failure can be attributed to the project
+ * that owns it; the safety property (any unreadable registered lock aborts
+ * before returning a claim set) is identical either way.
+ */
+declare function workspaceClaims(ws: Workspace, dir: string): Promise<WorkspaceClaims>;
+interface WorkspaceProjectStatus {
+    id: string;
+    provider: string;
+    account: string | null;
+    manifest: string;
+    lock: string;
+    entries: number;
+    byState: Record<PlanState, number>;
+    spendByUnit: Record<CostUnit, number>;
+    error: string | null;
+}
+interface WorkspaceStatusReport {
+    version: 1;
+    safe: boolean;
+    /** The catalog's own directory — resolved paths in `projects` sit under it. */
+    dir: string;
+    projects: WorkspaceProjectStatus[];
+    totals: {
+        byState: Record<PlanState, number>;
+        spendByUnit: Record<CostUnit, number>;
+        claims: number;
+    };
+    diagnostics: WorkspaceDiagnostic[];
+}
+/**
+ * Aggregate, read-only account/project state — offline throughout, using the
+ * same offline cost estimator `plan` uses. A project whose manifest or lock
+ * fails to load surfaces as that project's own `error` rather than aborting
+ * the whole report, so one broken sibling does not hide every other
+ * project's status. It never writes to any registered project's lock.
+ */
+declare function workspaceStatus(ws: Workspace, dir: string): Promise<WorkspaceStatusReport>;
+
+export { type AdoptResult, 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 CacheHealthOptions, type CacheHealthReport, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_RATE_LIMIT, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type Generator, GeneratorSchema, type GenericTileset, type JobState, type LoadedManifest, type Lock, type LockEntry, LockEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, ManifestSchema, type MapObject, type MountPlacement, type MountedSheet, type NormalizedTileRules, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, type PackedFrame, type PackedSheet, type PackedSource, type PickResult, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type Provider, type ProviderMetadata, type RateLimit, type RemoteAsset, type RemoteHashCacheHealth, type ResolvedOutput, type ResolvedSpec, type ResolvedStyleImage, type SalvageAction, type SalvageResult, type ScannedAsset, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, StyleSchema, 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, applyTags, auditStyle, backoffMs, buildManifest, buildPlan, candidateCount, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, currentEntryOutputPath, currentOutputPath, doctor, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, findOrphans, formatCost, generationCost, groupOrphansByStyle, hex, idFromPrompt, imageMetadata, inspectCaches, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeTileRules, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pngSize, poll, portableOutputPath, primaryOutput, pushTags, remove, renderSalvageSheet, renderSheet, requireDelete, requireList, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, retryAfterMs, runPicker, runSalvage, saveLock, saveWorkspace, scanAssets, selectEntryOutput, sha256, sha256File, shouldRetry, slugify, specHash, spendByUnit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, upsert, validateCostEstimate, validateWorkspace, verifyArtifactBundle, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };

package/dist/index.d.ts

@@ -2576,6 +2576,18 @@ interface SiblingManifest {
     label: string;
     manifest: Manifest;
 }
+/**
+ * Loads every sibling project's manifest for `groupOrphansByStyle`'s
+ * sibling-exclusion signal, from the union of a workspace catalog's
+ * registered manifests and the conventional sibling beside each `--claims`
+ * lockfile (same directory, by the convention `--lock` defaults from
+ * `--manifest`). The two sources are meant to combine, not choose between
+ * (docs/RECOVERY.md: "`--claims` still works and unions with a workspace's
+ * claim set") — a `--claims` path passed alongside `--workspace` must still
+ * contribute its own style signal. Best-effort: a missing or malformed
+ * sibling just means no extra signal for that orphan, not an error.
+ */
+declare function loadSiblingManifests(ownManifestPath: string, workspaceManifestPaths: string[], claimPaths: string[]): Promise<SiblingManifest[]>;
 interface OrphanGroups {
     /** styleId → its matched orphans, in manifest style order. */
     matched: Map<string, Orphan[]>;
@@ -2676,4 +2688,159 @@ interface SalvageSheetContext {
  */
 declare function renderSalvageSheet(orphans: Orphan[], ctx?: SalvageSheetContext): string;
 
-export { type AdoptResult, 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 CacheHealthOptions, type CacheHealthReport, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_RATE_LIMIT, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type Generator, GeneratorSchema, type GenericTileset, type JobState, type LoadedManifest, type Lock, type LockEntry, LockEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, ManifestSchema, type MapObject, type MountPlacement, type MountedSheet, type NormalizedTileRules, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, type PackedFrame, type PackedSheet, type PackedSource, type PickResult, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type Provider, type ProviderMetadata, type RateLimit, type RemoteAsset, type RemoteHashCacheHealth, type ResolvedOutput, type ResolvedSpec, type ResolvedStyleImage, type SalvageAction, type SalvageResult, type ScannedAsset, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, StyleSchema, type SubmitOptions, type SubmitResult, type TilesPro, type TilesetExport, type TilesetExportOptions, type TilesetFormat, UnsupportedCapabilityError, adopt, applyTags, auditStyle, backoffMs, buildManifest, buildPlan, candidateCount, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, currentEntryOutputPath, currentOutputPath, doctor, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, findOrphans, formatCost, generationCost, groupOrphansByStyle, hex, idFromPrompt, imageMetadata, inspectCaches, loadClaims, loadLock, loadManifest, lockKey, matchOrphanStyle, measureBalanceChange, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeTileRules, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, pngSize, poll, portableOutputPath, primaryOutput, pushTags, remove, renderSalvageSheet, renderSheet, requireDelete, requireList, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, retryAfterMs, runPicker, runSalvage, saveLock, scanAssets, selectEntryOutput, sha256, sha256File, shouldRetry, slugify, specHash, spendByUnit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, totalSpend, upsert, validateCostEstimate, verifyArtifactBundle, withArtifactManifest, writeArtifactBundle, writeManagedArtifactBundle };
+/**
+ * One sibling project registered in a workspace catalog. Only paths and
+ * identity live here — never a credential. Each project keeps loading its own
+ * key from its own `.env`, the same as it does standalone.
+ */
+declare const WorkspaceProjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    /** Manifest path, relative to the catalog file's own directory. */
+    manifest: z.ZodString;
+    /** Lockfile path, relative to the catalog file's own directory. */
+    lock: z.ZodString;
+    provider: z.ZodDefault<z.ZodString>;
+    /** Free-form label for a shared account, e.g. distinguishing sandboxes. */
+    account: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    provider: string;
+    id: string;
+    manifest: string;
+    lock: string;
+    account?: string | undefined;
+}, {
+    id: string;
+    manifest: string;
+    lock: string;
+    provider?: string | undefined;
+    account?: string | undefined;
+}>;
+declare const WorkspaceSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    projects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        /** Manifest path, relative to the catalog file's own directory. */
+        manifest: z.ZodString;
+        /** Lockfile path, relative to the catalog file's own directory. */
+        lock: z.ZodString;
+        provider: z.ZodDefault<z.ZodString>;
+        /** Free-form label for a shared account, e.g. distinguishing sandboxes. */
+        account: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        provider: string;
+        id: string;
+        manifest: string;
+        lock: string;
+        account?: string | undefined;
+    }, {
+        id: string;
+        manifest: string;
+        lock: string;
+        provider?: string | undefined;
+        account?: string | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    version: 1;
+    projects: {
+        provider: string;
+        id: string;
+        manifest: string;
+        lock: string;
+        account?: string | undefined;
+    }[];
+}, {
+    version: 1;
+    projects?: {
+        id: string;
+        manifest: string;
+        lock: string;
+        provider?: string | undefined;
+        account?: string | undefined;
+    }[] | undefined;
+}>;
+type WorkspaceProject = z.infer<typeof WorkspaceProjectSchema>;
+type Workspace = z.infer<typeof WorkspaceSchema>;
+/**
+ * Parses a workspace catalog, rejecting anything that is not v1.
+ *
+ * Mirrors `parseLock`'s stance: no migration path, fail loudly rather than
+ * guess at a hand-edited or corrupted file's intent.
+ */
+declare function parseWorkspace(raw: unknown): Workspace;
+declare function loadWorkspace(workspacePath: string): Promise<Workspace>;
+/** Atomic write — a crash mid-save must not leave a truncated catalog. */
+declare function saveWorkspace(workspacePath: string, ws: Workspace): Promise<void>;
+/** Stored path convention: relative to the catalog's directory, forward-slash. */
+declare function toPortablePath(dir: string, absolute: string): string;
+/** Resolve a registered project's stored paths against the catalog's directory. */
+declare function resolveProject(dir: string, project: WorkspaceProject): {
+    manifestPath: string;
+    lockPath: string;
+};
+interface WorkspaceDiagnostic {
+    id: "duplicate-id" | "duplicate-lock" | "duplicate-manifest" | "missing-manifest" | "missing-lock" | "absolute-path" | "mixed-provider";
+    level: "error" | "warning";
+    message: string;
+}
+/**
+ * Checks the catalog without touching the network or any registered
+ * project's files. Duplicate ids and duplicate lock paths are errors — either
+ * would corrupt the union claim set. A duplicate manifest is only a warning,
+ * because a manifest paired with a variant `--lock` is an already-supported
+ * pattern (see `cachePathFor`). Missing files are errors: a claim set derived
+ * from a workspace that silently skipped a project is the exact hazard this
+ * catalog exists to prevent.
+ */
+declare function validateWorkspace(ws: Workspace, dir: string): WorkspaceDiagnostic[];
+
+interface WorkspaceClaims {
+    claimed: Set<string>;
+    /** Claim count contributed by each registered project. */
+    byProject: Record<string, number>;
+    lockPaths: string[];
+}
+/**
+ * The complete account-wide claim set, derived from every registered lock.
+ *
+ * Delegates the union rule itself to `loadClaims` rather than reimplementing
+ * it, so the workspace and single-project `--claims` paths cannot drift. Each
+ * lock is loaded one at a time — rather than handing `loadClaims` the whole
+ * path list at once — purely so a failure can be attributed to the project
+ * that owns it; the safety property (any unreadable registered lock aborts
+ * before returning a claim set) is identical either way.
+ */
+declare function workspaceClaims(ws: Workspace, dir: string): Promise<WorkspaceClaims>;
+interface WorkspaceProjectStatus {
+    id: string;
+    provider: string;
+    account: string | null;
+    manifest: string;
+    lock: string;
+    entries: number;
+    byState: Record<PlanState, number>;
+    spendByUnit: Record<CostUnit, number>;
+    error: string | null;
+}
+interface WorkspaceStatusReport {
+    version: 1;
+    safe: boolean;
+    /** The catalog's own directory — resolved paths in `projects` sit under it. */
+    dir: string;
+    projects: WorkspaceProjectStatus[];
+    totals: {
+        byState: Record<PlanState, number>;
+        spendByUnit: Record<CostUnit, number>;
+        claims: number;
+    };
+    diagnostics: WorkspaceDiagnostic[];
+}
+/**
+ * Aggregate, read-only account/project state — offline throughout, using the
+ * same offline cost estimator `plan` uses. A project whose manifest or lock
+ * fails to load surfaces as that project's own `error` rather than aborting
+ * the whole report, so one broken sibling does not hide every other
+ * project's status. It never writes to any registered project's lock.
+ */
+declare function workspaceStatus(ws: Workspace, dir: string): Promise<WorkspaceStatusReport>;
+
+export { type AdoptResult, 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 CacheHealthOptions, type CacheHealthReport, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_RATE_LIMIT, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type Generator, GeneratorSchema, type GenericTileset, type JobState, type LoadedManifest, type Lock, type LockEntry, LockEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, ManifestSchema, type MapObject, type MountPlacement, type MountedSheet, type NormalizedTileRules, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, type PackedFrame, type PackedSheet, type PackedSource, type PickResult, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type Provider, type ProviderMetadata, type RateLimit, type RemoteAsset, type RemoteHashCacheHealth, type ResolvedOutput, type ResolvedSpec, type ResolvedStyleImage, type SalvageAction, type SalvageResult, type ScannedAsset, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, StyleSchema, 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, applyTags, auditStyle, backoffMs, buildManifest, buildPlan, candidateCount, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, currentEntryOutputPath, currentOutputPath, doctor, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, findOrphans, formatCost, generationCost, groupOrphansByStyle, hex, idFromPrompt, imageMetadata, inspectCaches, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeTileRules, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pngSize, poll, portableOutputPath, primaryOutput, pushTags, remove, renderSalvageSheet, renderSheet, requireDelete, requireList, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, retryAfterMs, runPicker, runSalvage, saveLock, saveWorkspace, scanAssets, selectEntryOutput, sha256, sha256File, shouldRetry, slugify, specHash, spendByUnit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, upsert, validateCostEstimate, validateWorkspace, verifyArtifactBundle, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };