@forgerock/login-framework-cli 0.0.0-beta-20260527205941 → 0.0.0-beta-20260527211328

package/README.md

@@ -35,10 +35,10 @@ pnpm dev
 
 **Options**
 
-| Flag              | Description                                                                                                            |
-| ----------------- | ---------------------------------------------------------------------------------------------------------------------- |
-| `--version <tag>` | Download a specific release (e.g. `v1.2.0`). Defaults to latest.                                                       |
-| `--local <path>`  | Use a local framework directory instead of downloading from GitHub. Useful for development or air-gapped environments. |
+| Flag             | Description                                                                                                            |
+| ---------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `--tag <tag>`    | Download a specific release tag (e.g. `v1.2.0`). Defaults to latest.                                                   |
+| `--local <path>` | Use a local framework directory instead of downloading from GitHub. Useful for development or air-gapped environments. |
 
 **What it does**
 
@@ -47,9 +47,9 @@ pnpm dev
 3. Writes a minimal `pnpm-workspace.yaml`
 4. Creates `experimental/custom/callbacks/` and `experimental/custom/stages/` with `.gitkeep` placeholders
 5. Copies the component authoring guide to `experimental/custom/README.md`
-6. Seeds an empty `core/journey/_utilities/custom-registry.ts`
-7. Injects the custom registry Vite plugin into widget and app configs
-8. Writes `.generator-version` to track the framework version in use
+6. Writes `.generator-version` to track the framework version in use
+
+The `core/journey/_utilities/registry/custom-registry.ts` file is generated by the framework's Vite plugin on the first `pnpm dev` or `pnpm build:widget` — the CLI never touches it.
 
 ---
 
@@ -57,7 +57,7 @@ pnpm dev
 
 ### `ping-lf generate stage <Name>`
 
-Scaffolds a new custom component under `experimental/custom/callbacks/<slug>/` or `experimental/custom/stages/<slug>/`, then regenerates `custom-registry.ts`.
+Scaffolds a new custom component under `experimental/custom/callbacks/<slug>/` or `experimental/custom/stages/<slug>/`. The Vite plugin watches these directories during `pnpm dev` and regenerates `custom-registry.ts` automatically on add/remove/change.
 
 Run from the root of an initialized project.
 
@@ -81,7 +81,7 @@ experimental/custom/callbacks/name-callback/
 └── name-callback.utilities.test.ts  # unit test stub
 ```
 
-The `@component` header in the generated `.svelte` file declares the type and name. The pre-build script and `ping-lf` both read this header to register the component:
+The `@component` header in the generated `.svelte` file declares the type and name. The framework's Vite plugin reads this header to register the component:
 
 ```svelte
 <!--
@@ -99,13 +99,13 @@ See `experimental/custom/README.md` for the full prop contract.
 
 ### `ping-lf update`
 
-Fetches the latest (or a specified) framework version and overwrites the core framework files while **preserving** `experimental/custom/` and project-level configs. Regenerates the component registry after the update.
+Fetches the latest (or a specified) framework version and overwrites the core framework files while **preserving** `experimental/custom/` and project-level configs. The component registry is regenerated by the Vite plugin on the next build or dev-server start.
 
 Run from the root of an initialized project.
 
 ```sh
 ping-lf update                     # update to latest
-ping-lf update --version v1.5.0    # pin to a specific version
+ping-lf update --tag v1.5.0        # pin to a specific release tag
 ping-lf update --local ../framework # use a local directory
 ```
 
@@ -139,32 +139,45 @@ my-login-project/
 
 ## Development
 
-> **All commands below must be run from the `tools/cli/` directory.**
+The CLI is a workspace package inside the framework monorepo, but it is **not** declared as a dependency of any other workspace. This is intentional: customer-generated projects must not carry a `workspace:*` link to this CLI, because that protocol only resolves inside this monorepo. The trade-off is that after a fresh clone, `ping-lf` is not on your `$PATH` until you set it up.
 
-```sh
-cd tools/cli
+### Recommended setup (once per machine)
 
-# Install dependencies
-pnpm install
+From the repo root, after `pnpm install`:
 
-# Build the CLI
-pnpm build
+```sh
+pnpm --filter @forgerock/login-framework-cli build
+pnpm --filter @forgerock/login-framework-cli link --global
+```
 
-# Run tests
-pnpm test
+`pnpm link --global` symlinks the CLI's `bin` (`tools/cli/dist/src/main.js`) into your machine's global pnpm bin directory, pointing back at this repo's `dist/`. After this, `ping-lf` works as a real command from anywhere:
 
-# Watch mode (rebuild on file changes)
-pnpm dev
+```sh
+ping-lf init my-project
+ping-lf generate callback MyCallback
+ping-lf update --tag v1.5.0
 ```
 
-### Running locally without installing globally
+Rebuilds (`pnpm --filter @forgerock/login-framework-cli build`) update the global binary automatically — no relink needed.
+
+To remove the global link later: `pnpm --filter @forgerock/login-framework-cli unlink --global`.
+
+### Without the global link
+
+If you'd rather not link globally, invoke the built binary directly. You still need to build first:
 
 ```sh
