@judo/model-loader 0.1.0

package/dist/loaders/http-loader.d.ts

@@ -0,0 +1,12 @@
+import { Application, ModelLoaderService } from '@judo/model-api';
+/**
+ * HTTP-based model loader.
+ * Fetches XML from URL and parses it.
+ */
+export declare class HttpModelLoader implements ModelLoaderService {
+    /**
+     * Load model from HTTP URL.
+     */
+    load(url: string): Promise<Application[]>;
+}
+//# sourceMappingURL=http-loader.d.ts.map

package/dist/loaders/http-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-loader.d.ts","sourceRoot":"","sources":["../../src/loaders/http-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAKvE;;;GAGG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;IACzD;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAkB/C"}

package/dist/loaders/index.d.ts

@@ -0,0 +1,4 @@
+export { HttpModelLoader } from './http-loader';
+export { FileModelLoader } from './file-loader';
+export { EmbeddedModelLoader } from './embedded-loader';
+//# sourceMappingURL=index.d.ts.map

package/dist/loaders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loaders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/registry/cross-reference.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Parsed cross-reference information.
+ */
+export interface ParsedReference {
+    namespace?: string;
+    actorName?: string;
+    elementId: string;
+    elementType?: string;
+}
+/**
+ * Parse a reference string into its component parts.
+ *
+ * Reference patterns:
+ * - Local: "Actor/(esm/_abc123)/ClassType"
+ * - Namespaced: "_default_transferobjecttypes::User"
+ * - Cross-actor: "OtherActor/(esm/_xyz789)/ClassType"
+ */
+export declare function parseReference(ref: string): ParsedReference;
+/**
+ * Build a reference string from parts.
+ */
+export declare function buildReference(actorName: string, elementId: string, elementType: string): string;
+/**
+ * Check if a reference is namespaced.
+ */
+export declare function isNamespacedReference(ref: string): boolean;
+/**
+ * Check if a reference crosses actors.
+ */
+export declare function isCrossActorReference(ref: string, currentActorName: string): boolean;
+//# sourceMappingURL=cross-reference.d.ts.map

package/dist/registry/cross-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-reference.d.ts","sourceRoot":"","sources":["../../src/registry/cross-reference.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAyB3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAGpF"}

package/dist/registry/index.d.ts

@@ -0,0 +1,4 @@
+export { ModelRegistry, type RegistrySnapshot } from './model-registry';
+export { parseReference, buildReference, isNamespacedReference, isCrossActorReference, type ParsedReference, } from './cross-reference';
+export { InstanceReferenceResolver, getContainer, getAncestors, findAncestor, isApplication, isPageContainer, isPageDefinition, REFERENCE_MAPPINGS, REFERENCE_PROPERTIES, type ReferenceMapping, } from './instance-resolver';
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACN,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,eAAe,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,gBAAgB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/registry/instance-resolver.d.ts

