@fluid-app/fluid-cli-portal 0.1.52 → 0.1.53

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-import { CliError, FetchClient, FluidPlugin, Result } from "@fluid-app/fluid-cli";
+import { CliError, FluidPlugin, Result } from "@fluid-app/fluid-cli";
 
 //#region src/types.d.ts
 /**
@@ -339,6 +339,35 @@ interface GitAutoCommitOptions {
 * `node_modules/`, `dist/`, `.portal-sync/`, logs, `*.tsbuildinfo`), so
 * generated output and local secrets stay out of the commit.
 *
+* That boundary is not enough on its own for tool-local state written
+* INTO the project directory by whatever opened it — most importantly
+* Mist Desktop's `.mist-desktop/` (private chats, attachments,
+* screenshots) and the `.mist` clone marker. A `.gitignore`-only fix
+* can't reach clones that already exist, so this applies belt AND
+* suspenders, all anchored to the repository root (see
+* {@link resolveRepoRoot}):
+*
+*   1. {@link excludeLocalStateFromGit} — idempotent `.git/info/exclude`
+*      write, so `git add` never picks the paths up in the first place.
+*      Heals pre-existing clones on their next push.
+*   2. `git reset -- ':(top).mist' .mist` after staging — unstages the
+*      marker if step 1 silently failed. We deliberately do NOT pass a
+*      `:(exclude)` pathspec to `git add`: when the path is *also*
+*      listed in `.git/info/exclude`, git exits 1 with "paths are
+*      ignored by one of your .gitignore files", turning the normal
+*      (already-healed) case into a hard failure. Add-then-reset is a
+*      no-op when there's nothing staged.
+*   3. `git rm --cached -r --ignore-unmatch .mist-desktop` — untracks
+*      chat history that an older, unhardened push already committed.
+*      Ignore rules alone cannot untrack an existing path. `--cached`
+*      keeps every file on disk; only the index entry goes away. This
+*      runs even under `ignoreRemovals`, where suppressing deletions
+*      protects remote-only *portal* files — private chats are never
+*      that, and leaving them tracked would keep republishing them.
+*
+* Steps 2 and 3 are best-effort and never fail the publish; the commit
+* itself is what must succeed.
+*
 * Uses the repo's configured identity, else a synthetic Fluid bot
 * identity so the commit isn't rejected. "nothing to commit" is treated
 * as a no-op, not an error.
@@ -364,7 +393,7 @@ declare function gitPush(cwd: string, remoteUrl: string, branch?: string): Promi
 *
 *   POST <endpoint>  ->  201 { git_credential: { remote_url, expires_at }, status, meta }
 *   errors: 409 not_provisioned/not_connected, 502 vendor_error, 422 else
-*           { error: { message, details: { type } }, status, meta }
+*           { error_message, errors: { type: [type] }, meta }
 *
 * The exact path is still being finalized as 006 lands, so it lives in
 * one constant here. Until the endpoint ships to prod a request 404s —
@@ -378,9 +407,16 @@ interface PortalGitCredential {
 }
 /**
 * Outcome of a credential request. `unavailable` means "no repo to sync"
-* (endpoint missing / not provisioned / not connected) — the caller
-* should warn and skip, never abort. `error` is an unexpected transport
-* failure the caller may log but still shouldn't hard-fail push on.
+* (endpoint missing / not provisioned / not connected). Its `retryable`
+* flag distinguishes backend states that are expected to self-heal
+* (`not_provisioned` — the first credential request triggers repository
+* provisioning) from ones that don't (`not_connected` — the company's
+* Git integration isn't connected, which no amount of retrying fixes;
+* verified against prod where both brand-new and long-standing
+* definitions on an unconnected company return `not_connected` 409s
+* permanently). `conflictType` carries the raw 409 conflict type so
+* callers can tailor messaging. `error` is an unexpected transport or
+* provider failure.
 */
 type GitCredentialOutcome = {
   readonly status: "ok";
@@ -388,6 +424,8 @@ type GitCredentialOutcome = {
 } | {
   readonly status: "unavailable";
   readonly reason: string;
+  readonly retryable: boolean;
+  readonly conflictType?: string;
 } | {
   readonly status: "error";
   readonly reason: string;
@@ -406,6 +444,8 @@ interface CreatePortalGitCredentialOptions {
   readonly definitionId: number;
   /** Injectable for tests; defaults to global fetch. */
   readonly fetchImpl?: typeof fetch;
+  /** Deadline for one API request; defaults to 15 seconds. */
+  readonly requestTimeoutMs?: number;
 }
 /**
 * Request a git credential for the portal definition's provisioned repo.
@@ -458,143 +498,6 @@ declare function createPortalProject(appName: string, options: CreateOptions, co
 //#region src/commands/pull.d.ts
 declare const pullCommand: Command;
 //#endregion
-//#region src/commands/push.d.ts
-declare const pushCommand: Command;
-//#endregion
-//#region src/commands/widget-create.d.ts
-declare const widgetCommand: Command;
-//#endregion
-//#region src/commands/widget-publish.d.ts
-declare const topLevelWidgetCommand: Command;
-//#endregion
-//#region src/commands/deploy.d.ts
-declare const deployCommand: Command;
-//#endregion
-//#region src/commands/version.d.ts
-declare const versionCommand: Command;
-//#endregion
-//#region src/commands/doctor.d.ts
-declare const doctorCommand: Command;
-//#endregion
-//#region src/utils/mappings.d.ts
-/** Definition metadata stored at the top level of the mappings file. */
-interface DefinitionMapping {
-  readonly name: string;
-  readonly id: number;
-}
-/**
-* Resource types that support slug-to-ID mappings.
-* "countries" and "ranks" use display names as keys (not slugified).
-*/
-type MappedResourceType = "screens" | "themes" | "navigations" | "profiles" | "countries" | "ranks";
-/** Full mappings structure persisted to disk. */
-interface PortalMappings {
-  readonly definition: DefinitionMapping;
-  readonly screens: Record<string, number>;
-  readonly themes: Record<string, number>;
-  readonly navigations: Record<string, number>;
-  readonly profiles: Record<string, number>;
-  readonly countries: Record<string, number>;
-  readonly ranks: Record<string, number>;
-}
-/**
-* Read the mappings file from the `.portal-sync/` directory.
-* Returns `null` if the file does not exist.
-*/
-declare function readMappings(portalSyncDir: string): Promise<PortalMappings | null>;
-/**
-* Write the mappings file to the `.portal-sync/` directory.
-* Creates the directory if it does not exist.
-*/
-declare function writeMappings(portalSyncDir: string, mappings: PortalMappings): Promise<void>;
-/**
-* Derive a filesystem-safe slug from a resource name.
-*
-* - Lowercases the name
-* - Replaces non-alphanumeric characters (except hyphens) with hyphens
-* - Collapses consecutive hyphens
-* - Trims leading/trailing hyphens
-*
-* If the derived slug collides with an existing slug in `existingSlugs`,
-* a numeric suffix is appended (e.g., `home-2`, `home-3`).
-*/
-declare function deriveSlug(name: string, existingSlugs?: ReadonlySet<string>): string;
-/**
-* Resolve a slug to its server-side ID.
-* Returns `undefined` if the slug is not mapped.
-*/
-declare function resolveSlugToId(mappings: PortalMappings, resourceType: MappedResourceType, slug: string): number | undefined;
-/**
-* Resolve a server-side ID back to its slug.
-* Returns `undefined` if no slug maps to the given ID.
-*/
-declare function resolveIdToSlug(mappings: PortalMappings, resourceType: MappedResourceType, id: number): string | undefined;
-/**
-* Add or update a mapping entry for a given resource type.
-* Returns a new `PortalMappings` object (immutable update).
-*/
-declare function updateMapping(mappings: PortalMappings, resourceType: MappedResourceType, slug: string, id: number): PortalMappings;
-/**
-* Remove a mapping entry for a given resource type.
-* Returns a new `PortalMappings` object (immutable update).
-* If the slug does not exist, the original mappings are returned unchanged.
-*/
-declare function removeMapping(mappings: PortalMappings, resourceType: MappedResourceType, slug: string): PortalMappings;
-//#endregion
-//#region src/utils/snapshot.d.ts
-/** SHA-256 hex digest of a file's contents. */
-type FileHash = string;
-/** Map of relative file paths to their content hashes. */
-type FileHashMap = Record<string, FileHash>;
-/** Snapshot structure persisted to `.portal-sync/snapshot.json`. */
-interface Snapshot {
-  /** Human-readable name of the portal definition. */
-  readonly definition: string;
-  /** Server-side ID of the portal definition. */
-  readonly definition_id: number;
-  /** ISO 8601 timestamp of when the snapshot was created. */
-  readonly pulled_at: string;
-  /** Map of relative file paths → SHA-256 hashes. */
-  readonly files: FileHashMap;
-}
-/** Result of diffing current files against a snapshot. */
-interface SnapshotDiff {
-  /** Files that exist on disk but not in the snapshot. */
-  readonly new: readonly string[];
-  /** Files that exist in both but have different hashes. */
-  readonly changed: readonly string[];
-  /** Files that exist in the snapshot but not on disk. */
-  readonly deleted: readonly string[];
-}
-/**
-* Compute the SHA-256 hash of a file's contents.
-* Returns the hex-encoded digest.
-*/
-declare function computeFileHash(filePath: string): Promise<FileHash>;
-/**
-* Read the snapshot file from the `.portal-sync/` directory.
-* Returns `null` if the file does not exist.
-*/
-declare function readSnapshot(portalSyncDir: string): Promise<Snapshot | null>;
-/**
-* Write the snapshot file to the `.portal-sync/` directory.
-* Creates the directory if it does not exist.
-*/
-declare function writeSnapshot(portalSyncDir: string, snapshot: Snapshot): Promise<void>;
-/**
-* Compare the current portal directory contents against a snapshot.
-*
-* Returns lists of new, changed, and deleted files (relative paths).
-*/
-declare function diffAgainstSnapshot(portalDir: string, snapshot: Snapshot): Promise<SnapshotDiff>;
-/**
-* Build a fresh snapshot from the current portal directory contents.
-*
-* Hashes every file in `portalDir` (excluding `.portal-sync/`)
-* and records the definition metadata.
-*/
-declare function buildSnapshot(portalDir: string, definitionName: string, definitionId: number): Promise<Snapshot>;
-//#endregion
 //#region ../../api-clients/fluidos/src/generated/fluid-os-v0.d.ts
 interface components {
   schemas: {
@@ -983,6 +886,192 @@ interface components {
   pathItems: never;
 }
 //#endregion
+//#region src/utils/mappings.d.ts
+/** Definition metadata stored at the top level of the mappings file. */
+interface DefinitionMapping {
+  readonly name: string;
+  readonly id: number;
+}
+/**
+* Resource types that support slug-to-ID mappings.
+* "countries" and "ranks" use display names as keys (not slugified).
+*/
+type MappedResourceType = "screens" | "themes" | "navigations" | "profiles" | "countries" | "ranks";
+/** Full mappings structure persisted to disk. */
+interface PortalMappings {
+  readonly definition: DefinitionMapping;
+  readonly screens: Record<string, number>;
+  readonly themes: Record<string, number>;
+  readonly navigations: Record<string, number>;
+  readonly profiles: Record<string, number>;
+  readonly countries: Record<string, number>;
+  readonly ranks: Record<string, number>;
+}
+/**
+* Read the mappings file from the `.portal-sync/` directory.
+* Returns `null` if the file does not exist.
+*/
+declare function readMappings(portalSyncDir: string): Promise<PortalMappings | null>;
+/**
+* Write the mappings file to the `.portal-sync/` directory.
+* Creates the directory if it does not exist.
+*/
+declare function writeMappings(portalSyncDir: string, mappings: PortalMappings): Promise<void>;
+/**
+* Derive a filesystem-safe slug from a resource name.
+*
+* - Lowercases the name
+* - Replaces non-alphanumeric characters (except hyphens) with hyphens
+* - Collapses consecutive hyphens
+* - Trims leading/trailing hyphens
+*
+* If the derived slug collides with an existing slug in `existingSlugs`,
+* a numeric suffix is appended (e.g., `home-2`, `home-3`).
+*/
+declare function deriveSlug(name: string, existingSlugs?: ReadonlySet<string>): string;
+/**
+* Resolve a slug to its server-side ID.
+* Returns `undefined` if the slug is not mapped.
+*/
+declare function resolveSlugToId(mappings: PortalMappings, resourceType: MappedResourceType, slug: string): number | undefined;
+/**
+* Resolve a server-side ID back to its slug.
+* Returns `undefined` if no slug maps to the given ID.
+*/
+declare function resolveIdToSlug(mappings: PortalMappings, resourceType: MappedResourceType, id: number): string | undefined;
+/**
+* Add or update a mapping entry for a given resource type.
+* Returns a new `PortalMappings` object (immutable update).
+*/
+declare function updateMapping(mappings: PortalMappings, resourceType: MappedResourceType, slug: string, id: number): PortalMappings;
+/**
+* Remove a mapping entry for a given resource type.
+* Returns a new `PortalMappings` object (immutable update).
+* If the slug does not exist, the original mappings are returned unchanged.
+*/
+declare function removeMapping(mappings: PortalMappings, resourceType: MappedResourceType, slug: string): PortalMappings;
+//#endregion
+//#region src/utils/snapshot.d.ts
+/** SHA-256 hex digest of a file's contents. */
+type FileHash = string;
+/** Map of relative file paths to their content hashes. */
+type FileHashMap = Record<string, FileHash>;
+/** Snapshot structure persisted to `.portal-sync/snapshot.json`. */
+interface Snapshot {
+  /** Human-readable name of the portal definition. */
+  readonly definition: string;
+  /** Server-side ID of the portal definition. */
+  readonly definition_id: number;
+  /** ISO 8601 timestamp of when the snapshot was created. */
+  readonly pulled_at: string;
+  /** Map of relative file paths → SHA-256 hashes. */
+  readonly files: FileHashMap;
+}
+/** Result of diffing current files against a snapshot. */
+interface SnapshotDiff {
+  /** Files that exist on disk but not in the snapshot. */
+  readonly new: readonly string[];
+  /** Files that exist in both but have different hashes. */
+  readonly changed: readonly string[];
+  /** Files that exist in the snapshot but not on disk. */
+  readonly deleted: readonly string[];
+}
+/**
+* Compute the SHA-256 hash of a file's contents.
+* Returns the hex-encoded digest.
+*/
+declare function computeFileHash(filePath: string): Promise<FileHash>;
+/**
+* Read the snapshot file from the `.portal-sync/` directory.
+* Returns `null` if the file does not exist.
+*/
+declare function readSnapshot(portalSyncDir: string): Promise<Snapshot | null>;
+/**
+* Write the snapshot file to the `.portal-sync/` directory.
+* Creates the directory if it does not exist.
+*/
+declare function writeSnapshot(portalSyncDir: string, snapshot: Snapshot): Promise<void>;
+/**
+* Compare the current portal directory contents against a snapshot.
+*
+* Returns lists of new, changed, and deleted files (relative paths).
+*/
+declare function diffAgainstSnapshot(portalDir: string, snapshot: Snapshot): Promise<SnapshotDiff>;
+/**
+* Build a fresh snapshot from the current portal directory contents.
+*
+* Hashes every file in `portalDir` (excluding `.portal-sync/`)
+* and records the definition metadata.
+*/
+declare function buildSnapshot(portalDir: string, definitionName: string, definitionId: number): Promise<Snapshot>;
+//#endregion
+//#region src/utils/push-validation.d.ts
+/** Categorize changed files by resource type. */
+interface CategorizedChanges {
+  readonly screens: {
+    new: string[];
+    changed: string[];
+    deleted: string[];
+  };
+  readonly themes: {
+    new: string[];
+    changed: string[];
+    deleted: string[];
+  };
+  readonly navigations: {
+    new: string[];
+    changed: string[];
+    deleted: string[];
+  };
+  readonly profiles: {
+    new: string[];
+    changed: string[];
+    deleted: string[];
+  };
+}
+/** A validation error found during cross-reference checking. */
+interface ValidationError {
+  readonly file: string;
+  readonly message: string;
+}
+/**
+* Extract the slug from a file path (e.g., "screens/home.json" -> "home").
+*/
+declare function slugFromPath(filePath: string): string;
+/**
+* Categorize a snapshot diff into resource-type-specific change lists.
+*/
+declare function categorizeChanges(diff: SnapshotDiff): CategorizedChanges;
+/**
+* Validate that all cross-references between local portal files are valid.
+*
+* Checks:
+* - New and changed resources contain the required local-file fields
+* - New and changed themes include the required config object
+* - Navigation items' "screen" slugs reference existing screen files or mappings
+* - Profile "navigation" and "mobile_navigation" slugs reference existing nav files or mappings
+* - Profile "themes" slugs reference existing theme files or mappings
+*/
+declare function validateCrossReferences(portalDir: string, mappings: PortalMappings, changes: CategorizedChanges): Promise<ValidationError[]>;
+//#endregion
+//#region src/commands/push.d.ts
+declare const pushCommand: Command;
+//#endregion
+//#region src/commands/widget-create.d.ts
+declare const widgetCommand: Command;
+//#endregion
+//#region src/commands/widget-publish.d.ts
+declare const topLevelWidgetCommand: Command;
+//#endregion
+//#region src/commands/deploy.d.ts
+declare const deployCommand: Command;
+//#endregion
+//#region src/commands/version.d.ts
+declare const versionCommand: Command;
+//#endregion
+//#region src/commands/doctor.d.ts
+declare const doctorCommand: Command;
+//#endregion
 //#region src/utils/transform.d.ts
 type ApiScreen = components["schemas"]["FluidOSScreen"];
 type ApiTheme = components["schemas"]["FluidOSTheme"];
@@ -999,7 +1088,8 @@ interface LocalTheme {
   readonly active: boolean;
 }
 interface LocalNavigationItem {
-  readonly id: number;
+  /** Server-owned sync identity. New draft items omit it until push. */
+  readonly id?: number;
   readonly icon: string | null;
   readonly label: string | null;
   readonly screen: string | null;
@@ -1069,383 +1159,8 @@ declare const buildThemeIdToSlugMap: (mappings: Record<string, number>) => Map<n
 */
 declare function transformProfile(profile: ApiProfile, navIdToSlug: Map<number, string>, themeIdToSlug: Map<number, string>): LocalProfile;
 //#endregion
-//#region src/utils/push-validation.d.ts
-/** Categorize changed files by resource type. */
-interface CategorizedChanges {
-  readonly screens: {
-    new: string[];
-    changed: string[];
-    deleted: string[];
-  };
-  readonly themes: {
-    new: string[];
-    changed: string[];
-    deleted: string[];
-  };
-  readonly navigations: {
-    new: string[];
-    changed: string[];
-    deleted: string[];
-  };
-  readonly profiles: {
-    new: string[];
-    changed: string[];
-    deleted: string[];
-  };
-}
-/** A validation error found during cross-reference checking. */
-interface ValidationError {
-  readonly file: string;
-  readonly message: string;
-}
-/**
-* Extract the slug from a file path (e.g., "screens/home.json" -> "home").
-*/
-declare function slugFromPath(filePath: string): string;
-/**
-* Categorize a snapshot diff into resource-type-specific change lists.
-*/
-declare function categorizeChanges(diff: SnapshotDiff): CategorizedChanges;
-/**
-* Validate that all cross-references between local portal files are valid.
-*
-* Checks:
-* - Navigation items' "screen" slugs reference existing screen files or mappings
-* - Profile "navigation" and "mobile_navigation" slugs reference existing nav files or mappings
-* - Profile "themes" slugs reference existing theme files or mappings
-*/
-declare function validateCrossReferences(portalDir: string, mappings: PortalMappings, changes: CategorizedChanges): Promise<ValidationError[]>;
-//#endregion
-//#region ../../portal/core/src/remote-dom-widget-package.d.ts
-declare const REMOTE_DOM_WIDGET_MANIFEST_VERSION: 1;
-declare const REMOTE_DOM_WIDGET_RUNTIME: "remote-dom";
-type JsonPrimitive = string | number | boolean | null;
-type JsonValue = JsonPrimitive | readonly JsonValue[] | JsonObject;
-interface JsonObject {
-  readonly [key: string]: JsonValue;
-}
-interface RemoteDomWidgetCapabilityDeclaration {
-  readonly name: string;
-  readonly version: string;
-}
-interface RemoteDomWidgetDefinition {
-  readonly type: string;
-  readonly displayName: string;
-  readonly description: string;
-  readonly icon: string;
-  readonly category: string;
-  readonly propertySchema: JsonObject;
-  readonly defaultProps: JsonObject;
-  readonly container: "inline" | "block" | "card" | "fullscreen";
-  readonly resizable: boolean | "horizontal" | "vertical" | "both";
-  readonly minSdkVersion: string;
-  readonly capabilities: readonly RemoteDomWidgetCapabilityDeclaration[];
-}
-/**
-* Canonical package contract shared by the CLI, catalog APIs, and portal hosts.
-* Catalog producers resolve every artifact to its public URL before returning
-* this descriptor; consumers do not translate legacy manifest shapes.
-*/
-interface RemoteDomWidgetPackageDescriptor {
-  readonly manifestVersion: typeof REMOTE_DOM_WIDGET_MANIFEST_VERSION;
-  readonly runtime: typeof REMOTE_DOM_WIDGET_RUNTIME;
-  readonly packageId: string;
-  readonly source: "company" | "droplet";
-  readonly version: string;
-  readonly workerEntryUrl: string;
-  readonly cssUrls: readonly string[];
-  readonly assetUrls: readonly string[];
-  readonly widgets: readonly RemoteDomWidgetDefinition[];
-}
-//#endregion
-//#region src/utils/widget-package-validation.d.ts
-type WidgetPackageOwnerKind = "company" | "droplet";
-interface WidgetCapabilityMetadata {
-  readonly name: string;
-  readonly version?: string;
-}
-interface SourceWidgetMetadata {
-  readonly name: string;
-  readonly displayName?: string;
-  readonly description?: string;
-  readonly icon?: string;
-  readonly category?: string;
-  readonly propertySchema?: JsonObject;
-  readonly defaultProps?: JsonObject;
-  readonly container?: unknown;
-  readonly minSdkVersion?: string;
-  readonly resizable?: unknown;
-  readonly capabilities?: readonly WidgetCapabilityMetadata[];
-}
-interface SourceWidgetPackageMetadata {
-  readonly manifestVersion?: number;
-  readonly scope?: string;
-  readonly packageStableId?: string;
-  readonly packageId: string;
-  readonly packageType?: string;
-  readonly version: string;
-  readonly widgets: readonly SourceWidgetMetadata[];
-  readonly cssUrls?: readonly string[];
-}
-interface WidgetDescriptorMetadata extends RemoteDomWidgetDefinition {
-  readonly name: string;
-}
-declare const WIDGET_PACKAGE_ARTIFACT_PATH: unique symbol;
-/** A package-local artifact path written into the uploaded manifest. */
-type WidgetPackageArtifactPath = string & {
-  readonly [WIDGET_PACKAGE_ARTIFACT_PATH]: true;
-};
-/**
-* Upload-time manifest whose artifact references are package-local paths.
-*
-* This is deliberately distinct from RemoteDomWidgetPackageDescriptor, whose
-* catalog-facing artifact fields must already be resolved to absolute URLs.
-*/
-interface WidgetPackagePublishManifest {
-  readonly manifestVersion: 1;
-  readonly runtime: "remote-dom";
-  readonly packageId: string;
-  readonly source: WidgetPackageOwnerKind;
-  readonly version: string;
-  readonly workerEntryUrl: WidgetPackageArtifactPath;
-  readonly cssUrls: readonly WidgetPackageArtifactPath[];
-  readonly assetUrls: readonly WidgetPackageArtifactPath[];
-  readonly widgets: readonly RemoteDomWidgetDefinition[];
-}
-interface ValidatedWidgetPackageBuild {
-  readonly sourcePackage: SourceWidgetPackageMetadata;
-  readonly packageKey: string;
-  readonly packageId: string;
-  readonly owner: WidgetPackageOwnerKind;
-  readonly version: string;
-  readonly widgets: readonly WidgetDescriptorMetadata[];
-}
-type WidgetPackageValidationErrorCode = "NO_SOURCE_PACKAGE" | "MULTIPLE_SOURCE_PACKAGES" | "INVALID_SOURCE_PACKAGE" | "INVALID_WIDGET_METADATA" | "UNSUPPORTED_OWNER" | "INVALID_PACKAGE_KEY" | "INVALID_VERSION" | "NO_WIDGETS" | "INVALID_WIDGET_NAME" | "INVALID_WIDGET_TYPE" | "DUPLICATE_WIDGET";
-interface WidgetPackageValidationError {
-  readonly code: WidgetPackageValidationErrorCode;
-  readonly message: string;
-  readonly path?: string;
-}
-interface WidgetPackageValidationResult {
-  readonly success: boolean;
-  readonly value?: ValidatedWidgetPackageBuild;
-  readonly errors: readonly WidgetPackageValidationError[];
-}
-interface ValidateSourceWidgetPackageOptions {
-  readonly owner?: WidgetPackageOwnerKind;
-}
-declare function validateSingleSourceWidgetPackage(sourcePackages: readonly unknown[], options?: ValidateSourceWidgetPackageOptions): WidgetPackageValidationResult;
-declare function buildWidgetPackagePublishManifest(validated: ValidatedWidgetPackageBuild, options?: {
-  readonly cssUrls?: readonly string[];
-}): WidgetPackagePublishManifest;
-//#endregion
-//#region src/utils/widget-package-builder.d.ts
-interface BuildSharedWidgetPackageOptions {
-  readonly projectDir: string;
-  readonly publishDir?: string;
-  readonly owner?: WidgetPackageOwnerKind;
-}
-interface SharedWidgetPackageBuildResult {
-  readonly publishDir: string;
-  readonly packageId: string;
-  readonly version: string;
-  readonly manifestPath: string;
-  readonly publishManifestPath: string;
-  readonly widgetScriptPath: string;
-}
-interface SharedWidgetPackageBuildError {
-  readonly code: "CONFIG_LOAD_FAILED" | "VALIDATION_FAILED" | "INVALID_PUBLISH_DIR" | "WRITE_FAILED";
-  readonly message: string;
-  readonly details?: string;
-}
-declare function buildSharedWidgetPackage(options: BuildSharedWidgetPackageOptions): Promise<Result<SharedWidgetPackageBuildResult, SharedWidgetPackageBuildError>>;
-declare function createWidgetPackageEntrySource(options: {
-  readonly configImportPath: string;
-  readonly cssImportPath?: string;
-  readonly validated: ValidatedWidgetPackageBuild;
-}): string;
-//#endregion
-//#region src/utils/widget-package-config.d.ts
-interface WidgetSourceConfig {
-  readonly path: string;
-  readonly relativePath: string;
-}
-interface WidgetSourceConfigLoadError {
-  readonly code: "CONFIG_LOAD_FAILED" | "INVALID_FORMAT";
-  readonly message: string;
-  readonly details?: string;
-}
-declare function resolvePortalWidgetSourceConfig(projectDir: string): Promise<WidgetSourceConfig | undefined>;
-declare function loadSourceWidgetPackages(projectDir: string): Promise<Result<unknown[], WidgetSourceConfigLoadError>>;
-//#endregion
-//#region src/utils/widget-package-artifacts.d.ts
-declare const WIDGET_PACKAGE_BUILDER_VERSION = "1";
-interface ArtifactMetadata {
-  readonly path: string;
-  readonly sha256: string;
-  readonly bytes: number;
-  readonly contentType: string;
-}
-interface PublishManifestMetadata {
-  readonly packageId: string;
-  readonly version: string;
-  readonly builderVersion: string;
-  readonly cliVersion: string;
-  readonly runtimeVersion: string;
-  readonly manifestHash: string;
-  readonly artifacts: readonly ArtifactMetadata[];
-}
-declare function computeArtifactMetadata(filePath: string, baseDir: string): Promise<ArtifactMetadata>;
-declare function collectWidgetPackageArtifacts(publishDir: string): Promise<ArtifactMetadata[]>;
-declare function createPublishManifestMetadata(options: {
-  readonly packageId: string;
-  readonly version: string;
-  readonly cliVersion: string;
-  readonly runtimeVersion: string;
-  readonly manifestContent: string | Buffer;
-  readonly artifacts: readonly ArtifactMetadata[];
-  readonly builderVersion?: string;
-}): PublishManifestMetadata;
-declare function getArtifactContentType(filePath: string): string;
-declare function sha256(content: string | Buffer): string;
-//#endregion
-//#region src/utils/widget-package-upload.d.ts
-type WidgetPackageUploadOwner = {
-  readonly kind: "droplet";
-  readonly uuid: string;
-} | {
-  readonly kind: "company";
-};
-type WidgetPackageArtifactMetadata = ArtifactMetadata;
-interface WidgetPackageUploadArtifact extends WidgetPackageArtifactMetadata {
-  readonly body: BodyInit;
-}
-interface WidgetPackageSessionRequest {
-  readonly version: string;
-  readonly packageKey: string;
-  readonly builderVersion: string;
-  readonly cliVersion: string;
-  readonly runtimeVersion: string;
-  readonly manifestHash: string;
-  readonly manifest: Record<string, unknown>;
-  readonly artifacts: readonly WidgetPackageArtifactMetadata[];
-}
-interface WidgetPackagePublishRequest extends Omit<WidgetPackageSessionRequest, "artifacts"> {
-  readonly artifacts: readonly WidgetPackageUploadArtifact[];
-}
-type WidgetPackageArtifactPayload = ArtifactMetadata;
-interface WidgetPackageUploadSessionPayload {
-  readonly version: string;
-  readonly package_key: string;
-  readonly builder_version: string;
-  readonly cli_version: string;
-  readonly runtime_version: string;
-  readonly manifest_hash: string;
-  readonly manifest: Record<string, unknown>;
-  readonly artifacts: readonly WidgetPackageArtifactPayload[];
-}
-interface WidgetPackageCompleteUploadPayload {
-  readonly package_key: string;
-  readonly artifacts: readonly WidgetPackageArtifactPayload[];
-}
-interface WidgetPackageSignedUpload {
-  readonly path: string;
-  readonly url: string;
-  readonly contentType: string;
-  readonly headers: Readonly<Record<string, string>>;
-}
-interface WidgetPackageUploadSession {
-  readonly version: string;
-  readonly uploads: readonly WidgetPackageSignedUpload[];
-  readonly raw: unknown;
-}
-interface WidgetPackageArtifactUploadResult {
-  readonly path: string;
-  readonly status: number;
-  readonly contentType: string;
-}
-interface WidgetPackageCompleteResult {
-  readonly version: string;
-  readonly status?: string;
-  readonly packageKey?: string;
-  readonly raw: unknown;
-}
-interface WidgetPackagePublishResult {
-  readonly dryRun: boolean;
-  readonly sessionPayload: WidgetPackageUploadSessionPayload;
-  readonly session?: WidgetPackageUploadSession;
-  readonly uploadedArtifacts?: readonly WidgetPackageArtifactUploadResult[];
-  readonly complete?: WidgetPackageCompleteResult;
-}
-interface BasePublishWidgetPackageVersionOptions {
-  readonly owner: WidgetPackageUploadOwner;
-  readonly request: WidgetPackagePublishRequest;
-  readonly fetchImpl?: WidgetPackageUploadFetch;
-}
-interface DryRunPublishWidgetPackageVersionOptions extends BasePublishWidgetPackageVersionOptions {
-  readonly client?: FetchClient;
-  readonly dryRun: true;
-}
-interface PublishWidgetPackageVersionUploadOptions extends BasePublishWidgetPackageVersionOptions {
-  readonly client: FetchClient;
-  readonly dryRun?: boolean;
-}
-type PublishWidgetPackageVersionOptions = DryRunPublishWidgetPackageVersionOptions | PublishWidgetPackageVersionUploadOptions;
-type WidgetPackageUploadFetch = (input: string | URL, init: RequestInit) => Promise<Response>;
-declare class WidgetPackageUploadError extends Error {
-  readonly code: string;
-  constructor(code: string, message: string);
-}
-declare function buildWidgetPackageUploadSessionPayload(request: WidgetPackageSessionRequest): WidgetPackageUploadSessionPayload;
-declare function buildWidgetPackageCompleteUploadPayload(packageKey: string, artifacts: readonly WidgetPackageArtifactMetadata[]): WidgetPackageCompleteUploadPayload;
-declare function getWidgetPackageUploadSessionRoute(owner: WidgetPackageUploadOwner): string;
-declare function getWidgetPackageCompleteUploadRoute(owner: WidgetPackageUploadOwner, version: string): string;
-declare function requestWidgetPackageUploadSession(client: FetchClient, owner: WidgetPackageUploadOwner, request: WidgetPackageSessionRequest): Promise<WidgetPackageUploadSession>;
-declare function uploadWidgetPackageArtifacts(session: WidgetPackageUploadSession, artifacts: readonly WidgetPackageUploadArtifact[], fetchImpl?: WidgetPackageUploadFetch): Promise<WidgetPackageArtifactUploadResult[]>;
-declare function completeWidgetPackageUpload(client: FetchClient, owner: WidgetPackageUploadOwner, version: string, packageKey: string, artifacts: readonly WidgetPackageArtifactMetadata[]): Promise<WidgetPackageCompleteResult>;
-declare function publishWidgetPackageVersion(options: PublishWidgetPackageVersionOptions): Promise<WidgetPackagePublishResult>;
-declare function normalizeWidgetPackageUploadSession(response: unknown, requestedVersion: string, requestedArtifacts: readonly WidgetPackageArtifactMetadata[]): WidgetPackageUploadSession;
-declare function normalizeWidgetPackageCompleteResponse(response: unknown, requestedVersion: string): WidgetPackageCompleteResult;
-//#endregion
-//#region src/commands/widget-package-publish.d.ts
-interface PublishWidgetRuntimeArtifactsOptions {
-  readonly projectDir: string;
-  readonly outDir: string;
-  readonly buildOwner: WidgetPackageOwnerKind;
-  readonly uploadOwner: WidgetPackageUploadOwner;
-  readonly dryRun?: boolean;
-  readonly client?: FetchClient;
-}
-interface PublishWidgetRuntimeArtifactsResult {
-  readonly build: SharedWidgetPackageBuildResult;
-  readonly request: WidgetPackagePublishRequest;
-  readonly publish: WidgetPackagePublishResult;
-}
-interface PublishWidgetRuntimeArtifactsDependencies {
-  readonly buildSharedWidgetPackage?: typeof buildSharedWidgetPackage;
-  readonly publishWidgetPackageVersion?: typeof publishWidgetPackageVersion;
-}
-declare function publishWidgetRuntimeArtifacts(options: PublishWidgetRuntimeArtifactsOptions, dependencies?: PublishWidgetRuntimeArtifactsDependencies): Promise<PublishWidgetRuntimeArtifactsResult>;
-declare function createWidgetPackagePublishRequest(options: {
-  readonly publishDir: string;
-  readonly manifestPath: string;
-  readonly publishManifestPath: string;
-  readonly owner: WidgetPackageOwnerKind;
-}): Promise<WidgetPackagePublishRequest>;
-declare function createAuthenticatedWidgetPackageClient(): FetchClient;
-declare function printWidgetPublishSummary(options: {
-  readonly title: string;
-  readonly ownerLabel: string;
-  readonly environment?: string;
-  readonly outDir: string;
-  readonly result: PublishWidgetRuntimeArtifactsResult;
-}): void;
-declare function printRuntimeOnlyNotice(): void;
-declare function printDryRunSessionPayload(result: PublishWidgetRuntimeArtifactsResult): void;
-declare function validateWidgetPublishOutDir(projectDir: string, outDir: string): string;
-//#endregion
 //#region src/index.d.ts
 declare const plugin: FluidPlugin;
 //#endregion
-export { type ArtifactMetadata, type BuildOptions, type BuildSharedWidgetPackageOptions, CANONICAL_PROJECT_NAME, type CategorizedChanges, type CreateOptions, type CreatePortalGitCredentialOptions, type CreatePortalProjectDependencies, type DefinitionMapping, type DevOptions, FILE_SYSTEM_ERRORS, type FileHash, type FileHashMap, type FileSystemError, type FileSystemErrorCode, type GitCredentialOutcome, GitError, type LocalNavigation, type LocalNavigationItem, type LocalProfile, type LocalScreen, type LocalTheme, type MappedResourceType, type PortalDeployOptions, type PortalGitCredential, type PortalGitSyncOptions, type PortalGitSyncResult, type PortalMappings, type ProjectConfig, type PublishManifestMetadata, type PublishWidgetPackageVersionOptions, type PublishWidgetRuntimeArtifactsDependencies, type PublishWidgetRuntimeArtifactsOptions, type PublishWidgetRuntimeArtifactsResult, type RemoteDomWidgetPackageDescriptor, type ScaffoldFromGitHubOptions, type SelectedPageTemplate, type SharedWidgetPackageBuildError, type SharedWidgetPackageBuildResult, type Snapshot, type SnapshotDiff, type SourceWidgetMetadata, type SourceWidgetPackageMetadata, TEMPLATES, TEMPLATE_REPO_URL, type TemplateName, type TemplatePaths, type TemplateVariables, type ValidateSourceWidgetPackageOptions, type ValidatedWidgetPackageBuild, type ValidationError, WIDGET_PACKAGE_BUILDER_VERSION, type WidgetCreateOptions, type WidgetDescriptorMetadata, type WidgetPackageArtifactMetadata, type WidgetPackageArtifactPath, type WidgetPackageArtifactPayload, type WidgetPackageArtifactUploadResult, type WidgetPackageCompleteResult, type WidgetPackageCompleteUploadPayload, type WidgetPackageOwnerKind, type WidgetPackagePublishManifest, type WidgetPackagePublishRequest, type WidgetPackagePublishResult, type WidgetPackageSessionRequest, type WidgetPackageSignedUpload, type WidgetPackageUploadArtifact, WidgetPackageUploadError, type WidgetPackageUploadFetch, type WidgetPackageUploadOwner, type WidgetPackageUploadSession, type WidgetPackageUploadSessionPayload, type WidgetPackageValidationError, type WidgetPackageValidationErrorCode, type WidgetPackageValidationResult, type WidgetPublishOptions, type WidgetSourceConfig, type WidgetSourceConfigLoadError, buildIdToSlugMap, buildNavigationIdToSlugMap, buildSharedWidgetPackage, buildSnapshot, buildThemeIdToSlugMap, buildWidgetPackageCompleteUploadPayload, buildWidgetPackagePublishManifest, buildWidgetPackageUploadSessionPayload, categorizeChanges, cloneCommand, collectWidgetPackageArtifacts, completeWidgetPackageUpload, computeArtifactMetadata, computeFileHash, copyTemplate, copyTemplateSafe, createAuthenticatedWidgetPackageClient, createCommand, createDirectory, createDirectorySafe, createPortalGitCredential, createPortalProject, createPublishManifestMetadata, createWidgetPackageEntrySource, createWidgetPackagePublishRequest, plugin as default, deployCommand, deriveScreenSlug, deriveSlug, diffAgainstSnapshot, directoryExists, doctorCommand, ensureGitAvailable, fileExists, getArtifactContentType, getInstallCommand, getOriginUrl, getRunCommand, getSdkVersion, getSdkVersionSafe, getTemplatePaths, getWidgetPackageCompleteUploadRoute, getWidgetPackageUploadSessionRoute, gitAheadBehindVsFetchHead, gitAutoCommit, gitClone, gitFetch, gitInit, gitMergeFastForward, gitMissingError, gitPush, hasUncommittedChanges, installDependencies, isGitAvailable, isGitRepo, loadSourceWidgetPackages, normalizeWidgetPackageCompleteResponse, normalizeWidgetPackageUploadSession, pathExists, portalGitCredentialPath, printDryRunSessionPayload, printRuntimeOnlyNotice, printWidgetPublishSummary, promptProjectConfig, publishWidgetPackageVersion, publishWidgetRuntimeArtifacts, pullCommand, pushCommand, readFileSafe, readMappings, readSnapshot, removeMapping, requestWidgetPackageUploadSession, resolveIdToSlug, resolvePortalWidgetSourceConfig, resolveSlugToId, rewriteProjectName, runPackageManager, runPortalGitSync, scaffoldFromGitHub, sha256, slugFromPath, topLevelWidgetCommand, transformNavigation, transformNavigationItems, transformProfile, transformScreen, transformTheme, updateMapping, uploadWidgetPackageArtifacts, validateCrossReferences, validateSingleSourceWidgetPackage, validateWidgetPublishOutDir, versionCommand, widgetCommand, writeFileSafe, writeFluidrcProfile, writeMappings, writeSnapshot };
+export { type BuildOptions, CANONICAL_PROJECT_NAME, type CategorizedChanges, type CreateOptions, type CreatePortalGitCredentialOptions, type CreatePortalProjectDependencies, type DefinitionMapping, type DevOptions, FILE_SYSTEM_ERRORS, type FileHash, type FileHashMap, type FileSystemError, type FileSystemErrorCode, type GitCredentialOutcome, GitError, type LocalNavigation, type LocalNavigationItem, type LocalProfile, type LocalScreen, type LocalTheme, type MappedResourceType, type PortalDeployOptions, type PortalGitCredential, type PortalGitSyncOptions, type PortalGitSyncResult, type PortalMappings, type ProjectConfig, type ScaffoldFromGitHubOptions, type SelectedPageTemplate, type Snapshot, type SnapshotDiff, TEMPLATES, TEMPLATE_REPO_URL, type TemplateName, type TemplatePaths, type TemplateVariables, type ValidationError, type WidgetCreateOptions, type WidgetPublishOptions, buildIdToSlugMap, buildNavigationIdToSlugMap, buildSnapshot, buildThemeIdToSlugMap, categorizeChanges, cloneCommand, computeFileHash, copyTemplate, copyTemplateSafe, createCommand, createDirectory, createDirectorySafe, createPortalGitCredential, createPortalProject, plugin as default, deployCommand, deriveScreenSlug, deriveSlug, diffAgainstSnapshot, directoryExists, doctorCommand, ensureGitAvailable, fileExists, getInstallCommand, getOriginUrl, getRunCommand, getSdkVersion, getSdkVersionSafe, getTemplatePaths, gitAheadBehindVsFetchHead, gitAutoCommit, gitClone, gitFetch, gitInit, gitMergeFastForward, gitMissingError, gitPush, hasUncommittedChanges, installDependencies, isGitAvailable, isGitRepo, pathExists, portalGitCredentialPath, promptProjectConfig, pullCommand, pushCommand, readFileSafe, readMappings, readSnapshot, removeMapping, resolveIdToSlug, resolveSlugToId, rewriteProjectName, runPackageManager, runPortalGitSync, scaffoldFromGitHub, slugFromPath, topLevelWidgetCommand, transformNavigation, transformNavigationItems, transformProfile, transformScreen, transformTheme, updateMapping, validateCrossReferences, versionCommand, widgetCommand, writeFileSafe, writeFluidrcProfile, writeMappings, writeSnapshot };
 //# sourceMappingURL=index.d.mts.map