@fluid-app/fluid-cli-portal 0.1.41 → 0.1.43

package/README.md

@@ -71,14 +71,30 @@ fluid portal version activate <version-id> # promote a specific version
 ## Publish widget runtime artifacts
 
 Portal widget packages are published separately from the hosted portal shell.
-The portal CLI only publishes company-owned portal widget packages:
+Create a Remote DOM widget and register it in the single source package:
+
+```bash
+fluid portal widget create stock-ticker
+```
+
+The scaffold writes the widget under `src/widgets/` and creates or updates
+`src/widgets.config.ts` using `defineWidget` and `defineWidgetPackage` from the
+worker-safe Portal SDK entry. `portal.config.ts`, `customWidgets`, and legacy
+manifest endpoints are not part of widget discovery.
+
+The portal CLI publishes company-owned portal widget packages:
 
 ```bash
 fluid portal deploy
 ```
 
-- Builds `defineWidgetPackage` runtime artifacts (`widget.js`, `manifest.json`,
-  CSS, source maps) into `.fluid/widget-dist` by default.
+- Builds `defineWidgetPackage` into `widget.js`, scoped CSS, `manifest.json`,
+  and `publish-manifest.json` under `.fluid/widget-dist` by default.
+- `manifest.json` uses the canonical Remote DOM descriptor. Its
+  `workerEntryUrl` and CSS URLs are package-local artifact paths; the catalog
+  resolves them to absolute public URLs before hosts consume the descriptor.
+  Company and droplet package IDs remain fully qualified (`company.*` or
+  `droplet.*`). The publish manifest records the artifact inventory and hashes.
 - Publishes a **company-owned** portal widget package for Fluid OS usage.
 - Defaults to `--environment production` (an output/reporting label) and
   `--out-dir .fluid/widget-dist`.

package/dist/index.d.mts

@@ -1,5 +1,7 @@
 import { Command } from "commander";
 import { CliError, FetchClient, FluidPlugin, Result } from "@fluid-app/fluid-cli";
+import { components } from "@fluid-app/fluidos-api-client";
+import { JsonObject, RemoteDomWidgetDefinition, RemoteDomWidgetPackageDescriptor } from "@fluid-app/portal-core/remote-dom-widget-package";
 
 //#region src/types.d.ts
 /**
@@ -317,8 +319,22 @@ declare function gitAheadBehindVsFetchHead(cwd: string): Promise<{
 /** Fast-forward HEAD to FETCH_HEAD. Fails (non-zero exit) if not
 *  fast-forwardable — callers check the ahead-count first. */
 declare function gitMergeFastForward(cwd: string): Promise<void>;
+interface GitAutoCommitOptions {
+  /**
+  * Stage with `git add --ignore-removal .` (new + modified files only)
+  * instead of `git add -A`, so files present in the index but absent
+  * from the working tree are NOT recorded as deletions. Used by the
+  * first-push adoption path in git-sync: a directory populated by
+  * `fluid portal pull` (content-only sync) has no idea what the full
+  * repo tracks, so local additions/edits win but remote-only files are
+  * preserved — deletions only ever ship from full checkouts.
+  */
+  readonly ignoreRemovals?: boolean;
+}
 /**
-* `git add -A && git commit -m <message>`.
+* `git add -A && git commit -m <message>` (or, with
+* `{ ignoreRemovals: true }`, `git add --ignore-removal .` — see
+* GitAutoCommitOptions).
 *
 * `git add -A` intentionally stages the whole work tree: a portal's
 * provisioned repo tracks the entire project (it's seeded from the
@@ -332,7 +348,7 @@ declare function gitMergeFastForward(cwd: string): Promise<void>;
 * identity so the commit isn't rejected. "nothing to commit" is treated
 * as a no-op, not an error.
 */
