@fluid-app/fluid-cli-widget 0.1.34 → 0.1.36

package/authoring/commands.md

@@ -0,0 +1,195 @@
+# fluid widget commands
+
+## fluid widget
+
+```text
+Usage: fluid widget [options] [command]
+
+Create, preview, link, validate, build, publish, push, and clone standalone
+Fluid widgets
+
+Options:
+  -h, --help                       display help for command
+
+Commands:
+  create [options] <project-name>  Create a standalone Fluid widget project
+  clone [options] <package>        Clone a widget package's git repository
+                                   (mints a fresh token per call)
+  dev [options]                    Start the local Fluid widget development
+                                   endpoints
+  link [options]                   Link this widget project to an existing
+                                   Fluid droplet
+  validate [options]               Validate the current droplet widget package
+  build [options]                  Validate and build the current droplet
+                                   widget package
+  publish [options]                Publish a Fluid widget package
+  push [options]                   Sync the widget's git repository (commit +
+                                   push), then build and publish
+  status [options]                 Show published widget package status for a
+                                   Droplet
+  logs [options]                   Show recent widget package publish logs for
+                                   a Droplet
+  help [command]                   display help for command
+```
+
+## fluid widget create
+
+```text
+Usage: fluid widget create [options] <project-name>
+
+Create a standalone Fluid widget project
+
+Arguments:
+  project-name                 Name of the widget project to create
+
+Options:
+  --skip-install               Create the scaffold only; skip dependency
+                               installation
+  -o, --output-dir <dir>       Directory to create the project in (defaults to
+                               cwd)
+  --scope <scope>              Widget package scope/namespace (default:
+                               "droplet")
+  --package-version <version>  Initial widget package version (default:
+                               "0.1.0")
+  --local                      Use local monorepo packages via link: paths (for
+                               development testing)
+  --remote-template            Use the GitHub starter template instead of the
+                               bundled template
+  --droplet <uuid>             Existing droplet UUID that owns the package
+  -h, --help                   display help for command
+```
+
+## fluid widget clone
+
+```text
+Usage: fluid widget clone [options] <package>
+
+Clone a widget package's git repository (mints a fresh token per call)
+
+Arguments:
+  package           Widget package key to clone
+
+Options:
+  --droplet <uuid>  Droplet UUID that owns the package (defaults to the
+                    company-owned package)
+  --dir <dir>       Target directory (defaults to ./<package>/)
+  --skip-install    Skip dependency installation
+  -h, --help        display help for command
+```
+
+## fluid widget dev
+
+```text
+Usage: fluid widget dev [options]
+
+Start the local Fluid widget development endpoints
+
+Options:
+  -p, --port <port>  Port to run the widget dev server on (default: "5174")
+  --host [host]      Expose the dev server to the network
+  --mode <mode>      Vite mode to run (default: "development")
+  -h, --help         display help for command
+```
+
+## fluid widget link
+
+```text
+Usage: fluid widget link [options]
+
+Link this widget project to an existing Fluid droplet
+
+Options:
+  --droplet <uuid>  Droplet UUID that owns the widget package
+  -h, --help        display help for command
+```
+
+## fluid widget validate
+
+```text
+Usage: fluid widget validate [options]
+
+Validate the current droplet widget package
+
+Options:
+  --json      Print machine-readable validation output
+  -h, --help  display help for command
+```
+
+## fluid widget build
+
+```text
+Usage: fluid widget build [options]
+
+Validate and build the current droplet widget package
+
+Options:
+  -o, --out-dir <dir>  Widget artifact output directory (default:
+                       ".fluid/widget-dist")
+  --skip-typecheck     Skip package typecheck script when present
+  -h, --help           display help for command
+```
+
+## fluid widget publish
+
+```text
+Usage: fluid widget publish [options]
+
+Publish a Fluid widget package
+
+Options:
+  -o, --out-dir <dir>  Widget artifact output directory (default:
+                       ".fluid/widget-dist")
+  --droplet <uuid>     Droplet UUID that owns the widget package
+  --dry-run            Build and validate without uploading
+  --skip-typecheck     Skip package typecheck script when present
+  -h, --help           display help for command
+```
+
+## fluid widget push
+
+```text
+Usage: fluid widget push [options]
+
+Sync the widget's git repository (commit + push), then build and publish
+
+Options:
+  -o, --out-dir <dir>      Widget artifact output directory (default:
+                           ".fluid/widget-dist")
+  --droplet <uuid>         Droplet UUID that owns the widget package
+  --branch <name>          Branch to push (default: main)
+  -m, --message <message>  Commit message for the auto-commit (default:
+                           timestamped Publish)
+  --no-commit              Skip the auto-commit step (push existing commits
+                           only)
+  --skip-publish           Sync the git repository only; skip build + publish
+  --dry-run                Build and validate without uploading (publish step)
+  --skip-typecheck         Skip package typecheck script when present
+  -h, --help               display help for command
+```
+
+## fluid widget status
+
+```text
+Usage: fluid widget status [options]
+
+Show published widget package status for a Droplet
+
+Options:
+  --droplet <uuid>  Droplet UUID that owns the widget package
+  --json            Print raw status response as JSON
+  -h, --help        display help for command
+```
+
+## fluid widget logs
+
+```text
+Usage: fluid widget logs [options]
+
+Show recent widget package publish logs for a Droplet
+
+Options:
+  --droplet <uuid>  Droplet UUID that owns the widget package
+  --limit <number>  Maximum number of log entries to request (default: "50")
+  --json            Print raw log response as JSON
+  -h, --help        display help for command
+```

