@yuneta/gobj-ui 7.23.169 → 7.23.171

package/dist/gobj-ui.es.js

@@ -23046,13 +23046,455 @@ function nodes_answer(data) {
 	};
 }
 //#endregion
+//#region src/schema_model.js
+/***********************************************************************
+*          schema_model.js
+*
+*      A SCHEMA out of the three meta-topics that store it.
+*
+*      `treedb_system_schema` keeps every schema of a yuno as DATA, in
+*      three flat topics — `treedbs`, `topics`, `cols` — linked by
+*      fkeys. That is the right STORAGE and the wrong thing to put in
+*      front of an operator: adding one column to one topic means
+*      finding it in a table holding every column of every topic of
+*      every treedb the yuno has.
+*
+*      This module turns those three lists back into what they
+*      describe: treedb -> topics -> columns, each in its declared
+*      `order`. Pure, so the editor's model can be tested with no DOM
+*      and no backend — the gclass fetches and draws, this decides
+*      what the records MEAN.
+*
+*      TWO THINGS IT EXISTS TO STATE ONCE:
+*
+*      1. A record is grouped by its FKEY, not by its id. The id is
+*         qualified (`<treedb>.<topic>.<column>`) and reading it back
+*         with a split on '.' works right up to the first treedb or
+*         topic whose name carries one. The fkey is the link the store
+*         itself uses; the id is only the fallback for a record whose
+*         fkey never arrived.
+*
+*      2. A fkey reaches this code in FOUR shapes, because `nodes`
+*         answers differently depending on the options it was called
+*         with: the bare ref string, the expanded object, a list of
+*         either, or a dict keyed by the ref. All four are the same
+*         fact and parse_fkey_ref() flattens them to it.
+*
+*          Copyright (c) 2026, ArtGins.
+*          All Rights Reserved.
+***********************************************************************/
+var DEFAULT_ORDER = 9999;
+/***************************************************************
+*  parse_fkey_ref(value) -> [{topic_name, id, hook_name}, ...]
+*
+*      Every shape a fkey column can arrive in, flattened to the
+*      refs it names. Anything unrecognizable contributes nothing —
+*      a schema drawn without one link beats a screen that throws.
+***************************************************************/
+function parse_fkey_ref(value) {
+	let refs = [];
+	let push_one = (v) => {
+		if (typeof v === "string") {
+			let parts = v.split("^");
+			if (parts.length !== 3) return;
+			refs.push({
+				topic_name: parts[0],
+				id: parts[1],
+				hook_name: parts[2]
+			});
+			return;
+		}
+		if (v && typeof v === "object") {
+			let id = v.id;
+			if (typeof id !== "string" || id.length === 0) return;
+			refs.push({
+				topic_name: v.topic_name || "",
+				id,
+				hook_name: v.hook_name || ""
+			});
+		}
+	};
+	if (value === null || value === void 0) return refs;
+	if (typeof value === "string") {
+		push_one(value);
+		return refs;
+	}
+	if (Array.isArray(value)) {
+		for (let v of value) push_one(v);
+		return refs;
+	}
+	if (typeof value === "object") for (let [key, v] of Object.entries(value)) if (v && typeof v === "object" && typeof v.id === "string") push_one(v);
+	else push_one(key);
+	return refs;
+}
+/***************************************************************
+*  The id of the FIRST parent a record names, or "" when it
+*  names none. A record has one parent here — a column belongs to
+*  one topic, a topic to one treedb — and a second ref would be a
+*  store this editor cannot draw anyway.
+***************************************************************/
+function parent_id(record, fkey_col) {
+	let refs = parse_fkey_ref(record ? record[fkey_col] : null);
+	return refs.length > 0 ? refs[0].id : "";
+}
+/***************************************************************
+*  The name a record is KNOWN by, which is not what it is keyed
+*  by: `topics` and `cols` key by the qualified id and carry the
+*  bare name in `value` (its pkey2). An older store that still
+*  keyed by rowid has no `value` worth showing, so the id stands
+*  in — the same fallback as node_label().
+***************************************************************/
+function record_name(record) {
+	if (!record) return "";
+	if (typeof record.value === "string" && record.value.length > 0) return record.value;
+	return typeof record.id === "string" ? record.id : "";
+}
+/***************************************************************
+*  The `order` of a record as a NUMBER, whatever the store put
+*  there: an integer column read back from JSON may arrive as a
+*  string, and comparing "10" with 9 sorts the schema wrong.
+***************************************************************/
+function record_order(record) {
+	let order = record ? record.order : void 0;
+	if (typeof order === "number" && isFinite(order)) return order;
+	if (typeof order === "string" && order.trim().length > 0) {
+		let n = Number(order);
+		if (isFinite(n)) return n;
+	}
+	return DEFAULT_ORDER;
+}
+/***************************************************************
+*  Sort in place by `order`, ties broken by name so a schema
+*  whose records all default to 9999 still draws the same way
+*  twice.
+***************************************************************/
+function sort_by_order(list) {
+	list.sort((a, b) => {
+		if (a.order !== b.order) return a.order - b.order;
+		return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;
+	});
+	return list;
+}
+/***************************************************************
+*  build_schema_model({treedbs, topics, cols}) -> model
+*
+*      model = {
+*          treedbs: [{
+*              id, name, record,
+*              schema_version, c_schema_version, system_schema_version,
+*              topics: [{
+*                  id, name, order, record,
+*                  pkey, topic_version, system_topic, main_topic,
+*                  cols: [{id, name, order, record}]
+*              }]
+*          }],
+*          orphan_topics: [...],   topics whose treedb is not in the store
+*          orphan_cols:   [...]    columns whose topic is not in the store
+*      }
+*
+*      An orphan is NOT dropped. A column whose topic was deleted is
+*      exactly the kind of leftover an operator opens this editor to
+*      find, and a model that hides it makes the editor lie.
+***************************************************************/
+function build_schema_model(records) {
+	let r = records || {};
+	let treedb_rows = Array.isArray(r.treedbs) ? r.treedbs : [];
+	let topic_rows = Array.isArray(r.topics) ? r.topics : [];
+	let col_rows = Array.isArray(r.cols) ? r.cols : [];
+	let treedbs = [];
+	let by_treedb_id = {};
+	for (let record of treedb_rows) {
+		if (!record || typeof record.id !== "string") continue;
+		let entry = {
+			id: record.id,
+			name: record.id,
+			record,
+			schema_version: record.schema_version,
+			c_schema_version: record.c_schema_version,
+			system_schema_version: record.system_schema_version,
+			topics: []
+		};
+		treedbs.push(entry);
+		by_treedb_id[entry.id] = entry;
+	}
+	let orphan_topics = [];
+	let by_topic_id = {};
+	for (let record of topic_rows) {
+		if (!record || typeof record.id !== "string") continue;
+		let entry = {
+			id: record.id,
+			name: record_name(record),
+			order: record_order(record),
+			record,
+			treedb_id: parent_id(record, "treedbs"),
+			pkey: record.pkey || "",
+			pkey2s: record.pkey2s,
+			system_flag: record.system_flag || "",
+			tkey: record.tkey || "",
+			topic_version: record.topic_version,
+			system_topic: !!record.system_topic,
+			main_topic: !!record.main_topic,
+			cols: []
+		};
+		by_topic_id[entry.id] = entry;
+		let parent = by_treedb_id[entry.treedb_id];
+		if (parent) parent.topics.push(entry);
+		else orphan_topics.push(entry);
+	}
+	let orphan_cols = [];
+	for (let record of col_rows) {
+		if (!record || typeof record.id !== "string") continue;
+		let entry = {
+			id: record.id,
+			name: record_name(record),
+			order: record_order(record),
+			record,
+			topic_id: parent_id(record, "topics")
+		};
+		let parent = by_topic_id[entry.topic_id];
+		if (parent) parent.cols.push(entry);
+		else orphan_cols.push(entry);
+	}
+	for (let treedb of treedbs) {
+		sort_by_order(treedb.topics);
+		for (let topic of treedb.topics) sort_by_order(topic.cols);
+	}
+	for (let topic of orphan_topics) sort_by_order(topic.cols);
+	treedbs.sort((a, b) => {
+		return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+	});
+	sort_by_order(orphan_topics);
+	sort_by_order(orphan_cols);
+	return {
+		treedbs,
+		orphan_topics,
+		orphan_cols
+	};
+}
+/***************************************************************
+*  Is there a value here at all?
+*
+*  The store answers a `blob` column that was never set with an
+*  EMPTY COLLECTION, not with nothing: `enum: {}`, `hook: {}`,
+*  `default: {}`. Read as "a value", those turn every export into
+*  a schema full of empty objects — and `'hook': {}` in a literal
+*  is a hook with no mapping, which is a link the treedb builds
+*  and nothing writes.
+***************************************************************/
+function is_empty_value(value) {
+	if (value === null || value === void 0 || value === "") return true;
+	if (Array.isArray(value)) return value.length === 0;
+	if (typeof value === "object") return Object.keys(value).length === 0;
+	return false;
+}
+/***************************************************************
+*  The fields of a column that are DECLARED as one thing and
+*  STORED as another.
+*
+*  `hook`, `enum`, `default`, `pkey2s` and `properties` are `blob`
+*  columns of the `cols` topic (treedb_system_schema.c), so what
+*  comes back may be the value or the JSON text of the value,
+*  depending on how it was written — a projection writes the
+*  value, a hand edit through a plain text field writes the text.
+*  `flag` is an array that a single-flag edit can leave as a bare
+*  string. Reading these without saying so is how a hook drawn
+*  from `{"users":"department"}` becomes no hook at all.
+***************************************************************/
+function as_json(value) {
+	if (typeof value !== "string") return value;
+	let text = value.trim();
+	if (text.length === 0) return null;
+	try {
+		return JSON.parse(text);
+	} catch (e) {
+		return value;
+	}
+}
+function col_flags(record) {
+	let flag = record ? record.flag : null;
+	if (Array.isArray(flag)) return flag.filter((f) => typeof f === "string" && f.length > 0);
+	if (typeof flag === "string" && flag.length > 0) {
+		let parsed = as_json(flag);
+		if (Array.isArray(parsed)) return parsed.filter((f) => typeof f === "string" && f.length > 0);
+		return [flag];
+	}
+	return [];
+}
+function col_hook(record) {
+	let hook = as_json(record ? record.hook : null);
+	if (hook && typeof hook === "object" && !Array.isArray(hook)) return hook;
+	return null;
+}
+function col_enum(record) {
+	let e = as_json(record ? record.enum : null);
+	if (Array.isArray(e)) return e;
+	return [];
+}
+function topic_pkey2s(record) {
+	let pkey2s = as_json(record ? record.pkey2s : null);
+	if (Array.isArray(pkey2s)) return pkey2s.filter((k) => typeof k === "string" && k.length > 0);
+	if (typeof pkey2s === "string" && pkey2s.length > 0) return [pkey2s];
+	return [];
+}
+/***************************************************************
+*  Lookups by id. The editor addresses a position by NAME (the
+*  url carries `<treedb>/<topic>`), so both are offered.
+***************************************************************/
+function find_treedb(model, treedb_id) {
+	if (!model || !Array.isArray(model.treedbs)) return null;
+	for (let treedb of model.treedbs) if (treedb.id === treedb_id) return treedb;
+	return null;
+}
+function find_topic(model, treedb_id, topic_name) {
+	let treedb = find_treedb(model, treedb_id);
+	if (!treedb) return null;
+	for (let topic of treedb.topics) if (topic.name === topic_name || topic.id === topic_name) return topic;
+	return null;
+}
+function find_col(model, treedb_id, topic_name, col_name) {
+	let topic = find_topic(model, treedb_id, topic_name);
+	if (!topic) return null;
+	for (let col of topic.cols) if (col.name === col_name || col.id === col_name) return col;
+	return null;
+}
+/***************************************************************
+*  The fkey a NEW record must carry to belong to `parent_id`.
+*  Written here because the editor is the only writer that has to
+*  compose one, and getting the hook name wrong links the record
+*  to nothing while the write still succeeds.
+***************************************************************/
+function fkey_ref(parent_topic, parent_id_, hook_name) {
+	return `${parent_topic}^${parent_id_}^${hook_name}`;
+}
+/***************************************************************
+*  Where a new sibling goes: after the last one. The store's own
+*  default (9999) would put every hand-made column in the same
+*  place and let their names decide the schema's order.
+***************************************************************/
+function next_order(siblings) {
+	let max = 0;
+	if (Array.isArray(siblings)) for (let s of siblings) {
+		let order = s && typeof s.order === "number" ? s.order : DEFAULT_ORDER;
+		if (order < 9999 && order > max) max = order;
+	}
+	return max + 1;
+}
+/***************************************************************
+*  Renumber a list AFTER a move, as the writes it takes: only the
+*  records whose order actually changed, so a drag of one row in a
+*  40-column topic is not 40 writes.
+*
+*      moved_orders(list) -> [{id, order}, ...]
+***************************************************************/
+function moved_orders(list) {
+	let writes = [];
+	if (!Array.isArray(list)) return writes;
+	for (let i = 0; i < list.length; i++) {
+		let entry = list[i];
+		let order = i + 1;
+		if (!entry || typeof entry.id !== "string") continue;
+		if (entry.order !== order) writes.push({
+			id: entry.id,
+			order
+		});
+	}
+	return writes;
+}
+//#endregion
+//#region src/treedb_topic_keys.js
+/***********************************************************************
+*          treedb_topic_keys.js
+*
+*      The KEYS of a treedb topic, read from its desc: the pkey, the
+*      secondary keys (`pkey2s`) and the time key (`tkey`), plus the
+*      names behind its `system_flag` number.
+*
+*      Every view that describes a topic -- the schema diagram, the
+*      topic-info panel, the topic cards -- must say them, and say them
+*      the same way. A topic with `pkey2s` is not a topic with one more
+*      column: one id holds several INSTANCES, an update has to carry
+*      the pkey2 or it lands on the primary, and `delete-instance`
+*      exists. `tkey` names where the time of every record comes from.
+*      The views said neither, so this is where they ask.
+*
+*      Pure, so it is tested with no DOM.
+*
+*          Copyright (c) 2026, ArtGins.
+*          All Rights Reserved.
+***********************************************************************/
+var SF_NAMES = [
+	"sf_string_key",
+	"sf_rowid_key",
+	"sf_int_key",
+	"",
+	"sf_zip_record",
+	"sf_cipher_record",
+	"",
+	"",
+	"sf_t_ms",
+	"sf_tm_ms",
+	"sf_deleted_instance",
+	"sf_immutable_record",
+	"sf_loading_from_disk",
+	"",
+	"",
+	""
+];
+/************************************************************
+*  The secondary keys of a topic, always a list. The desc
+*  carries a list; a schema literal may declare a bare
+*  string.
+************************************************************/
+function desc_pkey2s(desc) {
+	return topic_pkey2s(desc);
+}
+/************************************************************
+*  The time key of a topic, "" when it has none -- and then
+*  the time of a record is the time it was appended.
+************************************************************/
+function desc_tkey(desc) {
+	let tkey = desc ? desc.tkey : "";
+	return typeof tkey === "string" ? tkey : "";
+}
+/************************************************************
+*  Which keys of its topic a column IS, in the order the
+*  views print them: "pkey", "pkey2", "tkey". Empty for a
+*  column that is none.
+************************************************************/
+function col_key_roles(desc, col_id) {
+	let roles = [];
+	if (!desc || typeof col_id !== "string" || col_id.length === 0) return roles;
+	if (col_id === (desc.pkey || "id")) roles.push("pkey");
+	if (desc_pkey2s(desc).includes(col_id)) roles.push("pkey2");
+	if (desc_tkey(desc) === col_id) roles.push("tkey");
+	return roles;
+}
+/************************************************************
+*  The names of a system_flag. The desc carries the NUMBER
+*  (`1`), a schema literal carries the names
+*  ("sf_string_key|sf_t_ms"); both come back as a list. A
+*  set bit with no name is shown by its value, never
+*  dropped.
+************************************************************/
+function system_flag_names(system_flag) {
+	if (Array.isArray(system_flag)) return system_flag.filter((n) => typeof n === "string" && n.length > 0);
+	if (typeof system_flag === "string") return system_flag.split(/[|,]/).map((n) => n.trim()).filter((n) => n.length > 0);
+	if (typeof system_flag !== "number" || !Number.isInteger(system_flag) || system_flag <= 0) return [];
+	let names = [];
+	for (let bit = 0; bit < SF_NAMES.length; bit++) {
+		let mask = 1 << bit;
+		if (system_flag & mask) names.push(SF_NAMES[bit] || `0x${mask.toString(16).padStart(4, "0")}`);
+	}
+	return names;
+}
+//#endregion
 //#region src/c_yui_treedb_topics.js
 /***********************************************************************
 *          c_yui_treedb_topics.js
 *
 *          Management of TreeDB's topics with Bulma tabs
 *
-*          Copyright (c) 2025, ArtGins.
+*          Copyright (c) 2025-2026, ArtGins.
 *          All Rights Reserved.
 ***********************************************************************/
 /***************************************************************
@@ -23566,6 +24008,29 @@ function topic_card_meta(desc) {
 		{ class: "TREEDB_TOPIC_CARD_META" },
 		head
 	]);
+	let pkey2s = desc_pkey2s(desc);
+	if (pkey2s.length) {
+		let list = pkey2s.join(", ");
+		meta.push([
+			"div",
+			{
+				class: "TREEDB_TOPIC_CARD_REL TREEDB_TOPIC_CARD_PKEY2S",
+				title: list
+			},
+			[[
+				"span",
+				{
+					class: "TREEDB_TOPIC_CARD_REL_LABEL",
+					i18n: "pkey2s"
+				},
+				"pkey2s"
+			], [
+				"span",
+				{ class: "TREEDB_TOPIC_CARD_REL_LIST" },
+				list
+			]]
+		]);
+	}
 	let relation = (cls, key, arrow, names) => {
 		let list = names.join(", ");
 		return [
@@ -23829,33 +24294,26 @@ function show_topic_info(gobj, topic) {
 }
 /************************************************************
 *  Build the read-only topic-info panel from a topic desc: the
-*  topic name, its pkey, and a table of columns (name / type /
+*  topic name, its KEYS, and a table of columns (name / type /
 *  key relationship). Everything is guarded — a malformed desc
 *  renders a shorter panel, never throws.
+*
+*  The keys are what an operator has to know before touching a
+*  record, so they are all said, and the empty ones too: a
+*  topic with `pkey2s` keeps several instances under one id,
+*  and an empty `tkey` means the time of a record is the time
+*  it was appended -- a row missing is not the same as "none".
 ************************************************************/
 function build_topic_info_panel(gobj, $info, topic, desc) {
 	while ($info.firstChild) $info.removeChild($info.firstChild);
 	let pkey = desc.pkey || "";
-	let fmt_flag = (v) => {
-		if (is_array(v)) return v.join(", ");
-		if (is_object(v)) return Object.keys(v).join(", ");
-		return v === void 0 || v === null ? "" : String(v);
-	};
+	let pkey2s = desc_pkey2s(desc);
+	let tkey = desc_tkey(desc);
 	let $meta = [];
-	let push_meta = (key, value, highlight) => {
-		if (value === void 0 || value === null || value === "") return;
-		let $val = highlight ? [
-			"span",
-			{ class: "tag is-info" },
-			`${value}`
-		] : [
-			"code",
-			{},
-			`${value}`
-		];
+	let push_meta = (key, $val) => {
 		$meta.push([
 			"tr",
-			{},
+			{ class: `TREEDB_TOPIC_INFO_${key.toUpperCase()}` },
 			[[
 				"th",
 				{
@@ -23870,29 +24328,64 @@ function build_topic_info_panel(gobj, $info, topic, desc) {
 			]]
 		]);
 	};
-	push_meta("version", desc.topic_version, true);
-	push_meta("system", fmt_flag(desc.system_flag));
-	push_meta("pkey", pkey);
-	push_meta("tkey", desc.tkey);
+	if (desc.topic_version !== void 0 && desc.topic_version !== null && desc.topic_version !== "") push_meta("version", [
+		"span",
+		{ class: "tag is-info" },
+		`${desc.topic_version}`
+	]);
+	let sf_names = system_flag_names(desc.system_flag);
+	if (sf_names.length > 0) push_meta("system", [
+		"code",
+		{ title: `${desc.system_flag}` },
+		sf_names.join(" | ")
+	]);
+	if (pkey) push_meta("pkey", [
+		"code",
+		{},
+		pkey
+	]);
+	if (pkey2s.length > 0) push_meta("pkey2s", [
+		"span",
+		{ class: "tags" },
+		pkey2s.map((name) => [
+			"span",
+			{ class: "tag is-warning" },
+			name
+		])
+	]);
+	push_meta("tkey", tkey ? [
+		"code",
+		{},
+		tkey
+	] : [
+		"span",
+		{
+			class: "has-text-grey",
+			i18n: "append time"
+		},
+		"append time"
+	]);
 	let $rows = [];
 	let cols = is_array(desc.cols) ? desc.cols : [];
 	for (let col of cols) {
 		if (!col || !col.id || col.id.charAt(0) === "_") continue;
 		let type = col.type || (is_array(col.flag) ? col.flag.join(", ") : col.flag || "");
-		let rel = "";
-		if (col.id === pkey) rel = "pkey";
-		else if (is_object(col.fkey)) rel = "→ " + Object.keys(col.fkey).join(", ");
-		else if (is_object(col.hook)) rel = "hook → " + Object.keys(col.hook).join(", ");
+		let roles = col_key_roles(desc, col.id);
+		let parts = roles.slice();
+		if (is_object(col.fkey)) parts.push("→ " + Object.keys(col.fkey).join(", "));
+		else if (is_object(col.hook)) parts.push("hook → " + Object.keys(col.hook).join(", "));
+		let rel = parts.join(" · ");
+		let is_key = roles.length > 0;
 		$rows.push([
 			"tr",
-			{},
+			is_key ? { class: "TREEDB_TOPIC_INFO_KEY_COL" } : {},
 			[
 				[
 					"td",
 					{},
 					[[
 						"code",
-						{},
+						is_key ? { class: "has-text-weight-bold" } : {},
 						`${col.id}`
 					]]
 				],
@@ -23903,7 +24396,7 @@ function build_topic_info_panel(gobj, $info, topic, desc) {
 				],
 				[
 					"td",
-					{},
+					is_key ? { class: "has-text-weight-semibold" } : {},
 					`${rel}`
 				]
 			]
@@ -25699,6 +26192,43 @@ function plan_treedb_writes(flags) {
 		form_toolbar: null
 	};
 }
+/************************************************************
+*  Does column `col` travel back to treedb on a write?
+*
+*  The form SHOWS every field and sends back only what the topic
+*  accepts: the writable cols, the fkeys (a link is edited by
+*  linking) and the pkey, which is not written but is what
+*  ADDRESSES the record.
+*
+*  It matters because `treedb_update_node()` does not check
+*  `writable` -- it writes any col it is handed -- so a read-only
+*  field travelling back is written with whatever the form made of
+*  it, and the fields that describe a record are exactly the ones
+*  that do not survive a round trip through a widget: a `time` is an
+*  integer rendered as a `datetime-local`, with no seconds, so every
+*  save moved it back up to 59 s. Nothing looked wrong until the
+*  stored timestamp had moved.
+*
+*  `is_file` and not the type: a `file` column IS an fkey (it is
+*  flagged ['fkey','file']) but answers `type: "file"`, and the write
+*  goes out with `autolink`, which rebuilds the links from what the
+*  record carries. Dropped, a read-only `file` column -- the one only
+*  a load fills -- was UNLINKED by every save of any other field.
+*
+*  The pkey2s go back for the same reason as the pkey: a secondary key
+*  names the INSTANCE the update is for (`yunos.yuno_release` in the
+*  agent), and it is `persistent, required`, not `writable`. Dropped,
+*  the update reached the backend with no pkey2 and C_NODE resolved it
+*  to the PRIMARY instance -- right by chance while the table lists
+*  primaries, wrong from a form opened on a row of `instances`.
+************************************************************/
+function col_goes_back_to_treedb(desc, col) {
+	let d = desc || {};
+	let pkey = d.pkey || "id";
+	const field_desc = treedb_get_field_desc(col);
+	if (field_desc.is_writable || field_desc.type === "fkey" || field_desc.is_file || col.id === pkey) return true;
+	return topic_pkey2s(d).includes(col.id);
+}
 //#endregion
 //#region src/delete_impact.js
 /***********************************************************************
@@ -28046,35 +28576,6 @@ function get_schema_col(gobj, id) {
 	return null;
 }
 /************************************************************
-*  Does column `col` travel back to treedb on a write?
-*
-*  The form SHOWS every field and sends back only what the topic
-*  accepts: the writable cols, the fkeys (a link is edited by
-*  linking) and the pkey, which is not written but is what
-*  ADDRESSES the record.
-*
-*  It matters because `treedb_update_node()` does not check
-*  `writable` -- it writes any col it is handed -- so a read-only
-*  field travelling back is written with whatever the form made of
-*  it, and the fields that describe a record are exactly the ones
-*  that do not survive a round trip through a widget: a `time` is an
-*  integer rendered as a `datetime-local`, with no seconds, so every
-*  save moved it back up to 59 s. Nothing looked wrong until the
-*  stored timestamp had moved.
-*
-*  `is_file` and not the type: a `file` column IS an fkey (it is
-*  flagged ['fkey','file']) but answers `type: "file"`, and the write
-*  goes out with `autolink`, which rebuilds the links from what the
-*  record carries. Dropped, a read-only `file` column -- the one only
-*  a load fills -- was UNLINKED by every save of any other field.
-************************************************************/
-function col_goes_back_to_treedb(gobj, col) {
-	let pkey = gobj_read_attr(gobj, "desc").pkey || "id";
-	const field_desc = treedb_get_field_desc(col);
-	if (field_desc.is_writable || field_desc.type === "fkey" || field_desc.is_file || col.id === pkey) return true;
-	return false;
-}
-/************************************************************
 *  The record the FORM hands over, without the columns that do
 *  not go back to treedb (see col_goes_back_to_treedb()). The
 *  form has already encoded the values, so only the columns are
@@ -28084,7 +28585,7 @@ function strip_read_only_cols(gobj, record) {
 	let row = {};
 	for (let field_name of Object.keys(record || {})) {
 		let col = get_schema_col(gobj, field_name);
-		if (col && !col_goes_back_to_treedb(gobj, col)) continue;
+		if (col && !col_goes_back_to_treedb(gobj_read_attr(gobj, "desc"), col)) continue;
 		row[field_name] = record[field_name];
 	}
 	return row;
@@ -28100,7 +28601,7 @@ function transform__form_record_2_treedb_record(gobj, kw, operation) {
 		if (empty_string(field_name)) continue;
 		let col = get_schema_col(gobj, field_name);
 		if (!col) continue;
-		if (!col_goes_back_to_treedb(gobj, col)) continue;
+		if (!col_goes_back_to_treedb(gobj_read_attr(gobj, "desc"), col)) continue;
 		let value = kw[field_name];
 		row[field_name] = transform__form_value_2_treedb_value(gobj, col, value, operation);
 	}
@@ -68475,12 +68976,20 @@ function hook_mark(type) {
 *      (↖)  1 fkey      (1 parent)
 *      [↖]  n fkeys     (n parents)
 *      {↖}  N fkeys     (N parents)
+*      (2)  a secondary key (pkey2)
+*      (t)  the time key (tkey)
 *      *    required
 *      #    the primary key
 *
-*   A column can be BOTH hook and fkey, so the flags are read
-*   here rather than through treedb_get_field_desc's single
-*   `type`, which keeps only the last flag it saw.
+*   The key marks lead the mark column, and a pkey2 is drawn in
+*   bold like the pkey: a topic with secondary keys keeps several
+*   instances under one id, which is the first thing to know
+*   about it. `(t)` is new to the notation: the literals' legend
+*   carries it too.
+*
+*   The flags are read here rather than through
+*   treedb_get_field_desc's single `type`, which keeps only the
+*   last flag it saw.
 ************************************************************/
 function schema_rows(desc) {
 	let rows = [];
@@ -68490,19 +68999,25 @@ function schema_rows(desc) {
 		let flags = Array.isArray(col.flag) ? col.flag : [];
 		let is_hook = flags.indexOf("hook") >= 0;
 		let is_fkey = flags.indexOf("fkey") >= 0;
+		let roles = col_key_roles(desc, col.id);
+		let key_marks = [];
+		if (roles.includes("pkey2")) key_marks.push("(2)");
+		if (roles.includes("tkey")) key_marks.push("(t)");
 		let mark = "";
 		if (is_hook) mark = hook_mark(col.type);
 		if (is_fkey) {
 			let fmark = hook_mark(col.type).replace("}", "↖}").replace("]", "↖]").replace(")", "↖)");
 			mark = mark ? mark + " " + fmark : fmark;
 		}
+		if (key_marks.length) mark = mark ? key_marks.join(" ") + " " + mark : key_marks.join(" ");
 		rows.push({
 			name: col.id,
 			type: col.type || "",
 			mark,
 			is_hook,
 			is_fkey,
-			is_pkey: col.id === desc.pkey,
+			is_pkey: roles.includes("pkey"),
+			is_pkey2: roles.includes("pkey2"),
 			required: flags.indexOf("required") >= 0 || flags.indexOf("notnull") >= 0
 		});
 	}
@@ -68549,7 +69064,7 @@ function build_card_innerHTML(topic, rows, color, dark) {
 	let rows_html = "";
 	for (let row of rows) {
 		let lead = row.is_pkey ? "#" : row.required ? "*" : "";
-		let name_weight = row.is_pkey || row.required ? "600" : "400";
+		let name_weight = row.is_pkey || row.is_pkey2 ? "700" : row.required ? "600" : "400";
 		let name_color = row.is_hook || row.is_fkey ? title_color : text_color;
 		rows_html += `    <div class="TREEDB_SCHEMA_FIELD" style="
         display: flex; align-items: center; gap: 6px;
@@ -69018,361 +69533,6 @@ function register_c_yui_treedb_schema() {
 	return create_gclass$2(GCLASS_NAME$2);
 }
 //#endregion
-//#region src/schema_model.js
-/***********************************************************************
-*          schema_model.js
-*
-*      A SCHEMA out of the three meta-topics that store it.
-*
-*      `treedb_system_schema` keeps every schema of a yuno as DATA, in
-*      three flat topics — `treedbs`, `topics`, `cols` — linked by
-*      fkeys. That is the right STORAGE and the wrong thing to put in
-*      front of an operator: adding one column to one topic means
-*      finding it in a table holding every column of every topic of
-*      every treedb the yuno has.
-*
-*      This module turns those three lists back into what they
-*      describe: treedb -> topics -> columns, each in its declared
-*      `order`. Pure, so the editor's model can be tested with no DOM
-*      and no backend — the gclass fetches and draws, this decides
-*      what the records MEAN.
-*
-*      TWO THINGS IT EXISTS TO STATE ONCE:
-*
-*      1. A record is grouped by its FKEY, not by its id. The id is
-*         qualified (`<treedb>.<topic>.<column>`) and reading it back
-*         with a split on '.' works right up to the first treedb or
-*         topic whose name carries one. The fkey is the link the store
-*         itself uses; the id is only the fallback for a record whose
-*         fkey never arrived.
-*
-*      2. A fkey reaches this code in FOUR shapes, because `nodes`
-*         answers differently depending on the options it was called
-*         with: the bare ref string, the expanded object, a list of
-*         either, or a dict keyed by the ref. All four are the same
-*         fact and parse_fkey_ref() flattens them to it.
-*
-*          Copyright (c) 2026, ArtGins.
-*          All Rights Reserved.
-***********************************************************************/
-var DEFAULT_ORDER = 9999;
-/***************************************************************
-*  parse_fkey_ref(value) -> [{topic_name, id, hook_name}, ...]
-*
-*      Every shape a fkey column can arrive in, flattened to the
-*      refs it names. Anything unrecognizable contributes nothing —
-*      a schema drawn without one link beats a screen that throws.
-***************************************************************/
-function parse_fkey_ref(value) {
-	let refs = [];
-	let push_one = (v) => {
-		if (typeof v === "string") {
-			let parts = v.split("^");
-			if (parts.length !== 3) return;
-			refs.push({
-				topic_name: parts[0],
-				id: parts[1],
-				hook_name: parts[2]
-			});
-			return;
-		}
-		if (v && typeof v === "object") {
-			let id = v.id;
-			if (typeof id !== "string" || id.length === 0) return;
-			refs.push({
-				topic_name: v.topic_name || "",
-				id,
-				hook_name: v.hook_name || ""
-			});
-		}
-	};
-	if (value === null || value === void 0) return refs;
-	if (typeof value === "string") {
-		push_one(value);
-		return refs;
-	}
-	if (Array.isArray(value)) {
-		for (let v of value) push_one(v);
-		return refs;
-	}
-	if (typeof value === "object") for (let [key, v] of Object.entries(value)) if (v && typeof v === "object" && typeof v.id === "string") push_one(v);
-	else push_one(key);
-	return refs;
-}
-/***************************************************************
-*  The id of the FIRST parent a record names, or "" when it
-*  names none. A record has one parent here — a column belongs to
-*  one topic, a topic to one treedb — and a second ref would be a
-*  store this editor cannot draw anyway.
-***************************************************************/
-function parent_id(record, fkey_col) {
-	let refs = parse_fkey_ref(record ? record[fkey_col] : null);
-	return refs.length > 0 ? refs[0].id : "";
-}
-/***************************************************************
-*  The name a record is KNOWN by, which is not what it is keyed
-*  by: `topics` and `cols` key by the qualified id and carry the
-*  bare name in `value` (its pkey2). An older store that still
-*  keyed by rowid has no `value` worth showing, so the id stands
-*  in — the same fallback as node_label().
-***************************************************************/
-function record_name(record) {
-	if (!record) return "";
-	if (typeof record.value === "string" && record.value.length > 0) return record.value;
-	return typeof record.id === "string" ? record.id : "";
-}
-/***************************************************************
-*  The `order` of a record as a NUMBER, whatever the store put
-*  there: an integer column read back from JSON may arrive as a
-*  string, and comparing "10" with 9 sorts the schema wrong.
-***************************************************************/
-function record_order(record) {
-	let order = record ? record.order : void 0;
-	if (typeof order === "number" && isFinite(order)) return order;
-	if (typeof order === "string" && order.trim().length > 0) {
-		let n = Number(order);
-		if (isFinite(n)) return n;
-	}
-	return DEFAULT_ORDER;
-}
-/***************************************************************
-*  Sort in place by `order`, ties broken by name so a schema
-*  whose records all default to 9999 still draws the same way
-*  twice.
-***************************************************************/
-function sort_by_order(list) {
-	list.sort((a, b) => {
-		if (a.order !== b.order) return a.order - b.order;
-		return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;
-	});
-	return list;
-}
-/***************************************************************
-*  build_schema_model({treedbs, topics, cols}) -> model
-*
-*      model = {
-*          treedbs: [{
-*              id, name, record,
-*              schema_version, c_schema_version, system_schema_version,
-*              topics: [{
-*                  id, name, order, record,
-*                  pkey, topic_version, system_topic, main_topic,
-*                  cols: [{id, name, order, record}]
-*              }]
-*          }],
-*          orphan_topics: [...],   topics whose treedb is not in the store
-*          orphan_cols:   [...]    columns whose topic is not in the store
-*      }
-*
-*      An orphan is NOT dropped. A column whose topic was deleted is
-*      exactly the kind of leftover an operator opens this editor to
-*      find, and a model that hides it makes the editor lie.
-***************************************************************/
-function build_schema_model(records) {
-	let r = records || {};
-	let treedb_rows = Array.isArray(r.treedbs) ? r.treedbs : [];
-	let topic_rows = Array.isArray(r.topics) ? r.topics : [];
-	let col_rows = Array.isArray(r.cols) ? r.cols : [];
-	let treedbs = [];
-	let by_treedb_id = {};
-	for (let record of treedb_rows) {
-		if (!record || typeof record.id !== "string") continue;
-		let entry = {
-			id: record.id,
-			name: record.id,
-			record,
-			schema_version: record.schema_version,
-			c_schema_version: record.c_schema_version,
-			system_schema_version: record.system_schema_version,
-			topics: []
-		};
-		treedbs.push(entry);
-		by_treedb_id[entry.id] = entry;
-	}
-	let orphan_topics = [];
-	let by_topic_id = {};
-	for (let record of topic_rows) {
-		if (!record || typeof record.id !== "string") continue;
-		let entry = {
-			id: record.id,
-			name: record_name(record),
-			order: record_order(record),
-			record,
-			treedb_id: parent_id(record, "treedbs"),
-			pkey: record.pkey || "",
-			pkey2s: record.pkey2s,
-			system_flag: record.system_flag || "",
-			tkey: record.tkey || "",
-			topic_version: record.topic_version,
-			system_topic: !!record.system_topic,
-			main_topic: !!record.main_topic,
-			cols: []
-		};
-		by_topic_id[entry.id] = entry;
-		let parent = by_treedb_id[entry.treedb_id];
-		if (parent) parent.topics.push(entry);
-		else orphan_topics.push(entry);
-	}
-	let orphan_cols = [];
-	for (let record of col_rows) {
-		if (!record || typeof record.id !== "string") continue;
-		let entry = {
-			id: record.id,
-			name: record_name(record),
-			order: record_order(record),
-			record,
-			topic_id: parent_id(record, "topics")
-		};
-		let parent = by_topic_id[entry.topic_id];
-		if (parent) parent.cols.push(entry);
-		else orphan_cols.push(entry);
-	}
-	for (let treedb of treedbs) {
-		sort_by_order(treedb.topics);
-		for (let topic of treedb.topics) sort_by_order(topic.cols);
-	}
-	for (let topic of orphan_topics) sort_by_order(topic.cols);
-	treedbs.sort((a, b) => {
-		return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
-	});
-	sort_by_order(orphan_topics);
-	sort_by_order(orphan_cols);
-	return {
-		treedbs,
-		orphan_topics,
-		orphan_cols
-	};
-}
-/***************************************************************
-*  Is there a value here at all?
-*
-*  The store answers a `blob` column that was never set with an
-*  EMPTY COLLECTION, not with nothing: `enum: {}`, `hook: {}`,
-*  `default: {}`. Read as "a value", those turn every export into
-*  a schema full of empty objects — and `'hook': {}` in a literal
-*  is a hook with no mapping, which is a link the treedb builds
-*  and nothing writes.
-***************************************************************/
-function is_empty_value(value) {
-	if (value === null || value === void 0 || value === "") return true;
-	if (Array.isArray(value)) return value.length === 0;
-	if (typeof value === "object") return Object.keys(value).length === 0;
-	return false;
-}
-/***************************************************************
-*  The fields of a column that are DECLARED as one thing and
-*  STORED as another.
-*
-*  `hook`, `enum`, `default`, `pkey2s` and `properties` are `blob`
-*  columns of the `cols` topic (treedb_system_schema.c), so what
-*  comes back may be the value or the JSON text of the value,
-*  depending on how it was written — a projection writes the
-*  value, a hand edit through a plain text field writes the text.
-*  `flag` is an array that a single-flag edit can leave as a bare
-*  string. Reading these without saying so is how a hook drawn
-*  from `{"users":"department"}` becomes no hook at all.
-***************************************************************/
-function as_json(value) {
-	if (typeof value !== "string") return value;
-	let text = value.trim();
-	if (text.length === 0) return null;
-	try {
-		return JSON.parse(text);
-	} catch (e) {
-		return value;
-	}
-}
-function col_flags(record) {
-	let flag = record ? record.flag : null;
-	if (Array.isArray(flag)) return flag.filter((f) => typeof f === "string" && f.length > 0);
-	if (typeof flag === "string" && flag.length > 0) {
-		let parsed = as_json(flag);
-		if (Array.isArray(parsed)) return parsed.filter((f) => typeof f === "string" && f.length > 0);
-		return [flag];
-	}
-	return [];
-}
-function col_hook(record) {
-	let hook = as_json(record ? record.hook : null);
-	if (hook && typeof hook === "object" && !Array.isArray(hook)) return hook;
-	return null;
-}
-function col_enum(record) {
-	let e = as_json(record ? record.enum : null);
-	if (Array.isArray(e)) return e;
-	return [];
-}
-function topic_pkey2s(record) {
-	let pkey2s = as_json(record ? record.pkey2s : null);
-	if (Array.isArray(pkey2s)) return pkey2s.filter((k) => typeof k === "string" && k.length > 0);
-	if (typeof pkey2s === "string" && pkey2s.length > 0) return [pkey2s];
-	return [];
-}
-/***************************************************************
-*  Lookups by id. The editor addresses a position by NAME (the
-*  url carries `<treedb>/<topic>`), so both are offered.
-***************************************************************/
-function find_treedb(model, treedb_id) {
-	if (!model || !Array.isArray(model.treedbs)) return null;
-	for (let treedb of model.treedbs) if (treedb.id === treedb_id) return treedb;
-	return null;
-}
-function find_topic(model, treedb_id, topic_name) {
-	let treedb = find_treedb(model, treedb_id);
-	if (!treedb) return null;
-	for (let topic of treedb.topics) if (topic.name === topic_name || topic.id === topic_name) return topic;
-	return null;
-}
-function find_col(model, treedb_id, topic_name, col_name) {
-	let topic = find_topic(model, treedb_id, topic_name);
-	if (!topic) return null;
-	for (let col of topic.cols) if (col.name === col_name || col.id === col_name) return col;
-	return null;
-}
-/***************************************************************
-*  The fkey a NEW record must carry to belong to `parent_id`.
-*  Written here because the editor is the only writer that has to
-*  compose one, and getting the hook name wrong links the record
-*  to nothing while the write still succeeds.
-***************************************************************/
-function fkey_ref(parent_topic, parent_id_, hook_name) {
-	return `${parent_topic}^${parent_id_}^${hook_name}`;
-}
-/***************************************************************
-*  Where a new sibling goes: after the last one. The store's own
-*  default (9999) would put every hand-made column in the same
-*  place and let their names decide the schema's order.
-***************************************************************/
-function next_order(siblings) {
-	let max = 0;
-	if (Array.isArray(siblings)) for (let s of siblings) {
-		let order = s && typeof s.order === "number" ? s.order : DEFAULT_ORDER;
-		if (order < 9999 && order > max) max = order;
-	}
-	return max + 1;
-}
-/***************************************************************
-*  Renumber a list AFTER a move, as the writes it takes: only the
-*  records whose order actually changed, so a drag of one row in a
-*  40-column topic is not 40 writes.
-*
-*      moved_orders(list) -> [{id, order}, ...]
-***************************************************************/
-function moved_orders(list) {
-	let writes = [];
-	if (!Array.isArray(list)) return writes;
-	for (let i = 0; i < list.length; i++) {
-		let entry = list[i];
-		let order = i + 1;
-		if (!entry || typeof entry.id !== "string") continue;
-		if (entry.order !== order) writes.push({
-			id: entry.id,
-			order
-		});
-	}
-	return writes;
-}
-//#endregion
 //#region src/schema_validate.js
 /***********************************************************************
 *          schema_validate.js