@kalada/core 0.0.0

package/dist/kuery-v1/types.d.ts

@@ -0,0 +1,65 @@
+/** JSON data accepted and produced by the strict expression API. */
+type JsonPrimitive = null | boolean | number | string;
+type JsonValue = JsonPrimitive | JsonArray | JsonObject;
+type JsonArray = readonly JsonValue[];
+type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+/** A literal, opaque reference, or operator application. */
+type ValueExpression<R extends JsonValue = string> = {
+    readonly kind: "literal";
+    readonly value: JsonValue;
+} | {
+    readonly kind: "ref";
+    readonly ref: R;
+} | {
+    readonly kind: "op";
+    readonly op: string;
+    readonly args: readonly ValueExpression<R>[];
+};
+type ExpressionPath = readonly (string | number)[];
+type ExpressionDiagnosticCode = "EXPRESSION_INVALID_INPUT" | "EXPRESSION_LIMIT_EXCEEDED" | "EXPRESSION_INVALID_REFERENCE" | "EXPRESSION_UNKNOWN_OPERATOR" | "EXPRESSION_INVALID_ARITY" | "EXPRESSION_TYPE_MISMATCH" | "EXPRESSION_DIVISION_BY_ZERO" | "EXPRESSION_NON_FINITE_RESULT" | "EXPRESSION_REFERENCE_ERROR" | "EXPRESSION_REFERENCE_MISSING" | "EXPRESSION_REFERENCE_DENIED" | "EXPRESSION_OPERATOR_ERROR" | "EXPRESSION_ASYNC_UNSUPPORTED" | "EXPRESSION_EVALUATION_LIMIT" | "EXPRESSION_INVALID_RESULT";
+interface ExpressionDiagnostic {
+    readonly code: ExpressionDiagnosticCode;
+    readonly path: ExpressionPath;
+    readonly message: string;
+}
+type Result<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly diagnostic: ExpressionDiagnostic;
+};
+interface ExpressionLimits {
+    readonly maxDepth: number;
+    readonly maxNodes: number;
+    readonly maxArgs: number;
+    readonly maxStringLength: number;
+    readonly maxReferenceLength: number;
+    readonly maxEvaluationSteps: number;
+}
+interface ReferenceCodec<R extends JsonValue> {
+    readonly validate: (input: unknown) => input is R;
+    readonly canonicalize?: (reference: R) => R;
+}
+interface CanonicalizeExpressionOptions<R extends JsonValue> {
+    readonly reference?: ReferenceCodec<R>;
+    readonly limits?: Partial<ExpressionLimits>;
+}
+type ReferenceResolution = {
+    readonly found: true;
+    readonly value: JsonValue;
+} | {
+    readonly found: false;
+    readonly reason?: "missing" | "denied" | undefined;
+};
+/** Trusted host callback. Throwing and asynchronous outcomes are contained as diagnostics. */
+type ReferenceResolver<R extends JsonValue> = (reference: R) => ReferenceResolution;
+interface CompiledExpression<R extends JsonValue> {
+    readonly expression: ValueExpression<R>;
+    readonly dependencies: readonly R[];
+    evaluate(resolve: ReferenceResolver<R>): Result<JsonValue>;
+}
+
+export type { CanonicalizeExpressionOptions, CompiledExpression, ExpressionDiagnostic, ExpressionDiagnosticCode, ExpressionLimits, ExpressionPath, JsonArray, JsonObject, JsonPrimitive, JsonValue, ReferenceCodec, ReferenceResolution, ReferenceResolver, Result, ValueExpression };

package/dist/kuery-v1/types.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

package/dist/kuery-v1/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}

package/dist/program-v1.cjs

