@metaobjectsdev/runtime-web 1.0.5-rc.1 → 1.0.5-rc.10

package/dist/filter-qs.d.ts

@@ -1,8 +1,14 @@
 /**
  * Build a bracketed qs URL fragment from a filter object.
  *
- * Output shape (qs's default bracketed style):
- *   ?filter[email][like]=%25@x.com&filter[subscribed]=true&sort=createdAt:desc&limit=25&withCount=1&search=term
+ * Output shape (qs's bracketed style), shown DECODED:
+ *   ?filter[email][like]=%@x.com&filter[subscribed]=true&sort=createdAt:desc&limit=25&withCount=1&search=term
+ *
+ * On the wire the brackets are percent-encoded (`filter%5Bemail%5D%5Blike%5D=…`). RFC 3986
+ * admits no raw `[`/`]` in a query, and Tomcat — every Spring Boot app's default server —
+ * answers a raw one with its own HTML 400, so the generated Java and Kotlin controllers could
+ * not serve a single filtered request while this sent them raw. Every server-side parser
+ * decodes before it reads the brackets, so the encoded form means the same thing everywhere.
  *
  * Top-level `limit`, `offset`, `sort`, `withCount`, and `search` are emitted
  * at the top level (not under `filter`). All other keys go inside `filter`.

package/dist/filter-qs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter-qs.d.ts","sourceRoot":"","sources":["../src/filter-qs.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAYrE"}
+{"version":3,"file":"filter-qs.d.ts","sourceRoot":"","sources":["../src/filter-qs.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAYrE"}

package/dist/filter-qs.js

@@ -2,8 +2,14 @@ import qs from "qs";
 /**
  * Build a bracketed qs URL fragment from a filter object.
  *
- * Output shape (qs's default bracketed style):
- *   ?filter[email][like]=%25@x.com&filter[subscribed]=true&sort=createdAt:desc&limit=25&withCount=1&search=term
+ * Output shape (qs's bracketed style), shown DECODED:
+ *   ?filter[email][like]=%@x.com&filter[subscribed]=true&sort=createdAt:desc&limit=25&withCount=1&search=term
+ *
+ * On the wire the brackets are percent-encoded (`filter%5Bemail%5D%5Blike%5D=…`). RFC 3986
+ * admits no raw `[`/`]` in a query, and Tomcat — every Spring Boot app's default server —
+ * answers a raw one with its own HTML 400, so the generated Java and Kotlin controllers could
+ * not serve a single filtered request while this sent them raw. Every server-side parser
+ * decodes before it reads the brackets, so the encoded form means the same thing everywhere.
  *
  * Top-level `limit`, `offset`, `sort`, `withCount`, and `search` are emitted
  * at the top level (not under `filter`). All other keys go inside `filter`.
@@ -34,6 +40,6 @@ export function buildFilterQs(filter) {
         filterObj.or = or;
     if (and !== undefined)
         filterObj.and = and;
-    return qs.stringify({ ...top, filter: filterObj }, { encodeValuesOnly: true });
+    return qs.stringify({ ...top, filter: filterObj });
 }
 //# sourceMappingURL=filter-qs.js.map

package/dist/filter-qs.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter-qs.js","sourceRoot":"","sources":["../src/filter-qs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,MAAa,CAAC;IACrF,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,KAAK,KAAS,SAAS;QAAE,GAAG,CAAC,KAAK,GAAO,KAAK,CAAC;IACnD,IAAI,MAAM,KAAQ,SAAS;QAAE,GAAG,CAAC,MAAM,GAAM,MAAM,CAAC;IACpD,IAAI,IAAI,KAAU,SAAS;QAAE,GAAG,CAAC,IAAI,GAAQ,IAAI,CAAC;IAClD,IAAI,SAAS,KAAK,SAAS;QAAE,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;IACvD,IAAI,MAAM,KAAQ,SAAS;QAAE,GAAG,CAAC,MAAM,GAAM,MAAM,CAAC;IACpD,MAAM,SAAS,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IACzD,IAAI,EAAE,KAAM,SAAS;QAAE,SAAS,CAAC,EAAE,GAAI,EAAE,CAAC;IAC1C,IAAI,GAAG,KAAK,SAAS;QAAE,SAAS,CAAC,GAAG,GAAG,GAAG,CAAC;IAC3C,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;AACjF,CAAC"}
+{"version":3,"file":"filter-qs.js","sourceRoot":"","sources":["../src/filter-qs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,MAAa,CAAC;IACrF,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,KAAK,KAAS,SAAS;QAAE,GAAG,CAAC,KAAK,GAAO,KAAK,CAAC;IACnD,IAAI,MAAM,KAAQ,SAAS;QAAE,GAAG,CAAC,MAAM,GAAM,MAAM,CAAC;IACpD,IAAI,IAAI,KAAU,SAAS;QAAE,GAAG,CAAC,IAAI,GAAQ,IAAI,CAAC;IAClD,IAAI,SAAS,KAAK,SAAS;QAAE,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;IACvD,IAAI,MAAM,KAAQ,SAAS;QAAE,GAAG,CAAC,MAAM,GAAM,MAAM,CAAC;IACpD,MAAM,SAAS,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IACzD,IAAI,EAAE,KAAM,SAAS;QAAE,SAAS,CAAC,EAAE,GAAI,EAAE,CAAC;IAC1C,IAAI,GAAG,KAAK,SAAS;QAAE,SAAS,CAAC,GAAG,GAAG,GAAG,CAAC;IAC3C,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/grid-from-metadata.d.ts

@@ -1,4 +1,4 @@
-import type { MetaObject } from "@metaobjectsdev/metadata";
+import type { MetaRead } from "./meta-read.js";
 import type { GridConfig } from "./fetcher.js";
 /** A neutral, framework-agnostic column descriptor derived from metadata. */
 export interface MetaColumn {
@@ -21,5 +21,5 @@ export interface MetaGrid {
  * Otherwise every field becomes a column with sensible defaults — so it works
  * for ANY object, with or without a declared grid.
  */
-export declare function buildGrid(meta: MetaObject, gridName?: string): MetaGrid;
+export declare function buildGrid(meta: MetaRead, gridName?: string): MetaGrid;
 //# sourceMappingURL=grid-from-metadata.d.ts.map

package/dist/grid-from-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid-from-metadata.d.ts","sourceRoot":"","sources":["../src/grid-from-metadata.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAuB,MAAM,0BAA0B,CAAC;AAgBhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAwDD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAmCvE"}
+{"version":3,"file":"grid-from-metadata.d.ts","sourceRoot":"","sources":["../src/grid-from-metadata.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAA+B,MAAM,gBAAgB,CAAC;AAgB5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAwDD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAmCrE"}

package/dist/grid-from-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"grid-from-metadata.js","sourceRoot":"","sources":["../src/grid-from-metadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"grid-from-metadata.js","sourceRoot":"","sources":["../src/grid-from-metadata.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,6 +4,8 @@ export type { EntityFetcher, GridConfig } from "./fetcher.js";
 export { joinBaseUrl } from "./join-base-url.js";
 export { buildGrid } from "./grid-from-metadata.js";
 export type { MetaColumn, MetaGrid } from "./grid-from-metadata.js";
+export type { MetaRead, MetaFieldRead, MetaViewRead, MetaLayoutRead, MetaModelRead, AttrReader, } from "./meta-read.js";
+export { loadMetaModel } from "./load-meta-model.js";
 export { canvasToJpegBlob } from "./canvas-to-jpeg-blob.js";
 export { reencodeJpeg } from "./reencode-jpeg.js";
 export type { ImageUploadAdapter, ImageMeta } from "./image-adapter.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EACV,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,GACjF,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -3,6 +3,7 @@ export { formatCurrency, parseCurrency, minorUnitsFor } from "./currency.js";
 export { buildFilterQs } from "./filter-qs.js";
 export { joinBaseUrl } from "./join-base-url.js";
 export { buildGrid } from "./grid-from-metadata.js";
+export { loadMetaModel } from "./load-meta-model.js";
 export { canvasToJpegBlob } from "./canvas-to-jpeg-blob.js";
 export { reencodeJpeg } from "./reencode-jpeg.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAKpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/load-meta-model.d.ts

@@ -0,0 +1,11 @@
+import type { MetaModelRead } from "./meta-read.js";
+/**
+ * Read a `GET /_meta` document (effective canonical JSON) into a browser model.
+ *
+ * Accepts the raw response text or an already-parsed value. The document is
+ * assumed valid: the server loaded and validated it, and serving the EFFECTIVE
+ * form means every inherited member is already materialized here — so `extends`
+ * is deliberately never followed (see attrReaderFor).
+ */
+export declare function loadMetaModel(json: string | unknown): MetaModelRead;
+//# sourceMappingURL=load-meta-model.d.ts.map

package/dist/load-meta-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-meta-model.d.ts","sourceRoot":"","sources":["../src/load-meta-model.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACiC,aAAa,EACzD,MAAM,gBAAgB,CAAC;AA4GxB;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,CAWnE"}

package/dist/load-meta-model.js

@@ -0,0 +1,128 @@
+// UI-2 — read the `GET /_meta` document into a model buildGrid can walk.
+//
+// Deliberately NOT the metadata loader: that package's root barrel exports
+// MetaDataLoader, which transitively imports `node:url`, so it cannot be bundled
+// for a browser (#287). This is a reader over an already-validated, already-
+// resolved document — no validation, no registry, no super-resolution.
+//
+// #287: metamodel VALUES come from the browser-safe constants subpath, never the
+// package root — see grid-from-metadata.ts for the full story. The type imports
+// below are fine on the root: `import type` is erased at build time.
+import { TYPE_FIELD, TYPE_LAYOUT, TYPE_VIEW, TYPE_OBJECT, ATTR_PREFIX, RESERVED_KEY_NAME, RESERVED_KEY_PACKAGE, RESERVED_KEY_CHILDREN, TYPE_SUBTYPE_SEPARATOR, } from "@metaobjectsdev/metadata/constants";
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/** A canonical node is a single-key object: { "field.string": { ... } }. */
+function readNode(value) {
+    if (!isRecord(value))
+        return undefined;
+    const keys = Object.keys(value);
+    if (keys.length !== 1)
+        return undefined;
+    const fused = keys[0];
+    const body = value[fused];
+    if (!isRecord(body))
+        return undefined;
+    const sep = fused.indexOf(TYPE_SUBTYPE_SEPARATOR);
+    if (sep < 0)
+        return undefined;
+    return { type: fused.slice(0, sep), subType: fused.slice(sep + TYPE_SUBTYPE_SEPARATOR.length), body };
+}
+function childrenOf(node) {
+    const raw = node.body[RESERVED_KEY_CHILDREN];
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const entry of raw) {
+        const child = readNode(entry);
+        if (child !== undefined)
+            out.push(child);
+    }
+    return out;
+}
+/**
+ * Attributes are the `@`-prefixed body keys, read without the prefix.
+ *
+ * Every OTHER body key — `name`, `package`, `children`, and — the trap — `extends`
+ * — is structural and is excluded here by construction (it never starts with
+ * `ATTR_PREFIX`), not by naming and skipping it. The effective document still
+ * carries `extends`, with the members it once referenced already inlined
+ * elsewhere in the body; this reader never follows it, so nothing is resolved
+ * and nothing is double-counted.
+ */
+function attrReaderFor(node) {
+    const attrs = new Map();
+    for (const [key, value] of Object.entries(node.body)) {
+        if (key.startsWith(ATTR_PREFIX))
+            attrs.set(key.slice(ATTR_PREFIX.length), value);
+    }
+    return (name) => attrs.get(name);
+}
+function nameOf(node) {
+    const raw = node.body[RESERVED_KEY_NAME];
+    return typeof raw === "string" ? raw : "";
+}
+/**
+ * A node's OWN `package` body key, when present. Objects never inherit a file's
+ * default package (only certain root-level fields/validators do — see
+ * parser-core.ts), so this is undefined unless the node declared one itself,
+ * matching what `MetaData.package` reads server-side.
+ */
+function packageOf(node) {
+    const raw = node.body[RESERVED_KEY_PACKAGE];
+    return typeof raw === "string" ? raw : undefined;
+}
+function toView(node) {
+    return { subType: node.subType, attr: attrReaderFor(node) };
+}
+function toField(node) {
+    const views = childrenOf(node).filter((c) => c.type === TYPE_VIEW).map(toView);
+    return {
+        name: nameOf(node),
+        subType: node.subType,
+        attr: attrReaderFor(node),
+        views: () => views,
+    };
+}
+function toLayout(node) {
+    return { name: nameOf(node), subType: node.subType, attr: attrReaderFor(node) };
+}
+function toObject(node) {
+    const kids = childrenOf(node);
+    const fields = kids.filter((c) => c.type === TYPE_FIELD).map(toField);
+    const layouts = kids.filter((c) => c.type === TYPE_LAYOUT).map(toLayout);
+    const pkg = packageOf(node);
+    return {
+        name: nameOf(node),
+        // Conditional spread, not `package: pkg`: exactOptionalPropertyTypes
+        // distinguishes "absent" from "present and undefined", and MetaRead.package
+        // is meant to read as absent (not `undefined`-valued) for a node with no
+        // own package.
+        ...(pkg !== undefined ? { package: pkg } : {}),
+        subType: node.subType,
+        attr: attrReaderFor(node),
+        fields: () => fields,
+        layouts: () => layouts,
+    };
+}
+/**
+ * Read a `GET /_meta` document (effective canonical JSON) into a browser model.
+ *
+ * Accepts the raw response text or an already-parsed value. The document is
+ * assumed valid: the server loaded and validated it, and serving the EFFECTIVE
+ * form means every inherited member is already materialized here — so `extends`
+ * is deliberately never followed (see attrReaderFor).
+ */
+export function loadMetaModel(json) {
+    const parsed = typeof json === "string" ? JSON.parse(json) : json;
+    const root = readNode(parsed);
+    const objects = root === undefined
+        ? []
+        : childrenOf(root).filter((c) => c.type === TYPE_OBJECT).map(toObject);
+    const byName = new Map(objects.map((o) => [o.name, o]));
+    return {
+        objects: () => objects,
+        object: (name) => byName.get(name),
+    };
+}
+//# sourceMappingURL=load-meta-model.js.map

package/dist/load-meta-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-meta-model.js","sourceRoot":"","sources":["../src/load-meta-model.ts"],"names":[],"mappings":"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"}

package/dist/meta-read.d.ts

@@ -0,0 +1,44 @@
+/** A metadata attribute reader. Returns `undefined` for an unset OR unregistered name. */
+export type AttrReader = (name: string) => unknown;
+export interface MetaViewRead {
+    readonly subType: string;
+    attr: AttrReader;
+}
+export interface MetaFieldRead {
+    readonly name: string;
+    readonly subType: string;
+    attr: AttrReader;
+    views(): MetaViewRead[];
+}
+export interface MetaLayoutRead {
+    readonly name: string;
+    readonly subType: string;
+    attr: AttrReader;
+}
+/** One object (entity / value / projection) as a runtime UI reads it. */
+export interface MetaRead {
+    readonly name: string;
+    /**
+     * The node's OWN package, when declared. Undefined for a node that inherits its
+     * package from the declaring file's default rather than declaring one itself —
+     * the same "own, not resolved" reading `MetaData.package` carries server-side
+     * (objects never auto-inherit a file's default package; see parser-core.ts).
+     *
+     * `object(name)` and the model's `byName` lookup key on the SHORT name only, so
+     * two same-named objects in different packages (a shape this repo models
+     * deliberately — see `fixtures/conformance/xpkg-collision-*`) are NOT
+     * disambiguated by `object()`. A caller that might see a cross-package
+     * collision should walk `objects()` and filter on `package` itself.
+     */
+    readonly package?: string;
+    readonly subType: string;
+    attr: AttrReader;
+    fields(): MetaFieldRead[];
+    layouts(): MetaLayoutRead[];
+}
+/** The whole model, as returned by `loadMetaModel`. */
+export interface MetaModelRead {
+    objects(): MetaRead[];
+    object(name: string): MetaRead | undefined;
+}
+//# sourceMappingURL=meta-read.d.ts.map

package/dist/meta-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-read.d.ts","sourceRoot":"","sources":["../src/meta-read.ts"],"names":[],"mappings":"AAWA,0FAA0F;AAC1F,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,IAAI,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,yEAAyE;AACzE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,IAAI,aAAa,EAAE,CAAC;IAC1B,OAAO,IAAI,cAAc,EAAE,CAAC;CAC7B;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,OAAO,IAAI,QAAQ,EAAE,CAAC;IACtB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC5C"}

package/dist/meta-read.js

@@ -0,0 +1,12 @@
+// The narrow, read-only metadata surface a runtime UI consumer needs.
+//
+// Declared here rather than imported from @metaobjectsdev/metadata because this
+// package must satisfy it with a browser-built model too: the metadata package's
+// root barrel exports MetaDataLoader, which transitively imports `node:url`, so
+// it cannot be bundled for a browser (#287). A real MetaObject satisfies these
+// interfaces structurally, so server-side callers are unaffected.
+//
+// ADR-0039: every accessor here is the RESOLVING one. `attr()` must answer with
+// inherited values, and `views()`/`fields()` must include inherited members.
+export {};
+//# sourceMappingURL=meta-read.js.map

package/dist/meta-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-read.js","sourceRoot":"","sources":["../src/meta-read.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,+EAA+E;AAC/E,kEAAkE;AAClE,EAAE;AACF,gFAAgF;AAChF,6EAA6E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/runtime-web",
-  "version": "1.0.5-rc.1",
+  "version": "1.0.5-rc.10",
   "description": "Pure framework-agnostic browser core for metaobjects: currency, filter URL serialization, fetcher contract types.",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@metaobjectsdev/metadata": "1.0.5-rc.1",
+    "@metaobjectsdev/metadata": "1.0.5-rc.10",
     "qs": "^6.13.0"
   },
   "devDependencies": {

package/src/filter-qs.ts

@@ -3,8 +3,14 @@ import qs from "qs";
 /**
  * Build a bracketed qs URL fragment from a filter object.
  *
- * Output shape (qs's default bracketed style):
- *   ?filter[email][like]=%25@x.com&filter[subscribed]=true&sort=createdAt:desc&limit=25&withCount=1&search=term
+ * Output shape (qs's bracketed style), shown DECODED:
+ *   ?filter[email][like]=%@x.com&filter[subscribed]=true&sort=createdAt:desc&limit=25&withCount=1&search=term
+ *
+ * On the wire the brackets are percent-encoded (`filter%5Bemail%5D%5Blike%5D=…`). RFC 3986
+ * admits no raw `[`/`]` in a query, and Tomcat — every Spring Boot app's default server —
+ * answers a raw one with its own HTML 400, so the generated Java and Kotlin controllers could
+ * not serve a single filtered request while this sent them raw. Every server-side parser
+ * decodes before it reads the brackets, so the encoded form means the same thing everywhere.
  *
  * Top-level `limit`, `offset`, `sort`, `withCount`, and `search` are emitted
  * at the top level (not under `filter`). All other keys go inside `filter`.
@@ -28,5 +34,5 @@ export function buildFilterQs(filter: Record<string, unknown>): string {
   const filterObj: Record<string, unknown> = { ...fields };
   if (or  !== undefined) filterObj.or  = or;
   if (and !== undefined) filterObj.and = and;
-  return qs.stringify({ ...top, filter: filterObj }, { encodeValuesOnly: true });
+  return qs.stringify({ ...top, filter: filterObj });
 }

package/src/grid-from-metadata.ts

@@ -8,8 +8,12 @@
 // Mirrors the derivation in codegen-ts-tanstack's columns-file (humanized
 // headers, the field's view subtype as the cell-renderer hint, @columns / grid
 // attrs from the dataGrid layout) so a runtime-built grid matches a generated
-// one. Browser-safe: depends only on @metaobjectsdev/metadata.
-import type { MetaObject, MetaField, MetaView } from "@metaobjectsdev/metadata";
+// one. Browser-safe: types come from the local MetaRead surface (./meta-read.js)
+// below, never from @metaobjectsdev/metadata's classes, and the only values
+// imported from that package come from its browser-safe /constants subpath
+// (#287 — the metadata root barrel cannot be bundled). A real MetaObject
+// satisfies MetaRead structurally, so server callers are unaffected.
+import type { MetaRead, MetaFieldRead, MetaViewRead } from "./meta-read.js";
 // #287: metamodel VALUES come from the browser-safe constants subpath, never the package
 // root. The root exports MetaDataLoader -> library-sources.ts -> `node:url`, so a single
 // constant import from it made every browser bundle fail ("Browser polyfill for module
@@ -51,14 +55,14 @@ function humanize(s: string): string {
   return s.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/^./, (c) => c.toUpperCase());
 }
 
-function firstView(field: MetaField): MetaView | undefined {
+function firstView(field: MetaFieldRead): MetaViewRead | undefined {
   // views(), not ownViews(): ADR-0039 — a field that `extends` an abstract parent
   // inherits the parent's view, and an own-only read drops it, so the column would
   // silently lose both its header and its renderer hint.
   return field.views()[0];
 }
 
-function header(field: MetaField): string {
+function header(field: MetaFieldRead): string {
   // DOC_ATTR_TITLE, not the literal "label". `@label` is registered by NO provider in
   // any port — `@title` is the documentation commonAttr chartered as the display label
   // — so this read was `undefined` for every field that ever set one, and every grid
@@ -70,7 +74,7 @@ function header(field: MetaField): string {
   return typeof label === "string" ? label : humanize(field.name);
 }
 
-function viewKind(field: MetaField): string {
+function viewKind(field: MetaFieldRead): string {
   return firstView(field)?.subType ?? field.subType;
 }
 
@@ -93,7 +97,7 @@ function viewKind(field: MetaField): string {
  */
 function gridDefaultSortOrder(
   declaredOrder: unknown,
-  field: MetaField | undefined,
+  field: MetaFieldRead | undefined,
 ): "asc" | "desc" {
   if (declaredOrder === "asc" || declaredOrder === "desc") return declaredOrder;
   const fromField = field?.attr(FIELD_ATTR_SORTABLE_DEFAULT_ORDER);
@@ -108,7 +112,7 @@ function gridDefaultSortOrder(
  * Otherwise every field becomes a column with sensible defaults — so it works
  * for ANY object, with or without a declared grid.
  */
-export function buildGrid(meta: MetaObject, gridName?: string): MetaGrid {
+export function buildGrid(meta: MetaRead, gridName?: string): MetaGrid {
   const layouts = meta.layouts().filter((l) => l.subType === LAYOUT_SUBTYPE_DATA_GRID);
   const layout = gridName ? layouts.find((l) => l.name === gridName) : layouts[0];
 
@@ -126,7 +130,7 @@ export function buildGrid(meta: MetaObject, gridName?: string): MetaGrid {
 
   const columns: MetaColumn[] = names
     .map((n) => fieldsByName.get(n))
-    .filter((f): f is MetaField => f !== undefined)
+    .filter((f): f is MetaFieldRead => f !== undefined)
     .map((f) => ({ field: f.name, header: header(f), viewKind: viewKind(f) }));
 
   const pageSizeAttr = layout?.attr(LAYOUT_DATA_GRID_ATTR_PAGE_SIZE);

package/src/index.ts

@@ -5,6 +5,10 @@ export type { EntityFetcher, GridConfig } from "./fetcher.js";
 export { joinBaseUrl } from "./join-base-url.js";
 export { buildGrid } from "./grid-from-metadata.js";
 export type { MetaColumn, MetaGrid } from "./grid-from-metadata.js";
+export type {
+  MetaRead, MetaFieldRead, MetaViewRead, MetaLayoutRead, MetaModelRead, AttrReader,
+} from "./meta-read.js";
+export { loadMetaModel } from "./load-meta-model.js";
 export { canvasToJpegBlob } from "./canvas-to-jpeg-blob.js";
 export { reencodeJpeg } from "./reencode-jpeg.js";
 export type { ImageUploadAdapter, ImageMeta } from "./image-adapter.js";

package/src/load-meta-model.ts

@@ -0,0 +1,144 @@
+// UI-2 — read the `GET /_meta` document into a model buildGrid can walk.
+//
+// Deliberately NOT the metadata loader: that package's root barrel exports
+// MetaDataLoader, which transitively imports `node:url`, so it cannot be bundled
+// for a browser (#287). This is a reader over an already-validated, already-
+// resolved document — no validation, no registry, no super-resolution.
+//
+// #287: metamodel VALUES come from the browser-safe constants subpath, never the
+// package root — see grid-from-metadata.ts for the full story. The type imports
+// below are fine on the root: `import type` is erased at build time.
+import {
+  TYPE_FIELD, TYPE_LAYOUT, TYPE_VIEW, TYPE_OBJECT,
+  ATTR_PREFIX, RESERVED_KEY_NAME, RESERVED_KEY_PACKAGE, RESERVED_KEY_CHILDREN, TYPE_SUBTYPE_SEPARATOR,
+} from "@metaobjectsdev/metadata/constants";
+import type {
+  AttrReader, MetaFieldRead, MetaLayoutRead, MetaModelRead, MetaRead, MetaViewRead,
+} from "./meta-read.js";
+
+/** One parsed node: its fused "type.subType" key and its body. */
+interface RawNode {
+  type: string;
+  subType: string;
+  body: Record<string, unknown>;
+}
+
+function isRecord(v: unknown): v is Record<string, unknown> {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+
+/** A canonical node is a single-key object: { "field.string": { ... } }. */
+function readNode(value: unknown): RawNode | undefined {
+  if (!isRecord(value)) return undefined;
+  const keys = Object.keys(value);
+  if (keys.length !== 1) return undefined;
+  const fused = keys[0]!;
+  const body = value[fused];
+  if (!isRecord(body)) return undefined;
+  const sep = fused.indexOf(TYPE_SUBTYPE_SEPARATOR);
+  if (sep < 0) return undefined;
+  return { type: fused.slice(0, sep), subType: fused.slice(sep + TYPE_SUBTYPE_SEPARATOR.length), body };
+}
+
+function childrenOf(node: RawNode): RawNode[] {
+  const raw = node.body[RESERVED_KEY_CHILDREN];
+  if (!Array.isArray(raw)) return [];
+  const out: RawNode[] = [];
+  for (const entry of raw) {
+    const child = readNode(entry);
+    if (child !== undefined) out.push(child);
+  }
+  return out;
+}
+
+/**
+ * Attributes are the `@`-prefixed body keys, read without the prefix.
+ *
+ * Every OTHER body key — `name`, `package`, `children`, and — the trap — `extends`
+ * — is structural and is excluded here by construction (it never starts with
+ * `ATTR_PREFIX`), not by naming and skipping it. The effective document still
+ * carries `extends`, with the members it once referenced already inlined
+ * elsewhere in the body; this reader never follows it, so nothing is resolved
+ * and nothing is double-counted.
+ */
+function attrReaderFor(node: RawNode): AttrReader {
+  const attrs = new Map<string, unknown>();
+  for (const [key, value] of Object.entries(node.body)) {
+    if (key.startsWith(ATTR_PREFIX)) attrs.set(key.slice(ATTR_PREFIX.length), value);
+  }
+  return (name: string) => attrs.get(name);
+}
+
+function nameOf(node: RawNode): string {
+  const raw = node.body[RESERVED_KEY_NAME];
+  return typeof raw === "string" ? raw : "";
+}
+
+/**
+ * A node's OWN `package` body key, when present. Objects never inherit a file's
+ * default package (only certain root-level fields/validators do — see
+ * parser-core.ts), so this is undefined unless the node declared one itself,
+ * matching what `MetaData.package` reads server-side.
+ */
+function packageOf(node: RawNode): string | undefined {
+  const raw = node.body[RESERVED_KEY_PACKAGE];
+  return typeof raw === "string" ? raw : undefined;
+}
+
+function toView(node: RawNode): MetaViewRead {
+  return { subType: node.subType, attr: attrReaderFor(node) };
+}
+
+function toField(node: RawNode): MetaFieldRead {
+  const views = childrenOf(node).filter((c) => c.type === TYPE_VIEW).map(toView);
+  return {
+    name: nameOf(node),
+    subType: node.subType,
+    attr: attrReaderFor(node),
+    views: () => views,
+  };
+}
+
+function toLayout(node: RawNode): MetaLayoutRead {
+  return { name: nameOf(node), subType: node.subType, attr: attrReaderFor(node) };
+}
+
+function toObject(node: RawNode): MetaRead {
+  const kids = childrenOf(node);
+  const fields = kids.filter((c) => c.type === TYPE_FIELD).map(toField);
+  const layouts = kids.filter((c) => c.type === TYPE_LAYOUT).map(toLayout);
+  const pkg = packageOf(node);
+  return {
+    name: nameOf(node),
+    // Conditional spread, not `package: pkg`: exactOptionalPropertyTypes
+    // distinguishes "absent" from "present and undefined", and MetaRead.package
+    // is meant to read as absent (not `undefined`-valued) for a node with no
+    // own package.
+    ...(pkg !== undefined ? { package: pkg } : {}),
+    subType: node.subType,
+    attr: attrReaderFor(node),
+    fields: () => fields,
+    layouts: () => layouts,
+  };
+}
+
+/**
+ * Read a `GET /_meta` document (effective canonical JSON) into a browser model.
+ *
+ * Accepts the raw response text or an already-parsed value. The document is
+ * assumed valid: the server loaded and validated it, and serving the EFFECTIVE
+ * form means every inherited member is already materialized here — so `extends`
+ * is deliberately never followed (see attrReaderFor).
+ */
+export function loadMetaModel(json: string | unknown): MetaModelRead {
+  const parsed: unknown = typeof json === "string" ? JSON.parse(json) : json;
+  const root = readNode(parsed);
+  const objects = root === undefined
+    ? []
+    : childrenOf(root).filter((c) => c.type === TYPE_OBJECT).map(toObject);
+  const byName = new Map(objects.map((o) => [o.name, o] as const));
+  return {
+    objects: () => objects,
+    object: (name: string) => byName.get(name),
+  };
+}

package/src/meta-read.ts

@@ -0,0 +1,59 @@
+// The narrow, read-only metadata surface a runtime UI consumer needs.
+//
+// Declared here rather than imported from @metaobjectsdev/metadata because this
+// package must satisfy it with a browser-built model too: the metadata package's
+// root barrel exports MetaDataLoader, which transitively imports `node:url`, so
+// it cannot be bundled for a browser (#287). A real MetaObject satisfies these
+// interfaces structurally, so server-side callers are unaffected.
+//
+// ADR-0039: every accessor here is the RESOLVING one. `attr()` must answer with
+// inherited values, and `views()`/`fields()` must include inherited members.
+
+/** A metadata attribute reader. Returns `undefined` for an unset OR unregistered name. */
+export type AttrReader = (name: string) => unknown;
+
+export interface MetaViewRead {
+  readonly subType: string;
+  attr: AttrReader;
+}
+
+export interface MetaFieldRead {
+  readonly name: string;
+  readonly subType: string;
+  attr: AttrReader;
+  views(): MetaViewRead[];
+}
+
+export interface MetaLayoutRead {
+  readonly name: string;
+  readonly subType: string;
+  attr: AttrReader;
+}
+
+/** One object (entity / value / projection) as a runtime UI reads it. */
+export interface MetaRead {
+  readonly name: string;
+  /**
+   * The node's OWN package, when declared. Undefined for a node that inherits its
+   * package from the declaring file's default rather than declaring one itself —
+   * the same "own, not resolved" reading `MetaData.package` carries server-side
+   * (objects never auto-inherit a file's default package; see parser-core.ts).
+   *
+   * `object(name)` and the model's `byName` lookup key on the SHORT name only, so
+   * two same-named objects in different packages (a shape this repo models
+   * deliberately — see `fixtures/conformance/xpkg-collision-*`) are NOT
+   * disambiguated by `object()`. A caller that might see a cross-package
+   * collision should walk `objects()` and filter on `package` itself.
+   */
+  readonly package?: string;
+  readonly subType: string;
+  attr: AttrReader;
+  fields(): MetaFieldRead[];
+  layouts(): MetaLayoutRead[];
+}
+
+/** The whole model, as returned by `loadMetaModel`. */
+export interface MetaModelRead {
+  objects(): MetaRead[];
+  object(name: string): MetaRead | undefined;
+}