@metaobjectsdev/metadata 0.5.0-rc.1

package/src/parser-json.ts

@@ -0,0 +1,28 @@
+// Canonical JSON parser.
+//
+// parseJson is a thin front-end: strip the UTF-8 BOM, JSON.parse, then hand
+// the canonical object to the shared buildTree (parser-core.ts).
+
+import { ParseError } from "./errors.js";
+import { buildTree, errOpts } from "./parser-core.js";
+import type { ParseOptions, ParseResult } from "./parser-core.js";
+
+export type { ParseOptions, ParseResult } from "./parser-core.js";
+
+export function parseJson(content: string, opts: ParseOptions): ParseResult {
+  // Strip UTF-8 BOM if present (Java-authored files often have it).
+  const normalizedContent =
+    content.charCodeAt(0) === 0xfeff ? content.slice(1) : content;
+
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(normalizedContent);
+  } catch (err) {
+    throw new ParseError(
+      `Invalid JSON: ${(err as Error).message}`,
+      { ...errOpts(opts.sourceName), code: "ERR_MALFORMED_JSON" },
+    );
+  }
+
+  return buildTree(parsed, opts);
+}

package/src/persistence/db/db-constants.ts

@@ -0,0 +1,6 @@
+// DB concern constants — physical DB column attr keys.
+
+/** Custom DB column name override on a field (maps to @dbColumn in metadata). */
+export const FIELD_ATTR_DB_COLUMN = "dbColumn";
+/** When true, suppress the @filterable-without-index Loader warning (Project D drift check). */
+export const FIELD_ATTR_DB_INDEXED = "db.indexed";

package/src/persistence/db/db-provider.ts

@@ -0,0 +1,36 @@
+// dbProvider — the DB-domain MetaDataTypeProvider. Registers the DB-domain
+// attributes (@dbColumn, @db.indexed on fields; @name on source.dbTable /
+// source.dbView) by extending the core-registered types. Mirrors Java's
+// CoreDBMetaDataProvider (com.metaobjects.database).
+
+import type { MetaDataTypeProvider } from "../../provider.js";
+import type { TypeRegistry } from "../../registry.js";
+import { TYPE_FIELD, TYPE_SOURCE } from "../../shared/base-types.js";
+import { FIELD_SUBTYPES } from "../../core/field/field-constants.js";
+import {
+  SOURCE_SUBTYPE_DB_TABLE,
+  SOURCE_SUBTYPE_DB_VIEW,
+} from "../source/source-constants.js";
+import { dbColumnSchema, dbIndexedSchema, sourceNameSchema } from "./db-schema.js";
+
+export const dbProvider: MetaDataTypeProvider = {
+  id: "metaobjects-db",
+  dependencies: ["metaobjects-core-types"],
+  description:
+    "DB-domain attributes — @dbColumn / @db.indexed on fields, @name on source.dbTable / source.dbView.",
+  registerTypes(registry: TypeRegistry): void {
+    for (const subType of FIELD_SUBTYPES) {
+      registry.extend(TYPE_FIELD, subType, {
+        attributes: [dbColumnSchema, dbIndexedSchema],
+      });
+    }
+    // Two explicit calls (not a loop) — dbTable and dbView are the only DB
+    // source subtypes, and there is no DB_SOURCE_SUBTYPES constant to loop.
+    registry.extend(TYPE_SOURCE, SOURCE_SUBTYPE_DB_TABLE, {
+      attributes: [sourceNameSchema],
+    });
+    registry.extend(TYPE_SOURCE, SOURCE_SUBTYPE_DB_VIEW, {
+      attributes: [sourceNameSchema],
+    });
+  },
+};

package/src/persistence/db/db-schema.ts

