@acorex-platform/framework-shared 0.0.1 → 0.0.9

package/package.json

@@ -1,21 +1,32 @@
-{
-  "name": "@acorex-platform/framework-shared",
-  "version": "0.0.1",
-  "private": false,
-  "type": "commonjs",
-  "sideEffects": false,
-  "exports": {
-    "./core": {
-      "types": "./core/src/index.d.ts",
-      "default": "./core/src/index.js"
-    },
-    "./domain": {
-      "types": "./domain/src/index.d.ts",
-      "default": "./domain/src/index.js"
-    },
-    "./entity": {
-      "types": "./entity/src/index.d.ts",
-      "default": "./entity/src/index.js"
-    }
-  }
-}
+{
+  "name": "@acorex-platform/framework-shared",
+  "version": "0.0.9",
+  "type": "commonjs",
+  "sideEffects": false,
+  "exports": {
+    "./core": {
+      "types": "./core/src/index.d.ts",
+      "default": "./core/src/index.js"
+    },
+    "./domain": {
+      "types": "./domain/src/index.d.ts",
+      "default": "./domain/src/index.js"
+    },
+    "./entity": {
+      "types": "./entity/src/index.d.ts",
+      "default": "./entity/src/index.js"
+    },
+    "./runtime": {
+      "types": "./runtime/src/index.d.ts",
+      "default": "./runtime/src/index.js"
+    },
+    "./widget-core": {
+      "types": "./widget-core/src/index.d.ts",
+      "default": "./widget-core/src/index.js"
+    },
+    "./runtime/catalog-sidecars": {
+      "types": "./runtime/src/catalog-sidecars.d.ts",
+      "default": "./runtime/src/catalog-sidecars.js"
+    }
+  }
+}

package/runtime/src/catalog-sidecars.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Node-safe entry for `*.definition.ts` sidecars (generate-runtime-catalog under ts-node).
+ * Re-exports build-time metadata only — do not add Angular modules or runtime services here.
+ */
+export * from './lib/commands/catalog-command-definition';
+export * from './lib/queries/catalog-query-definition';
+export { defineWidget } from './lib/widgets/define-widget';
+//# sourceMappingURL=catalog-sidecars.d.ts.map

package/runtime/src/catalog-sidecars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-sidecars.d.ts","sourceRoot":"","sources":["../../../../../../libs/framework/shared/runtime/src/catalog-sidecars.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC"}

package/runtime/src/catalog-sidecars.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Node-safe entry for `*.definition.ts` sidecars (generate-runtime-catalog under ts-node).
+ * Re-exports build-time metadata only — do not add Angular modules or runtime services here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineWidget = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/commands/catalog-command-definition"), exports);
+tslib_1.__exportStar(require("./lib/queries/catalog-query-definition"), exports);
+var define_widget_1 = require("./lib/widgets/define-widget");
+Object.defineProperty(exports, "defineWidget", { enumerable: true, get: function () { return define_widget_1.defineWidget; } });
+//# sourceMappingURL=catalog-sidecars.js.map

package/runtime/src/catalog-sidecars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-sidecars.js","sourceRoot":"","sources":["../../../../../../libs/framework/shared/runtime/src/catalog-sidecars.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;AAEH,oFAA0D;AAC1D,iFAAuD;AACvD,6DAA2D;AAAlD,6GAAA,YAAY,OAAA"}

package/runtime/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib';
+//# sourceMappingURL=index.d.ts.map

package/runtime/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/framework/shared/runtime/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/runtime/src/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib"), exports);
+//# sourceMappingURL=index.js.map

package/runtime/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/framework/shared/runtime/src/index.ts"],"names":[],"mappings":";;;AAAA,gDAAsB"}

package/runtime/src/lib/commands/catalog-command-definition.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Build-time command metadata only. Safe under Node (e.g. generate-runtime-catalog) without loading the command executor stack.
+ * Sidecars should import `defineCommand` from `@acorex-platform/framework-shared/runtime`.
+ */
+export { defineCommand } from './define-command';
+export * from './command-definition.categories';
+export * from './command-definition.types';
+//# sourceMappingURL=catalog-command-definition.d.ts.map

package/runtime/src/lib/commands/catalog-command-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-command-definition.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/catalog-command-definition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC"}

