@fluid-app/fluid-cli-widget 0.1.23 → 0.1.25

package/README.md

@@ -16,7 +16,7 @@ fluid widget status
 fluid widget logs
 ```
 
-- `fluid widget create <project-name>` — scaffold a standalone widget package project.
+- `fluid widget create <project-name>` — scaffold a standalone worker-only widget package from the bundled canonical template. Pass `--remote-template` only to opt into the GitHub mirror, or `--skip-install` for scaffold-only output.
 - `fluid widget link` — link the current project to an existing Droplet and package name.
 - `pnpm dev` — run the generated project's local Remote DOM development endpoints.
 - `fluid widget build` — validate and build runtime artifacts into `.fluid/widget-dist`.

package/dist/index.d.mts

@@ -21,11 +21,8 @@ interface WidgetCreateOptions {
   readonly droplet?: string;
   /** Initial widget package version written into manifest.ts. */
   readonly packageVersion?: string;
-  /**
-  * Skip pulling the GitHub starter template and use the CLI's bundled
-  * template instead. Implied by `--local`. Useful offline or in tests.
-  */
-  readonly skipRemoteTemplate?: boolean;
+  /** Explicitly use the GitHub starter instead of the bundled template. */
+  readonly remoteTemplate?: boolean;
 }
 interface WidgetLinkOptions {
   readonly droplet?: string;
@@ -56,12 +53,39 @@ declare const buildCommand: Command;
 interface CloneCommandOptions {
   readonly droplet?: string;
   readonly dir?: string;
+  readonly skipInstall?: boolean;
 }
 declare const cloneCommand: Command;
 //#endregion
+//#region src/utils/package-manager.d.ts
+declare function installDependencies(cwd: string): Promise<void>;
+//#endregion
+//#region src/utils/github-template.d.ts
+interface GithubTemplateVariables {
+  readonly projectName: string;
+  readonly widgetScope: string;
+  readonly widgetPackageVersion: string;
+}
+/**
+* Clone the GitHub widget template into `targetPath`, strip its git history,
+* and rewrite the baked defaults to the user's values. The repo holds a fully
+* rendered project (no `{{placeholders}}`), so we do targeted, deterministic
+* replacements of the known defaults rather than template interpolation.
+*
+* Returns true on success. Returns false (never throws) when the template
+* couldn't be fetched — git missing, offline, repo unavailable. The caller
+* reports that requested-template failure. The partially-cloned target is
+* cleaned up before returning false.
+*/
+declare function tryFetchGithubTemplate(targetPath: string, variables: GithubTemplateVariables): Promise<boolean>;
+//#endregion
 //#region src/commands/create.d.ts
+interface CreateWidgetProjectDependencies {
+  readonly installDependencies: typeof installDependencies;
+  readonly tryFetchGithubTemplate: typeof tryFetchGithubTemplate;
+}
 declare const createCommand: Command;
-declare function createWidgetProject(projectName: string, options: WidgetCreateOptions): Promise<void>;
+declare function createWidgetProject(projectName: string, options: WidgetCreateOptions, dependencies?: CreateWidgetProjectDependencies): Promise<void>;
 //#endregion
 //#region src/commands/push.d.ts
 interface PushCommandOptions {
@@ -208,5 +232,5 @@ declare function formatValidationErrors(errors: readonly WidgetCliValidationErro
 declare const widgetCommand: Command;
 declare const plugin: FluidPlugin;
 //#endregion
-export { type BuildWidgetOptions, type BuildWidgetPackageOptions, type BuildWidgetPackageResult, type CloneCommandOptions, DEFAULT_WIDGET_DEV_PORT, DEFAULT_WIDGET_OUT_DIR, type FluidWidgetConfig, type LoadedWidgetConfig, type LogsCommandOptions, type PublishCommandOptions, type PublishWidgetPackageDependencies, type PublishWidgetPackageOptions, type PublishWidgetPackageResult, type PushCommandOptions, ROOT_WIDGET_CONFIG_FILE, type StatusCommandOptions, type ValidateWidgetOptions, WIDGET_CONFIG_FILE, WIDGET_DEV_ROUTES, type WidgetCliValidationError, type WidgetCommandOptions, type WidgetCreateOptions, type WidgetDevOptions, type WidgetDevProjectSummary, type WidgetLinkOptions, type WidgetTemplateVariables, WidgetValidationError, type WidgetValidationResult, buildCommand, buildViteDevArgs, buildWidgetPackage, cloneCommand, createCommand, createWidgetProject, plugin as default, devCommand, formatValidationErrors, formatValidationSuccess, formatWidgetConfig, linkCommand, loadWidgetConfig, logsCommand, mergeWidgetConfig, parseWidgetConfigSource, printWidgetDevSummary, publishCommand, publishWidgetPackage, pushCommand, resolveWidgetConfigPath, resolveWidgetDevProject, resolveWidgetSourceConfig, runViteDevServer, statusCommand, validateCommand, validateDropletUuid, validateDropletWidgetProject, widgetCommand, withRootWidgetConfigBridge, writeWidgetConfig };
+export { type BuildWidgetOptions, type BuildWidgetPackageOptions, type BuildWidgetPackageResult, type CloneCommandOptions, type CreateWidgetProjectDependencies, DEFAULT_WIDGET_DEV_PORT, DEFAULT_WIDGET_OUT_DIR, type FluidWidgetConfig, type LoadedWidgetConfig, type LogsCommandOptions, type PublishCommandOptions, type PublishWidgetPackageDependencies, type PublishWidgetPackageOptions, type PublishWidgetPackageResult, type PushCommandOptions, ROOT_WIDGET_CONFIG_FILE, type StatusCommandOptions, type ValidateWidgetOptions, WIDGET_CONFIG_FILE, WIDGET_DEV_ROUTES, type WidgetCliValidationError, type WidgetCommandOptions, type WidgetCreateOptions, type WidgetDevOptions, type WidgetDevProjectSummary, type WidgetLinkOptions, type WidgetTemplateVariables, WidgetValidationError, type WidgetValidationResult, buildCommand, buildViteDevArgs, buildWidgetPackage, cloneCommand, createCommand, createWidgetProject, plugin as default, devCommand, formatValidationErrors, formatValidationSuccess, formatWidgetConfig, linkCommand, loadWidgetConfig, logsCommand, mergeWidgetConfig, parseWidgetConfigSource, printWidgetDevSummary, publishCommand, publishWidgetPackage, pushCommand, resolveWidgetConfigPath, resolveWidgetDevProject, resolveWidgetSourceConfig, runViteDevServer, statusCommand, validateCommand, validateDropletUuid, validateDropletWidgetProject, widgetCommand, withRootWidgetConfigBridge, writeWidgetConfig };
 //# sourceMappingURL=index.d.mts.map

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/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

@@ -1174,7 +1174,7 @@ function writeWidgetMarker(dir, marker) {
 }
 //#endregion
 //#region src/commands/clone.ts
-const cloneCommand = new Command("clone").description("Clone a widget package's git repository (mints a fresh token per call)").argument("<package>", "Widget package key to clone").option("--droplet <uuid>", "Droplet UUID that owns the package (defaults to the company-owned package)").option("--dir <dir>", "Target directory (defaults to ./<package>/)").action((packageKey, options) => runCliAction(async () => {
+const cloneCommand = new Command("clone").description("Clone a widget package's git repository (mints a fresh token per call)").argument("<package>", "Widget package key to clone").option("--droplet <uuid>", "Droplet UUID that owns the package (defaults to the company-owned package)").option("--dir <dir>", "Target directory (defaults to ./<package>/)").option("--skip-install", "Skip dependency installation").action((packageKey, options) => runCliAction(async () => {
 	const trimmedPackage = packageKey.trim();
 	if (!trimmedPackage) throw new Error("A widget package key is required.");
 	const droplet = options.droplet?.trim();
@@ -1219,10 +1219,27 @@ const cloneCommand = new Command("clone").description("Clone a widget package's
 		...droplet ? { droplet } : {}
 	});
 	spinner.succeed(`Cloned into ${chalk.cyan(targetDir)}`);
+	const installCommand = getInstallCommand(targetDir);
+	if (options.skipInstall !== true) {
+		spinner.start(`Installing dependencies with ${installCommand}...`);
+		try {
+			await installDependencies(targetDir);
+			spinner.succeed("Installed dependencies");
+		} catch {
+			spinner.fail("Failed to install dependencies");
+			console.log();
+			console.log(chalk.yellow("You can install dependencies manually:"));
+			console.log(chalk.cyan(`  ${installCommand}`));
+		}
+	}
 	console.log(chalk.dim(`  cd ${path.relative(process.cwd(), targetDir) || "."}`));
+	if (options.skipInstall === true) console.log(chalk.dim(`  ${installCommand}`));
 }));
 //#endregion
 //#region src/utils/template.ts
+const EMBEDDED_PORTAL_SDK_VERSION = "0.1.460";
+const EMBEDDED_CLI_CORE_VERSION = "0.1.14";
+const EMBEDDED_CLI_WIDGET_VERSION = "0.1.25";
 function getDefaultTemplatePath() {
 	return path.join(findPackageRoot(), "templates", "default");
 }
@@ -1245,27 +1262,32 @@ async function copyWidgetTemplate(templatePath, targetPath, variables) {
 	for (const skillFile of await getSharedTemplateSkillFiles()) await writeOutputFiles(targetPath, getOutputFilenames(skillFile.relativePath), skillFile.content);
 }
 async function getPortalSdkVersion(options = {}) {
-	return getWorkspacePackageVersion(["portal", "sdk"], "^0.1.0", options);
+	return getWorkspacePackageVersion(["portal", "sdk"], EMBEDDED_PORTAL_SDK_VERSION, options);
 }
 async function getPortalCoreVersion(options = {}) {
-	return getWorkspacePackageVersion(["portal", "core"], "^0.1.0", options);
+	return getWorkspacePackageVersion(["portal", "core"], void 0, options);
 }
 async function getCliVersion(options = {}) {
-	return getWorkspacePackageVersion(["cli", "core"], "^0.1.0", options);
+	return getWorkspacePackageVersion(["cli", "core"], EMBEDDED_CLI_CORE_VERSION, options);
 }
 async function getWidgetCliVersion(options = {}) {
-	return getWorkspacePackageVersion(["cli", "widget"], "^0.1.0", options);
+	return getWorkspacePackageVersion(["cli", "widget"], EMBEDDED_CLI_WIDGET_VERSION, options);
 }
-async function getWorkspacePackageVersion(packagePathSegments, fallback, options) {
+async function getWorkspacePackageVersion(packagePathSegments, embeddedVersion, options) {
 	try {
 		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, "/") || "."}`;