package/dist/{index-JKSTx5pZ.d.mts → index-DW3icMxz.d.mts}

@@ -115,6 +115,12 @@ interface FluidWidgetDevPluginOptions {
   */
   readonly allowNoPackages?: boolean;
 }
+/**
+* Creates the Vite plugin that serves a widget package descriptor and worker entry.
+*
+* @param options - Source layout and ownership overrides. The defaults match the standalone widget template.
+* @returns A serve-only Vite plugin for Fluid widget development.
+*/
 declare function fluidWidgetDevPlugin(options?: FluidWidgetDevPluginOptions): Plugin;
 /**
 * Widget projects intentionally have no HTML entrypoint, so Vite cannot
@@ -196,4 +202,4 @@ declare function buildRuntimeEntryBootstrapScript(entryPath: string, origin: str
 declare function createDevWidgetPackageDescriptors(configModule: Readonly<Record<string, unknown>>, origin: string, owner?: WidgetPackageOwnerKind): readonly RemoteDomWidgetPackageDescriptor[];
 //#endregion
 export { fluidWidgetDevPlugin as a, createWidgetDevServerConfig as i, buildRuntimeEntryBootstrapScript as n, ValidatedWidgetPackageBuild as o, createDevWidgetPackageDescriptors as r, WidgetPackageValidationError as s, FluidWidgetDevPluginOptions as t };
-//# sourceMappingURL=index-JKSTx5pZ.d.mts.map
+//# sourceMappingURL=index-DW3icMxz.d.mts.map

package/dist/index-DW3icMxz.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DW3icMxz.d.mts","names":[],"sources":["../../../portal/core/src/remote-dom-widget-package.ts","../../widget-tooling/src/internal/widget-package-validation.ts","../../widget-tooling/src/dev-routes.ts"],"mappings":";;;cAMa,kCAAA;AAAA,cACA,yBAAA;AAAA,KAED,aAAA;AAAA,KAEA,SAAA,GAAY,aAAA,YAAyB,SAAA,KAAc,UAAA;AAAA,UAE9C,UAAA;EAAA,UACS,GAAA,WAAA,SAAA;AAAA;AAAA,UA4DT,oCAAA;EAAA,SACN,IAAA;EAAA,SACA,OAAA;AAAA;AAAA,UAGM,yBAAA;EAAA,SACN,IAAA;EAAA,SACA,WAAA;EAAA,SACA,WAAA;EAAA,SACA,IAAA;EAAA,SACA,QAAA;EAAA,SACA,cAAA,EAAgB,UAAA;EAAA,SAChB,YAAA,EAAc,UAAA;EAAA,SACd,SAAA;EAAA,SACA,SAAA;EAAA,SACA,aAAA;EAAA,SACA,YAAA,WAAuB,oCAAA;AAAA;;;;;;UAQjB,gCAAA;EAAA,SACN,eAAA,SAAwB,kCAAA;EAAA,SACxB,OAAA,SAAgB,yBAAA;EAAA,SAChB,SAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAAA,SACA,cAAA;EAAA,SACA,OAAA;EAAA,SACA,SAAA;EAAA,SACA,OAAA,WAAkB,yBAAA;AAAA;;;KCnFjB,sBAAA;AAAA,UAKK,wBAAA;EAAA,SACN,IAAA;EAAA,SACA,OAAA;AAAA;AAAA,UAGM,oBAAA;EAAA,SACN,IAAA;EAAA,SACA,WAAA;EAAA,SACA,WAAA;EAAA,SACA,IAAA;EAAA,SACA,QAAA;EAAA,SACA,cAAA,GAAiB,UAAA;EAAA,SACjB,YAAA,GAAe,UAAA;EAAA,SACf,SAAA;EAAA,SACA,aAAA;EAAA,SACA,SAAA;EAAA,SACA,YAAA,YAAwB,wBAAA;AAAA;AAAA,UAGlB,2BAAA;EAAA,SACN,eAAA;EAAA,SACA,KAAA;EAAA,SACA,eAAA;EAAA,SACA,SAAA;EAAA,SACA,WAAA;EAAA,SACA,OAAA;EAAA,SACA,OAAA,WAAkB,oBAAA;EAAA,SAClB,OAAA;AAAA;AAAA,UAGM,wBAAA,SAAiC,yBAAA;EAAA,SACvC,IAAA;AAAA;AAAA,UA4BM,2BAAA;EAAA,SACN,aAAA,EAAe,2BAAA;EAAA,SACf,UAAA;EAAA,SACA,SAAA;EAAA,SACA,KAAA,EAAO,sBAAA;EAAA,SACP,OAAA;EAAA,SACA,OAAA,WAAkB,wBAAA;AAAA;AAAA,KAGjB,gCAAA;AAAA,UAaK,4BAAA;EAAA,SACN,IAAA,EAAM,gCAAA;EAAA,SACN,OAAA;EAAA,SACA,IAAA;AAAA;;;AD3GX;;;;;AACA;;;;AADA,UEUiB,2BAAA;EFPjB;EAAA,SESW,eAAA;;WAEA,gBAAA;EFXC;EAAA,SEaD,KAAA,GAAQ,sBAAA;EFXP;;;;;;;EAAA,SEmBD,eAAA;AAAA;;;;AFjBX;;;iBE0BgB,oBAAA,CACd,OAAA,GAAS,2BAAA,GACR,MAAA;;AFiCH;;;;;AAKA;;;;;;iBEqBgB,2BAAA,CAAA,GAA+B,UAAA;;;;;;;;;;;;;;;;;;AFF/C;;;;;;;;;;;;;;;;;;;;;;;;;AC1EA;;;;;AAKA;;;;;AAKA;;;;;;iBCgKgB,gCAAA,CACd,SAAA,UACA,MAAA;;;;;;iBA4Cc,iCAAA,CACd,YAAA,EAAc,QAAA,CAAS,MAAA,oBACvB,MAAA,UACA,KAAA,GAAO,sBAAA,YACG,gCAAA"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { o as ValidatedWidgetPackageBuild, s as WidgetPackageValidationError } from "./index-JKSTx5pZ.mjs";
+import { o as ValidatedWidgetPackageBuild, s as WidgetPackageValidationError } from "./index-DW3icMxz.mjs";
 import { Command } from "commander";
 import { FluidPlugin } from "@fluid-app/fluid-cli";
 
@@ -174,7 +174,9 @@ declare const validateCommand: Command;
 //#endregion
 //#region src/utils/config.d.ts
 declare const WIDGET_CONFIG_FILE = "fluid.widget.config.ts";
+/** Author-owned settings in `fluid.widget.config.ts`. */
 interface FluidWidgetConfig {
+  /** Stable Fluid droplet identifier that owns published package versions. */
   readonly droplet?: string;
 }
 interface LoadedWidgetConfig {

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/commands/build.ts","../src/commands/clone.ts","../src/utils/package-manager.ts","../src/utils/github-template.ts","../src/commands/create.ts","../src/commands/push.ts","../src/commands/dev.ts","../src/commands/link.ts","../src/commands/logs.ts","../src/commands/publish.ts","../src/commands/status.ts","../src/commands/validate.ts","../src/utils/config.ts","../src/utils/source-package.ts","../src/utils/validation.ts","../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/commands/build.ts","../src/commands/clone.ts","../src/utils/package-manager.ts","../src/utils/github-template.ts","../src/commands/create.ts","../src/commands/push.ts","../src/commands/dev.ts","../src/commands/link.ts","../src/commands/logs.ts","../src/commands/publish.ts","../src/commands/status.ts","../src/commands/validate.ts","../src/utils/config.ts","../src/utils/source-package.ts","../src/utils/validation.ts","../src/index.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { i as fluidOsV0WidgetPackageGitCredentialCreate, l as WidgetToolingError, n as loadAndValidateWidgetPackage, r as publishWidgetPackage$1, t as buildWidgetPackage$1 } from "./src-C4sP-_qd.mjs";
+import { i as fluidOsV0WidgetPackageGitCredentialCreate, l as WidgetToolingError, n as loadAndValidateWidgetPackage, r as publishWidgetPackage$1, t as buildWidgetPackage$1 } from "./src-CzqGGQnf.mjs";
 import { Command } from "commander";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
@@ -574,9 +574,9 @@ function isRecord$3(value) {
 }
 //#endregion
 //#region src/utils/template.ts
-const EMBEDDED_PORTAL_SDK_VERSION = "0.1.468";
-const EMBEDDED_CLI_CORE_VERSION = "0.1.14";
-const EMBEDDED_CLI_WIDGET_VERSION = "0.1.34";
+const EMBEDDED_PORTAL_SDK_VERSION = "0.1.475";
+const EMBEDDED_CLI_CORE_VERSION = "0.1.18";
+const EMBEDDED_CLI_WIDGET_VERSION = "0.1.36";
 function getDefaultTemplatePath() {
 	return path.join(findPackageRoot(), "templates", "default");
 }
@@ -615,7 +615,7 @@ async function getWorkspacePackageVersion(packagePathSegments, embeddedVersion,
 		const packageRoot = findPackageRoot();
 		const packagesRoot = path.join(packageRoot, "..", "..");
 		const targetPackageRoot = path.join(packagesRoot, ...packagePathSegments);
-		if (options.local) return `link:${(options.targetPath ? path.relative(options.targetPath, targetPackageRoot) : targetPackageRoot).replace(/\\/g, "/") || "."}`;
+		if (options.local) return getLocalPackageLinkVersion(targetPackageRoot);
 		if (embeddedVersion) return embeddedVersion;
 		const packageJsonPath = path.join(targetPackageRoot, "package.json");
 		const content = await readFile(packageJsonPath, "utf-8");
@@ -627,6 +627,18 @@ async function getWorkspacePackageVersion(packagePathSegments, embeddedVersion,
 		throw new Error(`Could not resolve the exact template package version for ${packagePathSegments.join("/")}`, { cause: error });
 	}
 }
+/**
+* Builds an absolute pnpm link: specifier for local scaffolds.
+*
+* link: keeps the dependency pointed at the workspace package source instead of
+* packing only package.json "files" entries like file: does. That lets Vite's
+* development export resolve the SDK source and its workspace dependencies. An
+* absolute path also remains valid when the operating system canonicalizes the
+* generated project path, such as macOS resolving /tmp to /private/tmp.
+*/
+function getLocalPackageLinkVersion(packagePath) {
+	return `link:${path.resolve(packagePath).replace(/\\/g, "/")}`;
+}
 async function getFiles(dir, baseDir = dir) {
 	const entries = await readdir(dir, { withFileTypes: true });
 	const files = [];
@@ -2430,7 +2442,7 @@ const defaultCreateWidgetProjectDependencies = {
 	installDependencies,
 	tryFetchGithubTemplate
 };
-const createCommand = new Command("create").description("Create a standalone Fluid widget project").argument("<project-name>", "Name of the widget project to create").option("--skip-install", "Create the scaffold only; skip dependency installation").option("-o, --output-dir <dir>", "Directory to create the project in (defaults to cwd)").option("--scope <scope>", "Widget package scope/namespace", DEFAULT_WIDGET_SCOPE).option("--package-version <version>", "Initial widget package version", DEFAULT_WIDGET_PACKAGE_VERSION).option("--local", "Use local monorepo packages via file: links (for development testing)").option("--remote-template", "Use the GitHub starter template instead of the bundled template").option("--droplet <uuid>", "Existing droplet UUID that owns the package").action(async (projectName, options) => {
+const createCommand = new Command("create").description("Create a standalone Fluid widget project").argument("<project-name>", "Name of the widget project to create").option("--skip-install", "Create the scaffold only; skip dependency installation").option("-o, --output-dir <dir>", "Directory to create the project in (defaults to cwd)").option("--scope <scope>", "Widget package scope/namespace", DEFAULT_WIDGET_SCOPE).option("--package-version <version>", "Initial widget package version", DEFAULT_WIDGET_PACKAGE_VERSION).option("--local", "Use local monorepo packages via link: paths (for development testing)").option("--remote-template", "Use the GitHub starter template instead of the bundled template").option("--droplet <uuid>", "Existing droplet UUID that owns the package").action(async (projectName, options) => {
 	try {
 		await createWidgetProject(projectName, options);
 	} catch (err) {
@@ -2458,10 +2470,7 @@ async function createWidgetProject(projectName, options, dependencies = defaultC
 	if (options.remoteTemplate !== true && !await directoryExists(templatePath)) throw new Error("Default widget template not found.");
 	const config = mergeWidgetConfig({}, { droplet });
 	const widgetScope = options.scope ?? DEFAULT_WIDGET_SCOPE;
-	const localOptions = {
-		local: options.local === true,
-		targetPath
-	};
+	const localOptions = { local: options.local === true };
 	const variables = {
 		projectName,
 		droplet: config.droplet,