package/runtime/src/lib/commands/catalog-command-definition.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineCommand = void 0;
+const tslib_1 = require("tslib");
+/**
+ * Build-time command metadata only. Safe under Node (e.g. generate-runtime-catalog) without loading the command executor stack.
+ * Sidecars should import `defineCommand` from `@acorex-platform/framework-shared/runtime`.
+ */
+var define_command_1 = require("./define-command");
+Object.defineProperty(exports, "defineCommand", { enumerable: true, get: function () { return define_command_1.defineCommand; } });
+tslib_1.__exportStar(require("./command-definition.categories"), exports);
+tslib_1.__exportStar(require("./command-definition.types"), exports);
+//# sourceMappingURL=catalog-command-definition.js.map

package/runtime/src/lib/commands/catalog-command-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-command-definition.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/catalog-command-definition.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,0EAAgD;AAChD,qEAA2C"}

package/runtime/src/lib/commands/command-definition.categories.d.ts

@@ -0,0 +1,2 @@
+export { AXP_CATALOG_DEFINITION_CATEGORY_AI_TOOLS as AXP_COMMAND_DEFINITION_CATEGORY_AI_TOOLS, AXP_CATALOG_DEFINITION_CATEGORY_ASSESSMENT as AXP_COMMAND_DEFINITION_CATEGORY_ASSESSMENT, AXP_CATALOG_DEFINITION_CATEGORY_DATA_MANAGEMENT as AXP_COMMAND_DEFINITION_CATEGORY_DATA_MANAGEMENT, AXP_CATALOG_DEFINITION_CATEGORY_ENTITY as AXP_COMMAND_DEFINITION_CATEGORY_ENTITY, AXP_CATALOG_DEFINITION_CATEGORY_FILE_WIDGET as AXP_COMMAND_DEFINITION_CATEGORY_FILE_WIDGET, AXP_CATALOG_DEFINITION_CATEGORY_HUMAN_CAPITAL as AXP_COMMAND_DEFINITION_CATEGORY_HUMAN_CAPITAL, AXP_CATALOG_DEFINITION_CATEGORY_ORGANIZATION as AXP_COMMAND_DEFINITION_CATEGORY_ORGANIZATION, AXP_CATALOG_DEFINITION_CATEGORY_PLATFORM as AXP_COMMAND_DEFINITION_CATEGORY_PLATFORM, AXP_CATALOG_DEFINITION_CATEGORY_PRODUCT as AXP_COMMAND_DEFINITION_CATEGORY_PRODUCT, AXP_CATALOG_DEFINITION_CATEGORY_REPORT as AXP_COMMAND_DEFINITION_CATEGORY_REPORT, AXP_CATALOG_DEFINITION_CATEGORY_SECURITY as AXP_COMMAND_DEFINITION_CATEGORY_SECURITY, AXP_CATALOG_DEFINITION_CATEGORY_SETTINGS as AXP_COMMAND_DEFINITION_CATEGORY_SETTINGS, AXP_CATALOG_DEFINITION_CATEGORY_STORAGE as AXP_COMMAND_DEFINITION_CATEGORY_STORAGE, AXP_CATALOG_DEFINITION_CATEGORY_TENANT as AXP_COMMAND_DEFINITION_CATEGORY_TENANT, AXP_CATALOG_DEFINITION_CATEGORY_UTILITY as AXP_COMMAND_DEFINITION_CATEGORY_UTILITY, AXP_CATALOG_DEFINITION_CATEGORY_WORKFLOW as AXP_COMMAND_DEFINITION_CATEGORY_WORKFLOW, } from '../shared/catalog-definition.categories';
+//# sourceMappingURL=command-definition.categories.d.ts.map

package/runtime/src/lib/commands/command-definition.categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-definition.categories.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command-definition.categories.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wCAAwC,IAAI,wCAAwC,EACpF,0CAA0C,IAAI,0CAA0C,EACxF,+CAA+C,IAAI,+CAA+C,EAClG,sCAAsC,IAAI,sCAAsC,EAChF,2CAA2C,IAAI,2CAA2C,EAC1F,6CAA6C,IAAI,6CAA6C,EAC9F,4CAA4C,IAAI,4CAA4C,EAC5F,wCAAwC,IAAI,wCAAwC,EACpF,uCAAuC,IAAI,uCAAuC,EAClF,sCAAsC,IAAI,sCAAsC,EAChF,wCAAwC,IAAI,wCAAwC,EACpF,wCAAwC,IAAI,wCAAwC,EACpF,uCAAuC,IAAI,uCAAuC,EAClF,sCAAsC,IAAI,sCAAsC,EAChF,uCAAuC,IAAI,uCAAuC,EAClF,wCAAwC,IAAI,wCAAwC,GACrF,MAAM,yCAAyC,CAAC"}