@@ -0,0 +1,40 @@
+// DB-domain attribute schemas — registered by dbProvider (db-provider.ts),
+// not the core metamodel.
+
+import type { AttrSchema } from "../../registry.js";
+import {
+  ATTR_SUBTYPE_STRING,
+  ATTR_SUBTYPE_BOOLEAN,
+} from "../../core/attr/attr-constants.js";
+import {
+  FIELD_ATTR_DB_COLUMN,
+  FIELD_ATTR_DB_INDEXED,
+} from "./db-constants.js";
+import { SOURCE_ATTR_NAME } from "../source/source-constants.js";
+
+/** `@dbColumn` — column-name override; on every field subtype. */
+export const dbColumnSchema: AttrSchema = {
+  name: FIELD_ATTR_DB_COLUMN,
+  valueType: ATTR_SUBTYPE_STRING,
+  required: false,
+  description:
+    "Override the generated SQL column name for this field. Defaults to the field name run through the project's columnNamingStrategy.",
+};
+
+/** `@db.indexed` — suppress the @filterable-without-index warning; on every field subtype. */
+export const dbIndexedSchema: AttrSchema = {
+  name: FIELD_ATTR_DB_INDEXED,
+  valueType: ATTR_SUBTYPE_BOOLEAN,
+  required: false,
+  description:
+    "When true, suppress the @filterable-without-index Loader warning (the field is indexed by other means).",
+};
+
+/** `@name` — the SQL table/view identifier; on source.dbTable and source.dbView. */
+export const sourceNameSchema: AttrSchema = {
+  name: SOURCE_ATTR_NAME,
+  valueType: ATTR_SUBTYPE_STRING,
+  required: false,
+  description:
+    "The SQL table or view name for this source. Defaults to the object name run through the columnNamingStrategy when omitted.",
+};

package/src/persistence/origin/meta-origin.ts

@@ -0,0 +1,67 @@
+// MetaOrigin — concrete node class for type=origin nodes.
+// Field-level provenance (Project E).
+// passthrough / aggregate origin subtypes declare how field values are derived.
+//
+// MetaPassthroughOrigin and MetaAggregateOrigin are co-located subtype classes
+// (mirrors the meta-identity.ts pattern).
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+
+import { MetaData } from "../../shared/meta-data.js";
+import {
+  ORIGIN_PASSTHROUGH_ATTR_FROM,
+  ORIGIN_PASSTHROUGH_ATTR_VIA,
+  ORIGIN_AGGREGATE_ATTR_AGG,
+  ORIGIN_AGGREGATE_ATTR_OF,
+  ORIGIN_AGGREGATE_ATTR_VIA,
+  type AggregateFunction,
+} from "./origin-constants.js";
+
+export class MetaOrigin extends MetaData {}
+
+/**
+ * Passthrough origin — the field's value is sourced directly from a
+ * cross-entity field reference (e.g. a projection that forwards Program.title).
+ *
+ * Carries `@from` (required): the dotted Entity.field reference identifying
+ * the source value.
+ */
+export class MetaPassthroughOrigin extends MetaOrigin {
+  /** The dotted-path cross-entity field reference this origin passes through (e.g. "Program.title"). */
+  get from(): string | undefined {
+    const v = this.ownAttr(ORIGIN_PASSTHROUGH_ATTR_FROM);
+    return typeof v === "string" ? v : undefined;
+  }
+
+  /** Optional dotted relationship path used to reach the source entity (e.g. "Program.weeks"). */
+  get via(): string | undefined {
+    const v = this.ownAttr(ORIGIN_PASSTHROUGH_ATTR_VIA);
+    return typeof v === "string" ? v : undefined;
+  }
+}
+
+/**
+ * Aggregate origin — the field's value is computed by aggregating values
+ * over a relationship path (count / sum / avg / min / max).
+ *
+ * Carries `@agg`, `@of`, and `@via` (all required).
+ */
+export class MetaAggregateOrigin extends MetaOrigin {
+  /** The aggregate function (count | sum | avg | min | max). */
+  get agg(): AggregateFunction | undefined {
+    const v = this.ownAttr(ORIGIN_AGGREGATE_ATTR_AGG);
+    return typeof v === "string" ? (v as AggregateFunction) : undefined;
+  }
+
+  /** The dotted-path target of the aggregate (e.g. "Week.id"). */
+  get of(): string | undefined {
+    const v = this.ownAttr(ORIGIN_AGGREGATE_ATTR_OF);
+    return typeof v === "string" ? v : undefined;
+  }
+
+  /** The dotted relationship path the aggregate walks (e.g. "Program.weeks"). */
+  get via(): string | undefined {
+    const v = this.ownAttr(ORIGIN_AGGREGATE_ATTR_VIA);
+    return typeof v === "string" ? v : undefined;
+  }
+}