-declare function gitAutoCommit(cwd: string, message: string): Promise<void>;
+declare function gitAutoCommit(cwd: string, message: string, options?: GitAutoCommitOptions): Promise<void>;
 /**
 * `git push <cleanUrl> HEAD:<branch>` — credentials supplied via
 * GIT_ASKPASS, never argv. `http.…/.extraheader=` clears any cached
@@ -578,394 +594,6 @@ declare function diffAgainstSnapshot(portalDir: string, snapshot: Snapshot): Pro
 */
 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: {
-    Meta: {
-      request_id?: string; /** Format: date-time */
-      timestamp?: string;
-    };
-    PaginatedMeta: {
-      current_page: number;
-      request_id: string; /** Format: date-time */
-      timestamp: string;
-      total_count: number;
-      total_pages: number;
-    };
-    ErrorResponse: {
-      error_message: string;
-      errors: components["schemas"]["ErrorBag"];
-      meta: components["schemas"]["Meta"];
-    };
-    UnauthorizedResponse: {
-      message: string;
-    }; /** @description Any valid JSON value for provider, integration, theme, metadata, or other dynamic payloads whose keys are not fixed by the API contract. */
-    JsonValue: string | number | boolean | null | components["schemas"]["JsonValue"][] | {
-      [key: string]: components["schemas"]["JsonValue"];
-    }; /** @description A validation or API error value. */
-    ErrorValue: string | string[] | components["schemas"]["JsonValue"]; /** @description Validation errors keyed by field, a list of errors, a single error message, or null when no structured error details are available. */
-    ErrorBag: string | components["schemas"]["ErrorValue"][] | {
-      [key: string]: components["schemas"]["ErrorValue"];
-    } | null; /** @description An API error message represented as text or structured JSON. */
-    ErrorMessage: string | components["schemas"]["ErrorBag"] | null; /** @description Common legacy error response envelope. Older endpoints may return one or more of these fields depending on the controller path. */
-    StandardErrorResponse: {
-      message?: string;
-      error?: components["schemas"]["ErrorMessage"];
-      error_message?: components["schemas"]["ErrorMessage"];
-      errors?: components["schemas"]["ErrorBag"];
-      meta?: components["schemas"]["Meta"];
-    } & {
-      [key: string]: components["schemas"]["JsonValue"];
-    }; /** @description Common legacy unauthorized response envelope. */
-    StandardUnauthorizedResponse: components["schemas"]["StandardErrorResponse"];
-    FluidOSDefinitionListResponse: {
-      definitions: components["schemas"]["FluidOSDefinitionBasic"][];
-      meta: components["schemas"]["PaginatedMeta"];
-    };
-    FluidOSDefinitionRequest: {
-      definition?: {
-        name: string;
-        active?: boolean;
-      } | null;
-    };
-    FluidOSDefinitionUpdateRequest: {
-      definition?: {
-        name?: string;
-        active?: boolean;
-      } | null;
-    };
-    FluidOSNavigationItemCreateRequest: {
-      navigation_item?: {
-        icon?: string;
-        label: string;
-        position: number;
-        parent_id?: number | null;
-        screen_id?: number | null;
-        slug?: string | null;
-        source?: "user" | "system" | "code" | null;
-      } | null;
-    };
-    FluidOSNavigationCreateRequest: {
-      navigation?: {
-        name: string;
-        platform: string;
-      } | null;
-    };
-    FluidOSProfileCreateRequest: {
-      profile?: {
-        name: string;
-        default?: boolean;
-        navigation_id?: number;
-        mobile_navigation_id?: number;
-        navigation_attributes?: {
-          name: string;
-          navigation_items_attributes?: Partial<NonNullable<components["schemas"]["FluidOSNavigationItemCreateRequest"]["navigation_item"]>>[];
-        };
-        mobile_navigation_attributes?: {
-          name: string;
-          navigation_items_attributes?: Partial<NonNullable<components["schemas"]["FluidOSNavigationItemCreateRequest"]["navigation_item"]>>[];
-        };
-        theme_ids?: number[];
-        permissions?: components["schemas"]["FluidOSDynamicPayload"];
-      } | null;
-    };
-    FluidOSScreenCreateRequest: {
-      screen?: {
-        name: string;
-        slug: string;
-        component_tree?: components["schemas"]["FluidOSDynamicPayload"] | null;
-      } | null;
-    };
-    FluidOSThemeCreateRequest: {
-      theme?: {
-        config: components["schemas"]["FluidOSDynamicPayload"];
-        name: string;
-        active?: boolean;
-      } | null;
-    };
-    FluidOSNavigationItemUpdateRequest: {
-      navigation_item?: Partial<NonNullable<components["schemas"]["FluidOSNavigationItemCreateRequest"]["navigation_item"]>> | null;
-    };
-    FluidOSNavigationUpdateRequest: {
-      navigation?: {
-        name?: string;
-        platform?: "web" | "mobile";
-      } | null;
-    };
-    FluidOSProfileUpdateRequest: {
-      profile?: {
-        name?: string;
-        default?: boolean;
-        navigation_id?: number;
-        mobile_navigation_id?: number;
-        theme_ids?: number[];
-        permissions?: components["schemas"]["FluidOSDynamicPayload"];
-      } | null;
-    };
-    FluidOSScreenUpdateRequest: {
-      screen?: {
-        name?: string;
-        slug?: string;
-        component_tree?: components["schemas"]["FluidOSDynamicPayload"] | null;
-      } | null;
-    };
-    FluidOSThemeUpdateRequest: {
-      theme?: {
-        name?: string;
-        active?: boolean;
-        config?: components["schemas"]["FluidOSDynamicPayload"];
-      } | null;
-    };
-    FluidOSVersionUpdateRequest: {
-      version?: {
-        active?: boolean;
-      } | null;
-    }; /** FluidOS::NavigationItem */
-    FluidOSNavigationItem: {
-      id: number;
-      icon?: string | null;
-      label?: string | null;
-      parent_id?: number | null;
-      position?: number | null;
-      screen_id?: number | null;
-      slug?: string | null; /** @enum {string} */
-      source?: "user" | "system" | "code";
-      children?: components["schemas"]["FluidOSNavigationItem"][];
-    }; /** FluidOS::Screen */
-    FluidOSScreenBasic: {
-      id: number;
-      name?: string | null;
-      slug?: string | null;
-      definition_id: number;
-    }; /** FluidOS::Screen */
-    FluidOSScreen: {
-      id: number;
-      name?: string | null;
-      slug?: string | null;
-      definition_id: number;
-      component_tree?: components["schemas"]["FluidOSDynamicPayload"];
-    }; /** FluidOS::Theme */
-    FluidOSTheme: {
-      id: number;
-      config?: components["schemas"]["FluidOSDynamicPayload"];
-      active?: boolean | null;
-      name?: string | null;
-      definition_id: number;
-    }; /** FluidOS::Navigation */
-    FluidOSNavigationBasic: {
-      id: number;
-      name?: string | null;
-      definition_id: number; /** @enum {string} */
-      platform: "web" | "mobile";
-    }; /** FluidOS::Navigation */
-    FluidOSNavigation: {
-      id: number;
-      name?: string | null;
-      definition_id: number; /** @enum {string} */
-      platform: "web" | "mobile";
-      screens?: components["schemas"]["FluidOSScreen"][];
-    }; /** FluidOS::Navigation */
-    FluidOSNavigationWithItems: {
-      id: number;
-      name?: string | null;
-      definition_id: number; /** @enum {string} */
-      platform: "web" | "mobile";
-      navigation_items?: components["schemas"]["FluidOSNavigationItem"][];
-    }; /** FluidOS::Profile */
-    FluidOSProfile: {
-      id: number;
-      name?: string | null;
-      default?: boolean | null;
-      permissions?: components["schemas"]["FluidOSDynamicPayload"];
-      definition_id: number;
-      navigation?: components["schemas"]["FluidOSNavigationWithItems"] | null;
-      mobile_navigation?: components["schemas"]["FluidOSNavigationWithItems"];
-      themes?: components["schemas"]["FluidOSTheme"][];
-    }; /** FluidOS::Profile */
-    FluidOSProfileWithScreens: {
-      id: number;
-      name?: string | null;
-      default?: boolean | null;
-      permissions?: components["schemas"]["FluidOSDynamicPayload"];
-      definition_id: number;
-      navigation?: components["schemas"]["FluidOSNavigationWithItems"] | null;
-      mobile_navigation?: components["schemas"]["FluidOSNavigationWithItems"];
-      themes?: components["schemas"]["FluidOSTheme"][];
-      screens?: components["schemas"]["FluidOSScreen"][];
-    }; /** FluidOS::Definition */
-    FluidOSDefinitionBasic: {
-      id: number;
-      name?: string | null;
-      active?: boolean | null;
-    }; /** FluidOS::Definition */
-    FluidOSDefinition: {
-      id: number;
-      name?: string | null;
-      active?: boolean | null;
-      profiles?: components["schemas"]["FluidOSProfile"][];
-      screens?: components["schemas"]["FluidOSScreenBasic"][];
-      navigations?: components["schemas"]["FluidOSNavigationBasic"][];
-      themes?: components["schemas"]["FluidOSTheme"][];
-    }; /** FluidOS::Version */
-    FluidOSVersion: {
-      id: number;
-      active?: boolean | null;
-      manifest?: components["schemas"]["FluidOSDynamicPayload"]; /** Format: date-time */
-      published_at?: string | null;
-      definition_id: number;
-    }; /** @description Couples each widget package artifact path class with the only accepted contentType value. */
-    FluidOSWidgetPackageVersionArtifactContentTypeConstraint: {
-      /** @constant */path: "widget.js"; /** @constant */
-      contentType: "application/javascript";
-    } | {
-      /** @constant */path: "manifest.json"; /** @constant */
-      contentType: "application/json";
-    } | {
-      path: string; /** @constant */
-      contentType: "text/css";
-    } | {
-      path: string; /** @constant */
-      contentType: "application/json";
-    }; /** @description Couples each widget package artifact path class with the only accepted contentType/content_type alias values when supplied. */
-    FluidOSWidgetPackageVersionCompletionArtifactContentTypeConstraint: {
-      /** @constant */path: "widget.js"; /** @constant */
-      contentType?: "application/javascript"; /** @constant */
-      content_type?: "application/javascript";
-    } | {
-      /** @constant */path: "manifest.json"; /** @constant */
-      contentType?: "application/json"; /** @constant */
-      content_type?: "application/json";
-    } | {
-      path: string; /** @constant */
-      contentType?: "text/css"; /** @constant */
-      content_type?: "text/css";
-    } | {
-      path: string; /** @constant */
-      contentType?: "application/json"; /** @constant */
-      content_type?: "application/json";
-    }; /** @description Artifact metadata required before Fluid OS widget package upload URLs can be issued. Artifact paths must be unique within the request, and the artifact list must include widget.js and manifest.json before upload URLs are issued. Artifact paths are top-level package artifact filenames only; accepted names are widget.js, manifest.json, *.css, and *.js.map with no slash paths. Accepted content types are application/javascript for widget.js, application/json for manifest.json and *.js.map, and text/css for *.css. Byte sizes are non-negative and checked against configured per-artifact and bundle limits; defaults are 5 MiB per artifact and 10 MiB per bundle unless environment config changes them. */
-    FluidOSWidgetPackageVersionArtifactInput: {
-      /** @description Top-level package artifact filename. Accepted names are widget.js, manifest.json, *.css, or *.js.map; slash paths are not accepted. */path: string; /** @description Expected SHA256 checksum for the artifact content. */
-      sha256: string; /** @description Expected artifact size in bytes. Checked against configured per-artifact and bundle limits; defaults are 5 MiB per artifact and 10 MiB per bundle unless environment config changes them. */
-      bytes: number;
-      /**
-       * @description MIME content type used when uploading the artifact. Accepted values are application/javascript for widget.js, application/json for manifest.json and *.js.map, and text/css for *.css.
-       * @enum {string}
-       */
-      contentType: "application/javascript" | "application/json" | "text/css";
-    } & components["schemas"]["FluidOSWidgetPackageVersionArtifactContentTypeConstraint"]; /** @description Request payload for starting a company-owned Fluid OS widget package version publish flow. Artifact paths must be unique top-level package artifact filenames. The artifacts list must include widget.js and manifest.json so the API can issue upload URLs and later verify the completed upload. */
-    FluidOSWidgetPackageVersionCreateRequest: {
-      /** @description Non-empty, object-path-safe company-owned widget package key. Use URL-safe characters only; . and .. are not accepted. */package_key: string; /** @description Non-empty, object-path-safe widget package version identifier accepted in the URL and upload path. Dotted versions such as 1.0.0 are accepted; only exact . or .. path segments and characters outside [A-Za-z0-9._~-] are rejected. */
-      version: string; /** @description Fluid OS builder version that produced this package. */
-      builder_version: string; /** @description Fluid OS CLI version that published this package. */
-      cli_version: string; /** @description Fluid OS runtime version targeted by this package. */
-      runtime_version: string; /** @description SHA256 checksum of the serialized manifest JSON. */
-      manifest_hash: string; /** @description Widget package manifest JSON. It must use the supported widget manifest structure, contain at least one extractable widget type, and every widget type in that structure must use the company-owned prefix `company.<package_key>.`. */
-      manifest: {
-        [key: string]: components["schemas"]["JsonValue"];
-      }; /** @description Top-level package artifacts to upload. The list must include widget.js and manifest.json. */
-      artifacts: components["schemas"]["FluidOSWidgetPackageVersionArtifactInput"][] & (unknown & unknown); /** @description Optional publisher metadata stored with the package version. */
-      build_metadata?: {
-        [key: string]: components["schemas"]["JsonValue"];
-      };
-    }; /** @description Upload instructions for a widget package artifact. */
-    FluidOSWidgetPackageVersionUpload: {
-      /** @description Top-level package artifact filename. */path: string; /** Format: uri */
-      upload_url: string; /** Format: uri */
-      public_url: string;
-    }; /** @description Upload session details for a pending Fluid OS widget package version. */
-    FluidOSWidgetPackageVersionCreateResponse: {
-      version_id: number; /** Format: uri */
-      artifact_base_url: string;
-      uploads: components["schemas"]["FluidOSWidgetPackageVersionUpload"][];
-    }; /** @description Optional artifact metadata supplied when completing a widget package upload. Artifact paths must be unique top-level package artifact filenames within the request; accepted names are widget.js, manifest.json, *.css, and *.js.map with no slash paths. Accepted content types are application/javascript for widget.js, application/json for manifest.json and *.js.map, and text/css for *.css. Byte sizes are non-negative and checked against configured per-artifact and bundle limits; defaults are 5 MiB per artifact and 10 MiB per bundle unless environment config changes them. sha256/checksum, bytes/size, and contentType/content_type are accepted aliases and must match when both aliases are present; supplied artifact metadata is compared with the stored upload-session/package version artifact metadata during verification. If artifacts are supplied, they must include exactly the stored upload-session artifact paths. Manifest verification is separate and happens against uploaded artifact content. */
-    FluidOSWidgetPackageVersionCompletionArtifactInput: {
-      /** @description Top-level package artifact filename. Accepted names are widget.js, manifest.json, *.css, or *.js.map; slash paths are not accepted. */path: string; /** @description Expected SHA256 checksum for the artifact content. */
-      sha256?: string; /** @description Alias for sha256. */
-      checksum?: string; /** @description Expected artifact size in bytes. Checked against configured per-artifact and bundle limits; defaults are 5 MiB per artifact and 10 MiB per bundle unless environment config changes them. */
-      bytes?: number; /** @description Alias for bytes; checked against the same configured per-artifact and bundle limits. */
-      size?: number;
-      /**
-       * @description MIME content type for the artifact. Accepted values are application/javascript for widget.js, application/json for manifest.json and *.js.map, and text/css for *.css.
-       * @enum {string}
-       */
-      contentType?: "application/javascript" | "application/json" | "text/css";
-      /**
-       * @description Alias for contentType.
-       * @enum {string}
-       */
-      content_type?: "application/javascript" | "application/json" | "text/css";
-    } & components["schemas"]["FluidOSWidgetPackageVersionCompletionArtifactContentTypeConstraint"]; /** @description Request payload for verifying uploaded company-owned Fluid OS widget package artifacts. The version path parameter, optional package_key, and any supplied artifact metadata must match the stored upload-session/package version artifact metadata before the package version is approved. If artifacts are supplied, they must include exactly the stored upload-session artifact paths. Uploaded manifest.json is verified for matching packageId, matching version, and valid company-owned `company.<package_key>.` widget type prefixes. */
-    FluidOSWidgetPackageVersionCompleteUploadRequest: {
-      /** @description Optional non-empty, object-path-safe widget package key. When omitted, the company's widget package is used; . and .. are not accepted. */package_key?: string | null; /** @description Optional artifact metadata to compare with the stored upload session. When supplied, the list must include exactly the stored upload-session artifact paths; omissions and extras are rejected. */
-      artifacts?: components["schemas"]["FluidOSWidgetPackageVersionCompletionArtifactInput"][];
-    }; /** @description Approved Fluid OS widget package version details. */
-    FluidOSWidgetPackageVersionCompleteUploadResponse: {
-      status: string;
-      packageId: string; /** @description Non-empty, object-path-safe widget package version identifier. Dotted versions such as 1.0.0 are accepted; only exact . or .. path segments and characters outside [A-Za-z0-9._~-] are rejected. */
-      version: string; /** Format: uri */
-      scriptUrl: string;
-      cssUrls: string[]; /** Format: uri */
-      manifestUrl: string;
-    }; /** @description Flat verification failure response returned when uploaded artifacts do not match the package manifest or expected metadata. */
-    FluidOSWidgetPackageVersionVerificationErrorResponse: {
-      /** @enum {string} */status: "error";
-      error_message: string;
-      details: {
-        [key: string]: components["schemas"]["JsonValue"];
-      };
-    }; /** @description Dynamic Fluid OS JSON payload whose keys are defined by the app builder configuration. */
-    FluidOSDynamicPayload: {
-      [key: string]: components["schemas"]["JsonValue"];
-    } | null;
-    FluidOSWidgetPackageCatalogEntry: {
-      /**
-       * @description Package ownership source for the shared widget loading path.
-       * @enum {string}
-       */
-      source: "company" | "droplet";
-      /**
-       * @description Runtime package identifier prefixed by source.
-       * @example company.portal-home
-       * @example droplet.reviews
-       */
-      packageId: string; /** @description Approved package version currently active for this owner. */
-      version: string; /** @description Public module script URL for the package runtime artifact. */
-      scriptUrl: string | null; /** @description Public stylesheet URLs for the package runtime artifacts. */
-      cssUrls: string[]; /** @description Public URL for the package manifest artifact. */
-      manifestUrl: string | null; /** @description Approved package manifest JSON used by the runtime loader. */
-      manifest: {
-        [key: string]: components["schemas"]["JsonValue"];
-      };
-    };
-    FluidOSWidgetPackageCatalogResponse: {
-      packages: components["schemas"]["FluidOSWidgetPackageCatalogEntry"][];
-    };
-    FluidOSWidgetPackageDropletForbiddenResponse: {
-      error: {
-        message: string;
-        details?: {
-          [key: string]: components["schemas"]["JsonValue"];
-        };
-      }; /** @enum {integer} */
-      status: 403;
-      meta?: components["schemas"]["Meta"];
-    };
-    FluidOSWidgetPackageRoleForbiddenResponse: {
-      message: string;
-    };
-    FluidOSWidgetPackagePermissionForbiddenResponse: {
-      error: string;
-    };
-    FluidOSWidgetPackageForbiddenResponse: components["schemas"]["FluidOSWidgetPackageDropletForbiddenResponse"] | components["schemas"]["FluidOSWidgetPackageRoleForbiddenResponse"] | components["schemas"]["FluidOSWidgetPackagePermissionForbiddenResponse"];
-  };
-  responses: never;
-  parameters: never;
-  requestBodies: never;
-  headers: never;
-  pathItems: never;
-}
-//#endregion
 //#region src/utils/transform.d.ts
 type ApiScreen = components["schemas"]["FluidOSScreen"];
 type ApiTheme = components["schemas"]["FluidOSTheme"];