package/runtime/src/lib/commands/command-definition.categories.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_COMMAND_DEFINITION_CATEGORY_WORKFLOW = exports.AXP_COMMAND_DEFINITION_CATEGORY_UTILITY = exports.AXP_COMMAND_DEFINITION_CATEGORY_TENANT = exports.AXP_COMMAND_DEFINITION_CATEGORY_STORAGE = exports.AXP_COMMAND_DEFINITION_CATEGORY_SETTINGS = exports.AXP_COMMAND_DEFINITION_CATEGORY_SECURITY = exports.AXP_COMMAND_DEFINITION_CATEGORY_REPORT = exports.AXP_COMMAND_DEFINITION_CATEGORY_PRODUCT = exports.AXP_COMMAND_DEFINITION_CATEGORY_PLATFORM = exports.AXP_COMMAND_DEFINITION_CATEGORY_ORGANIZATION = exports.AXP_COMMAND_DEFINITION_CATEGORY_HUMAN_CAPITAL = exports.AXP_COMMAND_DEFINITION_CATEGORY_FILE_WIDGET = exports.AXP_COMMAND_DEFINITION_CATEGORY_ENTITY = exports.AXP_COMMAND_DEFINITION_CATEGORY_DATA_MANAGEMENT = exports.AXP_COMMAND_DEFINITION_CATEGORY_ASSESSMENT = exports.AXP_COMMAND_DEFINITION_CATEGORY_AI_TOOLS = void 0;
+var catalog_definition_categories_1 = require("../shared/catalog-definition.categories");
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_AI_TOOLS", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_AI_TOOLS; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_ASSESSMENT", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_ASSESSMENT; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_DATA_MANAGEMENT", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_DATA_MANAGEMENT; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_ENTITY", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_ENTITY; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_FILE_WIDGET", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_FILE_WIDGET; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_HUMAN_CAPITAL", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_HUMAN_CAPITAL; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_ORGANIZATION", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_ORGANIZATION; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_PLATFORM", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_PLATFORM; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_PRODUCT", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_PRODUCT; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_REPORT", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_REPORT; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_SECURITY", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_SECURITY; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_SETTINGS", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_SETTINGS; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_STORAGE", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_STORAGE; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_TENANT", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_TENANT; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_UTILITY", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_UTILITY; } });
+Object.defineProperty(exports, "AXP_COMMAND_DEFINITION_CATEGORY_WORKFLOW", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_WORKFLOW; } });
+//# sourceMappingURL=command-definition.categories.js.map

package/runtime/src/lib/commands/command-definition.categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-definition.categories.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command-definition.categories.ts"],"names":[],"mappings":";;;AAAA,yFAiBiD;AAhB/C,yJAAA,wCAAwC,OAA4C;AACpF,2JAAA,0CAA0C,OAA8C;AACxF,gKAAA,+CAA+C,OAAmD;AAClG,uJAAA,sCAAsC,OAA0C;AAChF,4JAAA,2CAA2C,OAA+C;AAC1F,8JAAA,6CAA6C,OAAiD;AAC9F,6JAAA,4CAA4C,OAAgD;AAC5F,yJAAA,wCAAwC,OAA4C;AACpF,wJAAA,uCAAuC,OAA2C;AAClF,uJAAA,sCAAsC,OAA0C;AAChF,yJAAA,wCAAwC,OAA4C;AACpF,yJAAA,wCAAwC,OAA4C;AACpF,wJAAA,uCAAuC,OAA2C;AAClF,uJAAA,sCAAsC,OAA0C;AAChF,wJAAA,uCAAuC,OAA2C;AAClF,yJAAA,wCAAwC,OAA4C"}

