@weave-kit/engine 0.1.0

package/dist/core/object/parse.d.ts

@@ -0,0 +1,10 @@
+import type { ObjectDefinition } from '../types/index.js';
+import { type ValidateOptions } from './validate.js';
+/**
+ * Parse a `schema.json` file string into a validated object definition. Older
+ * on-disk formats are migrated to the current one before validation, so
+ * unversioned files keep loading. Throws a localized {@link SchemaError} on
+ * invalid JSON, an unsupported format version, or an invalid schema.
+ */
+export declare function parseSchema(json: string, options?: ValidateOptions): ObjectDefinition;
+//# sourceMappingURL=parse.d.ts.map

package/dist/core/object/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/core/object/parse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAYrF"}

package/dist/core/object/parse.js

@@ -0,0 +1,23 @@
+import { SchemaError } from '../types/errors.js';
+import { migrateSchemaObject } from './migrations.js';
+import { validateObject } from './validate.js';
+/**
+ * Parse a `schema.json` file string into a validated object definition. Older
+ * on-disk formats are migrated to the current one before validation, so
+ * unversioned files keep loading. Throws a localized {@link SchemaError} on
+ * invalid JSON, an unsupported format version, or an invalid schema.
+ */
+export function parseSchema(json, options) {
+    let data;
+    try {
+        data = JSON.parse(json);
+    }
+    catch {
+        throw new SchemaError('parse.json.invalid');
+    }
+    const migrated = typeof data === 'object' && data !== null && !Array.isArray(data)
+        ? migrateSchemaObject(data, options?.locale).object
+        : data;
+    return validateObject(migrated, options);
+}
+//# sourceMappingURL=parse.js.map

package/dist/core/object/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/core/object/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAwB,MAAM,eAAe,CAAC;AAErE;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAyB;IACjE,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,QAAQ,GACZ,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAC/D,CAAC,CAAC,mBAAmB,CAAC,IAA+B,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM;QAC9E,CAAC,CAAC,IAAI,CAAC;IACX,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/core/object/registry.d.ts

@@ -0,0 +1,24 @@
+import type { ObjectDefinition } from '../types/index.js';
+import { RelationGraph, type BuildGraphOptions } from './graph.js';
+import { type ValidateOptions } from './validate.js';
+/**
+ * In-memory collection of object definitions keyed by object name.
+ *
+ * Register validates each object (self-contained checks only — cross-object
+ * checks happen in {@link buildGraph}) and rejects duplicates. `buildGraph`
+ * then validates relations across the whole set and derives the relation graph.
+ */
+export declare class ObjectRegistry {
+    private readonly defs;
+    /** validate and store one object definition; throws on duplicate name */
+    register(input: unknown, options?: ValidateOptions): ObjectDefinition;
+    /** look up an object by name */
+    get(name: string): ObjectDefinition | undefined;
+    /** all registered objects, in registration order */
+    list(): ObjectDefinition[];
+    /** cross-object validation + relation graph derivation over all objects */
+    buildGraph(options?: BuildGraphOptions): RelationGraph;
+}
+/** one-off validation of a single object definition (no registry, no graph) */
+export declare function defineObject(input: unknown, options?: ValidateOptions): ObjectDefinition;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/object/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/object/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAc,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAErE;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuC;IAE5D,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,gBAAgB;IASrE,gCAAgC;IAChC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/C,oDAAoD;IACpD,IAAI,IAAI,gBAAgB,EAAE;IAI1B,2EAA2E;IAC3E,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,aAAa;CAGvD;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAExF"}

package/dist/core/object/registry.js