@@ -0,0 +1,72 @@
+'use strict';
+
+var canonicalize_js = require('./kuery-v1/canonicalize.js');
+var result_js = require('./kuery-v1/result.js');
+
+const PROGRAM_KEYS = /* @__PURE__ */ new Set(["format", "version", "profile", "expression"]);
+function canonicalizeKaladaProgramV1(input, options = {}) {
+  const fields = readProgramFields(input);
+  if (!fields.ok) return fields;
+  if (fields.value.format !== "kalada-program" || fields.value.version !== 1 || fields.value.profile !== "standard-v1") {
+    return result_js.failure("EXPRESSION_INVALID_INPUT", []);
+  }
+  const expression = canonicalize_js.canonicalizeExpression(fields.value.expression, options);
+  if (!expression.ok) return prefixExpressionPath(expression.diagnostic);
+  return result_js.success(
+    Object.freeze({
+      format: "kalada-program",
+      version: 1,
+      profile: "standard-v1",
+      expression: expression.value
+    })
+  );
+}
+function fromKueryExpression(expression, options = {}) {
+  return canonicalizeKaladaProgramV1(
+    { format: "kalada-program", version: 1, profile: "standard-v1", expression },
+    options
+  );
+}
+function toKueryExpression(program, options = {}) {
+  const canonical = canonicalizeKaladaProgramV1(program, options);
+  return canonical.ok ? result_js.success(canonical.value.expression) : canonical;
+}
+function readProgramFields(input) {
+  if (!isPlainObject(input)) return result_js.failure("EXPRESSION_INVALID_INPUT", []);
+  try {
+    const keys = Reflect.ownKeys(input);
+    if (keys.length !== PROGRAM_KEYS.size) return result_js.failure("EXPRESSION_INVALID_INPUT", []);
+    const fields = {};
+    for (const key of keys) {
+      if (typeof key !== "string" || !PROGRAM_KEYS.has(key)) {
+        return result_js.failure("EXPRESSION_INVALID_INPUT", []);
+      }
+      const descriptor = Object.getOwnPropertyDescriptor(input, key);
+      if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) {
+        return result_js.failure("EXPRESSION_INVALID_INPUT", [key]);
+      }
+      fields[key] = descriptor.value;
+    }
+    return result_js.success(fields);
+  } catch {
+    return result_js.failure("EXPRESSION_INVALID_INPUT", []);
+  }
+}
+function isPlainObject(input) {
+  if (typeof input !== "object" || input === null || Array.isArray(input)) return false;
+  try {
+    const prototype = Object.getPrototypeOf(input);
+    return prototype === Object.prototype || prototype === null;
+  } catch {
+    return false;
+  }
+}
+function prefixExpressionPath(diagnostic) {
+  return result_js.failure(diagnostic.code, ["expression", ...diagnostic.path]);
+}
+
+exports.canonicalizeKaladaProgramV1 = canonicalizeKaladaProgramV1;
+exports.fromKueryExpression = fromKueryExpression;
+exports.toKueryExpression = toKueryExpression;
+//# sourceMappingURL=program-v1.cjs.map
+//# sourceMappingURL=program-v1.cjs.map