package/runtime/src/lib/commands/command-definition.types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Build-time command metadata for AXPCommand implementations.
+ * `inputs` / `outputs` are schema rows (same family as entity optionDefinitions).
+ * Validation entries: only `rule` name and optional `options` (no title/message on rules).
+ * Do not import from Angular templates; sidecars may import `defineCommand` from `@acorex-platform/framework-shared/runtime`.
+ *
+ * Query metadata (fetch-only, no outcomes) is defined in `../queries/query-definition.types.ts` with `defineQuery`.
+ * Widget metadata sidecars use `../widgets/widget-definition.types.ts` with `defineWidget`.
+ */
+import type { AXPCatalogExecutionMode, AXPCatalogMetadataDefinitionBase } from '../shared/catalog-definition-base.types';
+export * from '../shared/catalog-definition-base.types';
+export type AXPCommandOutcomeDefinition = {
+    mode: 'static';
+    values: string[];
+} | {
+    mode: 'dynamic';
+    summary: string;
+    derivesFrom: string;
+    examples?: string[];
+};
+export interface AXPCommandMetadataDefinition extends AXPCatalogMetadataDefinitionBase {
+    /** Runtime registration key (provideCommand / provideCommandSetups). */
+    key: string;
+    executionMode: AXPCatalogExecutionMode;
+    outcomes: AXPCommandOutcomeDefinition;
+}
+//# sourceMappingURL=command-definition.types.d.ts.map

package/runtime/src/lib/commands/command-definition.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-definition.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command-definition.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EACjC,MAAM,yCAAyC,CAAC;AAEjD,cAAc,yCAAyC,CAAC;AAIxD,MAAM,MAAM,2BAA2B,GACnC;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAMN,MAAM,WAAW,4BAA6B,SAAQ,gCAAgC;IACpF,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,uBAAuB,CAAC;IACvC,QAAQ,EAAE,2BAA2B,CAAC;CACvC"}

package/runtime/src/lib/commands/command-definition.types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Build-time command metadata for AXPCommand implementations.
+ * `inputs` / `outputs` are schema rows (same family as entity optionDefinitions).
+ * Validation entries: only `rule` name and optional `options` (no title/message on rules).
+ * Do not import from Angular templates; sidecars may import `defineCommand` from `@acorex-platform/framework-shared/runtime`.
+ *
+ * Query metadata (fetch-only, no outcomes) is defined in `../queries/query-definition.types.ts` with `defineQuery`.
+ * Widget metadata sidecars use `../widgets/widget-definition.types.ts` with `defineWidget`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("../shared/catalog-definition-base.types"), exports);
+//#endregion
+//# sourceMappingURL=command-definition.types.js.map

package/runtime/src/lib/commands/command-definition.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-definition.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command-definition.types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAOH,kFAAwD;AA2BxD,YAAY"}

package/runtime/src/lib/commands/command.interface.d.ts

@@ -0,0 +1,6 @@
+import { AXPExecuteCommandResult } from '@acorex-platform/framework-shared/core';
+export type AXPExecuteCommandResultPromise<TResult = any> = Promise<AXPExecuteCommandResult<TResult>>;
+export interface AXPCommand<TInput = any, TResult = any> {
+    execute(input: TInput): AXPExecuteCommandResultPromise<TResult>;
+}
+//# sourceMappingURL=command.interface.d.ts.map

package/runtime/src/lib/commands/command.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,MAAM,MAAM,8BAA8B,CAAC,OAAO,GAAG,GAAG,IAAI,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;AAEtG,MAAM,WAAW,UAAU,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACrD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;CACjE"}

package/runtime/src/lib/commands/command.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command.interface.js.map

package/runtime/src/lib/commands/command.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command.interface.ts"],"names":[],"mappings":""}

package/runtime/src/lib/commands/define-command.d.ts

@@ -0,0 +1,6 @@
+import type { AXPCommandMetadataDefinition } from './command-definition.types';
+/**
+ * Typed identity helper for command metadata sidecars.
+ */
+export declare function defineCommand<T extends AXPCommandMetadataDefinition>(definition: T): T;
+//# sourceMappingURL=define-command.d.ts.map

package/runtime/src/lib/commands/define-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-command.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/define-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAI/E;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,4BAA4B,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAEtF"}

