@forgerock/login-framework-cli 0.1.0 → 0.1.1

package/README.md

@@ -35,10 +35,10 @@ pnpm dev
 
 **Options**
 
-| 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. |
+| Flag             | Description                                                                                                                 |
+| ---------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| `--tag <tag>`    | Download a specific Git release tag (e.g. `@forgerock/login-widget@2.1.0`; legacy `v1.2.0` also works). Defaults to `main`. |
+| `--local <path>` | Use a local framework directory instead of downloading from GitHub. Useful for development or air-gapped environments.      |
 
 **What it does**
 
@@ -163,7 +163,7 @@ 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 @forgerock/login-widget@2.1.0  # pin to a specific release tag
 ping-lf update --local ../framework     # use a local directory
 ping-lf update --directory /path/to/project  # target a specific project root
 ```
@@ -214,7 +214,7 @@ pnpm --filter @forgerock/login-framework-cli link --global
 ```sh
 ping-lf init my-project
 ping-lf generate callback MyCallback
-ping-lf update --tag v1.5.0
+ping-lf update --tag @forgerock/login-widget@2.1.0
 ```
 
 Rebuilds (`pnpm --filter @forgerock/login-framework-cli build`) update the global binary automatically — no relink needed.

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

@@ -12,5 +12,5 @@ export declare const initProject: ({ directory, local, version }: InitProjectOpt
 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("../errors.js").RegistryScanError | import("@effect/platform/Error").PlatformError, {
     readonly directory: string;
     readonly local: Option.Option<string>;
-    readonly version: Option.Option<string>;
+    readonly tag: Option.Option<string>;
 }>;

package/dist/src/commands/init.js

@@ -89,5 +89,5 @@ export const initProject = ({ directory, local, version }) => Effect.gen(functio
 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 release tag to download (e.g. v1.2.0). If omitted, the main branch is used.'))),
-}, ({ directory, local, version }) => initProject({ directory, local, version })).pipe(Command.withDescription('Bootstrap a new Ping Login Widget or Login App project from a GitHub release or a local framework path.'));
+    tag: Options.optional(Options.text('tag').pipe(Options.withDescription('Framework Git release tag to download (e.g. @forgerock/login-widget@2.1.0 or v1.2.0). If omitted, the main branch is used.'))),
+}, ({ directory, local, tag }) => initProject({ directory, local, version: tag })).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

@@ -3,5 +3,5 @@ import { Option } from 'effect';
 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, {
     readonly directory: Option.Option<string>;
     readonly local: Option.Option<string>;
-    readonly version: Option.Option<string>;
+    readonly tag: Option.Option<string>;
 }>;

package/dist/src/commands/update.js

@@ -8,8 +8,8 @@ import { resolveSource } from './source.js';
 export const updateCommand = Command.make('update', {
     directory: Options.optional(Options.text('directory').pipe(Options.withDescription('Project root directory. Defaults to the current working 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 update to (e.g. v1.2.0). If omitted, the main branch is used.'))),
-}, ({ local, version, directory }) => Effect.gen(function* () {
+    tag: Options.optional(Options.text('tag').pipe(Options.withDescription('Framework Git release tag to update to (e.g. @forgerock/login-widget@2.1.0 or v1.2.0). If omitted, the main branch is used.'))),
+}, ({ local, tag, directory }) => Effect.gen(function* () {
     const cwd = nodePath.resolve(expandTilde(Option.getOrElse(directory, () => process.cwd())));
     // ── 1. Verify this is an initialized project ──────────────────────────
     const currentVersion = yield* assertValidProject(cwd);
@@ -18,7 +18,7 @@ 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;

package/dist/src/main.js

@@ -49,8 +49,8 @@ const program = isMcpLaunch
         `  ${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` +
+        `  • Specify a tag:      ping-lf init <dir> --tag @forgerock/login-widget@2.1.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 a Git tag like @forgerock/login-widget@2.1.0 or 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` +

package/dist/src/mcp.js

@@ -25,7 +25,7 @@ function formatError(cause) {
         const e = err.value;
         switch (e._tag) {
             case 'InvalidVersionError':
-                return `Invalid version "${e['version']}". Expected semver format like v1.0.0.`;
+                return `Invalid version "${e['version']}". Expected a Git tag like @forgerock/login-widget@2.1.0 or v1.0.0.`;
             case 'ReleaseNetworkError':
                 return `Network error reaching GitHub: ${e['cause']}`;
             case 'ReleaseParseError':
@@ -69,7 +69,7 @@ const InitTool = Tool.make('init', {
             description: 'Directory to initialize the project in (e.g. "my-project" or "./")',
         }),
         version: Schema.optional(Schema.String).annotations({
-            description: 'Framework version tag to download (e.g. v1.2.0). Defaults to latest.',
+            description: 'Framework Git release tag to download (e.g. @forgerock/login-widget@2.1.0 or v1.2.0). Defaults to main.',
         }),
         local: Schema.optional(Schema.String).annotations({
             description: 'Path to a local framework directory instead of downloading from GitHub.',
@@ -117,7 +117,7 @@ const UpdateTool = Tool.make('update', {
     parameters: {
         directory: directoryParam,
         version: Schema.optional(Schema.String).annotations({
-            description: 'Framework version tag to update to (e.g. v1.2.0). Defaults to latest.',
+            description: 'Framework Git release tag to update to (e.g. @forgerock/login-widget@2.1.0 or v1.2.0). Defaults to main.',
         }),
         local: Schema.optional(Schema.String).annotations({
             description: 'Path to a local framework directory instead of downloading from GitHub.',

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

@@ -2,13 +2,20 @@ 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. */
+interface ComponentEntry {
+    filePath: string;
+    name: string;
+    type: ComponentType;
+    acceptedProps: string[];
+}
+/** Extracts names of all `export let` prop declarations from a Svelte component's instance script. */
 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>;
+export declare function buildRegistryContent(path: Path.Path, registryDir: string, stageComponents: ComponentEntry[], callbackComponents: ComponentEntry[]): string;
 /**
  * Scans `experimental/custom/stages/` and `experimental/custom/callbacks/` for
  * `@component`-annotated Svelte files and writes

package/dist/src/services/registry.js

@@ -1,19 +1,26 @@
 import { FileSystem, Path } from '@effect/platform';
 import { Console, Effect } from 'effect';
+import { parse } from 'svelte/compiler';
 import { RegistryScanError } from '../errors.js';
 // --------------------------------------------------------------------------
 // Helpers (exported for testing)
 // --------------------------------------------------------------------------
-/** Extracts names of all `export let` prop declarations from a Svelte component's `<script>` block. */
+/** Extracts names of all `export let` prop declarations from a Svelte component's instance script. */
 export function parseAcceptedProps(content) {
-    const scriptMatch = content.match(/<script[^>]*>([\s\S]*?)<\/script>/);
-    if (!scriptMatch)
-        return [];
+    const abstractSyntaxTree = parse(content, { modern: false });
     const props = [];
-    const regex = /export\s+let\s+(\w+)/g;
-    let m;
-    while ((m = regex.exec(scriptMatch[1])) !== null)
-        props.push(m[1]);
+    for (const node of abstractSyntaxTree.instance?.content.body ?? []) {
+        if (node.type !== 'ExportNamedDeclaration') {
+            continue;
+        }
+        if (node.declaration?.type === 'VariableDeclaration' && node.declaration.kind === 'let') {
+            for (const declarator of node.declaration.declarations) {
+                if (declarator.id.type === 'Identifier') {
+                    props.push(declarator.id.name);
+                }
+            }
+        }
+    }
     return props;
 }
 function toPascalCase(str) {
@@ -72,7 +79,7 @@ const scanDirectory = (fs, path, dir, expectedType) => findSvelteFiles(fs, path,
 // --------------------------------------------------------------------------
 // Registry content builder (pure)
 // --------------------------------------------------------------------------
-function buildRegistryContent(path, registryDir, stageComponents, callbackComponents) {
+export 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}`;
@@ -111,12 +118,12 @@ function buildRegistryContent(path, registryDir, stageComponents, callbackCompon
     }
     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(`  ${JSON.stringify(name)}: { get component() { return ${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(`  ${JSON.stringify(name)}: { get component() { return ${varName}; }, acceptedProps: ${JSON.stringify(acceptedProps)} },`);
     lines.push(`};`);
     lines.push(``);
     return lines.join('\n');

package/dist/src/services/release.js

@@ -8,7 +8,7 @@ const API_HEADERS = {
     'User-Agent': 'ping-lf-cli',
     Accept: 'application/vnd.github.v3+json',
 };
-const VERSION_REGEX = /^v?\d+\.\d+\.\d+(-[\w.]+)?$/;
+const VERSION_REGEX = /^(?:v?\d+\.\d+\.\d+(-[\w.]+)?|@forgerock\/login-widget@\d+\.\d+\.\d+(-[\w.]+)?)$/;
 const toCauseString = (cause) => cause instanceof Error ? cause.message : String(cause);
 export function validateVersion(version) {
     return VERSION_REGEX.test(version)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgerock/login-framework-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI tool for scaffolding and managing Ping Login Widget and Login App custom component projects",
   "type": "module",
   "exports": {