@@ -0,0 +1,63 @@
+import { Application, ModelElement, PageContainer, PageDefinition } from '@judo/model-api';
+/**
+ * Reference property mapping.
+ * Maps property names to the type of element they reference.
+ */
+export interface ReferenceMapping {
+    property: string;
+    targetType: "ClassType" | "DataElement" | "PageDefinition" | "PageContainer" | "ActionDefinition" | "AttributeType" | "RelationType" | "OperationType" | "NavigationItem" | "VisualElement" | "Any";
+}
+/**
+ * All known reference properties in the model.
+ */
+export declare const REFERENCE_MAPPINGS: ReferenceMapping[];
+/**
+ * Properties that are known to be string references.
+ */
+export declare const REFERENCE_PROPERTIES: Set<string>;
+/**
+ * Resolve all string references to actual object instances.
+ * Also sets up eContainer navigation for all elements.
+ */
+export declare class InstanceReferenceResolver {
+    private elementIndex;
+    /**
+     * Build index and resolve all references for the given applications.
+     * Uses a single-pass algorithm with deferred resolution for better performance.
+     */
+    resolve(applications: Application[]): void;
+    /**
+     * Single-pass traversal that indexes elements, sets eContainer,
+     * and collects string references for later resolution.
+     */
+    private indexAndCollectRefs;
+    /**
+     * Get the element index for testing.
+     */
+    getIndex(): Map<string, unknown>;
+}
+/**
+ * Get the eContainer of an element.
+ */
+export declare function getContainer<T extends ModelElement = ModelElement>(element: ModelElement): T | undefined;
+/**
+ * Get all ancestors of an element up to the root.
+ */
+export declare function getAncestors(element: ModelElement): ModelElement[];
+/**
+ * Find the nearest ancestor of a specific type.
+ */
+export declare function findAncestor<T extends ModelElement>(element: ModelElement, predicate: (e: ModelElement) => e is T): T | undefined;
+/**
+ * Check if an element is an Application.
+ */
+export declare function isApplication(element: ModelElement): element is Application;
+/**
+ * Check if an element is a PageContainer.
+ */
+export declare function isPageContainer(element: ModelElement): element is PageContainer;
+/**
+ * Check if an element is a PageDefinition.
+ */
+export declare function isPageDefinition(element: ModelElement): element is PageDefinition;
+//# sourceMappingURL=instance-resolver.d.ts.map

package/dist/registry/instance-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-resolver.d.ts","sourceRoot":"","sources":["../../src/registry/instance-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEhG;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EACP,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,KAAK,CAAC;CACT;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EAqFhD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,aAAqD,CAAC;AAWvF;;;GAGG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,YAAY,CAA8B;IAElD;;;OAGG;IACH,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,IAAI;IAqB1C;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAkD3B;;OAEG;IACH,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;CAGhC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,OAAO,EAAE,YAAY,GAAG,CAAC,GAAG,SAAS,CAExG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAUlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAClD,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,CAAC,IAAI,CAAC,GACpC,CAAC,GAAG,SAAS,CAWf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,IAAI,WAAW,CAE3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,IAAI,aAAa,CAI/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,IAAI,cAAc,CAEjF"}

package/dist/registry/model-registry.d.ts