package/dist/program-v1.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/program-v1.ts"],"names":["failure","canonicalizeExpression","success"],"mappings":"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","file":"program-v1.cjs","sourcesContent":["import { canonicalizeExpression } from \"./kuery-v1/canonicalize.js\";\nimport { failure, success } from \"./kuery-v1/result.js\";\nimport type {\n  CanonicalizeExpressionOptions,\n  ExpressionDiagnostic,\n  JsonValue,\n  Result,\n  ValueExpression,\n} from \"./kuery-v1/types.js\";\n\nexport interface KaladaProgramV1<R extends JsonValue = string> {\n  readonly format: \"kalada-program\";\n  readonly version: 1;\n  readonly profile: \"standard-v1\";\n  readonly expression: ValueExpression<R>;\n}\n\nexport type KaladaProgramV1Options<R extends JsonValue = string> = CanonicalizeExpressionOptions<R>;\nexport type KaladaProgramV1Result<R extends JsonValue = string> = Result<KaladaProgramV1<R>>;\nexport type KueryExpressionV1<R extends JsonValue = string> = ValueExpression<R>;\nexport type KaladaProgramDiagnostic = ExpressionDiagnostic;\n\nconst PROGRAM_KEYS = new Set([\"format\", \"version\", \"profile\", \"expression\"]);\n\nexport function canonicalizeKaladaProgramV1<R extends JsonValue = string>(\n  input: unknown,\n  options: KaladaProgramV1Options<R> = {},\n): KaladaProgramV1Result<R> {\n  const fields = readProgramFields(input);\n  if (!fields.ok) return fields;\n  if (\n    fields.value.format !== \"kalada-program\" ||\n    fields.value.version !== 1 ||\n    fields.value.profile !== \"standard-v1\"\n  ) {\n    return failure(\"EXPRESSION_INVALID_INPUT\", []);\n  }\n  const expression = canonicalizeExpression<R>(fields.value.expression, options);\n  if (!expression.ok) return prefixExpressionPath(expression.diagnostic);\n  return success(\n    Object.freeze({\n      format: \"kalada-program\",\n      version: 1,\n      profile: \"standard-v1\",\n      expression: expression.value,\n    }),\n  );\n}\n\nexport function fromKueryExpression<R extends JsonValue = string>(\n  expression: unknown,\n  options: KaladaProgramV1Options<R> = {},\n): KaladaProgramV1Result<R> {\n  return canonicalizeKaladaProgramV1(\n    { format: \"kalada-program\", version: 1, profile: \"standard-v1\", expression },\n    options,\n  );\n}\n\nexport function toKueryExpression<R extends JsonValue = string>(\n  program: unknown,\n  options: KaladaProgramV1Options<R> = {},\n): Result<ValueExpression<R>> {\n  const canonical = canonicalizeKaladaProgramV1<R>(program, options);\n  return canonical.ok ? success(canonical.value.expression) : canonical;\n}\n\nfunction readProgramFields(input: unknown): Result<Readonly<Record<string, unknown>>> {\n  if (!isPlainObject(input)) return failure(\"EXPRESSION_INVALID_INPUT\", []);\n  try {\n    const keys = Reflect.ownKeys(input);\n    if (keys.length !== PROGRAM_KEYS.size) return failure(\"EXPRESSION_INVALID_INPUT\", []);\n    const fields: Record<string, unknown> = {};\n    for (const key of keys) {\n      if (typeof key !== \"string\" || !PROGRAM_KEYS.has(key)) {\n        return failure(\"EXPRESSION_INVALID_INPUT\", []);\n      }\n      const descriptor = Object.getOwnPropertyDescriptor(input, key);\n      if (!descriptor || !(\"value\" in descriptor) || !descriptor.enumerable) {\n        return failure(\"EXPRESSION_INVALID_INPUT\", [key]);\n      }\n      fields[key] = descriptor.value;\n    }\n    return success(fields);\n  } catch {\n    return failure(\"EXPRESSION_INVALID_INPUT\", []);\n  }\n}\n\nfunction isPlainObject(input: unknown): input is object {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) return false;\n  try {\n    const prototype = Object.getPrototypeOf(input);\n    return prototype === Object.prototype || prototype === null;\n  } catch {\n    return false;\n  }\n}\n\nfunction prefixExpressionPath<R extends JsonValue>(\n  diagnostic: ExpressionDiagnostic,\n): KaladaProgramV1Result<R> {\n  return failure(diagnostic.code, [\"expression\", ...diagnostic.path]);\n}\n"]}

package/dist/program-v1.d.cts

