@judo/codegen 0.1.0

package/LICENSE

@@ -0,0 +1,277 @@
+Eclipse Public License - v 2.0
+
+    THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+    PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION
+    OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.
+
+1. DEFINITIONS
+
+"Contribution" means:
+
+  a) in the case of the initial Contributor, the initial content
+     Distributed under this Agreement, and
+
+  b) in the case of each subsequent Contributor:
+     i) changes to the Program, and
+     ii) additions to the Program;
+  where such changes and/or additions to the Program originate from
+  and are Distributed by that particular Contributor. A Contribution
+  "originates" from a Contributor if it was added to the Program by
+  such Contributor itself or anyone acting on such Contributor's behalf.
+  Contributions do not include changes or additions to the Program that
+  are not Modified Works.
+
+"Contributor" means any person or entity that Distributes the Program.
+
+"Licensed Patents" mean patent claims licensable by a Contributor which
+are necessarily infringed by the use or sale of its Contribution alone
+or when combined with the Program.
+
+"Program" means the Contributions Distributed in accordance with this
+Agreement.
+
+"Recipient" means anyone who receives the Program under this Agreement
+or any Secondary License (as applicable), including Contributors.
+
+"Derivative Works" shall mean any work, whether in Source Code or other
+form, that is based on (or derived from) the Program and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship.
+
+"Modified Works" shall mean any work in Source Code or other form that
+results from an addition to, deletion from, or modification of the
+contents of the Program, including, for purposes of clarity any new file
+in Source Code form that contains any contents of the Program. Modified
+Works shall not include works that contain only declarations,
+interfaces, types, classes, structures, or files of the Program solely
+in each case in order to link to, bind by name, or subclass the Program
+or Modified Works thereof.
+
+"Distribute" means the acts of a) distributing or b) making available
+in any manner that enables the transfer of a copy.
+
+"Source Code" means the form of a Program preferred for making
+modifications, including but not limited to software source code,
+documentation source, and configuration files.
+
+"Secondary License" means either the GNU General Public License,
+Version 2.0, or any later versions of that license, including any
+exceptions or additional permissions as identified by the initial
+Contributor.
+
+2. GRANT OF RIGHTS
+
+  a) Subject to the terms of this Agreement, each Contributor hereby
+  grants Recipient a non-exclusive, worldwide, royalty-free copyright
+  license to reproduce, prepare Derivative Works of, publicly display,
+  publicly perform, Distribute and sublicense the Contribution of such
+  Contributor, if any, and such Derivative Works.
+
+  b) Subject to the terms of this Agreement, each Contributor hereby
+  grants Recipient a non-exclusive, worldwide, royalty-free patent
+  license under Licensed Patents to make, use, sell, offer to sell,
+  import and otherwise transfer the Contribution of such Contributor,
+  if any, in Source Code or other form. This patent license shall
+  apply to the combination of the Contribution and the Program if, at
+  the time the Contribution is added by the Contributor, such addition
+  of the Contribution causes such combination to be covered by the
+  Licensed Patents. The patent license shall not apply to any other
+  combinations which include the Contribution. No hardware per se is
+  licensed hereunder.
+
+  c) Recipient understands that although each Contributor grants the
+  licenses to its Contributions set forth herein, no assurances are
+  provided by any Contributor that the Program does not infringe the
+  patent or other intellectual property rights of any other entity.
+  Each Contributor disclaims any liability to Recipient for claims
+  brought by any other entity based on infringement of intellectual
+  property rights or otherwise. As a condition to exercising the
+  rights and licenses granted hereunder, each Recipient hereby
+  assumes sole responsibility to secure any other intellectual
+  property rights needed, if any. For example, if a third party
+  patent license is required to allow Recipient to Distribute the
+  Program, it is Recipient's responsibility to acquire that license
+  before distributing the Program.
+
+  d) Each Contributor represents that to its knowledge it has
+  sufficient copyright rights in its Contribution, if any, to grant
+  the copyright license set forth in this Agreement.
+
+  e) Notwithstanding the terms of any Secondary License, no
+  Contributor makes additional grants to any Recipient (other than
+  those set forth in this Agreement) as a result of such Recipient's
+  receipt of the Program under the terms of a Secondary License
+  (if permitted under the terms of Section 3).
+
+3. REQUIREMENTS
+
+3.1 If a Contributor Distributes the Program in any form, then:
+
+  a) the Program must also be made available as Source Code, in
+  accordance with section 3.2, and the Contributor must accompany
+  the Program with a statement that the Source Code for the Program
+  is available under this Agreement, and informs Recipients how to
+  obtain it in a reasonable manner on or through a medium customarily
+  used for software exchange; and
+
+  b) the Contributor may Distribute the Program under a license
+  different than this Agreement, provided that such license:
+     i) effectively disclaims on behalf of all other Contributors all
+     warranties and conditions, express and implied, including
+     warranties or conditions of title and non-infringement, and
+     implied warranties or conditions of merchantability and fitness
+     for a particular purpose;
+
+     ii) effectively excludes on behalf of all other Contributors all
+     liability for damages, including direct, indirect, special,
+     incidental and consequential damages, such as lost profits;
+
+     iii) does not attempt to limit or alter the recipients' rights
+     in the Source Code under section 3.2; and
+
+     iv) requires any subsequent distribution of the Program by any
+     party to be under a license that satisfies the requirements
+     of this section 3.
+
+3.2 When the Program is Distributed as Source Code:
+
+  a) it must be made available under this Agreement, or if the
+  Program (i) is combined with other material in a separate file or
+  files made available under a Secondary License, and (ii) the initial
+  Contributor attached to the Source Code the notice described in
+  Exhibit A of this Agreement, then the Program may be made available
+  under the terms of such Secondary Licenses, and
+
+  b) a copy of this Agreement must be included with each copy of
+  the Program.
+
+3.3 Contributors may not remove or alter any copyright, patent,
+trademark, attribution notices, disclaimers of warranty, or limitations
+of liability ("notices") contained within the Program from any copy of
+the Program which they Distribute, provided that Contributors may add
+their own appropriate notices.
+
+4. COMMERCIAL DISTRIBUTION
+
+Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program,
+the Contributor who includes the Program in a commercial product
+offering should do so in a manner which does not create potential
+liability for other Contributors. Therefore, if a Contributor includes
+the Program in a commercial product offering, such Contributor
+("Commercial Contributor") hereby agrees to defend and indemnify every
+other Contributor ("Indemnified Contributor") against any losses,
+damages and costs (collectively "Losses") arising from claims, lawsuits
+and other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the Program
+in a commercial product offering. The obligations in this section do not
+apply to any claims or Losses relating to any actual or alleged
+intellectual property infringement. In order to qualify, an Indemnified
+Contributor must: a) promptly notify the Commercial Contributor in
+writing of such claim, and b) allow the Commercial Contributor to control,
+and cooperate with the Commercial Contributor in, the defense and any
+related settlement negotiations. The Indemnified Contributor may
+participate in any such claim at its own expense.
+
+For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor's responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those performance
+claims and warranties, and if a court requires any other Contributor to
+pay any damages as a result, the Commercial Contributor must pay
+those damages.
+
+5. NO WARRANTY
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+PERMITTED BY APPLICABLE LAW, THE PROGRAM IS PROVIDED ON AN "AS IS"
+BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR
+IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF
+TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+PURPOSE. Each Recipient is solely responsible for determining the
+appropriateness of using and distributing the Program and assumes all
+risks associated with its exercise of rights under this Agreement,
+including but not limited to the risks and costs of program errors,
+compliance with applicable laws, damage to or loss of data, programs
+or equipment, and unavailability or interruption of operations.
+
+6. DISCLAIMER OF LIABILITY
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+PERMITTED BY APPLICABLE LAW, NEITHER RECIPIENT NOR ANY CONTRIBUTORS
+SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST
+PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE
+EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+7. GENERAL
+
+If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further
+action by the parties hereto, such provision shall be reformed to the
+minimum extent necessary to make such provision valid and enforceable.
+
+If Recipient institutes patent litigation against any entity
+(including a cross-claim or counterclaim in a lawsuit) alleging that the
+Program itself (excluding combinations of the Program with other software
+or hardware) infringes such Recipient's patent(s), then such Recipient's
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.
+
+All Recipient's rights under this Agreement shall terminate if it
+fails to comply with any of the material terms or conditions of this
+Agreement and does not cure such failure in a reasonable period of
+time after becoming aware of such noncompliance. If all Recipient's
+rights under this Agreement terminate, Recipient agrees to cease use
+and distribution of the Program as soon as reasonably practicable.
+However, Recipient's obligations under this Agreement and any licenses
+granted by Recipient relating to the Program shall continue and survive.
+
+Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and
+may only be modified in the following manner. The Agreement Steward
+reserves the right to publish new versions (including revisions) of
+this Agreement from time to time. No one other than the Agreement
+Steward has the right to modify this Agreement. The Eclipse Foundation
+is the initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+Distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is published,
+Contributor may elect to Distribute the Program (including its
+Contributions) under the new version.
+
+Except as expressly stated in Sections 2(a) and 2(b) above, Recipient
+receives no rights or licenses to the intellectual property of any
+Contributor under this Agreement, whether expressly, by implication,
+estoppel or otherwise. All rights in the Program not expressly granted
+under this Agreement are reserved. Nothing in this Agreement is intended
+to be enforceable by any entity that is not a Contributor or Recipient.
+No third-party beneficiary rights are created under this Agreement.
+
+Exhibit A - Form of Secondary Licenses Notice
+
+"This Source Code may also be made available under the following 
+Secondary Licenses when the conditions for such availability set forth 
+in the Eclipse Public License, v. 2.0 are satisfied: {name license(s),
+version(s), and exceptions or additional permissions here}."
+
+  Simply including a copy of this Agreement, including this Exhibit A
+  is not sufficient to license the Source Code under Secondary Licenses.
+
+  If it is not possible or desirable to put the notice in a particular
+  file, then You may include the notice in a location (such as a LICENSE
+  file in a relevant directory) where a recipient would be likely to
+  look for such a notice.
+
+  You may add additional accurate notices of copyright ownership.