@@ -0,0 +1,39 @@
+import { SchemaError } from '../types/errors.js';
+import { buildGraph, RelationGraph } from './graph.js';
+import { validateObject } from './validate.js';
+/**
+ * In-memory collection of object definitions keyed by object name.
+ *
+ * Register validates each object (self-contained checks only — cross-object
+ * checks happen in {@link buildGraph}) and rejects duplicates. `buildGraph`
+ * then validates relations across the whole set and derives the relation graph.
+ */
+export class ObjectRegistry {
+    defs = new Map();
+    /** validate and store one object definition; throws on duplicate name */
+    register(input, options) {
+        const def = validateObject(input, options);
+        if (this.defs.has(def.name)) {
+            throw new SchemaError('registry.duplicate', { name: def.name }, options?.locale);
+        }
+        this.defs.set(def.name, def);
+        return def;
+    }
+    /** look up an object by name */
+    get(name) {
+        return this.defs.get(name);
+    }
+    /** all registered objects, in registration order */
+    list() {
+        return [...this.defs.values()];
+    }
+    /** cross-object validation + relation graph derivation over all objects */
+    buildGraph(options) {
+        return buildGraph(this.defs, options);
+    }
+}
+/** one-off validation of a single object definition (no registry, no graph) */
+export function defineObject(input, options) {
+    return validateObject(input, options);
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/object/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/object/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,aAAa,EAA0B,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAwB,MAAM,eAAe,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACR,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE5D,yEAAyE;IACzE,QAAQ,CAAC,KAAc,EAAE,OAAyB;QAChD,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,WAAW,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gCAAgC;IAChC,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,oDAAoD;IACpD,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,2EAA2E;IAC3E,UAAU,CAAC,OAA2B;QACpC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;CACF;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,OAAyB;IACpE,OAAO,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/dist/core/object/schema-version.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `schema.json` on-disk format version — single source of truth.
+ *
+ * Every object file may carry a top-level `schemaVersion` (a positive integer).
+ * Files written before versioning existed are treated as {@link LEGACY_SCHEMA_FORMAT_VERSION}.
+ * Bump {@link SCHEMA_FORMAT_VERSION} and register a migration in `migrations.ts`
+ * whenever the on-disk shape changes; `weave schema:upgrade` stamps files to the
+ * current version and the loader reads older files through the same migrations.
+ */
+export declare const SCHEMA_FORMAT_VERSION: 1;
+export type SchemaFormatVersion = typeof SCHEMA_FORMAT_VERSION;
+/** implicit version of files that predate the `schemaVersion` field. */
+export declare const LEGACY_SCHEMA_FORMAT_VERSION: 0;
+//# sourceMappingURL=schema-version.d.ts.map

package/dist/core/object/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../../../src/core/object/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAG,CAAU,CAAC;AAChD,MAAM,MAAM,mBAAmB,GAAG,OAAO,qBAAqB,CAAC;AAE/D,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,EAAG,CAAU,CAAC"}

package/dist/core/object/schema-version.js

@@ -0,0 +1,13 @@
+/**
+ * `schema.json` on-disk format version — single source of truth.
+ *
+ * Every object file may carry a top-level `schemaVersion` (a positive integer).
+ * Files written before versioning existed are treated as {@link LEGACY_SCHEMA_FORMAT_VERSION}.
+ * Bump {@link SCHEMA_FORMAT_VERSION} and register a migration in `migrations.ts`
+ * whenever the on-disk shape changes; `weave schema:upgrade` stamps files to the
+ * current version and the loader reads older files through the same migrations.
+ */
+export const SCHEMA_FORMAT_VERSION = 1;
+/** implicit version of files that predate the `schemaVersion` field. */
+export const LEGACY_SCHEMA_FORMAT_VERSION = 0;
+//# sourceMappingURL=schema-version.js.map

package/dist/core/object/schema-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.js","sourceRoot":"","sources":["../../../src/core/object/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAU,CAAC;AAGhD,wEAAwE;AACxE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAU,CAAC"}

package/dist/core/object/validate.d.ts

@@ -0,0 +1,21 @@
+import type { Locale } from '../i18n/index.js';
+import type { ObjectDefinition } from '../types/index.js';
+export interface ValidateOptions {
+    /** directory name hint; must equal object name when provided */
+    nameHint?: string;
+    /** message locale; defaults to English */
+    locale?: Locale;
+    /**
+     * field-type whitelist (config `features.fieldTypes`). When provided, a field
+     * declaring a type outside the whitelist is rejected (fail-closed). Defaults
+     * to all types (gating is opt-in via config).
+     */
+    allowedFieldTypes?: readonly string[];
+}
+/**
+ * Validate a raw object definition (single object, self-contained checks only).
+ * Includes field validation, primary-key rules, titleTemplate placeholder checks
+ * and same-object formula validation. Cross-object checks live in buildGraph.
+ */
+export declare function validateObject(raw: unknown, options?: ValidateOptions): ObjectDefinition;
+//# sourceMappingURL=validate.d.ts.map

package/dist/core/object/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/core/object/validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,kBAAkB,CAAC;AAe3D,OAAO,KAAK,EAGV,gBAAgB,EAIjB,MAAM,mBAAmB,CAAC;AAojB3B,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,gBAAgB,CA4FxF"}