package/src/persistence/origin/origin-constants.ts

@@ -0,0 +1,35 @@
+// Origin concern constants — subtypes and attr keys for the origin.* type family.
+
+import { SUBTYPE_BASE } from "../../shared/base-types.js";
+
+// ---------------------------------------------------------------------------
+// Origin type — field-level provenance (Project E).
+//
+// Origin is a child of `field`. Says "this field's value comes from there."
+// passthrough: from <Entity.field> [via <relationship path>]
+// aggregate:   <agg> of <Entity.field> via <relationship path>
+//
+// ---------------------------------------------------------------------------
+
+export const ORIGIN_SUBTYPE_PASSTHROUGH = "passthrough";
+export const ORIGIN_SUBTYPE_AGGREGATE   = "aggregate";
+
+export const ORIGIN_SUBTYPES = [
+  SUBTYPE_BASE,
+  ORIGIN_SUBTYPE_PASSTHROUGH,
+  ORIGIN_SUBTYPE_AGGREGATE,
+] as const;
+export type OriginSubType = (typeof ORIGIN_SUBTYPES)[number];
+
+// passthrough attrs
+export const ORIGIN_PASSTHROUGH_ATTR_FROM = "from";
+export const ORIGIN_PASSTHROUGH_ATTR_VIA  = "via";
+
+// aggregate attrs
+export const ORIGIN_AGGREGATE_ATTR_AGG = "agg";
+export const ORIGIN_AGGREGATE_ATTR_OF  = "of";
+export const ORIGIN_AGGREGATE_ATTR_VIA = "via";
+
+// aggregate function vocabulary
+export const AGGREGATE_FUNCTIONS = ["count", "sum", "avg", "min", "max"] as const;
+export type AggregateFunction = (typeof AGGREGATE_FUNCTIONS)[number];

package/src/persistence/origin/origin-schema.ts

@@ -0,0 +1,66 @@
+// Origin attribute schemas — per-subtype attr inventories for origin types.
+// Consumed by registerCoreTypes().
+
+import type { AttrSchema } from "../../registry.js";
+import { ATTR_SUBTYPE_STRING } from "../../core/attr/attr-constants.js";
+import { SUBTYPE_BASE } from "../../shared/base-types.js";
+import {
+  ORIGIN_SUBTYPE_PASSTHROUGH,
+  ORIGIN_SUBTYPE_AGGREGATE,
+  ORIGIN_PASSTHROUGH_ATTR_FROM,
+  ORIGIN_PASSTHROUGH_ATTR_VIA,
+  ORIGIN_AGGREGATE_ATTR_AGG,
+  ORIGIN_AGGREGATE_ATTR_OF,
+  ORIGIN_AGGREGATE_ATTR_VIA,
+  AGGREGATE_FUNCTIONS,
+} from "./origin-constants.js";
+
+/** Attrs on origin.passthrough — @from is required. */
+const passthroughOriginAttrs: AttrSchema[] = [
+  {
+    name: ORIGIN_PASSTHROUGH_ATTR_FROM,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: true,
+    description:
+      "Dotted Entity.field reference identifying the source value this projection field passes through (e.g. 'Program.title').",
+  },
+  {
+    name: ORIGIN_PASSTHROUGH_ATTR_VIA,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description:
+      "Optional dotted relationship path used to reach the source entity (e.g. 'Program.weeks').",
+  },
+];
+
+/** Attrs on origin.aggregate — @agg, @of, @via all required. */
+const aggregateOriginAttrs: AttrSchema[] = [
+  {
+    name: ORIGIN_AGGREGATE_ATTR_AGG,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: true,
+    allowedValues: [...AGGREGATE_FUNCTIONS],
+    description: "Aggregate function applied over the relationship path: count, sum, avg, min, or max.",
+  },
+  {
+    name: ORIGIN_AGGREGATE_ATTR_OF,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: true,
+    description:
+      "Dotted Entity.field reference identifying the column being aggregated (e.g. 'Week.durationMinutes').",
+  },
+  {
+    name: ORIGIN_AGGREGATE_ATTR_VIA,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: true,
+    description:
+      "Dotted relationship path from the base entity to the aggregated rows (e.g. 'Program.weeks' or 'Program.weeks.workouts').",
+  },
+];
+
+/** Attrs per origin subtype. base has none; passthrough and aggregate carry their respective attrs. */
+export const ORIGIN_ATTRS_MAP = new Map<string, AttrSchema[]>([
+  [SUBTYPE_BASE, []],
+  [ORIGIN_SUBTYPE_PASSTHROUGH, [...passthroughOriginAttrs]],
+  [ORIGIN_SUBTYPE_AGGREGATE, [...aggregateOriginAttrs]],
+]);