-# From tools/cli/ after pnpm build:
-node dist/main.js init my-project
+pnpm --filter @forgerock/login-framework-cli build
+./tools/cli/dist/src/main.js init my-project
+# or:
+pnpm --filter @forgerock/login-framework-cli exec ping-lf init my-project
+```
+
+### Other useful commands
 
-# Or from anywhere using the full path:
-node /path/to/forgerock-web-login-framework/tools/cli/dist/main.js init my-project
+```sh
+pnpm --filter @forgerock/login-framework-cli test          # run unit tests
+pnpm --filter @forgerock/login-framework-cli run dev       # tsc --watch
 ```
 
 ### Project structure
@@ -180,7 +193,6 @@ tools/cli/
 │   │   └── update.ts             # ping-lf update
 │   ├── services/
 │   │   ├── file-system.ts        # copyWithExclusions
-│   │   ├── registry.ts           # component scanning + registry generation
 │   │   ├── release.ts            # GitHub release fetch
 │   │   └── vite-config.ts        # Vite plugin injection
 │   └── config/

package/dist/src/commands/generate.d.ts

@@ -19,7 +19,7 @@ export declare const StageNameSchema: Schema.transform<Schema.filter<typeof Sche
     name: typeof Schema.String;
     slug: typeof Schema.String;
 }>>;
-export declare const generateCommand: Command.Command<"generate", FileSystem.FileSystem | Path.Path | import("@effect/platform/Terminal").Terminal, import("../errors.js").GeneratorVersionError | import("../errors.js").RegistryScanError | InvalidComponentNameError | ComponentAlreadyExistsError | import("@effect/platform/Error").PlatformError | import("@effect/platform/Terminal").QuitException, {
+export declare const generateCommand: Command.Command<"generate", FileSystem.FileSystem | Path.Path | import("@effect/platform/Terminal").Terminal, import("../errors.js").GeneratorVersionError | InvalidComponentNameError | ComponentAlreadyExistsError | import("@effect/platform/Error").PlatformError | import("@effect/platform/Terminal").QuitException, {
     readonly subcommand: import("effect/Option").Option<{
         readonly name: string;
     } | {

package/dist/src/commands/generate.js

@@ -5,7 +5,7 @@ import nodePath from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { assertValidProject } from '../config/version.js';
 import { ComponentAlreadyExistsError, InvalidComponentNameError } from '../errors.js';
-import { runRegistryScript } from '../services/registry.js';
+import { toPascalCase } from '../utils.js';
 const CUSTOM_DIR = 'experimental/custom';
 /**
  * Converts a PascalCase name to a kebab-case slug.
@@ -85,28 +85,31 @@ function scaffoldComponent(type, name) {
         // ── Create component directory ─────────────────────────────────────────
         yield* fs.makeDirectory(componentDir, { recursive: true });
         // ── Copy and process template files ───────────────────────────────────
-        // Each file name contains __COMPONENT_SLUG__; its contents contain both
-        // __COMPONENT_NAME__ (PascalCase) and __COMPONENT_SLUG__ (kebab-case).
+        // Each file name contains __COMPONENT_SLUG__; its contents use:
+        //   __COMPONENT_NAME__        — raw display name (may contain spaces, e.g. "My Login Stage")
+        //   __COMPONENT_NAME_PASCAL__ — PascalCase identifier derived from slug (e.g. "MyLoginStage"),
+        //                               safe for use in TypeScript symbol positions (function names etc.)
+        //   __COMPONENT_SLUG__        — kebab-case slug (e.g. "my-login-stage")
+        const pascalName = toPascalCase(name);
         const templateFiles = yield* fs.readDirectory(templatesDir);
         const createdFiles = [];
         for (const templateFile of templateFiles) {
             const targetFileName = templateFile.replaceAll('__COMPONENT_SLUG__', slug);
             const sourceContent = yield* fs.readFileString(p.join(templatesDir, templateFile));
             const processedContent = sourceContent
+                .replaceAll('__COMPONENT_NAME_PASCAL__', pascalName)
                 .replaceAll('__COMPONENT_NAME__', name)
                 .replaceAll('__COMPONENT_SLUG__', slug);
             const targetPath = p.join(componentDir, targetFileName);
             yield* fs.writeFileString(targetPath, processedContent);
             createdFiles.push(targetPath);
         }
-        // ── Regenerate custom-registry.ts ────────────────────────────────────
-        yield* Console.log('Regenerating custom component registry...');
-        yield* runRegistryScript(cwd);
         // ── Print summary ──────────────────────────────────────────────────────
         yield* Console.log(`Done. ${type} component scaffolded successfully.\n\n` +
             `Files created:\n` +
-            createdFiles.map((f) => `  ${f}`).join('\n') +
-            `\n\nNext: open ${p.join(componentDir, `${slug}.svelte`)} and implement your component.\n`);
+            createdFiles.map((createdPath) => `  ${createdPath}`).join('\n') +
+            `\n\nNext: open ${p.join(componentDir, `${slug}.svelte`)} and implement your component.\n` +
+            `If a dev server is running, the registry will pick up the new component automatically.\n`);
     });
 }
 // ── Subcommands ──────────────────────────────────────────────────────────────

package/dist/src/commands/init.d.ts

@@ -1,8 +1,8 @@
 import { Command } from '@effect/cli';
 import { FileSystem, Path } from '@effect/platform';
 import { DirectoryConflictError, DirectoryNotEmptyError } from '../errors.js';
-export declare const initCommand: Command.Command<"init", FileSystem.FileSystem | Path.Path | import("../services/release.js").Release, import("../errors.js").InvalidVersionError | import("../errors.js").ReleaseNetworkError | import("../errors.js").ReleaseParseError | import("../errors.js").ReleaseFsError | import("../errors.js").FileSystemError | import("../errors.js").RegistryScanError | DirectoryConflictError | DirectoryNotEmptyError | import("@effect/platform/Error").PlatformError, {
+export declare const initCommand: Command.Command<"init", FileSystem.FileSystem | Path.Path | import("../services/release.js").Release, import("../errors.js").InvalidVersionError | import("../errors.js").ReleaseNetworkError | import("../errors.js").ReleaseParseError | import("../errors.js").ReleaseFsError | import("../errors.js").FileSystemError | DirectoryConflictError | DirectoryNotEmptyError | import("@effect/platform/Error").PlatformError, {
     readonly directory: string;
     readonly local: import("effect/Option").Option<string>;
-    readonly version: import("effect/Option").Option<string>;
+    readonly tag: import("effect/Option").Option<string>;
 }>;

package/dist/src/commands/init.js

@@ -4,12 +4,9 @@ import { Console, Effect } from 'effect';
 import { writeVersion } from '../config/version.js';
 import { DirectoryConflictError, DirectoryNotEmptyError } from '../errors.js';
 import { copyWithExclusions, expandTilde, isFrameworkDirectory } from '../services/file-system.js';
-import { runRegistryScript } from '../services/registry.js';
 import { resolveSource } from './source.js';
 /**
  * Minimal pnpm-workspace.yaml written to the customer project.
- * Intentionally omits `tools/` — that workspace entry exists only in the
- * upstream monorepo and is not needed (or valid) in a customer project.
  */
 const PNPM_WORKSPACE = `packages:
   - 'packages/*'
