@judo/codegen 0.1.0

package/dist/model-reader.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Model reader — extracts structured data from .model XML files
+ * for use by the code generator.
+ *
+ * Uses fast-xml-parser for lightweight XML extraction.
+ */
+export interface ExtractedModel {
+    /** All applications (actors) found in the model */
+    applications: ExtractedApplication[];
+    /** All unique pages across all applications */
+    pages: ExtractedPage[];
+    /** All elements with customImplementation="true" */
+    components: ExtractedComponent[];
+    /** Navigation items extracted for translation key generation */
+    navigationItems: ExtractedNavigationItem[];
+    /** All unique subTheme names found on visual elements */
+    subThemeNames: string[];
+    /** All data types (primitives + enumerations) from the model */
+    dataTypes: ExtractedDataType[];
+    /** All transfer types (ClassType data elements) from the model */
+    transferTypes: ExtractedTransferType[];
+}
+export interface ExtractedApplication {
+    name: string;
+    sourceId: string;
+}
+export interface ExtractedPage {
+    /** Human-readable page name from the model */
+    name: string;
+    /** The xmi:id (sourceId) of the PageDefinition */
+    sourceId: string;
+    /** Application this page belongs to */
+    applicationName: string;
+    /** The label from the model (for translation baseline generation) */
+    label?: string;
+    /** Whether this page opens in a dialog */
+    openInDialog: boolean;
+    /** Whether this is a dashboard page */
+    dashboard: boolean;
+    /** Container type (TABLE, FORM, VIEW) */
+    containerType?: string;
+    /** Actions available on this page */
+    actions: ExtractedAction[];
+    /** Named elements on this page (for visual property overrides) */
+    elements: ExtractedElement[];
+}
+export interface ExtractedAction {
+    /** Human-readable action name from the model */
+    name: string;
+    /** The xmi:id (sourceId) of the Action */
+    sourceId: string;
+    /** The @type of the ActionDefinition (e.g., "DeleteActionDefinition") */
+    actionDefinitionType: string;
+    /** The xmi:id of the ActionDefinition */
+    actionDefinitionSourceId: string;
+}
+export interface ExtractedComponent {
+    /** Human-readable element name from the model */
+    name: string;
+    /** The xmi:id (sourceId) of the VisualElement */
+    sourceId: string;
+    /** The @type of the VisualElement (e.g., "Flex") */
+    elementType: string;
+    /** Page this component belongs to (for context) */
+    pageName?: string;
+    /** Resolved annotation names on this element (e.g. ["useFancyText"]) */
+    annotations?: string[];
+}
+export interface ExtractedNavigationItem {
+    /** Human-readable name from the model */
+    name: string;
+    /** The xmi:id of the navigation item */
+    sourceId: string;
+    /** The display label */
+    label?: string;
+}
+export interface ExtractedElement {
+    /** Human-readable element name */
+    name: string;
+    /** Hierarchical dot-separated path from container root (e.g. "View.group.stars") */
+    path: string;
+    /** The xmi:id (sourceId) */
+    sourceId: string;
+    /** The @type of the VisualElement */
+    elementType: string;
+    /** The label from the model (for translation baseline generation) */
+    label?: string;
+    /** Resolved annotation names on this element (e.g. ["useFancyText", "dashboard"]) */
+    annotations?: string[];
+}
+export interface ExtractedDataType {
+    /** xmi:id of the data type */
+    xmiId: string;
+    /** xsi:type (e.g., "data:StringType", "data:NumericType") */
+    xsiType: string;
+    /** Name from the model (e.g., "types::String", "Gender") */
+    name: string;
+    /** For EnumerationType: member value names (e.g., ["MALE", "FEMALE"]) */
+    members?: string[];
+}
+export interface ExtractedTransferAttribute {
+    /** Attribute name (e.g., "city", "name") */
+    name: string;
+    /** Reference to the data type xmi:id */
+    dataTypeRef: string;
+    /** Whether the attribute is read-only */
+    isReadOnly: boolean;
+    /** Whether the attribute is required */
+    isRequired: boolean;
+}
+export interface ExtractedTransferRelation {
+    /** Relation name (e.g., "country", "items") */
+    name: string;
+    /** Reference to the target ClassType xmi:id */
+    targetRef: string;
+    /** Whether this is a collection relation */
+    isCollection: boolean;
+}
+export interface ExtractedTransferType {
+    /** The DTO name (e.g., "AddressDTO", "OrderDTO") */
+    name: string;
+    /** xmi:id of the ClassType */
+    xmiId: string;
+    /** Whether this is an actor type */
+    isActor: boolean;
+    /** Attributes on this type */
+    attributes: ExtractedTransferAttribute[];
+    /** Relations to other ClassTypes */
+    relations: ExtractedTransferRelation[];
+}
+/**
+ * Extract model information from XML content.
+ * This does a lightweight parse focused on what the codegen needs:
+ * pages, actions, and customImplementation elements.
+ */
+export declare function extractModel(xmlContent: string): ExtractedModel;
+//# sourceMappingURL=model-reader.d.ts.map