package/runtime/src/lib/commands/define-command.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineCommand = defineCommand;
+//#region ---- defineCommand ----
+/**
+ * Typed identity helper for command metadata sidecars.
+ */
+function defineCommand(definition) {
+    return definition;
+}
+//#endregion
+//# sourceMappingURL=define-command.js.map

package/runtime/src/lib/commands/define-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-command.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/define-command.ts"],"names":[],"mappings":";;AAOA,sCAEC;AAPD,iCAAiC;AAEjC;;GAEG;AACH,SAAgB,aAAa,CAAyC,UAAa;IACjF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,YAAY"}

package/runtime/src/lib/index.d.ts

@@ -0,0 +1,16 @@
+export * from './shared/catalog-definition-base.types';
+export * from './shared/catalog-definition.categories';
+export * from './commands/command.interface';
+export * from './commands/command-definition.types';
+export * from './commands/command-definition.categories';
+export * from './commands/define-command';
+export * from './commands/catalog-command-definition';
+export * from './queries/query.interface';
+export * from './queries/query-definition.types';
+export * from './queries/query-definition.categories';
+export * from './queries/define-query';
+export * from './queries/catalog-query-definition';
+export * from './views/view.interface';
+export * from './widgets/widget-definition.types';
+export * from './widgets/define-widget';
+//# sourceMappingURL=index.d.ts.map

package/runtime/src/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/shared/runtime/src/lib/index.ts"],"names":[],"mappings":"AAEA,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AAEvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AAEtD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,oCAAoC,CAAC;AAEnD,cAAc,wBAAwB,CAAC;AAEvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC"}

package/runtime/src/lib/index.js

@@ -0,0 +1,21 @@
+"use strict";
+//#region ---- Runtime contracts ----
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./shared/catalog-definition-base.types"), exports);
+tslib_1.__exportStar(require("./shared/catalog-definition.categories"), exports);
+tslib_1.__exportStar(require("./commands/command.interface"), exports);
+tslib_1.__exportStar(require("./commands/command-definition.types"), exports);
+tslib_1.__exportStar(require("./commands/command-definition.categories"), exports);
+tslib_1.__exportStar(require("./commands/define-command"), exports);
+tslib_1.__exportStar(require("./commands/catalog-command-definition"), exports);
+tslib_1.__exportStar(require("./queries/query.interface"), exports);
+tslib_1.__exportStar(require("./queries/query-definition.types"), exports);
+tslib_1.__exportStar(require("./queries/query-definition.categories"), exports);
+tslib_1.__exportStar(require("./queries/define-query"), exports);
+tslib_1.__exportStar(require("./queries/catalog-query-definition"), exports);
+tslib_1.__exportStar(require("./views/view.interface"), exports);
+tslib_1.__exportStar(require("./widgets/widget-definition.types"), exports);
+tslib_1.__exportStar(require("./widgets/define-widget"), exports);
+//#endregion
+//# sourceMappingURL=index.js.map

package/runtime/src/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/shared/runtime/src/lib/index.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;AAErC,iFAAuD;AACvD,iFAAuD;AAEvD,uEAA6C;AAC7C,8EAAoD;AACpD,mFAAyD;AACzD,oEAA0C;AAC1C,gFAAsD;AAEtD,oEAA0C;AAC1C,2EAAiD;AACjD,gFAAsD;AACtD,iEAAuC;AACvC,6EAAmD;AAEnD,iEAAuC;AAEvC,4EAAkD;AAClD,kEAAwC;AAExC,YAAY"}

package/runtime/src/lib/queries/catalog-query-definition.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build-time query metadata only. Safe under Node (e.g. generate-runtime-catalog) without loading the query executor stack.
+ * Sidecars should import `defineQuery` from `@acorex-platform/framework-shared/runtime`.
+ */
+export { defineQuery } from './define-query';
+export * from './query-definition.categories';
+//# sourceMappingURL=catalog-query-definition.d.ts.map

package/runtime/src/lib/queries/catalog-query-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-query-definition.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/catalog-query-definition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,cAAc,+BAA+B,CAAC"}