@@ -0,0 +1,17 @@
+import { ExpressionDiagnostic, JsonValue, ValueExpression, CanonicalizeExpressionOptions, Result } from './kuery-v1/types.cjs';
+
+interface KaladaProgramV1<R extends JsonValue = string> {
+    readonly format: "kalada-program";
+    readonly version: 1;
+    readonly profile: "standard-v1";
+    readonly expression: ValueExpression<R>;
+}
+type KaladaProgramV1Options<R extends JsonValue = string> = CanonicalizeExpressionOptions<R>;
+type KaladaProgramV1Result<R extends JsonValue = string> = Result<KaladaProgramV1<R>>;
+type KueryExpressionV1<R extends JsonValue = string> = ValueExpression<R>;
+type KaladaProgramDiagnostic = ExpressionDiagnostic;
+declare function canonicalizeKaladaProgramV1<R extends JsonValue = string>(input: unknown, options?: KaladaProgramV1Options<R>): KaladaProgramV1Result<R>;
+declare function fromKueryExpression<R extends JsonValue = string>(expression: unknown, options?: KaladaProgramV1Options<R>): KaladaProgramV1Result<R>;
+declare function toKueryExpression<R extends JsonValue = string>(program: unknown, options?: KaladaProgramV1Options<R>): Result<ValueExpression<R>>;
+
+export { type KaladaProgramDiagnostic, type KaladaProgramV1, type KaladaProgramV1Options, type KaladaProgramV1Result, type KueryExpressionV1, canonicalizeKaladaProgramV1, fromKueryExpression, toKueryExpression };

package/dist/program-v1.d.ts

@@ -0,0 +1,17 @@
+import { ExpressionDiagnostic, JsonValue, ValueExpression, CanonicalizeExpressionOptions, Result } from './kuery-v1/types.js';
+
+interface KaladaProgramV1<R extends JsonValue = string> {
+    readonly format: "kalada-program";
+    readonly version: 1;
+    readonly profile: "standard-v1";
+    readonly expression: ValueExpression<R>;
+}
+type KaladaProgramV1Options<R extends JsonValue = string> = CanonicalizeExpressionOptions<R>;
+type KaladaProgramV1Result<R extends JsonValue = string> = Result<KaladaProgramV1<R>>;
+type KueryExpressionV1<R extends JsonValue = string> = ValueExpression<R>;
+type KaladaProgramDiagnostic = ExpressionDiagnostic;
+declare function canonicalizeKaladaProgramV1<R extends JsonValue = string>(input: unknown, options?: KaladaProgramV1Options<R>): KaladaProgramV1Result<R>;
+declare function fromKueryExpression<R extends JsonValue = string>(expression: unknown, options?: KaladaProgramV1Options<R>): KaladaProgramV1Result<R>;
+declare function toKueryExpression<R extends JsonValue = string>(program: unknown, options?: KaladaProgramV1Options<R>): Result<ValueExpression<R>>;
+
+export { type KaladaProgramDiagnostic, type KaladaProgramV1, type KaladaProgramV1Options, type KaladaProgramV1Result, type KueryExpressionV1, canonicalizeKaladaProgramV1, fromKueryExpression, toKueryExpression };

package/dist/program-v1.js