@@ -34,8 +31,8 @@ Read the authoring guide: experimental/custom/README.md
 export const initCommand = Command.make('init', {
     directory: Args.text({ name: 'directory' }).pipe(Args.withDescription('Directory to initialize the project in. Use "./" for the current directory.')),
     local: Options.optional(Options.text('local').pipe(Options.withDescription('Path to a local framework directory. If omitted, the main branch is downloaded from GitHub.'))),
-    version: Options.optional(Options.text('version').pipe(Options.withDescription('Framework version tag to download (e.g. v1.2.0). If omitted, the main branch is used.'))),
-}, ({ directory, local, version }) => Effect.gen(function* () {
+    tag: Options.optional(Options.text('tag').pipe(Options.withDescription('Framework release tag to download (e.g. v1.2.0). If omitted, the main branch is used.'))),
+}, ({ directory, local, tag }) => Effect.gen(function* () {
     const fs = yield* FileSystem.FileSystem;
     const path = yield* Path.Path;
     const resolvedDir = path.resolve(expandTilde(directory));
@@ -58,7 +55,7 @@ export const initCommand = Command.make('init', {
     // Effect.scoped closes the Scope that release.fetch opens, triggering
     // automatic removal of the .framework-tmp directory after copying.
     const resolvedVersion = yield* Effect.scoped(Effect.gen(function* () {
-        const { sourceDir, resolvedVersion } = yield* resolveSource(local, version, resolvedDir);
+        const { sourceDir, resolvedVersion } = yield* resolveSource(local, tag, resolvedDir);
         // ── 2. Create target directory + copy framework (with exclusions) ──
         yield* Console.log('Copying framework files...');
         yield* fs.makeDirectory(resolvedDir, { recursive: true });
@@ -78,18 +75,11 @@ export const initCommand = Command.make('init', {
         yield* fs.makeDirectory(customDir, { recursive: true });
         yield* fs.writeFileString(path.join(customDir, '.gitkeep'), '');
     }), { concurrency: 'unbounded', discard: true });
-    // ── 5. Generate custom-registry.ts ────────────────────────────────────
-    // Run the canonical registry script so the file is immediately present
-    // with the correct CustomRegistryEntry format. The empty callbacks/ and
-    // stages/ dirs produce empty registries — no custom components yet.
-    yield* Console.log('Generating custom component registry...');
-    yield* runRegistryScript(resolvedDir);
-    // ── 6. Write .generator-version ────────────────────────────────────────
+    // ── 5. Write .generator-version ────────────────────────────────────────
     yield* writeVersion(resolvedDir, {
         version: resolvedVersion,
-        commitHash: '',
         generatedAt: new Date().toISOString(),
     });
-    // ── 7. Print next steps ───────────────────────────────────────────────
+    // ── 6. Print next steps ───────────────────────────────────────────────
     yield* Console.log(nextStepsMessage(directory));
 })).pipe(Command.withDescription('Bootstrap a new Ping Login Widget or Login App project from a GitHub release or a local framework path.'));

package/dist/src/commands/update.d.ts

@@ -1,5 +1,5 @@
 import { Command } from '@effect/cli';
-export declare const updateCommand: Command.Command<"update", import("@effect/platform/FileSystem").FileSystem | import("@effect/platform/Path").Path | import("../services/release.js").Release, import("../errors.js").InvalidVersionError | import("../errors.js").ReleaseNetworkError | import("../errors.js").ReleaseParseError | import("../errors.js").ReleaseFsError | import("../errors.js").FileSystemError | import("../errors.js").GeneratorVersionError | import("../errors.js").RegistryScanError | import("@effect/platform/Error").PlatformError, {
+export declare const updateCommand: Command.Command<"update", import("@effect/platform/FileSystem").FileSystem | import("@effect/platform/Path").Path | import("../services/release.js").Release, import("../errors.js").InvalidVersionError | import("../errors.js").ReleaseNetworkError | import("../errors.js").ReleaseParseError | import("../errors.js").ReleaseFsError | import("../errors.js").FileSystemError | import("../errors.js").GeneratorVersionError | import("@effect/platform/Error").PlatformError, {
     readonly local: import("effect/Option").Option<string>;
-    readonly version: import("effect/Option").Option<string>;
+    readonly tag: import("effect/Option").Option<string>;
 }>;

package/dist/src/commands/update.js

@@ -2,12 +2,11 @@ import { Command, Options } from '@effect/cli';
 import { Console, Effect } from 'effect';
 import { assertValidProject, writeVersion } from '../config/version.js';
 import { copyWithExclusions } from '../services/file-system.js';
-import { runRegistryScript } from '../services/registry.js';
 import { resolveSource } from './source.js';
 export const updateCommand = Command.make('update', {
     local: Options.optional(Options.text('local').pipe(Options.withDescription('Path to a local framework directory. If omitted, the main branch is downloaded from GitHub.'))),
-    version: Options.optional(Options.text('version').pipe(Options.withDescription('Framework version tag to update to (e.g. v1.2.0). If omitted, the main branch is used.'))),
-}, ({ local, version }) => Effect.gen(function* () {
+    tag: Options.optional(Options.text('tag').pipe(Options.withDescription('Framework release tag to update to (e.g. v1.2.0). If omitted, the main branch is used.'))),
+}, ({ local, tag }) => Effect.gen(function* () {
     const cwd = process.cwd();
     // ── 1. Verify this is an initialized project ──────────────────────────
     const currentVersion = yield* assertValidProject(cwd);
@@ -16,21 +15,16 @@ export const updateCommand = Command.make('update', {
     // Effect.scoped closes the Scope that release.fetch opens, triggering
     // automatic removal of the .framework-tmp directory after copying.
     const resolvedVersion = yield* Effect.scoped(Effect.gen(function* () {
-        const { sourceDir, resolvedVersion } = yield* resolveSource(local, version, cwd);
+        const { sourceDir, resolvedVersion } = yield* resolveSource(local, tag, cwd);
         yield* Console.log('Copying updated framework files...');
         yield* copyWithExclusions(sourceDir, cwd);
         return resolvedVersion;
     }));
-    // ── 3. Regenerate custom-registry.ts ──────────────────────────────────
-    yield* Console.log('Regenerating custom component registry...');
-    yield* runRegistryScript(cwd);
-    // ── 4. Update .generator-version ──────────────────────────────────────
+    // ── 3. Update .generator-version ──────────────────────────────────────
     yield* writeVersion(cwd, {
         version: resolvedVersion,
-        commitHash: '',
         generatedAt: new Date().toISOString(),
     });
     yield* Console.log(`\nDone. Updated from ${currentVersion.version} to ${resolvedVersion}.\n` +
-        'Custom component registry regenerated.\n' +
         'Run "pnpm install" if package dependencies changed.\n');
 })).pipe(Command.withDescription('Fetch the latest (or a specified) framework version and overwrite core files while preserving experimental/custom/.'));

package/dist/src/config/version.d.ts

@@ -3,13 +3,11 @@ import { Effect, Schema } from 'effect';
 import { GeneratorVersionError } from '../errors.js';
 declare const GeneratorVersionSchema: Schema.Struct<{
     version: typeof Schema.String;
-    commitHash: typeof Schema.String;
     generatedAt: typeof Schema.String;
 }>;
 export type GeneratorVersion = typeof GeneratorVersionSchema.Type;
 export declare const readVersion: (directory: string) => Effect.Effect<{
     readonly version: string;
-    readonly commitHash: string;
     readonly generatedAt: string;
 }, GeneratorVersionError | import("@effect/platform/Error").PlatformError, FileSystem.FileSystem>;
 export declare const writeVersion: (directory: string, version: GeneratorVersion) => Effect.Effect<void, import("@effect/platform/Error").PlatformError, FileSystem.FileSystem>;
@@ -20,7 +18,6 @@ export declare const writeVersion: (directory: string, version: GeneratorVersion
  */
 export declare const assertValidProject: (directory: string) => Effect.Effect<{
     readonly version: string;
-    readonly commitHash: string;
     readonly generatedAt: string;
 }, GeneratorVersionError | import("@effect/platform/Error").PlatformError, FileSystem.FileSystem>;
 export {};

package/dist/src/config/version.js

@@ -3,7 +3,6 @@ import { Console, Effect, Schema } from 'effect';
 import { GeneratorVersionError } from '../errors.js';
 const GeneratorVersionSchema = Schema.Struct({
     version: Schema.String,
-    commitHash: Schema.String,
     generatedAt: Schema.String,
 });
 const VERSION_FILE = '.generator-version';

package/dist/src/errors.d.ts

@@ -51,14 +51,6 @@ export declare class GeneratorVersionError extends GeneratorVersionError_base<{
     readonly path?: string;
 }> {
 }
-declare const RegistryScanError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
-    readonly _tag: "RegistryScanError";
-} & Readonly<A>;
-export declare class RegistryScanError extends RegistryScanError_base<{
-    readonly directory: string;
-    readonly cause?: unknown;
-}> {
-}
 declare const DirectoryConflictError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "DirectoryConflictError";
 } & Readonly<A>;

package/dist/src/errors.js

@@ -13,8 +13,6 @@ export class FileSystemError extends Data.TaggedError('FileSystemError') {
 }
 export class GeneratorVersionError extends Data.TaggedError('GeneratorVersionError') {
 }
-export class RegistryScanError extends Data.TaggedError('RegistryScanError') {
-}
 export class DirectoryConflictError extends Data.TaggedError('DirectoryConflictError') {
 }
 export class DirectoryNotEmptyError extends Data.TaggedError('DirectoryNotEmptyError') {

package/dist/src/main.js

@@ -10,7 +10,7 @@ import { updateCommand } from './commands/update.js';
 import { GithubReleaseLayer } from './services/release.js';
 // Read the version from package.json at runtime so it stays in sync
 // with the published package version after changesets bumps it.
-const { version } = createRequire(import.meta.url)('../package.json');
+const { version } = createRequire(import.meta.url)('../../package.json');
 const rootCommand = Command.make('ping-lf').pipe(Command.withDescription('CLI for initializing, scaffolding, and updating Ping Login Widget and Login App custom component projects.'), Command.withSubcommands([initCommand, generateCommand, updateCommand, releasesCommand]));
 const cli = Command.run(rootCommand, {
     name: 'ping-lf',
@@ -23,7 +23,7 @@ cli(process.argv).pipe(Effect.catchTag('DirectoryConflictError', (err) => Consol
     `  ${err.cause}\n\n` +
     `  • Check your network connection and try again.\n` +
     `  • Use a local path:   ping-lf init <dir> --local <path>\n` +
-    `  • Specify a version:  ping-lf init <dir> --version v1.0.0\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('ReleaseParseError', (err) => Console.error(`\nError: Failed to parse the release data.\n  ${err.cause}\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('ReleaseFsError', (err) => Console.error(`\nError: Filesystem error during release download (${err.operation}).\n  ${err.cause}\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('InvalidVersionError', (err) => Console.error(`\nError: "${err.version}" is not a valid version tag.\n` +
+    `  • Specify a tag:      ping-lf init <dir> --tag v1.0.0\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('ReleaseParseError', (err) => Console.error(`\nError: Failed to parse the release data.\n  ${err.cause}\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('ReleaseFsError', (err) => Console.error(`\nError: Filesystem error during release download (${err.operation}).\n  ${err.cause}\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('InvalidVersionError', (err) => Console.error(`\nError: "${err.version}" is not a valid version tag.\n` +
     `  Expected semver format like v1.0.0.\n` +
     `  Use "ping-lf releases" to list available versions.\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('ReleaseNotFoundError', (err) => Console.error(`\nError: No releases found on GitHub.` +
     (err.cause ? `\n  ${err.cause}` : '') +

package/dist/src/templates/callback/__COMPONENT_SLUG__.mock.ts

@@ -0,0 +1,22 @@
+/**
+ * Mock journey step for the __COMPONENT_NAME__ callback's Storybook stories.
+ *
+ * Replace the placeholder `type`, `output`, and `input` fields with the real
+ * AM payload your callback consumes. The shape mirrors what AM sends back from
+ * an authentication tree.
+ */
+
+import { createJourneyStep } from '$login-framework';
+
+export default createJourneyStep({
+  authId: 'test-auth-id',
+  callbacks: [
+    {
+      type: 'NameCallback',
+      output: [{ name: 'prompt', value: '__COMPONENT_NAME__ prompt' }],
+      input: [{ name: 'IDToken1', value: '' }],
+      _id: 0,
+    },
+  ],
+  stage: 'DefaultLogin',
+});

package/dist/src/templates/callback/__COMPONENT_SLUG__.stories.js

@@ -0,0 +1,28 @@
+/**
+ * Storybook stories for the __COMPONENT_NAME__ callback.
+ *
+ * Update the `getCallback` helper if your mock contains more than one callback,
+ * or add additional stories for variants (loading, error, prefilled, etc.).
+ */
+
+import step from './__COMPONENT_SLUG__.mock';
+import Story from './__COMPONENT_SLUG__.story.svelte';
+
+export default {
+  argTypes: {
+    callback: { control: false },
+  },
+  component: Story,
+  parameters: {
+    layout: 'fullscreen',
+  },
+  title: 'Custom/Callback/__COMPONENT_NAME__',
+};
+
+const getCallback = () => step.callbacks[0];
+
+export const Base = {
+  args: {
+    callback: getCallback(),
+  },
+};

package/dist/src/templates/callback/__COMPONENT_SLUG__.story.svelte

@@ -0,0 +1,59 @@
+<!--
+  Story wrapper for the __COMPONENT_NAME__ callback. Mounts the component
+  with default metadata so it can render in isolation inside Storybook.
+-->
+
+<script lang="ts">
+  import {
+    type BaseCallback,
+    type CallbackMetadata,
+    Centered,
+    type Maybe,
+    type SelfSubmitFunction,
+    type StepMetadata,
+    type StyleObject,
+  } from '$login-framework';
+  import __COMPONENT_NAME_PASCAL__ from './__COMPONENT_SLUG__.svelte';
+
+  export let callback: BaseCallback;
+  export let callbackMetadata: Maybe<CallbackMetadata> = undefined;
+  export let style: StyleObject = {};
+  export let selfSubmitFunction: Maybe<SelfSubmitFunction> = null;
+  export let stepMetadata: Maybe<StepMetadata> = null;
+
+  const defaultCallbackMetadata: CallbackMetadata = {
+    derived: {
+      canForceUserInputOptionality: false,
+      isFirstInvalidInput: false,
+      isReadyForSubmission: false,
+      isSelfSubmitting: false,
+      isUserInputRequired: true,
+      isPasskeyAutofillEligible: false,
+    },
+    idx: 0,
+  };
+
+  const defaultStepMetadata: StepMetadata = {
+    derived: {
+      isStepSelfSubmittable: () => false,
+      isUserInputOptional: false,
+      numOfCallbacks: 1,
+      numOfSelfSubmittableCbs: 0,
+      numOfUserInputCbs: 1,
+    },
+  };
+
+  $: mergedCallbackMetadata = { ...defaultCallbackMetadata, ...callbackMetadata };
+  $: mergedStepMetadata = stepMetadata ?? defaultStepMetadata;
+</script>
+
+<Centered>
+  <svelte:component
+    this={__COMPONENT_NAME_PASCAL__}
+    {callback}
+    callbackMetadata={mergedCallbackMetadata}
+    {style}
+    {selfSubmitFunction}
+    stepMetadata={mergedStepMetadata}
+  />
+</Centered>

package/dist/src/templates/callback/__COMPONENT_SLUG__.svelte

@@ -7,46 +7,20 @@ Custom callback component. Replace this description with your own.
 -->
 
 <script lang="ts">
-  import type { FRCallback } from '@forgerock/javascript-sdk';
-  import type { z } from 'zod';
-
-  import type { Maybe } from '$core/interfaces';
-  import type { styleSchema } from '$core/style.store';
-  import type {
-    CallbackMetadata,
-    SelfSubmitFunction,
-    StepMetadata,
-  } from '$journey/journey.interfaces';
+  import type { BaseCallback } from '@forgerock/journey-client/types';
 
   /**
-   * The AM callback instance for this component. Use `callback.getInputValue()`
+   * The callback instance for this component. Use `callback.getInputValue()`
    * and `callback.setInputValue()` to read/write values sent back to the server.
    */
-  export let callback: FRCallback;
-
-  /**
-   * Optional function to trigger self-submission (e.g. after an async action).
-   * Set to `null` when the callback does not need to submit the form itself.
-   */
-  export const selfSubmitFunction: Maybe<SelfSubmitFunction> = null;
-
-  /**
-   * Metadata about the current step (page node) — includes stage name,
-   * header/description overrides, and derived helpers like `isStepSelfSubmittable()`.
-   */
-  export const stepMetadata: Maybe<StepMetadata> = null;
-
-  /**
-   * Per-callback metadata from the step — may include policies, failed policies,
-   * and other AM-provided hints for rendering.
-   */
-  export const callbackMetadata: Maybe<CallbackMetadata> = null;
-
-  /**
-   * The widget's resolved style configuration (colors, logos, labels, etc.).
-   * Use this to keep your custom callback visually consistent with the theme.
-   */
-  export const style: z.infer<typeof styleSchema> = {};
+  export let callback: BaseCallback;
+
+  // Optionally declare any of these if your component needs them:
+  // import type { CallbackMetadata, Maybe, SelfSubmitFunction, StepMetadata, StyleObject } from '$login-framework';
+  // export let selfSubmitFunction: Maybe<SelfSubmitFunction> = null;
+  // export let stepMetadata: Maybe<StepMetadata> = null;
+  // export let callbackMetadata: Maybe<CallbackMetadata> = null;
+  // export let style: StyleObject = {};
 
   // Suppress the "unused export" warning — remove `void` once you use `callback`.
   void callback;

package/dist/src/templates/callback/__COMPONENT_SLUG__.utilities.test.ts

@@ -1,9 +1,9 @@
 import { describe, expect, it } from 'vitest';
 
-import { format__COMPONENT_NAME__Label } from './__COMPONENT_SLUG__.utilities.js';
+import { format__COMPONENT_NAME_PASCAL__Label } from './__COMPONENT_SLUG__.utilities.js';
 
 describe('__COMPONENT_NAME__ utilities', () => {
   it('trims whitespace from label', () => {
-    expect(format__COMPONENT_NAME__Label('  hello  ')).toBe('hello');
+    expect(format__COMPONENT_NAME_PASCAL__Label('  hello  ')).toBe('hello');
   });
 });

package/dist/src/templates/callback/__COMPONENT_SLUG__.utilities.ts

@@ -8,6 +8,6 @@
 /**
  * Example utility — replace with your own helpers.
  */
-export function format__COMPONENT_NAME__Label(value: string): string {
+export function format__COMPONENT_NAME_PASCAL__Label(value: string): string {
   return value.trim();
 }

package/dist/src/templates/stage/__COMPONENT_SLUG__.mock.ts

@@ -0,0 +1,23 @@
+/**
+ * Mock journey step for the __COMPONENT_NAME__ stage's Storybook stories.
+ *
+ * A stage receives a full JourneyStep with one or more callbacks. Replace the
+ * placeholder callback entries below with the real shape AM sends for the
+ * page node this stage renders. Add more callbacks if your stage composes
+ * multiple inputs.
+ */
+
+import { createJourneyStep } from '$login-framework';
+
+export default createJourneyStep({
+  authId: 'test-auth-id',
+  callbacks: [
+    {
+      type: 'NameCallback',
+      output: [{ name: 'prompt', value: 'User Name' }],
+      input: [{ name: 'IDToken1', value: '' }],
+      _id: 0,
+    },
+  ],
+  stage: '__COMPONENT_NAME__',
+});

package/dist/src/templates/stage/__COMPONENT_SLUG__.stories.js

@@ -0,0 +1,43 @@
+/**
+ * Storybook stories for the __COMPONENT_NAME__ stage.
+ *
+ * Add additional stories for variants (loading, with form error, etc.) by
+ * cloning the `Base` args and overriding the relevant fields.
+ */
+
+import { fn } from 'storybook/test';
+import { writable } from 'svelte/store';
+
+import step from './__COMPONENT_SLUG__.mock';
+import Story from './__COMPONENT_SLUG__.story.svelte';
+
+export default {
+  argTypes: {
+    form: { control: false },
+    journey: { control: false },
+    step: { control: false },
+  },
+  component: Story,
+  parameters: {
+    layout: 'fullscreen',
+  },
+  title: 'Custom/Stage/__COMPONENT_NAME__',
+};
+
+export const Base = {
+  args: {
+    form: {
+      icon: true,
+      message: '',
+      status: '',
+      submit: fn(),
+    },
+    journey: {
+      loading: false,
+      pop: fn(),
+      push: fn(),
+      stack: writable([]),
+    },
+    step,
+  },
+};

package/dist/src/templates/stage/__COMPONENT_SLUG__.story.svelte

@@ -0,0 +1,47 @@
+<!--
+  Story wrapper for the __COMPONENT_NAME__ stage. Builds the metadata structure
+  the stage expects and mounts the component inside <Centered> so it can render
+  in isolation inside Storybook.
+-->
+
+<script lang="ts">
+  import {
+    buildCallbackMetadata,
+    buildStepMetadata,
+    Centered,
+    initCheckValidation,
+    initializeLinks,
+    initializeStyles,
+    type JourneyStep,
+    type StageFormObject,
+    type StageJourneyObject,
+    type StyleObject,
+  } from '$login-framework';
+  import __COMPONENT_NAME_PASCAL__ from './__COMPONENT_SLUG__.svelte';
+
+  export let form: StageFormObject;
+  export let journey: StageJourneyObject;
+  export let step: JourneyStep;
+  export let style: StyleObject = {};
+
+  const callbackMetadata = buildCallbackMetadata(step, initCheckValidation());
+  const stepMetadata = buildStepMetadata(callbackMetadata, undefined, step.getStage());
+  const metadata = {
+    callbacks: callbackMetadata,
+    step: stepMetadata,
+  };
+
+  initializeLinks({ termsAndConditions: '/' });
+  initializeStyles(style);
+</script>
+
+<Centered>
+  <svelte:component
+    this={__COMPONENT_NAME_PASCAL__}
+    componentStyle="modal"
+    {form}
+    {journey}
+    {metadata}
+    {step}
+  />
+</Centered>

package/dist/src/templates/stage/__COMPONENT_SLUG__.svelte

@@ -6,7 +6,7 @@ Name: __COMPONENT_NAME__
 Custom stage component. Replace this description with your own.
 
 A stage controls the layout and submission behaviour of an entire authentication
-step (page node). It receives the full FRStep, maps each callback to its
+step (page node). It receives the full JourneyStep, maps each callback to its
 component via CallbackMapper, and renders the form chrome (header, alerts,
 submit button, links).
 -->
@@ -15,27 +15,28 @@ submit button, links).
   import { afterUpdate, onDestroy, onMount } from 'svelte';
   import { get } from 'svelte/store';
 
-  import T from '$components/_utilities/locale-strings.svelte';
-  import Alert from '$components/primitives/alert/alert.svelte';
-  import Button from '$components/primitives/button/button.svelte';
-  import Form from '$components/primitives/form/form.svelte';
-  import { interpolate } from '$core/_utilities/i18n.utilities';
-  import { styleStore } from '$core/style.store';
-  import CallbackMapper from '$journey/_utilities/callback-mapper.svelte';
-  import { captureLinks } from '$journey/stages/_utilities/stage.utilities';
-  import { convertStringToKey } from '$journey/stages/_utilities/step.utilities';
-
-  import type { FRStep } from '@forgerock/javascript-sdk';
-  import type { z } from 'zod';
-
-  import type { Maybe } from '$core/interfaces';
-  import type { styleSchema } from '$core/style.store';
+  import {
+    Alert,
+    Button,
+    CallbackMapper,
+    captureLinks,
+    convertStringToKey,
+    Form,
+    interpolate,
+    styleStore,
+    T,
+  } from '$login-framework';
+
+  import type { JourneyStep } from '@forgerock/journey-client/types';
+
   import type {
     CallbackMetadata,
+    Maybe,
     StageFormObject,
     StageJourneyObject,
     StepMetadata,
-  } from '$journey/journey.interfaces';
+    StyleObject,
+  } from '$login-framework';
 
   /** Display mode — determines which chrome is visible (header, links, etc.). */
   export let componentStyle: 'app' | 'inline' | 'modal';
@@ -52,11 +53,11 @@ submit button, links).
   /** Step + callback metadata from AM — policies, derived helpers, stage header. */
   export let metadata: Maybe<{ callbacks: CallbackMetadata[]; step: StepMetadata }>;
 
-  /** The raw FRStep from the JavaScript SDK — contains all callbacks for this step. */
-  export let step: FRStep;
+  /** The raw JourneyStep from Journey Client — contains all callbacks for this step. */
+  export let step: JourneyStep;
 
   // Subscribe to style store so the template can pass styles to child callbacks.
-  let currentStyle: z.infer<typeof styleSchema> = get(styleStore);
+  let currentStyle: StyleObject = get(styleStore);
   const unsubStyle = styleStore.subscribe((v) => (currentStyle = v));
   onDestroy(unsubStyle);
 

package/dist/src/templates/stage/__COMPONENT_SLUG__.utilities.test.ts

@@ -1,9 +1,9 @@
 import { describe, expect, it } from 'vitest';
 
-import { format__COMPONENT_NAME__Label } from './__COMPONENT_SLUG__.utilities.js';
+import { format__COMPONENT_NAME_PASCAL__Label } from './__COMPONENT_SLUG__.utilities.js';
 
 describe('__COMPONENT_NAME__ utilities', () => {
   it('trims whitespace from label', () => {
-    expect(format__COMPONENT_NAME__Label('  hello  ')).toBe('hello');
+    expect(format__COMPONENT_NAME_PASCAL__Label('  hello  ')).toBe('hello');
   });
 });

package/dist/src/templates/stage/__COMPONENT_SLUG__.utilities.ts

@@ -8,6 +8,6 @@
 /**
  * Example utility — replace with your own helpers.
  */
-export function format__COMPONENT_NAME__Label(value: string): string {
+export function format__COMPONENT_NAME_PASCAL__Label(value: string): string {
   return value.trim();
 }

package/dist/src/templates/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "_comment": "IDE-only tsconfig. See companion file in this directory for details.",
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "allowJs": true,
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "paths": {
+      "$login-framework": ["../../../experimental/custom/login-framework.ts"]
+    }
+  },
+  "include": ["**/*.ts", "**/*.svelte"]
+}

package/dist/src/utils.d.ts

@@ -1,2 +1,11 @@
 /** Converts all backslashes to forward slashes for cross-platform path comparisons. */
 export declare function normalizeSeparators(p: string): string;
+/**
+ * Converts an arbitrary string to PascalCase, safe for use as a TypeScript identifier.
+ * Handles kebab-case, spaces, and preserves existing word boundaries in PascalCase input.
+ * Examples: "my-login-stage" → "MyLoginStage", "My Login Stage" → "MyLoginStage", "DefaultLogin" → "DefaultLogin"
+ *
+ * Intentionally duplicated from core/journey/_utilities/registry/registry.ts — tools/cli cannot
+ * depend on core/ (build-time vs. runtime boundary), so each package owns its own copy.
+ */
+export declare function toPascalCase(str: string): string;

package/dist/src/utils.js

@@ -2,3 +2,16 @@
 export function normalizeSeparators(p) {
     return p.replace(/\\/g, '/');
 }
+/**
+ * Converts an arbitrary string to PascalCase, safe for use as a TypeScript identifier.
+ * Handles kebab-case, spaces, and preserves existing word boundaries in PascalCase input.
+ * Examples: "my-login-stage" → "MyLoginStage", "My Login Stage" → "MyLoginStage", "DefaultLogin" → "DefaultLogin"
+ *
+ * Intentionally duplicated from core/journey/_utilities/registry/registry.ts — tools/cli cannot
+ * depend on core/ (build-time vs. runtime boundary), so each package owns its own copy.
+ */
+export function toPascalCase(str) {
+    return str
+        .replace(/[^a-zA-Z0-9]+(.)/g, (_, chr) => chr.toUpperCase())
+        .replace(/^(.)/, (_, chr) => chr.toUpperCase());
+}

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@forgerock/login-framework-cli",
-  "version": "0.0.0-beta-20260527205941",
+  "version": "0.0.0-beta-20260527211328",
   "description": "CLI tool for scaffolding and managing Ping Login Widget and Login App custom component projects",
   "type": "module",
   "exports": {
-    ".": "./dist/src/main.js",
-    "./generate-registry": "./dist/scripts/generate-registry.js"
+    ".": "./dist/src/main.js"
   },
   "main": "./dist/src/main.js",
   "module": "./dist/src/main.js",
@@ -44,6 +43,7 @@
     "@effect/printer-ansi": "^0.49.0",
     "@effect/typeclass": "^0.40.0",
     "effect": "^3.21.0",
+    "svelte": "^5.55.7",
     "tar": "^7.5.13"
   },
   "devDependencies": {

package/dist/scripts/generate-registry.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/scripts/generate-registry.js

@@ -1,20 +0,0 @@
-#!/usr/bin/env node
-/**
- * Thin Effect runner for generating the custom component registry.
- *
- * Called by:
- *  - packages/login-widget/package.json  "prebuild"
- *  - Root package.json                    "generate:registry"
- *
- * Requires the CLI to be compiled first:
- *   pnpm --filter @forgerock/login-framework-cli run build
- */
-import { NodeContext, NodeRuntime } from '@effect/platform-node';
-import { Effect } from 'effect';
-const { runRegistryScript } = await import('../src/services/registry.js');
-const projectDir = process.argv[2];
-if (!projectDir) {
-    console.error('Usage: node generate-registry.mjs <projectDir>');
-    process.exit(1);
-}
-NodeRuntime.runMain(runRegistryScript(projectDir).pipe(Effect.provide(NodeContext.layer)));

package/dist/src/services/registry.d.ts

@@ -1,22 +0,0 @@
-import { FileSystem, Path } from '@effect/platform';
-import { Effect } from 'effect';
-import { RegistryScanError } from '../errors.js';
-type ComponentType = 'stage' | 'callback';
-/** Extracts names of all `export let` prop declarations from a Svelte component's `<script>` block. */
-export declare function parseAcceptedProps(content: string): string[];
-/** Parses and validates the leading `<!-- @component -->` block from a Svelte file. */
-export declare const parseComponentHeader: (filePath: string, content: string) => Effect.Effect<{
-    type: ComponentType;
-    name: string;
-}, RegistryScanError>;
-/**
- * Scans `experimental/custom/stages/` and `experimental/custom/callbacks/` for
- * `@component`-annotated Svelte files and writes
- * `core/journey/_utilities/custom-registry.ts`.
- *
- * All I/O runs in-process via the platform `FileSystem` service — no subprocess
- * spawning. Validation errors across multiple components are collected and
- * reported together.
- */
-export declare const runRegistryScript: (projectDir: string) => Effect.Effect<void, RegistryScanError, FileSystem.FileSystem | Path.Path>;
-export {};

package/dist/src/services/registry.js

@@ -1,169 +0,0 @@
-import { FileSystem, Path } from '@effect/platform';
-import { Console, Effect } from 'effect';
-import { RegistryScanError } from '../errors.js';
-// --------------------------------------------------------------------------
-// Helpers (exported for testing)
-// --------------------------------------------------------------------------
-/** Extracts names of all `export let` prop declarations from a Svelte component's `<script>` block. */
-export function parseAcceptedProps(content) {
-    const scriptMatch = content.match(/<script[^>]*>([\s\S]*?)<\/script>/);
-    if (!scriptMatch)
-        return [];
-    const props = [];
-    const regex = /export\s+let\s+(\w+)/g;
-    let m;
-    while ((m = regex.exec(scriptMatch[1])) !== null)
-        props.push(m[1]);
-    return props;
-}
-function toPascalCase(str) {
-    return str
-        .replace(/[^a-zA-Z0-9]+(.)/g, (_, chr) => chr.toUpperCase())
-        .replace(/^(.)/, (_, chr) => chr.toUpperCase());
-}
-/** Parses and validates the leading `<!-- @component -->` block from a Svelte file. */
-export const parseComponentHeader = (filePath, content) => {
-    const fail = (cause) => Effect.fail(new RegistryScanError({ directory: filePath, cause }));
-    const commentMatch = content.match(/^<!--([\s\S]*?)-->/);
-    if (!commentMatch)
-        return fail('Missing @component header. Every custom component must begin with:\n' +
-            '<!--\n   @component\n   Type: stage|callback\n   Name: <ComponentName>\n   -->');
-    const block = commentMatch[1];
-    if (!block.includes('@component'))
-        return fail('Missing "@component" tag in the opening comment.');
-    const typeMatch = block.match(/Type:\s*(\S+)/);
-    if (!typeMatch)
-        return fail('Missing "Type:" field in @component header. Expected: Type: stage or Type: callback');
-    const rawType = typeMatch[1].toLowerCase();
-    if (rawType !== 'stage' && rawType !== 'callback')
-        return fail(`Invalid Type value "${typeMatch[1]}". Must be "stage" or "callback".`);
-    const nameMatch = block.match(/Name:\s*(.+)/);
-    if (!nameMatch)
-        return fail('Missing "Name:" field in @component header. Expected: Name: <ComponentName>');
-    return Effect.succeed({ type: rawType, name: nameMatch[1].trim() });
-};
-// --------------------------------------------------------------------------
-// File scanning
-// --------------------------------------------------------------------------
-const findSvelteFiles = (fs, path, dir) => fs.exists(dir).pipe(Effect.orElseSucceed(() => false), Effect.flatMap((exists) => !exists
-    ? Effect.succeed([])
-    : fs.readDirectory(dir).pipe(Effect.mapError((cause) => new RegistryScanError({ directory: dir, cause })), Effect.flatMap((entries) => Effect.forEach(entries, (entry) => {
-        const fullPath = path.join(dir, entry);
-        return fs.stat(fullPath).pipe(Effect.mapError((cause) => new RegistryScanError({ directory: dir, cause })), Effect.flatMap((stat) => stat.type === 'Directory'
-            ? findSvelteFiles(fs, path, fullPath)
-            : Effect.succeed(entry.endsWith('.svelte') && !entry.endsWith('.story.svelte')
-                ? [fullPath]
-                : [])));
-    }, { concurrency: 'unbounded' })), Effect.map((nested) => nested.flat()))));
-const scanDirectory = (fs, path, dir, expectedType) => findSvelteFiles(fs, path, dir).pipe(Effect.flatMap((files) => Effect.validateAll(files, (filePath) => fs.readFileString(filePath).pipe(Effect.mapError((cause) => new RegistryScanError({ directory: filePath, cause })), Effect.flatMap((content) => parseComponentHeader(filePath, content).pipe(Effect.flatMap(({ type, name }) => type !== expectedType
-    ? Effect.fail(new RegistryScanError({
-        directory: filePath,
-        cause: `Component in /experimental/custom/${expectedType}s/ declares Type: "${type}". Must declare Type: ${expectedType}`,
-    }))
-    : Effect.succeed({
-        filePath,
-        name,
-        type,
-        acceptedProps: parseAcceptedProps(content),
-    })))))).pipe(Effect.mapError((errors) => new RegistryScanError({
-    directory: dir,
-    cause: errors.map((e) => String(e.cause)).join('\n'),
-})))));
-// --------------------------------------------------------------------------
-// Registry content builder (pure)
-// --------------------------------------------------------------------------
-function buildRegistryContent(path, registryDir, stageComponents, callbackComponents) {
-    const toEntry = (prefix) => ({ filePath, name, acceptedProps }) => {
-        const relPath = path.relative(registryDir, filePath).replace(/\\/g, '/');
-        const importPath = relPath.startsWith('.') ? relPath : `./${relPath}`;
-        return { varName: `${prefix}${toPascalCase(name)}`, importPath, name, acceptedProps };
-    };
-    const stageEntries = stageComponents.map(toEntry('Stage'));
-    const callbackEntries = callbackComponents.map(toEntry('Callback'));
-    const lines = [
-        `/**`,
-        ` * AUTO-GENERATED — do not edit by hand.`,
-        ` * Run \`pnpm build:widget\` or \`pnpm --filter @forgerock/login-widget exec vite build\` to regenerate.`,
-        ` *`,
-        ` * Source: /experimental/custom/stages/ and /experimental/custom/callbacks/`,
-        ` */`,
-        ``,
-        `import type { Component } from 'svelte';`,
-        ``,
-        `export interface CustomRegistryEntry {`,
-        `  component: Component;`,
-        `  /** Props declared via \`export let\` in the component — only these are forwarded by the mapper. */`,
-        `  acceptedProps: string[];`,
-        `}`,
-        ``,
-    ];
-    if (stageEntries.length > 0) {
-        lines.push(`// Stage overrides / extensions`);
-        for (const { varName, importPath } of stageEntries)
-            lines.push(`import ${varName} from '${importPath}';`);
-        lines.push(``);
-    }
-    if (callbackEntries.length > 0) {
-        lines.push(`// Callback overrides / extensions`);
-        for (const { varName, importPath } of callbackEntries)
-            lines.push(`import ${varName} from '${importPath}';`);
-        lines.push(``);
-    }
-    lines.push(`export const customStageRegistry: Record<string, CustomRegistryEntry> = {`);
-    for (const { varName, name, acceptedProps } of stageEntries)
-        lines.push(`  ${JSON.stringify(name)}: { component: ${varName}, acceptedProps: ${JSON.stringify(acceptedProps)} },`);
-    lines.push(`};`);
-    lines.push(``);
-    lines.push(`export const customCallbackRegistry: Record<string, CustomRegistryEntry> = {`);
-    for (const { varName, name, acceptedProps } of callbackEntries)
-        lines.push(`  ${JSON.stringify(name)}: { component: ${varName}, acceptedProps: ${JSON.stringify(acceptedProps)} },`);
-    lines.push(`};`);
-    lines.push(``);
-    return lines.join('\n');
-}
-// --------------------------------------------------------------------------
-// Public API
-// --------------------------------------------------------------------------
-/**
- * Scans `experimental/custom/stages/` and `experimental/custom/callbacks/` for
- * `@component`-annotated Svelte files and writes
- * `core/journey/_utilities/custom-registry.ts`.
- *
- * All I/O runs in-process via the platform `FileSystem` service — no subprocess
- * spawning. Validation errors across multiple components are collected and
- * reported together.
- */
-export const runRegistryScript = (projectDir) => Effect.gen(function* () {
-    const fs = yield* FileSystem.FileSystem;
-    const path = yield* Path.Path;
-    const stageDir = path.join(projectDir, 'experimental', 'custom', 'stages');
-    const callbackDir = path.join(projectDir, 'experimental', 'custom', 'callbacks');
-    const registryDir = path.join(projectDir, 'core', 'journey', '_utilities');
-    const registryPath = path.join(registryDir, 'custom-registry.ts');
-    const [stageComponents, callbackComponents] = yield* Effect.all([
-        scanDirectory(fs, path, stageDir, 'stage'),
-        scanDirectory(fs, path, callbackDir, 'callback'),
-    ], { concurrency: 'unbounded' });
-    const content = buildRegistryContent(path, registryDir, stageComponents, callbackComponents);
-    yield* fs
-        .makeDirectory(registryDir, { recursive: true })
-        .pipe(Effect.mapError((cause) => new RegistryScanError({ directory: registryDir, cause })));
-    yield* fs
-        .writeFileString(registryPath, content)
-        .pipe(Effect.mapError((cause) => new RegistryScanError({ directory: registryPath, cause })));
-    const total = stageComponents.length + callbackComponents.length;
-    if (total === 0) {
-        yield* Console.log(`custom-registry.ts generated (no custom components found — registries are empty)`);
-    }
-    else {
-        yield* Console.log(`custom-registry.ts generated:`);
-        if (stageComponents.length > 0)
-            yield* Console.log(`  Stages    (${stageComponents.length}): ${stageComponents
-                .map((c) => c.name)
-                .join(', ')}`);
-        if (callbackComponents.length > 0)
-            yield* Console.log(`  Callbacks (${callbackComponents.length}): ${callbackComponents
-                .map((c) => c.name)
-                .join(', ')}`);
-    }
-});

package/dist/templates/callback/__COMPONENT_SLUG__.utilities.d.ts

@@ -1,10 +0,0 @@
-/**
- * Utility functions for the __COMPONENT_NAME__ callback.
- *
- * Keep callback-specific helpers here — data formatting, validation, API calls, etc.
- * This file is unit-tested independently of the Svelte component.
- */
-/**
- * Example utility — replace with your own helpers.
- */
-export declare function format__COMPONENT_NAME__Label(value: string): string;

package/dist/templates/callback/__COMPONENT_SLUG__.utilities.js

@@ -1,12 +0,0 @@
-/**
- * Utility functions for the __COMPONENT_NAME__ callback.
- *
- * Keep callback-specific helpers here — data formatting, validation, API calls, etc.
- * This file is unit-tested independently of the Svelte component.
- */
-/**
- * Example utility — replace with your own helpers.
- */
-export function format__COMPONENT_NAME__Label(value) {
-    return value.trim();
-}

package/dist/templates/callback/__COMPONENT_SLUG__.utilities.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/templates/callback/__COMPONENT_SLUG__.utilities.test.js

@@ -1,7 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { format__COMPONENT_NAME__Label } from './__COMPONENT_SLUG__.utilities.js';
-describe('__COMPONENT_NAME__ utilities', () => {
-    it('trims whitespace from label', () => {
-        expect(format__COMPONENT_NAME__Label('  hello  ')).toBe('hello');
-    });
-});

package/dist/templates/stage/__COMPONENT_SLUG__.utilities.d.ts

@@ -1,10 +0,0 @@
-/**
- * Utility functions for the __COMPONENT_NAME__ stage.
- *
- * Keep stage-specific helpers here — data formatting, validation, API calls, etc.
- * This file is unit-tested independently of the Svelte component.
- */
-/**
- * Example utility — replace with your own helpers.
- */
-export declare function format__COMPONENT_NAME__Label(value: string): string;

package/dist/templates/stage/__COMPONENT_SLUG__.utilities.js

@@ -1,12 +0,0 @@
-/**
- * Utility functions for the __COMPONENT_NAME__ stage.
- *
- * Keep stage-specific helpers here — data formatting, validation, API calls, etc.
- * This file is unit-tested independently of the Svelte component.
- */
-/**
- * Example utility — replace with your own helpers.
- */
-export function format__COMPONENT_NAME__Label(value) {
-    return value.trim();
-}

package/dist/templates/stage/__COMPONENT_SLUG__.utilities.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/templates/stage/__COMPONENT_SLUG__.utilities.test.js

@@ -1,7 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { format__COMPONENT_NAME__Label } from './__COMPONENT_SLUG__.utilities.js';
-describe('__COMPONENT_NAME__ utilities', () => {
-    it('trims whitespace from label', () => {
-        expect(format__COMPONENT_NAME__Label('  hello  ')).toBe('hello');
-    });
-});