@coffer-org/plugin-documents 5.0.0 → 6.0.0

package/dist/person_identity/index.js

@@ -5,7 +5,7 @@ export default defineExtend({
     label: 'documents.person_identity.label',
     icon: 'lucide:globe',
     attachTo: [{ library: 'people', shelf: 'person' }],
-    claude: `Canonical person identity (not tied to a physical document).
+    agent: `Canonical person identity (not tied to a physical document).
 nationality — ISO alpha-2. variants — given/family name per language (field.keyed by lang: name+surname).`,
     fields: {
         nationality: field.string({

package/dist/schema.js

@@ -4687,6 +4687,13 @@ function wrapKey(key, opts, meta) {
 			editor: opts.editor
 		}
 	};
+	if (opts.activate) m = {
+		...m,
+		hints: {
+			...m.hints,
+			activate: opts.activate
+		}
+	};
 	if (opts.span !== void 0) m = {
 		...m,
 		hints: {
@@ -4759,6 +4766,7 @@ function wrapKey(key, opts, meta) {
 function normalizeOpts(rawIn) {
 	const raw = rawIn;
 	if (raw["view"] !== void 0) throw new Error("[normalizeOpts] `view` is gone — presentational options live in `ui: {}` (see CLAUDE.md § field author options and the field-types skill).");
+	if (raw.ui?.["agent"] !== void 0) throw new Error("[normalizeOpts] `agent` is not presentation — declare it at the top level of the field call, not in `ui: {}`.");
 	const r = raw.rules ?? {};
 	const v = raw.ui ?? {};
 	const config = {};
@@ -4795,7 +4803,8 @@ function normalizeOpts(rawIn) {
 		emphasis: v.emphasis,
 		noLabel: v.noLabel,
 		role: v.role,
-		editor: v.editor
+		editor: v.editor,
+		activate: v.activate
 	};
 	return Object.fromEntries(Object.entries(result).filter(([, val]) => val !== void 0));
 }
@@ -5030,6 +5039,7 @@ function materialize(decl, name) {
 	const base = {
 		kind: type.kind,
 		label: opts.label ?? "",
+		...opts.agent !== void 0 && { agent: opts.agent },
 		required,
 		prim: type.prim,
 		column: built.column,
@@ -5073,6 +5083,7 @@ function collectionGroup(key, opts, parts, collectionView) {
 		multiple: true,
 		required: opts.required ?? false,
 		label: opts.label ?? key,
+		...opts.agent !== void 0 && { agent: opts.agent },
 		display: "wrap",
 		kind: collectionView,
 		fields: rowFields
@@ -10176,10 +10187,11 @@ var field = new Proxy({}, {
 	has: (_t, k) => k in composedField()
 });
 function toClient(field) {
-	const { kind, label, required, prim, hints, options, strict, relation, json, hidden, derived, parts, cache } = field;
+	const { kind, label, agent, required, prim, hints, options, strict, relation, json, hidden, derived, parts, cache } = field;
 	return {
 		kind,
 		label,
+		...agent !== void 0 && { agent },
 		required,
 		prim,
 		hints,
@@ -10967,7 +10979,7 @@ function defineShelf(m) {
 	const keys = fieldEntries(built.fields).map(([k]) => k);
 	const dup = keys.find((k, i) => keys.indexOf(k) !== i);
 	if (dup) throw new Error(`[shelf] ${built.library}/${built.shelf}: duplicate key '${dup}'`);
-	if (built.single && !built.claude) throw new Error(`[shelf] ${built.library}/${built.shelf}: single shelf requires \`claude\` — the agent cannot find it otherwise`);
+	if (built.single && !built.agent) throw new Error(`[shelf] ${built.library}/${built.shelf}: single shelf requires \`agent\` — the agent cannot find it otherwise`);
 	if (built.views?.list !== void 0 && !Array.isArray(built.views.list)) throw new Error(`[shelf] ${built.library}/${built.shelf}: views.list is a flat array of field keys — the { kind, fields } form is gone; use views.list: [...] plus views.listKind`);
 	if (built.standalone !== false && !built.single && !built.views?.list?.length) console.warn(`[shelf] ${built.library}/${built.shelf}: standalone shelf without an explicit views.list`);
 	if (built.views?.title && !ownFieldEntries(built.fields).some(([k]) => k === built.views.title)) throw new Error(`[shelf] ${built.library}/${built.shelf}: views.title '${built.views.title}' is not a field`);
@@ -11184,7 +11196,7 @@ var person_identity_default = defineExtend({
 		library: "people",
 		shelf: "person"
 	}],
-	claude: `Canonical person identity (not tied to a physical document).
+	agent: `Canonical person identity (not tied to a physical document).
 nationality — ISO alpha-2. variants — given/family name per language (field.keyed by lang: name+surname).`,
 	fields: {
 		nationality: field.string({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/plugin-documents",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -26,9 +26,9 @@
     "postpack": "node ../../scripts/swap-exports.mjs src"
   },
   "dependencies": {
-    "@coffer-org/plugin-people": "^5.0.0",
-    "@coffer-org/sdk": "^5.0.0",
-    "@coffer-org/server": "^5.0.0"
+    "@coffer-org/plugin-people": "^6.0.0",
+    "@coffer-org/sdk": "^6.0.0",
+    "@coffer-org/server": "^6.0.0"
   },
   "coffer": {
     "runtime": "node",