@@ -1101,19 +729,22 @@ declare function validateCrossReferences(portalDir: string, mappings: PortalMapp
 //#endregion
 //#region src/utils/widget-package-validation.d.ts
 type WidgetPackageOwnerKind = "company" | "droplet";
-type WidgetRuntimeContainer = "inline" | "block" | "card" | "fullscreen";
-type WidgetRuntimeResizable = boolean | "horizontal" | "vertical" | "both";
+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?: Record<string, unknown>;
-  readonly defaultProps?: Record<string, unknown>;
+  readonly propertySchema?: JsonObject;
+  readonly defaultProps?: JsonObject;
   readonly container?: unknown;
   readonly minSdkVersion?: string;
   readonly resizable?: unknown;
+  readonly capabilities?: readonly WidgetCapabilityMetadata[];
 }
 interface SourceWidgetPackageMetadata {
   readonly manifestVersion?: number;
@@ -1125,27 +756,30 @@ interface SourceWidgetPackageMetadata {
   readonly widgets: readonly SourceWidgetMetadata[];
   readonly cssUrls?: readonly string[];
 }
-interface WidgetDescriptorMetadata {
-  readonly type: string;
+interface WidgetDescriptorMetadata extends RemoteDomWidgetDefinition {
   readonly name: string;
-  readonly displayName: string;
-  readonly description: string;
-  readonly icon: string;
-  readonly category: string;
-  readonly propertySchema: Record<string, unknown>;
-  readonly defaultProps: Record<string, unknown>;
-  readonly container: WidgetRuntimeContainer;
-  readonly minSdkVersion: string;
-  readonly resizable: WidgetRuntimeResizable;
 }
-interface WidgetPackageDescriptorMetadata {
+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 packageType: WidgetPackageOwnerKind;
+  readonly source: WidgetPackageOwnerKind;
   readonly version: string;
-  readonly remoteEntryUrl: string;
-  readonly cssUrls: readonly string[];
-  readonly widgets: readonly WidgetDescriptorMetadata[];
+  readonly workerEntryUrl: WidgetPackageArtifactPath;
+  readonly cssUrls: readonly WidgetPackageArtifactPath[];
+  readonly assetUrls: readonly WidgetPackageArtifactPath[];
+  readonly widgets: readonly RemoteDomWidgetDefinition[];
 }
 interface ValidatedWidgetPackageBuild {
   readonly sourcePackage: SourceWidgetPackageMetadata;
@@ -1170,10 +804,9 @@ interface ValidateSourceWidgetPackageOptions {
   readonly owner?: WidgetPackageOwnerKind;
 }
 declare function validateSingleSourceWidgetPackage(sourcePackages: readonly unknown[], options?: ValidateSourceWidgetPackageOptions): WidgetPackageValidationResult;
-declare function buildWidgetPackageDescriptor(validated: ValidatedWidgetPackageBuild, options?: {
-  readonly remoteEntryUrl?: string;
+declare function buildWidgetPackagePublishManifest(validated: ValidatedWidgetPackageBuild, options?: {
   readonly cssUrls?: readonly string[];
-}): WidgetPackageDescriptorMetadata;
+}): WidgetPackagePublishManifest;
 //#endregion
 //#region src/utils/widget-package-builder.d.ts
 interface BuildSharedWidgetPackageOptions {
@@ -1197,6 +830,7 @@ interface SharedWidgetPackageBuildError {
 declare function buildSharedWidgetPackage(options: BuildSharedWidgetPackageOptions): Promise<Result<SharedWidgetPackageBuildResult, SharedWidgetPackageBuildError>>;
 declare function createWidgetPackageEntrySource(options: {
   readonly configImportPath: string;
+  readonly cssImportPath?: string;
   readonly validated: ValidatedWidgetPackageBuild;
 }): string;
 //#endregion
@@ -1382,5 +1016,5 @@ declare function validateWidgetPublishOutDir(projectDir: string, outDir: string)
 //#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 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 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 WidgetPackageArtifactPayload, type WidgetPackageArtifactUploadResult, type WidgetPackageCompleteResult, type WidgetPackageCompleteUploadPayload, type WidgetPackageDescriptorMetadata, type WidgetPackageOwnerKind, 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, buildWidgetPackageDescriptor, buildWidgetPackageUploadSessionPayload, categorizeChanges, cloneCommand, collectWidgetPackageArtifacts, completeWidgetPackageUpload, computeArtifactMetadata, computeFileHash, copyTemplate, copyTemplateSafe, createAuthenticatedWidgetPackageClient, createCommand, createDirectory, createDirectorySafe, createPortalGitCredential, 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 ArtifactMetadata, type BuildOptions, type BuildSharedWidgetPackageOptions, CANONICAL_PROJECT_NAME, type CategorizedChanges, type CreateOptions, type CreatePortalGitCredentialOptions, 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, 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 };
 //# sourceMappingURL=index.d.mts.map