package/README.md

@@ -0,0 +1,106 @@
+````markdown
+# @judo/codegen
+
+> Build-time code generator for JUDO UI Runtime extensibility — produces type-safe TypeScript interfaces from .model files
+
+## Purpose
+
+Reads `.model` XML files and generates TypeScript source files providing:
+
+1. **Typed action override interfaces** — per page, listing all actions and their lifecycle methods
+2. **Typed component props** — for each `customImplementation` element
+3. **Typed customization config** — a `createCustomizations()` factory with full type inference and name→sourceId resolution
+4. **Translation artifacts** — baseline `en-US.json` locale file and a `TRANSLATION_KEY_MAP` for runtime label resolution
+5. **Optional scaffolding stubs** — starter implementations as starting points
+
+## Architecture Layer
+
+**Build-time tooling** — used as a `devDependency`. Emits TypeScript source files consumed by runtime packages (`core`, `app-shell`).
+
+## Dependencies
+
+- `@judo/model-api` — model type definitions (workspace dependency)
+- `fast-xml-parser ^5` — lightweight XML parsing for `.model` files
+
+## File Structure
+
+```
+src/
+├── index.ts                  # Barrel re-exports: generate, extractModel, types
+├── cli.ts                    # CLI entry point (judo-codegen binary)
+├── model-reader.ts           # XML parser → ExtractedModel
+├── model-reader.test.ts
+├── generator.ts              # ExtractedModel → generated TypeScript files
+├── generator.test.ts
+├── name-utils.ts             # Name conversion utilities (PascalCase, camelCase, identifiers)
+├── name-utils.test.ts
+└── integration.test.ts       # End-to-end tests against real example models
+```
+
+## Exports Summary
+
+### Generator
+
+| Export            | Kind     | Description                                                                                  |
+| ----------------- | -------- | -------------------------------------------------------------------------------------------- |
+| `generate`        | function | Produces a `Map<string, string>` of relative file paths → TypeScript file contents           |
+| `GenerateOptions` | type     | Options: `model`, `scaffoldStubs?`, `applicationFilter?`, `customComponentAnnotationPrefix?` |
+| `GenerateResult`  | type     | Result containing `files: Map<string, string>`                                               |
+
+### Model Reader
+
+| Export               | Kind     | Description                                                                      |
+| -------------------- | -------- | -------------------------------------------------------------------------------- |
+| `extractModel`       | function | Parses `.model` XML content into an `ExtractedModel` structure                   |
+| `ExtractedModel`     | type     | Top-level model: applications, pages, components, navigationItems, subThemeNames |
+| `ExtractedPage`      | type     | Page with name, sourceId, applicationName, actions, elements, metadata           |
+| `ExtractedAction`    | type     | Action with name, sourceId, actionDefinitionType, actionDefinitionSourceId       |
+| `ExtractedComponent` | type     | Custom implementation element with name, sourceId, elementType, annotations      |
+| `ExtractedElement`   | type     | Named visual element with name, path, sourceId, elementType, label, annotations  |
+
+### CLI
+
+Binary: `judo-codegen` — invoked via `npx @judo/codegen generate --model <path> --outDir <dir> [options]`
+
+| Flag              | Description                                           |
+| ----------------- | ----------------------------------------------------- |
+| `--model <path>`  | Path to the `.model` XML file (required)              |
+| `--outDir <dir>`  | Output directory for generated files (required)       |
+| `--scaffoldStubs` | Generate starter implementation stubs                 |
+| `--watch`         | Watch the model file for changes and regenerate       |
+| `--app <name>`    | Only generate for a specific application (actor) name |
+
+## Generated Output Structure
+
+```
+generated/
+├── index.ts                     # Re-exports pages, components, factory, translation key map
+├── customizations.ts            # createCustomizations() factory + TypedCustomizationsInput
+├── _source-id-map.ts            # INTERNAL name→sourceId mapping (not re-exported)
+├── _translation-key-map.ts      # sourceId→translation key mapping (TRANSLATION_KEY_MAP)
+├── pages/
+│   ├── index.ts                 # Re-exports all page types
+│   └── <PageName>.ts            # Per-page action overrides + element names union type
+├── components/
+│   ├── index.ts                 # Re-exports all component props types
+│   └── <ComponentName>.ts       # Per-component typed CustomComponentProps
+├── locales/
+│   └── en-US.json               # Baseline translation file
+└── stubs/                       # Optional (--scaffoldStubs)
+    ├── pages/
+    │   └── use<PageName>Actions.ts
+    └── components/
+        └── <ComponentName>.tsx
+```
+
+## Key Patterns
+
+- **Name→sourceId isolation**: Developers use human-readable model names; `createCustomizations()` resolves to `xmi:id` sourceIds internally via `_source-id-map.ts`. Source IDs are never exposed.
+- **Annotation-based component wiring**: Elements sharing a `use`-prefixed annotation (e.g., `useFancyText`) are grouped; a single custom component is registered for all of them. Annotation components are processed before individual `components` entries, so explicit overrides win.
+- **Conditional generation**: `subThemeProviders`, `annotationComponents`, and per-page feature fields (`typeaheadProviders`, `tableRowHighlighting`, `enumOptionFilter`, `dateValidationProps`, `columnCustomizers`, `itemContainerConfigs`) are only emitted when the model has matching element types.
+- **Identifier deduplication**: Pages and components with colliding names after PascalCase conversion get numeric suffixes (e.g., `Dashboard`, `Dashboard1`).
+- **Element key shortening**: Customization keys use plain element names (e.g., `stars`) when unique within a page, falling back to shortest unique dot-suffix (e.g., `orders.price` vs `items.price`) for disambiguation. Section-specific keys (e.g., `tableRowHighlighting`) are disambiguated only among elements of the same type, avoiding cross-type collisions. Full hierarchical paths are retained internally for translation key generation.
+- **Translation baseline**: `locales/en-US.json` contains page titles (with `derivePageLabel` for operation pages), element labels, navigation items (`nav.*`), and static system messages (`system.*`). Keys are sorted alphabetically.
+- **Action definition type resolution**: Raw XML references like `TransferObjectViewDeleteActionDefinition` are mapped to canonical types (`DeleteActionDefinition`) via a pattern-matching table in `resolveActionDefinitionType`.
+- **Tree-shaking friendly**: Generated types are type-only (zero JS). The factory and source-id map are the only runtime JS. Stubs are not auto-imported.
+````

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @judo/codegen CLI
+ *
+ * Usage:
+ *   npx @judo/codegen generate --model <path> --outDir <dir> [--scaffoldStubs] [--watch] [--app <name>]
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/cli.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { n as generate, t as extractModel } from "./model-reader-SXrCZEyZ.js";
+import { existsSync, mkdirSync, readFileSync, unwatchFile, watchFile, writeFileSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+function parseArgs(e) {
+	let l = {
+		command: "",
+		model: "",
+		outDir: "",
+		scaffoldStubs: !1,
+		watch: !1
+	}, u = 2;
+	for (e[u] && !e[u].startsWith("-") && (l.command = e[u], u++); u < e.length; u++) switch (e[u]) {
+		case "--model":
+			l.model = e[++u] ?? "";
+			break;
+		case "--outDir":
+			l.outDir = e[++u] ?? "";
+			break;
+		case "--scaffoldStubs":
+			l.scaffoldStubs = !0;
+			break;
+		case "--watch":
+			l.watch = !0;
+			break;
+		case "--app":
+			l.app = e[++u] ?? void 0;
+			break;
+		default:
+			e[u].startsWith("-") || (l.command ||= e[u]);
+			break;
+	}
+	return l;
+}
+function printUsage() {
+	console.log("\n@judo/codegen — Generate type-safe extensibility interfaces from JUDO UI models\n\nUsage:\n  judo-codegen generate --model <path> --outDir <dir> [options]\n\nCommands:\n  generate    Generate TypeScript source files from a .model file\n\nOptions:\n  --model <path>       Path to the .model XML file (required)\n  --outDir <dir>       Output directory for generated files (required)\n  --scaffoldStubs      Generate starter implementation stubs\n  --watch              Watch the model file for changes and regenerate\n  --app <name>         Only generate for a specific application (actor) name\n\nExamples:\n  judo-codegen generate --model ./models/app.model --outDir ./src/generated\n  judo-codegen generate --model ./models/app.model --outDir ./src/generated --scaffoldStubs --watch\n");
+}
+function runGenerate(p) {
+	let m = resolve(p.model), h = resolve(p.outDir);
+	existsSync(m) || (console.error(`Error: Model file not found: ${m}`), process.exit(1)), console.log(`Reading model: ${m}`);
+	let g = readFileSync(m, "utf-8");
+	console.log("Extracting model data...");
+	let _ = extractModel(g);
+	console.log(`Found ${_.applications.length} application(s), ${_.pages.length} page(s), ${_.components.length} custom component(s)`), console.log("Generating TypeScript files...");
+	let v = generate({
+		model: _,
+		scaffoldStubs: p.scaffoldStubs,
+		applicationFilter: p.app
+	}), y = 0;
+	for (let [e, l] of v.files) {
+		let d = join(h, e), f = dirname(d);
+		existsSync(f) || mkdirSync(f, { recursive: !0 }), writeFileSync(d, l, "utf-8"), y++;
+	}
+	console.log(`Generated ${y} files in ${relative(process.cwd(), h)}/`), p.watch && (console.log(`\nWatching ${relative(process.cwd(), m)} for changes...`), watchFile(m, { interval: 500 }, () => {
+		console.log("\nModel changed, regenerating...");
+		try {
+			runGenerate({
+				...p,
+				watch: !1
+			}), console.log("Watching for changes...");
+		} catch (e) {
+			console.error("Generation error:", e);
+		}
+	}), process.on("SIGINT", () => {
+		unwatchFile(m), process.exit(0);
+	}));
+}
+var args = parseArgs(process.argv);
+if ((!args.command || args.command === "help" || args.command === "--help") && (printUsage(), process.exit(0)), args.command === "generate") {
+	args.model || (console.error("Error: --model is required"), printUsage(), process.exit(1)), args.outDir || (console.error("Error: --outDir is required"), printUsage(), process.exit(1));
+	try {
+		runGenerate(args);
+	} catch (e) {
+		console.error("Generation failed:", e), process.exit(1);
+	}
+} else console.error(`Unknown command: ${args.command}`), printUsage(), process.exit(1);

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":["args: CliArgs"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * @judo/codegen CLI\n *\n * Usage:\n *   npx @judo/codegen generate --model <path> --outDir <dir> [--scaffoldStubs] [--watch] [--app <name>]\n */\n\nimport { existsSync, mkdirSync, readFileSync, unwatchFile, watchFile, writeFileSync } from \"node:fs\";\nimport { dirname, join, relative, resolve } from \"node:path\";\nimport { generate } from \"./generator\";\nimport { extractModel } from \"./model-reader\";\n\ninterface CliArgs {\n\tcommand: string;\n\tmodel: string;\n\toutDir: string;\n\tscaffoldStubs: boolean;\n\twatch: boolean;\n\tapp?: string;\n}\n\nfunction parseArgs(argv: string[]): CliArgs {\n\tconst args: CliArgs = {\n\t\tcommand: \"\",\n\t\tmodel: \"\",\n\t\toutDir: \"\",\n\t\tscaffoldStubs: false,\n\t\twatch: false,\n\t};\n\n\tlet i = 2; // Skip node and script path\n\tif (argv[i] && !argv[i].startsWith(\"-\")) {\n\t\targs.command = argv[i];\n\t\ti++;\n\t}\n\n\tfor (; i < argv.length; i++) {\n\t\tswitch (argv[i]) {\n\t\t\tcase \"--model\":\n\t\t\t\targs.model = argv[++i] ?? \"\";\n\t\t\t\tbreak;\n\t\t\tcase \"--outDir\":\n\t\t\t\targs.outDir = argv[++i] ?? \"\";\n\t\t\t\tbreak;\n\t\t\tcase \"--scaffoldStubs\":\n\t\t\t\targs.scaffoldStubs = true;\n\t\t\t\tbreak;\n\t\t\tcase \"--watch\":\n\t\t\t\targs.watch = true;\n\t\t\t\tbreak;\n\t\t\tcase \"--app\":\n\t\t\t\targs.app = argv[++i] ?? undefined;\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tif (!argv[i].startsWith(\"-\")) {\n\t\t\t\t\t// Positional — first is command\n\t\t\t\t\tif (!args.command) {\n\t\t\t\t\t\targs.command = argv[i];\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\treturn args;\n}\n\nfunction printUsage(): void {\n\tconsole.log(`\n@judo/codegen — Generate type-safe extensibility interfaces from JUDO UI models\n\nUsage:\n  judo-codegen generate --model <path> --outDir <dir> [options]\n\nCommands:\n  generate    Generate TypeScript source files from a .model file\n\nOptions:\n  --model <path>       Path to the .model XML file (required)\n  --outDir <dir>       Output directory for generated files (required)\n  --scaffoldStubs      Generate starter implementation stubs\n  --watch              Watch the model file for changes and regenerate\n  --app <name>         Only generate for a specific application (actor) name\n\nExamples:\n  judo-codegen generate --model ./models/app.model --outDir ./src/generated\n  judo-codegen generate --model ./models/app.model --outDir ./src/generated --scaffoldStubs --watch\n`);\n}\n\nfunction runGenerate(args: CliArgs): void {\n\tconst modelPath = resolve(args.model);\n\tconst outDir = resolve(args.outDir);\n\n\tif (!existsSync(modelPath)) {\n\t\tconsole.error(`Error: Model file not found: ${modelPath}`);\n\t\tprocess.exit(1);\n\t}\n\n\tconsole.log(`Reading model: ${modelPath}`);\n\tconst xmlContent = readFileSync(modelPath, \"utf-8\");\n\n\tconsole.log(\"Extracting model data...\");\n\tconst model = extractModel(xmlContent);\n\tconsole.log(\n\t\t`Found ${model.applications.length} application(s), ${model.pages.length} page(s), ${model.components.length} custom component(s)`\n\t);\n\n\tconsole.log(\"Generating TypeScript files...\");\n\tconst result = generate({\n\t\tmodel,\n\t\tscaffoldStubs: args.scaffoldStubs,\n\t\tapplicationFilter: args.app,\n\t});\n\n\t// Write files\n\tlet written = 0;\n\tfor (const [filePath, content] of result.files) {\n\t\tconst fullPath = join(outDir, filePath);\n\t\tconst dir = dirname(fullPath);\n\t\tif (!existsSync(dir)) {\n\t\t\tmkdirSync(dir, { recursive: true });\n\t\t}\n\t\twriteFileSync(fullPath, content, \"utf-8\");\n\t\twritten++;\n\t}\n\n\tconsole.log(`Generated ${written} files in ${relative(process.cwd(), outDir)}/`);\n\n\tif (args.watch) {\n\t\tconsole.log(`\\nWatching ${relative(process.cwd(), modelPath)} for changes...`);\n\t\twatchFile(modelPath, { interval: 500 }, () => {\n\t\t\tconsole.log(\"\\nModel changed, regenerating...\");\n\t\t\ttry {\n\t\t\t\trunGenerate({ ...args, watch: false });\n\t\t\t\tconsole.log(\"Watching for changes...\");\n\t\t\t} catch (err) {\n\t\t\t\tconsole.error(\"Generation error:\", err);\n\t\t\t}\n\t\t});\n\n\t\t// Handle cleanup\n\t\tprocess.on(\"SIGINT\", () => {\n\t\t\tunwatchFile(modelPath);\n\t\t\tprocess.exit(0);\n\t\t});\n\t}\n}\n\n// Main\nconst args = parseArgs(process.argv);\n\nif (!args.command || args.command === \"help\" || args.command === \"--help\") {\n\tprintUsage();\n\tprocess.exit(0);\n}\n\nif (args.command === \"generate\") {\n\tif (!args.model) {\n\t\tconsole.error(\"Error: --model is required\");\n\t\tprintUsage();\n\t\tprocess.exit(1);\n\t}\n\tif (!args.outDir) {\n\t\tconsole.error(\"Error: --outDir is required\");\n\t\tprintUsage();\n\t\tprocess.exit(1);\n\t}\n\n\ttry {\n\t\trunGenerate(args);\n\t} catch (err) {\n\t\tconsole.error(\"Generation failed:\", err);\n\t\tprocess.exit(1);\n\t}\n} else {\n\tconsole.error(`Unknown command: ${args.command}`);\n\tprintUsage();\n\tprocess.exit(1);\n}\n"],"mappings":";;;;AAuBA,SAAS,UAAU,GAAyB;CAC3C,IAAMA,IAAgB;EACrB,SAAS;EACT,OAAO;EACP,QAAQ;EACR,eAAe;EACf,OAAO;EACP,EAEG,IAAI;AAMR,MALI,EAAK,MAAM,CAAC,EAAK,GAAG,WAAW,IAAI,KACtC,EAAK,UAAU,EAAK,IACpB,MAGM,IAAI,EAAK,QAAQ,IACvB,SAAQ,EAAK,IAAb;EACC,KAAK;AACJ,KAAK,QAAQ,EAAK,EAAE,MAAM;AAC1B;EACD,KAAK;AACJ,KAAK,SAAS,EAAK,EAAE,MAAM;AAC3B;EACD,KAAK;AACJ,KAAK,gBAAgB;AACrB;EACD,KAAK;AACJ,KAAK,QAAQ;AACb;EACD,KAAK;AACJ,KAAK,MAAM,EAAK,EAAE,MAAM,KAAA;AACxB;EACD;AACC,GAAK,EAAK,GAAG,WAAW,IAAI,KAG1B,EAAK,YAAU,EAAK;AAGtB;;AAIH,QAAO;;AAGR,SAAS,aAAmB;AAC3B,SAAQ,IAAI,uxBAmBX;;AAGF,SAAS,YAAY,GAAqB;CACzC,IAAM,IAAY,QAAQ,EAAK,MAAM,EAC/B,IAAS,QAAQ,EAAK,OAAO;AAOnC,CALK,WAAW,EAAU,KACzB,QAAQ,MAAM,gCAAgC,IAAY,EAC1D,QAAQ,KAAK,EAAE,GAGhB,QAAQ,IAAI,kBAAkB,IAAY;CAC1C,IAAM,IAAa,aAAa,GAAW,QAAQ;AAEnD,SAAQ,IAAI,2BAA2B;CACvC,IAAM,IAAQ,aAAa,EAAW;AAKtC,CAJA,QAAQ,IACP,SAAS,EAAM,aAAa,OAAO,mBAAmB,EAAM,MAAM,OAAO,YAAY,EAAM,WAAW,OAAO,sBAC7G,EAED,QAAQ,IAAI,iCAAiC;CAC7C,IAAM,IAAS,SAAS;EACvB;EACA,eAAe,EAAK;EACpB,mBAAmB,EAAK;EACxB,CAAC,EAGE,IAAU;AACd,MAAK,IAAM,CAAC,GAAU,MAAY,EAAO,OAAO;EAC/C,IAAM,IAAW,KAAK,GAAQ,EAAS,EACjC,IAAM,QAAQ,EAAS;AAK7B,EAJK,WAAW,EAAI,IACnB,UAAU,GAAK,EAAE,WAAW,IAAM,CAAC,EAEpC,cAAc,GAAU,GAAS,QAAQ,EACzC;;AAKD,CAFA,QAAQ,IAAI,aAAa,EAAQ,YAAY,SAAS,QAAQ,KAAK,EAAE,EAAO,CAAC,GAAG,EAE5E,EAAK,UACR,QAAQ,IAAI,cAAc,SAAS,QAAQ,KAAK,EAAE,EAAU,CAAC,iBAAiB,EAC9E,UAAU,GAAW,EAAE,UAAU,KAAK,QAAQ;AAC7C,UAAQ,IAAI,mCAAmC;AAC/C,MAAI;AAEH,GADA,YAAY;IAAE,GAAG;IAAM,OAAO;IAAO,CAAC,EACtC,QAAQ,IAAI,0BAA0B;WAC9B,GAAK;AACb,WAAQ,MAAM,qBAAqB,EAAI;;GAEvC,EAGF,QAAQ,GAAG,gBAAgB;AAE1B,EADA,YAAY,EAAU,EACtB,QAAQ,KAAK,EAAE;GACd;;AAKJ,IAAM,OAAO,UAAU,QAAQ,KAAK;AAOpC,KALI,CAAC,KAAK,WAAW,KAAK,YAAY,UAAU,KAAK,YAAY,cAChE,YAAY,EACZ,QAAQ,KAAK,EAAE,GAGZ,KAAK,YAAY,YAAY;AAMhC,CALK,KAAK,UACT,QAAQ,MAAM,6BAA6B,EAC3C,YAAY,EACZ,QAAQ,KAAK,EAAE,GAEX,KAAK,WACT,QAAQ,MAAM,8BAA8B,EAC5C,YAAY,EACZ,QAAQ,KAAK,EAAE;AAGhB,KAAI;AACH,cAAY,KAAK;UACT,GAAK;AAEb,EADA,QAAQ,MAAM,sBAAsB,EAAI,EACxC,QAAQ,KAAK,EAAE;;MAKhB,CAFA,QAAQ,MAAM,oBAAoB,KAAK,UAAU,EACjD,YAAY,EACZ,QAAQ,KAAK,EAAE"}