-		const content = await readFile(path.join(targetPackageRoot, "package.json"), "utf-8");
-		return `^${JSON.parse(content).version ?? fallback.replace(/^\^/, "")}`;
-	} catch {
-		return fallback;
+		if (embeddedVersion) return embeddedVersion;
+		const packageJsonPath = path.join(targetPackageRoot, "package.json");
+		const content = await readFile(packageJsonPath, "utf-8");
+		const pkg = JSON.parse(content);
+		if (typeof pkg.version !== "string") throw new Error(`Missing version in ${packageJsonPath}`);
+		return pkg.version;
+	} catch (error) {
+		if (embeddedVersion) return embeddedVersion;
+		throw new Error(`Could not resolve the exact template package version for ${packagePathSegments.join("/")}`, { cause: error });
 	}
 }
 async function getFiles(dir, baseDir = dir) {
@@ -1370,8 +1392,8 @@ const TEMPLATE_DEFAULTS = {
 * replacements of the known defaults rather than template interpolation.
 *
 * Returns true on success. Returns false (never throws) when the template
-* couldn't be fetched — git missing, offline, repo unavailable — so `create`
-* can fall back to the bundled template. The partially-cloned target is
+* couldn't be fetched — git missing, offline, repo unavailable. The caller
+* reports that requested-template failure. The partially-cloned target is
 * cleaned up before returning false.
 */
 async function tryFetchGithubTemplate(targetPath, variables) {
@@ -1439,7 +1461,11 @@ async function replaceInFile(filePath, replacements) {
 //#region src/commands/create.ts
 const DEFAULT_WIDGET_PACKAGE_VERSION = "0.1.0";
 const DEFAULT_WIDGET_SCOPE = "droplet";
-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", "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("--skip-remote-template", "Use the bundled template instead of pulling the GitHub starter template").option("--droplet <uuid>", "Existing droplet UUID that owns the package").action(async (projectName, options) => {
+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) => {
 	try {
 		await createWidgetProject(projectName, options);
 	} catch (err) {
@@ -1449,7 +1475,7 @@ const createCommand = new Command("create").description("Create a standalone Flu
 		process.exit(1);
 	}
 });
-async function createWidgetProject(projectName, options) {
+async function createWidgetProject(projectName, options, dependencies = defaultCreateWidgetProjectDependencies) {
 	console.log();
 	console.log(chalk.bold("Creating a new Fluid widget project"));
 	console.log();
@@ -1464,7 +1490,7 @@ async function createWidgetProject(projectName, options) {
 	const targetPath = path.join(outputDir, projectName);
 	if (await directoryExists(targetPath)) throw new Error(`Directory already exists: ${targetPath}`);
 	const templatePath = getDefaultTemplatePath();
-	if (!await directoryExists(templatePath)) throw new Error("Default widget template not found.");
+	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 = {
@@ -1481,17 +1507,21 @@ async function createWidgetProject(projectName, options) {
 		fluidCliVersion: await getCliVersion(localOptions),
 		widgetCliVersion: await getWidgetCliVersion(localOptions)
 	};
-	const useRemoteTemplate = options.local !== true && options.skipRemoteTemplate !== true;
+	if (options.local === true && options.remoteTemplate === true) throw new Error("--remote-template cannot be combined with --local");
+	const useRemoteTemplate = options.remoteTemplate === true;
 	let scaffolded = false;
 	if (useRemoteTemplate) {
 		const remoteSpinner = ora("Fetching widget template from GitHub...").start();
-		scaffolded = await tryFetchGithubTemplate(targetPath, {
+		scaffolded = await dependencies.tryFetchGithubTemplate(targetPath, {
 			projectName,
 			widgetScope,
 			widgetPackageVersion: options.packageVersion ?? DEFAULT_WIDGET_PACKAGE_VERSION
 		});
 		if (scaffolded) remoteSpinner.succeed("Fetched widget template from GitHub");
-		else remoteSpinner.warn("Couldn't fetch the GitHub template (git, network, or repo unavailable) — using the bundled template.");
+		else {
+			remoteSpinner.fail("Failed to fetch the GitHub widget template");
+			throw new Error("Couldn't fetch the requested GitHub template. Remove --remote-template to use the bundled template.");
+		}
 	}
 	const spinner = ora(scaffolded ? "Finalizing widget project..." : "Copying widget template...").start();
 	try {
@@ -1506,17 +1536,23 @@ async function createWidgetProject(projectName, options) {
 	if (options.skipInstall !== true) {
 		spinner.start(`Installing dependencies with ${installCommand}...`);
 		try {
-			await installDependencies(targetPath);
+			await dependencies.installDependencies(targetPath);
 			spinner.succeed("Installed dependencies");
-		} catch {
+		} catch (error) {
 			spinner.fail("Failed to install dependencies");
 			console.log();
-			console.log(chalk.yellow("You can install dependencies manually:"));
+			console.log(chalk.yellow(`The scaffold was retained at ${targetPath}.`));
+			console.log(chalk.yellow("Install dependencies manually to continue:"));
 			console.log(chalk.cyan(`  cd ${formatCdPath(targetPath)}`));
 			console.log(chalk.cyan(`  ${installCommand}`));
+			throw error;
 		}
 	}
 	console.log();
+	if (options.skipInstall === true) {
+		console.log(chalk.yellow("Scaffold only: dependencies were not installed and must be installed before development."));
+		console.log();
+	}
 	console.log(chalk.green.bold("Success!") + ` Created ${chalk.cyan(projectName)}`);
 	console.log();
 	console.log("Next steps:");
@@ -1591,8 +1627,16 @@ function printWidgetDevSummary(summary) {
 	console.log();
 }
 async function runViteDevServer(projectDir, options = {}) {
-	const viteCliPath = resolveViteCliPath(projectDir);
-	if (!viteCliPath) throw new Error("Unable to find Vite in node_modules. Run your package manager install command before starting widget dev.");
+	let viteCliPath = resolveViteCliPath(projectDir);
+	if (!viteCliPath) {
+		const installCommand = getInstallCommand(projectDir);
+		console.log(chalk.yellow(`Vite is not installed yet — running ${installCommand} first...`));
+		try {
+			await installDependencies(projectDir);
+		} catch {}
+		viteCliPath = resolveViteCliPath(projectDir);
+	}
+	if (!viteCliPath) throw new Error(`Unable to find Vite in node_modules. Run \`${getInstallCommand(projectDir)}\` in ${projectDir}, then retry.`);
 	await runNodeScript(viteCliPath, buildViteDevArgs(options), projectDir);
 }
 function resolveViteCliPath(projectDir) {