package/runtime/src/lib/queries/catalog-query-definition.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineQuery = void 0;
+const tslib_1 = require("tslib");
+/**
+ * Build-time query metadata only. Safe under Node (e.g. generate-runtime-catalog) without loading the query executor stack.
+ * Sidecars should import `defineQuery` from `@acorex-platform/framework-shared/runtime`.
+ */
+var define_query_1 = require("./define-query");
+Object.defineProperty(exports, "defineQuery", { enumerable: true, get: function () { return define_query_1.defineQuery; } });
+tslib_1.__exportStar(require("./query-definition.categories"), exports);
+//# sourceMappingURL=catalog-query-definition.js.map

package/runtime/src/lib/queries/catalog-query-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-query-definition.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/catalog-query-definition.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,wEAA8C"}

package/runtime/src/lib/queries/define-query.d.ts

@@ -0,0 +1,6 @@
+import type { AXPQueryMetadataDefinition } from './query-definition.types';
+/**
+ * Typed identity helper for query metadata sidecars.
+ */
+export declare function defineQuery<T extends AXPQueryMetadataDefinition>(definition: T): T;
+//# sourceMappingURL=define-query.d.ts.map

package/runtime/src/lib/queries/define-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-query.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/define-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAI3E;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,0BAA0B,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAElF"}

package/runtime/src/lib/queries/define-query.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineQuery = defineQuery;
+//#region ---- defineQuery ----
+/**
+ * Typed identity helper for query metadata sidecars.
+ */
+function defineQuery(definition) {
+    return definition;
+}
+//#endregion
+//# sourceMappingURL=define-query.js.map

package/runtime/src/lib/queries/define-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-query.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/define-query.ts"],"names":[],"mappings":";;AAOA,kCAEC;AAPD,+BAA+B;AAE/B;;GAEG;AACH,SAAgB,WAAW,CAAuC,UAAa;IAC7E,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,YAAY"}

package/runtime/src/lib/queries/query-definition.categories.d.ts

@@ -0,0 +1,2 @@
+export { AXP_CATALOG_DEFINITION_CATEGORY_ENTITY as AXP_QUERY_DEFINITION_CATEGORY_ENTITY, AXP_CATALOG_DEFINITION_CATEGORY_PLATFORM as AXP_QUERY_DEFINITION_CATEGORY_PLATFORM, AXP_CATALOG_DEFINITION_CATEGORY_STORAGE as AXP_QUERY_DEFINITION_CATEGORY_STORAGE, AXP_CATALOG_DEFINITION_CATEGORY_WIDGETS as AXP_QUERY_DEFINITION_CATEGORY_WIDGETS, } from '../shared/catalog-definition.categories';
+//# sourceMappingURL=query-definition.categories.d.ts.map

package/runtime/src/lib/queries/query-definition.categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-definition.categories.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-definition.categories.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sCAAsC,IAAI,oCAAoC,EAC9E,wCAAwC,IAAI,sCAAsC,EAClF,uCAAuC,IAAI,qCAAqC,EAChF,uCAAuC,IAAI,qCAAqC,GACjF,MAAM,yCAAyC,CAAC"}

package/runtime/src/lib/queries/query-definition.categories.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_QUERY_DEFINITION_CATEGORY_WIDGETS = exports.AXP_QUERY_DEFINITION_CATEGORY_STORAGE = exports.AXP_QUERY_DEFINITION_CATEGORY_PLATFORM = exports.AXP_QUERY_DEFINITION_CATEGORY_ENTITY = void 0;
+var catalog_definition_categories_1 = require("../shared/catalog-definition.categories");
+Object.defineProperty(exports, "AXP_QUERY_DEFINITION_CATEGORY_ENTITY", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_ENTITY; } });
+Object.defineProperty(exports, "AXP_QUERY_DEFINITION_CATEGORY_PLATFORM", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_PLATFORM; } });
+Object.defineProperty(exports, "AXP_QUERY_DEFINITION_CATEGORY_STORAGE", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_STORAGE; } });
+Object.defineProperty(exports, "AXP_QUERY_DEFINITION_CATEGORY_WIDGETS", { enumerable: true, get: function () { return catalog_definition_categories_1.AXP_CATALOG_DEFINITION_CATEGORY_WIDGETS; } });
+//# sourceMappingURL=query-definition.categories.js.map

package/runtime/src/lib/queries/query-definition.categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-definition.categories.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-definition.categories.ts"],"names":[],"mappings":";;;AAAA,yFAKiD;AAJ/C,qJAAA,sCAAsC,OAAwC;AAC9E,uJAAA,wCAAwC,OAA0C;AAClF,sJAAA,uCAAuC,OAAyC;AAChF,sJAAA,uCAAuC,OAAyC"}