package/src/persistence/source/meta-source.ts

@@ -0,0 +1,38 @@
+// MetaSource — concrete node class for type=source nodes.
+// Declares where an object's data lives (Project E).
+// dbTable / dbView source subtypes declare the SQL table or view name.
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+
+import { MetaData } from "../../shared/meta-data.js";
+import {
+  SOURCE_ATTR_NAME,
+  SOURCE_SUBTYPE_DB_TABLE,
+  SOURCE_SUBTYPE_DB_VIEW,
+} from "./source-constants.js";
+
+export class MetaSource extends MetaData {
+  /** The SQL table or view name (value of @name attr on the source child). */
+  get sourceName(): string | undefined {
+    const v = this.ownAttr(SOURCE_ATTR_NAME);
+    return typeof v === "string" ? v : undefined;
+  }
+
+  /**
+   * True when this source is a `dbTable` (writable).
+   * Explicitly defined rather than derived from `isReadOnly()` so it remains
+   * correct if a third source subtype is added in the future.
+   */
+  isWritable(): boolean {
+    return this.subType === SOURCE_SUBTYPE_DB_TABLE;
+  }
+
+  /**
+   * True when this source is a `dbView` (read-only projection).
+   * Explicitly defined rather than derived from `isWritable()` so it remains
+   * correct if a third source subtype is added in the future.
+   */
+  isReadOnly(): boolean {
+    return this.subType === SOURCE_SUBTYPE_DB_VIEW;
+  }
+}

package/src/persistence/source/source-constants.ts

@@ -0,0 +1,35 @@
+// Source concern constants — subtypes and attr keys for the source.* type family.
+
+import { SUBTYPE_BASE } from "../../shared/base-types.js";
+
+// ---------------------------------------------------------------------------
+// Source type — declares where an object's data lives (Project E).
+// dbTable / dbView ship in v1. Multiple sources per object are allowed
+// and meaningful (write-through CQRS: dbTable for writes + dbView for reads).
+// ---------------------------------------------------------------------------
+
+export const SOURCE_SUBTYPE_DB_TABLE = "dbTable";
+export const SOURCE_SUBTYPE_DB_VIEW  = "dbView";
+
+export const SOURCE_SUBTYPES = [
+  SUBTYPE_BASE,
+  SOURCE_SUBTYPE_DB_TABLE,
+  SOURCE_SUBTYPE_DB_VIEW,
+] as const;
+export type SourceSubType = (typeof SOURCE_SUBTYPES)[number];
+
+// Source attrs — both dbTable and dbView use @name for the SQL identifier
+// (table name and view name respectively). Same key for ergonomic consistency.
+export const SOURCE_DB_TABLE_ATTR_NAME = "name";
+export const SOURCE_DB_VIEW_ATTR_NAME  = "name";
+/** Shared @name attr key for MetaSource (covers both dbTable and dbView). Use this
+ *  in generic source accessors instead of the subtype-specific aliases above. */
+export const SOURCE_ATTR_NAME          = "name";
+
+/** Optional DB schema attr on source[dbTable] / source[dbView]. Postgres uses
+ *  this to namespace tables/views. SQLite has no schema concept and rejects
+ *  any non-default value. Default for Postgres: "public". */
+export const SOURCE_ATTR_SCHEMA = "schema";
+
+/** Default Postgres schema when @schema is omitted from a source. */
+export const DEFAULT_DB_SCHEMA_POSTGRES = "public";

