@forgerock/login-framework-cli 0.0.0-beta.0 → 0.1.1

package/dist/{templates → src/templates}/stage/__COMPONENT_SLUG__.svelte

@@ -6,35 +6,37 @@ 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).
 -->
 
 <script lang="ts">
-  import type { FRStep } from '@forgerock/javascript-sdk';
   import { afterUpdate, onDestroy, onMount } from 'svelte';
   import { get } from 'svelte/store';
-  import type { z } from 'zod';
-
-  import { interpolate } from '$core/_utilities/i18n.utilities';
-  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 { convertStringToKey } from '$journey/stages/_utilities/step.utilities';
-  import { captureLinks } from '$journey/stages/_utilities/stage.utilities';
-  import { styleStore } from '$core/style.store';
-  import type { styleSchema } from '$core/style.store';
-  import CallbackMapper from '$journey/_utilities/callback-mapper.svelte';
+
+  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';
-  import type { Maybe } from '$core/interfaces';
+    StyleObject,
+  } from '$login-framework';
 
   /** Display mode — determines which chrome is visible (header, links, etc.). */
   export let componentStyle: 'app' | 'inline' | 'modal';
@@ -51,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

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

package/dist/{templates → 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

@@ -0,0 +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

@@ -0,0 +1,17 @@
+/** Converts all backslashes to forward slashes for cross-platform path comparisons. */
+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,17 +1,18 @@
 {
   "name": "@forgerock/login-framework-cli",
-  "version": "0.0.0-beta.0",
+  "version": "0.1.1",
   "description": "CLI tool for scaffolding and managing Ping Login Widget and Login App custom component projects",
   "type": "module",
-  "exports": "./dist/main.js",
-  "main": "./dist/main.js",
-  "module": "./dist/main.js",
+  "exports": {
+    ".": "./dist/src/main.js"
+  },
+  "main": "./dist/src/main.js",
+  "module": "./dist/src/main.js",
   "bin": {
-    "ping-lf": "./dist/main.js"
+    "ping-lf": "./dist/src/main.js"
   },
   "files": [
-    "dist",
-    "scripts"
+    "dist"
   ],
   "keywords": [
     "ping-identity",
@@ -35,6 +36,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@effect/ai": "^0.35.0",
     "@effect/cli": "^0.75.0",
     "@effect/platform": "^0.96.0",
     "@effect/platform-node": "^0.106.0",
@@ -42,14 +44,15 @@
     "@effect/printer-ansi": "^0.49.0",
     "@effect/typeclass": "^0.40.0",
     "effect": "^3.21.0",
-    "tar": "^7.5.13"
+    "svelte": "^5.55.7",
+    "tar": "^7.5.21"
   },
   "devDependencies": {
     "typescript": "^5.2.2",
-    "vitest": "^3.0.0"
+    "vitest": "^3.2.6"
   },
   "scripts": {
-    "build": "rm -rf dist && tsc && chmod +x dist/main.js && ([ -d templates ] && cp -r templates/ dist/templates/ || true)",
+    "build": "rm -rf dist && tsc -p tsconfig.json && chmod +x dist/src/main.js && ([ -d templates ] && cp -r templates/ dist/src/templates/ || true)",
     "dev": "tsc --watch",
     "test": "vitest run",
     "test:watch": "vitest"

package/dist/commands/init.d.ts

@@ -1,8 +0,0 @@
-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, {
-    readonly directory: string;
-    readonly local: import("effect/Option").Option<string>;
-    readonly version: import("effect/Option").Option<string>;
-}>;

package/dist/main.js

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-import { Command } from '@effect/cli';
-import { NodeContext, NodeRuntime } from '@effect/platform-node';
-import { Console, Effect } from 'effect';
-import { createRequire } from 'node:module';
-import { initCommand } from './commands/init.js';
-import { generateCommand } from './commands/generate.js';
-import { releasesCommand } from './commands/releases.js';
-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 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',
-    version,
-});
-cli(process.argv).pipe(Effect.catchTag('DirectoryConflictError', (err) => Console.error(`\nError: "${err.path}" already contains a framework project.` +
-    `\n  Did you mean to use --local?\n` +
-    `\n    ping-lf init <new-directory> --local ${err.path}\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('DirectoryNotEmptyError', (err) => Console.error(`\nError: "${err.path}" already exists and is not empty.` +
-    `\n  Choose a different directory name, or delete the existing directory first.\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('ReleaseNetworkError', (err) => Console.error(`\nError: Could not reach GitHub to download the release.\n` +
-    `  ${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` +
-    `  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}` : '') +
-    `\n\n  • Check your network connection and try again.\n` +
-    `  • Use a local path:   ping-lf init <dir> --local <path>\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('InvalidComponentNameError', (err) => Console.error(`\nError: "${err.name}" is not a valid component name.\n` +
-    `  Names must be PascalCase, start with an uppercase letter, and contain only letters and digits.\n` +
-    `  Examples: MyCallback, JWTLogin, DefaultStage\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.catchTag('ComponentAlreadyExistsError', (err) => Console.error(`\nError: component directory already exists: ${err.path}\n` +
-    `  Choose a different name or delete the existing directory first.\n`).pipe(Effect.andThen(Effect.die(err)))), Effect.provide(GithubReleaseLayer), Effect.provide(NodeContext.layer), (effect) => NodeRuntime.runMain(effect, { disableErrorReporting: true }));

package/dist/templates/callback/__COMPONENT_SLUG__.svelte

@@ -1,73 +0,0 @@
-<!--
-@component
-Type: callback
-Name: __COMPONENT_NAME__
-
-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 {
-    CallbackMetadata,
-    SelfSubmitFunction,
-    StepMetadata,
-  } from '$journey/journey.interfaces';
-  import type { styleSchema } from '$core/style.store';
-  import type { Maybe } from '$core/interfaces';
-
-  /**
-   * The AM 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> = {};
-
-  // Suppress the "unused export" warning — remove `void` once you use `callback`.
-  void callback;
-</script>
-
-<!-- Replace the markup below with your custom callback UI. -->
-<div class="__COMPONENT_SLUG__ tw_p-4 tw_rounded-lg tw_border tw_border-secondary-light dark:tw_border-secondary-dark">
-  <p class="tw_text-base tw_text-secondary-dark dark:tw_text-secondary-light">
-    __COMPONENT_NAME__ callback — replace this with your implementation.
-  </p>
-</div>
-
-<!--
-  Scoped styles for this callback.
-  These styles only apply to this component — they won't leak to the rest of the widget.
-  You can also use Tailwind utility classes (prefixed with `tw_`) in the markup above.
--->
-<style>
-  .__COMPONENT_SLUG__ {
-    display: flex;
-    flex-direction: column;
-    gap: 0.5rem;
-  }
-</style>

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

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

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

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

package/dist/utils.d.ts

@@ -1,2 +0,0 @@
-/** Converts all backslashes to forward slashes for cross-platform path comparisons. */
-export declare function normalizeSeparators(p: string): string;

package/dist/utils.js

@@ -1,4 +0,0 @@
-/** Converts all backslashes to forward slashes for cross-platform path comparisons. */
-export function normalizeSeparators(p) {
-    return p.replace(/\\/g, '/');
-}

package/scripts/generate-registry.mjs

@@ -1,23 +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 @ping-identity/login-framework-cli run build
- */
-import { Effect } from 'effect';
-import { NodeContext, NodeRuntime } from '@effect/platform-node';
-
-const { runRegistryScript } = await import('../dist/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/{errors.d.ts → 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>;
@@ -87,4 +79,12 @@ export declare class ComponentAlreadyExistsError extends ComponentAlreadyExistsE
     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;
+}> {
+}
 export {};

package/dist/{errors.js → 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') {
@@ -23,3 +21,5 @@ export class InvalidComponentNameError extends Data.TaggedError('InvalidComponen
 }
 export class ComponentAlreadyExistsError extends Data.TaggedError('ComponentAlreadyExistsError') {
 }
+export class RegistryScanError extends Data.TaggedError('RegistryScanError') {
+}

package/dist/{services → src/services}/file-system.d.ts

@@ -1,5 +1,5 @@
-import { Effect } from 'effect';
 import { FileSystem } from '@effect/platform';
+import { Effect } from 'effect';
 import { FileSystemError } from '../errors.js';
 /**
  * Returns true if the given directory looks like an initialized framework

package/dist/{services → src/services}/file-system.js

@@ -1,8 +1,8 @@
-import { Effect } from 'effect';
 import { FileSystem } from '@effect/platform';
+import { Effect } from 'effect';
+import path from 'node:path';
 import { isExcluded } from '../config/exclusions.js';
 import { FileSystemError } from '../errors.js';
-import path from 'node:path';
 import { normalizeSeparators } from '../utils.js';
 const wrapFsCall = (operation, fsPath) => (effect) => {
     const fail = (cause) => Effect.fail(new FileSystemError({ operation, path: fsPath, cause }));