package/runtime/src/lib/queries/query-definition.types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Build-time query metadata for AXPQuery implementations.
+ * Mirrors command metadata shape except there are no `outcomes` (queries only `fetch`).
+ * Shares {@link AXPCatalogMetadataDefinitionBase} with commands and widgets; `inputs` / `outputs` live on the base.
+ */
+import type { AXPCatalogExecutionMode, AXPCatalogMetadataDefinitionBase, AXPCatalogSchemaPropertyDefinition } from '../shared/catalog-definition-base.types';
+/** One input/output property description for query definitions (same as command / widget catalog rows). */
+export type AXPQuerySchemaPropertyDefinition = AXPCatalogSchemaPropertyDefinition;
+export interface AXPQueryMetadataDefinition extends AXPCatalogMetadataDefinitionBase {
+    /** Runtime registration key (provideQuerySetups). */
+    key: string;
+    executionMode: AXPCatalogExecutionMode;
+}
+//# sourceMappingURL=query-definition.types.d.ts.map

package/runtime/src/lib/queries/query-definition.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-definition.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-definition.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAChC,kCAAkC,EACnC,MAAM,yCAAyC,CAAC;AAIjD,2GAA2G;AAC3G,MAAM,MAAM,gCAAgC,GAAG,kCAAkC,CAAC;AAElF,MAAM,WAAW,0BAA2B,SAAQ,gCAAgC;IAClF,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,uBAAuB,CAAC;CACxC"}

package/runtime/src/lib/queries/query-definition.types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Build-time query metadata for AXPQuery implementations.
+ * Mirrors command metadata shape except there are no `outcomes` (queries only `fetch`).
+ * Shares {@link AXPCatalogMetadataDefinitionBase} with commands and widgets; `inputs` / `outputs` live on the base.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=query-definition.types.js.map

package/runtime/src/lib/queries/query-definition.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-definition.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-definition.types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAmBH,YAAY"}

package/runtime/src/lib/queries/query.interface.d.ts

@@ -0,0 +1,4 @@
+export interface AXPQuery<TInput = any, TResult = any> {
+    fetch(input: TInput): Promise<TResult>;
+}
+//# sourceMappingURL=query.interface.d.ts.map

package/runtime/src/lib/queries/query.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query.interface.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACjD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C"}

package/runtime/src/lib/queries/query.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query.interface.js.map

package/runtime/src/lib/queries/query.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query.interface.ts"],"names":[],"mappings":""}