@@ -0,0 +1,129 @@
+import { ActionDefinition, Application, AttributeType, ClassType, DataType, ModelRegistryService, NavigationItem, OperationType, PageContainer, PageDefinition, RelationType, VisualElement } from '@judo/model-api';
+/**
+ * Registry snapshot for useSyncExternalStore.
+ */
+export interface RegistrySnapshot {
+    applications: Application[];
+    activeApplication: Application | null;
+    activeActorName: string | null;
+}
+/**
+ * ModelRegistry manages loaded models and provides element resolution.
+ * Automatically resolves string references to object instances and
+ * sets up eContainer navigation for all elements.
+ */
+export declare class ModelRegistry implements ModelRegistryService {
+    private applications;
+    private activeActorName;
+    private elementIndex;
+    private subscribers;
+    private instanceResolver;
+    private cachedSnapshot;
+    /**
+     * Register applications from a parsed model.
+     * Automatically resolves all string references to object instances
+     * and sets up eContainer navigation.
+     */
+    registerModel(apps: Application[]): void;
+    /**
+     * Get all registered applications (actors).
+     */
+    getApplications(): Application[];
+    /**
+     * Get specific application by actor name.
+     * Throws if not found.
+     */
+    getApplication(actorName: string): Application;
+    /**
+     * Get currently active application.
+     * Throws if none active.
+     */
+    getActiveApplication(): Application;
+    /**
+     * Set active application by actor name.
+     * Emits change event for subscribers.
+     */
+    setActiveApplication(actorName: string): void;
+    /**
+     * Resolve any element by xmi:id.
+     */
+    resolveById<T = unknown>(id: string): T | undefined;
+    /**
+     * Resolve ClassType by reference string.
+     * Handles cross-model references like `_default_transferobjecttypes::User`.
+     */
+    resolveClassType(ref: string): ClassType | undefined;
+    /**
+     * Resolve RelationType by reference string.
+     */
+    resolveRelationType(ref: string): RelationType | undefined;
+    /**
+     * Resolve AttributeType by reference string.
+     */
+    resolveAttributeType(ref: string): AttributeType | undefined;
+    /**
+     * Resolve PageDefinition by reference string.
+     */
+    resolvePageDefinition(ref: string): PageDefinition | undefined;
+    /**
+     * Resolve PageContainer by reference string.
+     */
+    resolvePageContainer(ref: string): PageContainer | undefined;
+    /**
+     * Resolve VisualElement by xmi:id or sourceId.
+     */
+    resolveVisualElement(id: string): VisualElement | undefined;
+    /**
+     * Resolve ActionDefinition by reference string.
+     */
+    resolveActionDefinition(ref: string): ActionDefinition | undefined;
+    /**
+     * Resolve DataType by reference string.
+     */
+    resolveDataType(ref: string): DataType | undefined;
+    /**
+     * Resolve OperationType by reference string.
+     */
+    resolveOperationType(ref: string): OperationType | undefined;
+    /**
+     * Resolve NavigationItem by xmi:id.
+     */
+    resolveNavigationItem(id: string): NavigationItem | undefined;
+    /**
+     * Internal reference resolution.
+     *
+     * All model references use exact xmi:id values, so direct lookup
+     * is sufficient. Returns undefined for unresolvable external references.
+     */
+    private resolveReference;
+    /**
+     * Type guard for ClassType.
+     */
+    private isClassType;
+    /**
+     * Type guard for RelationType.
+     */
+    private isRelationType;
+    /**
+     * Type guard for AttributeType.
+     */
+    private isAttributeType;
+    /**
+     * Type guard for OperationType.
+     */
+    private isOperationType;
+    /**
+     * Subscribe to registry changes (active app switch).
+     */
+    subscribe(callback: () => void): () => void;
+    /**
+     * Get current snapshot for useSyncExternalStore.
+     * Returns cached snapshot to maintain referential equality.
+     */
+    getSnapshot(): RegistrySnapshot;
+    /**
+     * Notify all subscribers of changes.
+     */
+    private notifySubscribers;
+}
+//# sourceMappingURL=model-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../src/registry/model-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,SAAS,EACT,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,MAAM,iBAAiB,CAAC;AAIzB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,iBAAiB,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,aAAc,YAAW,oBAAoB;IACzD,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,cAAc,CAAiC;IAEvD;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI;IAYxC;;OAEG;IACH,eAAe,IAAI,WAAW,EAAE;IAIhC;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IAQ9C;;;OAGG;IACH,oBAAoB,IAAI,WAAW;IAOnC;;;OAGG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO7C;;OAEG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAInD;;;OAGG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAQpD;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAQ1D;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAQ5D;;OAEG;IACH,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAK9D;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAK5D;;OAEG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAK3D;;OAEG;IACH,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAKlE;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAKlD;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAQ5D;;OAEG;IACH,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAK7D;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C;;;OAGG;IACH,WAAW,IAAI,gBAAgB;IAa/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAOzB"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@judo/model-loader",
+  "version": "0.1.0",
+  "description": "Model loading and registry services for JUDO UI Runtime",
+  "license": "EPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BlackBeltTechnology/judo-frontend-runtime.git",
+    "directory": "packages/model-loader"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/browser.js",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@judo/model-api": "0.1.0",
+    "@judo/model-parser": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "axios": "^1.13.5",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "@judo/model-api": "0.1.0",
+    "@judo/model-parser": "0.1.0"
+  },
+  "peerDependencies": {
+    "axios": "^1.9.0",
+    "@judo/model-api": "0.1.0",
+    "@judo/model-parser": "0.1.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "clean": "rm -rf dist",
+    "type-check": "tsgo --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}