package/src/presentation/layout/layout-constants.ts

@@ -0,0 +1,27 @@
+// Layout concern constants — subtypes and dataGrid attr keys.
+
+import { SUBTYPE_BASE } from "../../shared/base-types.js";
+
+// ---------------------------------------------------------------------------
+// Layout type — object-level UI surfaces (replaces Project B's object-attached
+// data-grid view subtype; views are now strictly field-level per Java parity).
+// ---------------------------------------------------------------------------
+
+export const LAYOUT_SUBTYPE_DATA_GRID = "dataGrid";
+
+export const LAYOUT_SUBTYPES = [
+  SUBTYPE_BASE,
+  LAYOUT_SUBTYPE_DATA_GRID,
+] as const;
+export type LayoutSubType = (typeof LAYOUT_SUBTYPES)[number];
+
+// ---------------------------------------------------------------------------
+// Layout attrs (on dataGrid layouts)
+// ---------------------------------------------------------------------------
+
+export const LAYOUT_DATA_GRID_ATTR_PAGE_SIZE          = "pageSize";
+export const LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD = "defaultSortField";
+export const LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER = "defaultSortOrder";
+export const LAYOUT_DATA_GRID_ATTR_FILTERABLE         = "filterable";
+export const LAYOUT_DATA_GRID_ATTR_FILTER             = "filter";
+export const LAYOUT_DATA_GRID_ATTR_COLUMNS            = "columns";

package/src/presentation/layout/layout-schema.ts

@@ -0,0 +1,62 @@
+// Layout attribute schemas — attrs for layout subtypes (e.g. dataGrid).
+// Consumed by registerCoreTypes().
+
+import type { AttrSchema } from "../../registry.js";
+import {
+  ATTR_SUBTYPE_INT,
+  ATTR_SUBTYPE_STRING,
+  ATTR_SUBTYPE_BOOLEAN,
+  ATTR_SUBTYPE_FILTER,
+  ATTR_SUBTYPE_STRINGARRAY,
+} from "../../core/attr/attr-constants.js";
+import { SORT_ORDER_VALUES } from "../../core/query/query-constants.js";
+import {
+  LAYOUT_DATA_GRID_ATTR_PAGE_SIZE,
+  LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD,
+  LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER,
+  LAYOUT_DATA_GRID_ATTR_FILTERABLE,
+  LAYOUT_DATA_GRID_ATTR_FILTER,
+  LAYOUT_DATA_GRID_ATTR_COLUMNS,
+} from "./layout-constants.js";
+
+/** Attrs on layout.dataGrid. */
+export const dataGridLayoutAttrs: AttrSchema[] = [
+  {
+    name: LAYOUT_DATA_GRID_ATTR_PAGE_SIZE,
+    valueType: ATTR_SUBTYPE_INT,
+    required: false,
+    description: "Number of rows per page in the generated data grid.",
+  },
+  {
+    name: LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description:
+      "Field name the grid is sorted by on initial render. Must reference an actual field on the entity.",
+  },
+  {
+    name: LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    allowedValues: [...SORT_ORDER_VALUES],
+    description: "Initial sort direction for the default sort field: 'asc' or 'desc'.",
+  },
+  {
+    name: LAYOUT_DATA_GRID_ATTR_FILTERABLE,
+    valueType: ATTR_SUBTYPE_BOOLEAN,
+    required: false,
+    description: "When true, the generated grid exposes column filtering UI.",
+  },
+  {
+    name: LAYOUT_DATA_GRID_ATTR_FILTER,
+    valueType: ATTR_SUBTYPE_FILTER,
+    required: false,
+    description: "Structured preset filter object applied to the grid at the metadata level. Desugared to canonical { field: { op: value } } form at parse time.",
+  },
+  {
+    name: LAYOUT_DATA_GRID_ATTR_COLUMNS,
+    valueType: ATTR_SUBTYPE_STRINGARRAY,
+    required: false,
+    description: "Flat ordered list of field names to display as grid columns.",
+  },
+];