package/runtime/src/lib/shared/catalog-definition-base.types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Shared build-time catalog metadata for command, query, and widget definition sidecars
+ * (`defineCommand`, `defineQuery`, `defineWidget`).
+ * Lives under `shared/` so consumers import one module without a "command" prefix on generic shapes.
+ */
+import type { AXPDefinitionCategory } from '@acorex-platform/framework-shared/core';
+/** Catalog metadata validation: rule key + optional rule options only. */
+export interface AXPCatalogValidationRuleValue {
+    rule: string;
+    options?: Record<string, unknown>;
+}
+/**
+ * Widget/interface reference for a schema property (name + optional widget options).
+ */
+export interface AXPCatalogInterfaceDefinitionValue {
+    name: string;
+    options?: Record<string, unknown>;
+}
+/**
+ * Agent-facing hints when a single catalog row can be satisfied in several ways
+ * (inline list, registry-backed dataSource key, query + assign, tabular columns, context merge, etc.).
+ * Documentation only; tooling may surface this next to `description` and `interface`.
+ */
+export interface AXPCatalogPropertyBindingHints {
+    /** Named strategies the agent or author may use to supply this parameter. */
+    strategies?: readonly string[];
+    /** Short concrete examples (strings or JSON fragments as documentation, not executed). */
+    examples?: readonly string[];
+    /** Extra notes: merge rules, mode flags, registry keys, or when to prefer one strategy over another. */
+    notes?: string;
+}
+/**
+ * One input/output property description (same structural role as entity option definitions).
+ */
+export interface AXPCatalogSchemaPropertyDefinition {
+    name: string;
+    title: string;
+    description?: string;
+    icon?: string;
+    defaultValue?: unknown;
+    disabled?: boolean;
+    interface: AXPCatalogInterfaceDefinitionValue;
+    validations?: AXPCatalogValidationRuleValue[];
+    /**
+     * Optional multi-strategy binding documentation for AI and codegen (commands, queries, widget sidecars).
+     * Prefer this over inventing a non-form `interface.name` that is not part of the AI-facing widget catalog.
+     */
+    bindingHints?: AXPCatalogPropertyBindingHints;
+}
+/** Structured usage hints for planners and assistants (prefer over duplicating rules only in `description`). */
+export interface AXPCatalogAiUsageMetadata {
+    whenToUse?: string[];
+    avoidWhen?: string[];
+    /** Registry keys or tool names that commonly follow this catalog entry. */
+    followUpTools?: string[];
+}
+/** Declarative contracts: what the entry provides, who depends on it, and guarantees. */
+export interface AXPCatalogAiContractsMetadata {
+    provides?: string[];
+    requiredBy?: string[];
+    guarantees?: string[];
+}
+export type AXPCatalogAiSafetyKind = 'read-only' | 'mutating';
+export interface AXPCatalogAiSafetyMetadata {
+    kind?: AXPCatalogAiSafetyKind;
+    sideEffects?: boolean;
+    requiresConfirmation?: boolean;
+}
+export type AXPCatalogAiPerformanceCost = 'low' | 'medium' | 'high';
+export interface AXPCatalogAiPerformanceMetadata {
+    cost?: AXPCatalogAiPerformanceCost;
+    cacheable?: boolean;
+}
+export interface AXPCatalogAiNextStepMetadata {
+    when: string;
+    action: string;
+}
+/**
+ * How to interpret a successful payload for agents (documentation only; not live workflow step outcomes).
+ */
+export interface AXPCatalogAiResultSemanticsMetadata {
+    noMatch?: string;
+    exactMatch?: string;
+    multipleMatches?: string;
+    failed?: string;
+    /** Full catalog listing (e.g. no entity filter). */
+    catalog?: string;
+}
+export interface AXPCatalogAiMetadata {
+    shortDescription?: string;
+    /**
+     * Long-form guidance appended to LLM tool descriptions (not for short UI/registry copy).
+     * Keep root `description` concise for pickers and entity rows.
+     */
+    instruction?: string;
+    tags?: string[];
+    usage?: AXPCatalogAiUsageMetadata;
+    contracts?: AXPCatalogAiContractsMetadata;
+    safety?: AXPCatalogAiSafetyMetadata;
+    performance?: AXPCatalogAiPerformanceMetadata;
+    nextSteps?: AXPCatalogAiNextStepMetadata[];
+    resultSemantics?: AXPCatalogAiResultSemanticsMetadata;
+    /**
+     * Default input fragment merged for AI/tool invocations (catalog & tooling).
+     * Runtime merge for a given entry is applied in the AI module (not the generic command executor).
+     */
+    toolInputDefaults?: Record<string, unknown>;
+    /**
+     * Optional JSON Schema fragment for LLM tool `parameters` (OpenAI-style function calling).
+     * Merged over the auto-generated schema from catalog `inputs` (`properties` / `required` deep-merged).
+     * Use when widget-to-type inference is insufficient (e.g. `object`, `array`, `enum`, `format`).
+     */
+    toolParametersSchema?: Record<string, unknown>;
+}
+export type AXPCatalogExecutionMode = 'frontend' | 'backend' | 'both';
+/**
+ * Where this catalog entry is intended to appear in product tooling (AI agents, workflow automation pickers, etc.).
+ * Omitted = not declared here; runtimes may fall back to other metadata (e.g. `ai.tags`).
+ */
+export type AXPCatalogCapability = 'ai' | 'workflow';
+export interface AXPCatalogMetadataDefinitionBase {
+    title: string;
+    description: string;
+    inputs?: AXPCatalogSchemaPropertyDefinition[];
+    outputs?: AXPCatalogSchemaPropertyDefinition[];
+    ai?: AXPCatalogAiMetadata;
+    capabilities?: AXPCatalogCapability[];
+    categories?: AXPDefinitionCategory | AXPDefinitionCategory[];
+}
+//# sourceMappingURL=catalog-definition-base.types.d.ts.map