@coffer-org/plugin-transit 5.0.0 → 7.0.0

package/dist/index.js

@@ -14,6 +14,7 @@ export default definePlugin({
                 label: 'transit.library.label',
                 icon: 'lucide:bus',
                 agent: 'Local bus routes and their departure schedules (bus_route).',
+                starterHint: 'the next departures on the saved routes',
             }),
             shelves: [bus_route],
         },

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
@@ -8545,6 +8556,12 @@ function divider(o) {
 /**
 * Reference markdown block by i18n key.
 *
+* The key is resolved WITH the variables of the running instance, so the locale string
+* may name facts that are not constants: `{{origin}}` is this instance's own address
+* (`https://coffer.example`), which is how a block documents an endpoint without
+* freezing a developer's `localhost` into every translation. The set is fixed and
+* ambient — the block declares only its key. See `web-ui/src/render/info-text.ts`.
+*
 * @layer   primitive
 * @prim    —
 * @widget  info
@@ -10159,10 +10176,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,
@@ -10955,7 +10973,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`);
@@ -11073,7 +11091,8 @@ var src_default = definePlugin({
 			id: "transit",
 			label: "transit.library.label",
 			icon: "lucide:bus",
-			agent: "Local bus routes and their departure schedules (bus_route)."
+			agent: "Local bus routes and their departure schedules (bus_route).",
+			starterHint: "the next departures on the saved routes"
 		}),
 		shelves: [bus_route_default]
 	}],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/plugin-transit",
-  "version": "5.0.0",
+  "version": "7.0.0",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -26,9 +26,9 @@
     "test": "node --import tsx/esm --test 'src/runtime/*.test.ts'"
   },
   "dependencies": {
-    "@coffer-org/sdk": "^5.0.0",
-    "@coffer-org/server": "^5.0.0",
-    "@coffer-org/helper-dav": "^5.0.0"
+    "@coffer-org/sdk": "^7.0.0",
+    "@coffer-org/server": "^7.0.0",
+    "@coffer-org/helper-dav": "^7.0.0"
   },
   "coffer": {
     "runtime": "node",