@@ -0,0 +1,68 @@
+import { canonicalizeExpression } from './kuery-v1/canonicalize.js';
+import { failure, success } from './kuery-v1/result.js';
+
+const PROGRAM_KEYS = /* @__PURE__ */ new Set(["format", "version", "profile", "expression"]);
+function canonicalizeKaladaProgramV1(input, options = {}) {
+  const fields = readProgramFields(input);
+  if (!fields.ok) return fields;
+  if (fields.value.format !== "kalada-program" || fields.value.version !== 1 || fields.value.profile !== "standard-v1") {
+    return failure("EXPRESSION_INVALID_INPUT", []);
+  }
+  const expression = canonicalizeExpression(fields.value.expression, options);
+  if (!expression.ok) return prefixExpressionPath(expression.diagnostic);
+  return success(
+    Object.freeze({
+      format: "kalada-program",
+      version: 1,
+      profile: "standard-v1",
+      expression: expression.value
+    })
+  );
+}
+function fromKueryExpression(expression, options = {}) {
+  return canonicalizeKaladaProgramV1(
+    { format: "kalada-program", version: 1, profile: "standard-v1", expression },
+    options
+  );
+}
+function toKueryExpression(program, options = {}) {
+  const canonical = canonicalizeKaladaProgramV1(program, options);
+  return canonical.ok ? success(canonical.value.expression) : canonical;
+}
+function readProgramFields(input) {
+  if (!isPlainObject(input)) return failure("EXPRESSION_INVALID_INPUT", []);
+  try {
+    const keys = Reflect.ownKeys(input);
+    if (keys.length !== PROGRAM_KEYS.size) return failure("EXPRESSION_INVALID_INPUT", []);
+    const fields = {};
+    for (const key of keys) {
+      if (typeof key !== "string" || !PROGRAM_KEYS.has(key)) {
+        return failure("EXPRESSION_INVALID_INPUT", []);
+      }
+      const descriptor = Object.getOwnPropertyDescriptor(input, key);
+      if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) {
+        return failure("EXPRESSION_INVALID_INPUT", [key]);
+      }
+      fields[key] = descriptor.value;
+    }
+    return success(fields);
+  } catch {
+    return failure("EXPRESSION_INVALID_INPUT", []);
+  }
+}
+function isPlainObject(input) {
+  if (typeof input !== "object" || input === null || Array.isArray(input)) return false;
+  try {
+    const prototype = Object.getPrototypeOf(input);
+    return prototype === Object.prototype || prototype === null;
+  } catch {
+    return false;
+  }
+}
+function prefixExpressionPath(diagnostic) {
+  return failure(diagnostic.code, ["expression", ...diagnostic.path]);
+}
+
+export { canonicalizeKaladaProgramV1, fromKueryExpression, toKueryExpression };
+//# sourceMappingURL=program-v1.js.map
+//# sourceMappingURL=program-v1.js.map