package/src/presentation/layout/meta-layout.ts

@@ -0,0 +1,61 @@
+// MetaLayout — concrete node class for type=layout nodes.
+// Object-level UI surfaces (Project E; replaces object-attached data-grid view
+// subtype; views are strictly field-level per Java parity).
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+
+import { MetaData } from "../../shared/meta-data.js";
+import {
+  LAYOUT_DATA_GRID_ATTR_PAGE_SIZE,
+  LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD,
+  LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER,
+  LAYOUT_DATA_GRID_ATTR_FILTERABLE,
+  LAYOUT_DATA_GRID_ATTR_FILTER,
+  LAYOUT_DATA_GRID_ATTR_COLUMNS,
+} from "./layout-constants.js";
+import type { SortOrderValue } from "../../core/query/query-constants.js";
+
+export class MetaLayout extends MetaData {
+  /** The number of rows per page for the dataGrid layout. */
+  get pageSize(): number | undefined {
+    const v = this.ownAttr(LAYOUT_DATA_GRID_ATTR_PAGE_SIZE);
+    return typeof v === "number" ? v : undefined;
+  }
+
+  /** The field name to sort by default in the dataGrid layout. */
+  get defaultSortField(): string | undefined {
+    const v = this.ownAttr(LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD);
+    return typeof v === "string" ? v : undefined;
+  }
+
+  /**
+   * The default sort order (`"asc"` or `"desc"`) for the dataGrid layout.
+   * Returns `undefined` when the attr is absent.
+   */
+  get defaultSortOrder(): SortOrderValue | undefined {
+    const v = this.ownAttr(LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER);
+    return typeof v === "string" ? (v as SortOrderValue) : undefined;
+  }
+
+  /**
+   * True when `@filterable: true` is set on the dataGrid layout.
+   * Defaults to `false` when the attr is absent.
+   */
+  get filterable(): boolean {
+    return this.ownAttr(LAYOUT_DATA_GRID_ATTR_FILTERABLE) === true;
+  }
+
+  /** The desugared preset filter object for the dataGrid layout, or undefined. */
+  get filter(): Record<string, unknown> | undefined {
+    const v = this.ownAttr(LAYOUT_DATA_GRID_ATTR_FILTER);
+    return typeof v === "object" && v !== null && !Array.isArray(v)
+      ? (v as Record<string, unknown>)
+      : undefined;
+  }
+
+  /** The ordered list of field names to display as columns in the dataGrid layout. */
+  get columns(): string[] {
+    const c = this.ownAttr(LAYOUT_DATA_GRID_ATTR_COLUMNS);
+    return Array.isArray(c) ? (c as string[]) : [];
+  }
+}

package/src/presentation/view/meta-view.ts

@@ -0,0 +1,8 @@
+// MetaView — concrete node class for type=view nodes.
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+// Currently minimal — placeholder for v0.3+ view-level accessors.
+
+import { MetaData } from "../../shared/meta-data.js";
+
+export class MetaView extends MetaData {}