package/dist/model-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-reader.d.ts","sourceRoot":"","sources":["../src/model-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,cAAc;IAC9B,mDAAmD;IACnD,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,+CAA+C;IAC/C,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,oDAAoD;IACpD,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,gEAAgE;IAChE,eAAe,EAAE,uBAAuB,EAAE,CAAC;IAC3C,yDAAyD;IACzD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gEAAgE;IAChE,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,kEAAkE;IAClE,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC7B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,YAAY,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC/B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,wBAAwB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IAClC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACvC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAChC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IACjC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IAC1C,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACzC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACrC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,UAAU,EAAE,0BAA0B,EAAE,CAAC;IACzC,oCAAoC;IACpC,SAAS,EAAE,yBAAyB,EAAE,CAAC;CACvC;AA2CD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CA8O/D"}

package/dist/name-utils.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Name utilities for converting model names to TypeScript identifiers.
+ */
+/**
+ * Convert a model page name to a TypeScript-safe identifier.
+ *
+ * Model page names use "::" separators, e.g.:
+ * - "Customer::customerOrders::AccessTablePage"
+ * - "AddressDTO::Form::group::country::LinkSetSelectorPage"
+ * - "Home::Order::ActionGroup::createNewOrder::Input::Form"
+ *
+ * We take the last meaningful segment and PascalCase it, deduplicating if needed.
+ */
+export declare function toPageIdentifier(pageName: string): string;
+/**
+ * Convert a model action name to a TypeScript-safe camelCase identifier.
+ *
+ * Action names like "Customer::customerOrders::Back" → "back"
+ * or "OrderDTO::OrderView::itemsGroup::items::TabularReferenceTableBulkDeleteAction" → "itemsBulkDelete"
+ */
+export declare function toActionIdentifier(actionName: string): string;
+/**
+ * Convert a model element name to a TypeScript-safe camelCase identifier.
+ */
+export declare function toElementIdentifier(elementName: string): string;
+/**
+ * Convert a model navigation item name to a clean PascalCase identifier
+ * suitable for use as a translation key segment.
+ *
+ * Navigation item names like "God::God::galaxies::NavigationItem" → "Galaxies"
+ * or "Admin::orders::NavigationItem" → "Orders"
+ */
+export declare function toNavItemIdentifier(navItemName: string): string;
+/**
+ * Convert a model component name to a TypeScript-safe PascalCase identifier.
+ */
+export declare function toComponentIdentifier(componentName: string): string;
+/**
+ * Convert a model transfer type or data type name to a TypeScript-safe PascalCase identifier.
+ *
+ * Transfer/data type names may contain "::" namespace separators:
+ * - "View::Galaxy" → "ViewGalaxy"
+ * - "ReadOnlyTest::SpaceShipTransfer" → "ReadOnlyTestSpaceShipTransfer"
+ * - "Galaxy" → "Galaxy" (no namespace)
+ */
+export declare function toTransferIdentifier(name: string): string;
+/**
+ * Create a safe key for use in Record types (for generated source-id maps).
+ * Uses the page name directly but sanitized.
+ */
+export declare function toSafeKey(name: string): string;
+/**
+ * Convert string to PascalCase.
+ */
+export declare function toPascalCase(str: string): string;
+/**
+ * Convert string to camelCase.
+ */
+export declare function toCamelCase(str: string): string;
+/**
+ * Deduplicate names in a list by appending numeric suffixes.
+ */
+export declare function deduplicateNames(names: string[]): Map<string, string>;
+//# sourceMappingURL=name-utils.d.ts.map

package/dist/name-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-utils.d.ts","sourceRoot":"","sources":["../src/name-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAsC7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAW/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAeD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAerE"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@judo/codegen",
+  "version": "0.1.0",
+  "description": "Code generator for JUDO UI Runtime extensibility — produces type-safe customization interfaces from .model files",
+  "license": "EPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BlackBeltTechnology/judo-frontend-runtime.git",
+    "directory": "packages/codegen"
+  },
+  "bin": {
+    "judo-codegen": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "fast-xml-parser": "^5.3.6",
+    "@judo/model-api": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.9.3",
+    "vite": "npm:rolldown-vite@7.3.1",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsgo --noEmit"
+  }
+}