package/dist/program-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/program-v1.ts"],"names":[],"mappings":"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","file":"program-v1.js","sourcesContent":["import { canonicalizeExpression } from \"./kuery-v1/canonicalize.js\";\nimport { failure, success } from \"./kuery-v1/result.js\";\nimport type {\n  CanonicalizeExpressionOptions,\n  ExpressionDiagnostic,\n  JsonValue,\n  Result,\n  ValueExpression,\n} from \"./kuery-v1/types.js\";\n\nexport interface KaladaProgramV1<R extends JsonValue = string> {\n  readonly format: \"kalada-program\";\n  readonly version: 1;\n  readonly profile: \"standard-v1\";\n  readonly expression: ValueExpression<R>;\n}\n\nexport type KaladaProgramV1Options<R extends JsonValue = string> = CanonicalizeExpressionOptions<R>;\nexport type KaladaProgramV1Result<R extends JsonValue = string> = Result<KaladaProgramV1<R>>;\nexport type KueryExpressionV1<R extends JsonValue = string> = ValueExpression<R>;\nexport type KaladaProgramDiagnostic = ExpressionDiagnostic;\n\nconst PROGRAM_KEYS = new Set([\"format\", \"version\", \"profile\", \"expression\"]);\n\nexport function canonicalizeKaladaProgramV1<R extends JsonValue = string>(\n  input: unknown,\n  options: KaladaProgramV1Options<R> = {},\n): KaladaProgramV1Result<R> {\n  const fields = readProgramFields(input);\n  if (!fields.ok) return fields;\n  if (\n    fields.value.format !== \"kalada-program\" ||\n    fields.value.version !== 1 ||\n    fields.value.profile !== \"standard-v1\"\n  ) {\n    return failure(\"EXPRESSION_INVALID_INPUT\", []);\n  }\n  const expression = canonicalizeExpression<R>(fields.value.expression, options);\n  if (!expression.ok) return prefixExpressionPath(expression.diagnostic);\n  return success(\n    Object.freeze({\n      format: \"kalada-program\",\n      version: 1,\n      profile: \"standard-v1\",\n      expression: expression.value,\n    }),\n  );\n}\n\nexport function fromKueryExpression<R extends JsonValue = string>(\n  expression: unknown,\n  options: KaladaProgramV1Options<R> = {},\n): KaladaProgramV1Result<R> {\n  return canonicalizeKaladaProgramV1(\n    { format: \"kalada-program\", version: 1, profile: \"standard-v1\", expression },\n    options,\n  );\n}\n\nexport function toKueryExpression<R extends JsonValue = string>(\n  program: unknown,\n  options: KaladaProgramV1Options<R> = {},\n): Result<ValueExpression<R>> {\n  const canonical = canonicalizeKaladaProgramV1<R>(program, options);\n  return canonical.ok ? success(canonical.value.expression) : canonical;\n}\n\nfunction readProgramFields(input: unknown): Result<Readonly<Record<string, unknown>>> {\n  if (!isPlainObject(input)) return failure(\"EXPRESSION_INVALID_INPUT\", []);\n  try {\n    const keys = Reflect.ownKeys(input);\n    if (keys.length !== PROGRAM_KEYS.size) return failure(\"EXPRESSION_INVALID_INPUT\", []);\n    const fields: Record<string, unknown> = {};\n    for (const key of keys) {\n      if (typeof key !== \"string\" || !PROGRAM_KEYS.has(key)) {\n        return failure(\"EXPRESSION_INVALID_INPUT\", []);\n      }\n      const descriptor = Object.getOwnPropertyDescriptor(input, key);\n      if (!descriptor || !(\"value\" in descriptor) || !descriptor.enumerable) {\n        return failure(\"EXPRESSION_INVALID_INPUT\", [key]);\n      }\n      fields[key] = descriptor.value;\n    }\n    return success(fields);\n  } catch {\n    return failure(\"EXPRESSION_INVALID_INPUT\", []);\n  }\n}\n\nfunction isPlainObject(input: unknown): input is object {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) return false;\n  try {\n    const prototype = Object.getPrototypeOf(input);\n    return prototype === Object.prototype || prototype === null;\n  } catch {\n    return false;\n  }\n}\n\nfunction prefixExpressionPath<R extends JsonValue>(\n  diagnostic: ExpressionDiagnostic,\n): KaladaProgramV1Result<R> {\n  return failure(diagnostic.code, [\"expression\", ...diagnostic.path]);\n}\n"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@kalada/core",
+  "version": "0.0.0",
+  "description": "Canonical runtime contracts for the Kalada expression language",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "provenance",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./kuery-v1": {
+      "import": {
+        "types": "./dist/kuery-v1/index.d.ts",
+        "default": "./dist/kuery-v1/index.js"
+      },
+      "require": {
+        "types": "./dist/kuery-v1/index.d.cts",
+        "default": "./dist/kuery-v1/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run src",
+    "typecheck": "tsc --noEmit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}

package/provenance/kuery-2.1.0.json

@@ -0,0 +1,93 @@
+{
+  "upstream": {
+    "package": "kuery@2.1.0",
+    "tag": "v2.1.0",
+    "releaseCommit": "732eb12b1deacd85bb1421b92169c9af20a98962",
+    "sourceTree": "be5951e00aa227d3f6c4009700fe5920e786b66c",
+    "treeListingSha256": "6bf36f342a26b2021a51f12b8421e6e8b5be630cee53e99e3142e81fafaf78c9",
+    "npmIntegrity": "sha512-L7H1oOAJApFQvgAuwBGvUsUcYmqsg04LxfpiCHSrYqDKecOzPDT4X2Yz5YrqrJDJevlZTCmsafV3JcBvAdxnJA=="
+  },
+  "productionFiles": [
+    [
+      "callback-promise.ts",
+      "7178b9cd936d317eaaec786932c1c251656fbb79",
+      "076faae096ce36ccfbc1e82a23c66f561b9af008514c4230bea1d5a7bba61d21"
+    ],
+    [
+      "canonicalize.ts",
+      "8b92e931c62855f7e677a93f1563cbcc5103d78c",
+      "aff37b07cf2b3cf6096e63208fc3cd4db5dcb2db9411cf111c708350af236eb1"
+    ],
+    [
+      "compile.ts",
+      "f3f5125cfbcc96bbc6cdd70af3d20528558cf044",
+      "b68b30cbcf4328f84a6f612c8f72808ba795f627f37109eb8d8d9abb4aef13e9"
+    ],
+    [
+      "dependencies.ts",
+      "09da4c7f3fe418257fd77607e8a977edd43a6be9",
+      "68f24956a37692d19a87fb1a54c4293f9c47a8d89b459a3b9bf97437ab2070dd"
+    ],
+    [
+      "evaluate.ts",
+      "e99d3e5d7b7531bf968828c2dad9f73e3a1b5cd9",
+      "2d3faf5f31717b2a8930ed27f7af54066816a8734a293d1743ff53c6d129376c"
+    ],
+    [
+      "index.ts",
+      "e747100518abce0ddf58139cf5a075a3b48a609b",
+      "2a975ea636eb0377c295c9e2296b65a0a100b34af8c90dde91a36c0c7d005ccd"
+    ],
+    [
+      "inspect.ts",
+      "abb662b632a836395a061f217b456b7691588158",
+      "05386e1a47cdb907f3da624be4e451c9e1ca50076d87912bb8da432856db94a3"
+    ],
+    [
+      "json-schema.ts",
+      "8c24f1d359bd2b0e7c8eb52b20fd7ec5e6f2b884",
+      "91f4894acf7701410727b5fd2e919e7c1bb67b546cdc7abca346805e9c49ee5a"
+    ],
+    [
+      "limits.ts",
+      "4ce94b35a92d3f3757625c9e692e371a6b926770",
+      "9a05f3f16f5d44746d4dbc8ffe09dee4415b95fec798bbd714fb3bee876f338b"
+    ],
+    [
+      "profile.ts",
+      "81d40b568f12ff09cac3121825a3e36ffa594367",
+      "6c5f8dadb87160ae2e1c9a544c099653000d77c6f8b51b7a2f1eda30219312bd"
+    ],
+    [
+      "result.ts",
+      "a1cf6072df5c05be80fcae3691fd2ff09c3a6fd7",
+      "12e4a4848b6c6337a45afed49c23f85d7dc53cdf052f6630fe92cf0e71377dca"
+    ],
+    [
+      "standard-profile.ts",
+      "b820f6c2b1f2a29bc01eab9184a3252f570c94ec",
+      "75ecb1cf7e552033243e0fdfb3bb8b944b2c3105f4d56e7b541e2408175eec0a"
+    ],
+    [
+      "types.ts",
+      "29eaacffbe92dca89a28a334ec4521bdea1b1374",
+      "702f11f74b602afe3c73cae364fc48b5cda705b1dec52d267c1599f17bd4b14c"
+    ]
+  ],
+  "productionSourcePrefix": "src/expression/",
+  "productionDestinationPrefix": "packages/core/src/kuery-v1/",
+  "productionClassification": "verbatim source before repository formatting; formatting/import/type syntax, explicit fields replacing parameter properties, strict annotations, one local rename, and one cohesive helper extraction only",
+  "tests": {
+    "source": "src/expression/__tests__/expression.test.ts",
+    "blob": "7b3e2dcda1bbe43e09119cb6f9b7f32ee3e3678c",
+    "sha256": "0d63e399e0e64326f752e573617c57e8955e2dd6490ffb5abd76b5cd8759c239",
+    "destinations": [
+      "packages/core/src/kuery-v1/__tests__/canonicalize.test.ts",
+      "packages/core/src/kuery-v1/__tests__/standard-profile.test.ts",
+      "packages/core/src/kuery-v1/__tests__/compiled.test.ts",
+      "packages/core/src/kuery-v1/__tests__/profiles.test.ts",
+      "packages/core/src/kuery-v1/__tests__/json-schema.test.ts"
+    ],
+    "classification": "split by top-level suite; imports formatted; strict annotations added; shared fixture constructors extracted"
+  }
+}