package/src/presentation/view/view-constants.ts

@@ -0,0 +1,53 @@
+// View concern constants — subtypes and attr keys for the view.* type family.
+
+import { SUBTYPE_BASE } from "../../shared/base-types.js";
+
+// ---------------------------------------------------------------------------
+// View subtypes (13)
+//
+// The view's subType IS the UI control type. Each control kind has its own
+// expected attrs (placeholder, maxLength, options, etc.) — runtime-ts
+// surfaces them as opaque Record<string, unknown>; UI layers interpret.
+// Mirrors metaobjects-dynamic/web/.../html/*View.java naming.
+// ---------------------------------------------------------------------------
+
+export const VIEW_SUBTYPE_TEXT = "text";
+export const VIEW_SUBTYPE_TEXTAREA = "textarea";
+export const VIEW_SUBTYPE_DATE = "date";
+export const VIEW_SUBTYPE_MONTH = "month";
+export const VIEW_SUBTYPE_HOTLINK = "hotlink";
+export const VIEW_SUBTYPE_DROPDOWN = "dropdown";
+export const VIEW_SUBTYPE_RADIO = "radio";
+export const VIEW_SUBTYPE_CHECKBOX = "checkbox";
+export const VIEW_SUBTYPE_NUMBER = "number";
+export const VIEW_SUBTYPE_PASSWORD = "password";
+export const VIEW_SUBTYPE_HIDDEN = "hidden";
+export const VIEW_SUBTYPE_WEB = "web";          // abstract base for web-rendered views
+export const VIEW_SUBTYPE_CURRENCY = "currency";
+
+export const VIEW_SUBTYPES = [
+  SUBTYPE_BASE,
+  VIEW_SUBTYPE_TEXT,
+  VIEW_SUBTYPE_TEXTAREA,
+  VIEW_SUBTYPE_DATE,
+  VIEW_SUBTYPE_MONTH,
+  VIEW_SUBTYPE_HOTLINK,
+  VIEW_SUBTYPE_DROPDOWN,
+  VIEW_SUBTYPE_RADIO,
+  VIEW_SUBTYPE_CHECKBOX,
+  VIEW_SUBTYPE_NUMBER,
+  VIEW_SUBTYPE_PASSWORD,
+  VIEW_SUBTYPE_HIDDEN,
+  VIEW_SUBTYPE_WEB,
+  VIEW_SUBTYPE_CURRENCY,
+] as const;
+export type ViewSubType = (typeof VIEW_SUBTYPES)[number];
+
+// ---------------------------------------------------------------------------
+// View attrs (on currency views)
+// ---------------------------------------------------------------------------
+
+/** BCP 47 locale code on a view[currency]. Defaults to "en-US" when omitted. */
+export const VIEW_CURRENCY_ATTR_LOCALE = "locale";
+/** Default BCP 47 locale code when @locale is omitted on a view[currency]. */
+export const VIEW_CURRENCY_ATTR_LOCALE_DEFAULT = "en-US";

package/src/presentation/view/view-schema.ts

@@ -0,0 +1,21 @@
+// View attribute schemas — per-subtype attr inventories for view types.
+// Consumed by registerCoreTypes().
+
+import type { AttrSchema } from "../../registry.js";
+import { ATTR_SUBTYPE_STRING } from "../../core/attr/attr-constants.js";
+import {
+  VIEW_CURRENCY_ATTR_LOCALE,
+  VIEW_CURRENCY_ATTR_LOCALE_DEFAULT,
+} from "./view-constants.js";
+
+/** Attrs on view.currency. */
+export const currencyViewAttrs: AttrSchema[] = [
+  {
+    name: VIEW_CURRENCY_ATTR_LOCALE,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    default: VIEW_CURRENCY_ATTR_LOCALE_DEFAULT,
+    description:
+      "BCP 47 locale code controlling currency display formatting. Defaults to 'en-US' when omitted.",
+  },
+];