@dforge-core/metadata 0.0.16 → 0.0.17

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to `@dforge-core/metadata` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this package adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.17] — 2026-08-19
+
+### Fixed
+
+- **`entityViewColumn.flags` documented a flag vocabulary that does not exist.** It
+  claimed `I/E/V/O/G/S/F/X/W` with the example `'VO'` "to expose it read-only". The
+  canonical set is `flagDefs` here — `V/I/E/M/H` — which is also the `^[VIEMH]*$`
+  pattern the schema enforces on a field's own `flags`, and a view override is the
+  same vocabulary by definition. Nothing reads `O`: the client `Column` honours
+  `V`/`E`/`I` and the installer resolves `M` into `isNullable`. Read-only is plain
+  `"V"` (visible, not editable). The description now also states the empty-string
+  case, since `""` is a real override meaning "no flags here" rather than "inherit".
+
 ## [0.0.16] — 2026-08-19
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dforge-core/metadata",
-	"version": "0.0.16",
+	"version": "0.0.17",
 	"description": "Canonical dForge authoring registries — field types, base datatypes, column types, traits, data-view kinds and chart types — with derivation helpers. Runtime-dependency-free; the single source of truth shared by editors, the web app and the CLI.",
 	"license": "MIT",
 	"author": "dForge",

package/schemas/entity.schema.json

@@ -141,7 +141,7 @@
 				"flags": {
 					"type": "string",
 					"maxLength": 10,
-					"description": "Flag letters for this column in this view (I/E/V/O/G/S/F/X/W), e.g. 'VO' to expose it read-only."
+					"description": "Flag letters for this column in this view — the same V/I/E/M/H vocabulary as a field's 'flags', overriding it for folders bound to this view. E.g. 'V' exposes the column read-only (visible, not editable). An EMPTY string is a real override meaning 'no flags here', not 'inherit': the runtime merges view over entity with COALESCE, which skips NULL only. Omit the key to inherit."
 				},
 				"orderNum": {
 					"type": "integer",