package/dist/generator.d.ts

@@ -0,0 +1,25 @@
+import { ExtractedModel } from './model-reader';
+export interface GenerateOptions {
+    /** Extracted model data */
+    model: ExtractedModel;
+    /** Whether to generate stub implementations */
+    scaffoldStubs?: boolean;
+    /** Only include pages from this application (actor) name. Omit to include all. */
+    applicationFilter?: string;
+    /**
+     * Prefix used to identify annotations that wire custom components.
+     * Annotations matching this prefix are stripped to produce the component implementation name.
+     * E.g., with prefix "use", annotation "useFancyText" → component name "FancyText".
+     * @default "use"
+     */
+    customComponentAnnotationPrefix?: string;
+}
+export interface GenerateResult {
+    /** Map of relative file path → file content */
+    files: Map<string, string>;
+}
+/**
+ * Generate TypeScript source files from an extracted model.
+ */
+export declare function generate(options: GenerateOptions): GenerateResult;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAKX,cAAc,EAGd,MAAM,gBAAgB,CAAC;AAuIxB,MAAM,WAAW,eAAe;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,cAAc,CAAC;IACtB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,+BAA+B,CAAC,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC9B,+CAA+C;IAC/C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3B;AA0CD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAqFjE"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @judo/codegen — Code generator for JUDO UI Runtime extensibility.
+ *
+ * Reads .model XML files and produces type-safe TypeScript interfaces,
+ * source ID constants, and registration helpers for the extensibility API.
+ *
+ * @module @judo/codegen
+ */
+export { generate } from './generator';
+export type { GenerateOptions, GenerateResult } from './generator';
+export { extractModel } from './model-reader';
+export type { ExtractedModel, ExtractedPage, ExtractedAction, ExtractedComponent, ExtractedElement, ExtractedDataType, ExtractedTransferAttribute, ExtractedTransferRelation, ExtractedTransferType, } from './model-reader';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACX,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+import { n as generate, t as extractModel } from "./model-reader-SXrCZEyZ.js";
+export { extractModel, generate };