@coffer-org/sdk 2.1.2 → 2.2.0

package/dist/field-presets.d.ts

@@ -152,6 +152,22 @@ export declare function snippet(o: CodeOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
+export declare const SOURCE_DEFAULT_MAX_BYTES = 262144;
+export declare function isBinaryText(v: string): boolean;
+export interface SourceOpts extends FieldCoreOpts {
+    label?: string;
+}
+export declare function source(o: SourceOpts & {
+    key: string;
+}): FieldItem;
+export declare function source(o: SourceOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function source(o: SourceOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
 export interface RatingOpts extends FieldCoreOpts {
     label?: string;
 }
@@ -242,6 +258,7 @@ export declare const presets: {
     tags: typeof tags;
     markdown: typeof markdown;
     snippet: typeof snippet;
+    source: typeof source;
     rating: typeof rating;
     duration: typeof duration;
     reminder: typeof reminder;

package/dist/field-presets.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { real, int, text, date, select, string, group, vmsg, jsonRefined, typeErr, optionalize, applyMultiple, wrapKey, normalizeOpts, } from "./fields.js";
+import { real, int, text, date, select, string, group, vmsg, jsonRefined, typeErr, reqTypeErr, optionalize, applyMultiple, wrapKey, normalizeOpts, } from "./fields.js";
 export function email(raw) {
     const o = normalizeOpts(raw);
     const required = o.required ?? false;
@@ -225,6 +225,34 @@ export function snippet(raw) {
     };
     return wrapKey(norm, meta);
 }
+export const SOURCE_DEFAULT_MAX_BYTES = 262_144;
+export function isBinaryText(v) {
+    return v.includes('\x00') || v.includes('�');
+}
+export function source(raw) {
+    const o = normalizeOpts(raw);
+    const required = o.required ?? false;
+    const ext = o.ext ?? 'txt';
+    const maxBytes = o.maxBytes ?? SOURCE_DEFAULT_MAX_BYTES;
+    const s = z.string(reqTypeErr()).superRefine((v, ctx) => {
+        if (isBinaryText(v)) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: vmsg('source_binary') });
+            return;
+        }
+        if (new TextEncoder().encode(v).length > maxBytes)
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: vmsg('source_too_large', { maxBytes }) });
+    });
+    const meta = {
+        kind: 'source',
+        label: o.label ?? '',
+        required,
+        prim: 'text',
+        column: 'text',
+        hints: { ext, maxBytes, noEditControl: true },
+        zod: optionalize(s, required),
+    };
+    return wrapKey(o, meta);
+}
 export function rating(raw) {
     const o = normalizeOpts(raw);
     const required = o.required ?? false;
@@ -328,6 +356,7 @@ export const presets = {
     tags,
     markdown,
     snippet,
+    source,
     rating,
     duration,
     reminder,

package/dist/fields/normalize.d.ts

@@ -13,6 +13,8 @@ export interface Rules {
     unique?: string[];
     fixed?: boolean;
     exts?: string[];
+    ext?: string;
+    maxBytes?: number;
     lead?: number;
     by?: FieldItem;
 }
@@ -66,6 +68,8 @@ export type NormalizedOpts = {
     unique?: string[];
     fixed?: boolean;
     exts?: string[];
+    ext?: string;
+    maxBytes?: number;
     lead?: number;
     by?: FieldItem;
     min?: number | string;

package/dist/fields/normalize.js

@@ -28,6 +28,8 @@ export function normalizeOpts(rawIn) {
         unique: r.unique,
         fixed: r.fixed,
         exts: r.exts,
+        ext: r.ext,
+        maxBytes: r.maxBytes,
         lead: r.lead,
         by: r.by,
         min: r.min,

package/dist/fields.d.ts

@@ -400,6 +400,7 @@ export declare function json(o: JsonOpts & {
 }): FieldMeta;
 export interface CheckOpts extends FieldCoreOpts {
     slots?: string[];
+    fields?: FieldItem[];
 }
 export declare function check(o: CheckOpts & {
     key: string;

package/dist/fields.js

@@ -509,13 +509,30 @@ export function check(raw) {
     const required = o.required ?? false;
     const multiple = o.multiple ?? false;
     const slots = o.slots && o.slots.length > 0 ? o.slots : [''];
+    const contentFields = o.fields?.length
+        ? o.fields
+        : [string({ key: 'text', label: 'core.fields.text' })];
+    const contentKeys = new Set();
+    for (const f of contentFields) {
+        if (contentKeys.has(f.key))
+            throw new Error(`[field.check] duplicate content field '${f.key}'`);
+        if (/^check\d+$/.test(f.key))
+            throw new Error(`[field.check] content field '${f.key}' is reserved for checkbox slots`);
+        if (!multiple && (f.type.virtual || f.type.columns))
+            throw new Error(`[field.check] single content field '${f.key}' must be a scalar stored field`);
+        contentKeys.add(f.key);
+    }
+    const checkFields = slots.map((label, i) => boolean({ key: `check${i}`, label: label || 'core.fields.check' }));
     if (multiple) {
-        const fields = slots.map((label, i) => boolean({ key: `check${i}`, label: label || 'core.fields.check' }));
-        fields.push(string({ key: 'text', label: 'core.fields.text' }));
+        const fields = [...checkFields, ...contentFields];
         return group({ key: o.key, label: o.label ?? o.key, multiple: true, required: required, fields, view: { kind: 'checklist' } });
     }
-    const shape = { text: z.string() };
-    const columns = { text: 'text' };
+    const shape = {};
+    const columns = {};
+    for (const f of contentFields) {
+        shape[f.key] = f.type.zod;
+        columns[f.key] = f.type.column;
+    }
     slots.forEach((_, i) => {
         shape[`check${i}`] = z.boolean();
         columns[`check${i}`] = 'boolean';
@@ -536,7 +553,10 @@ export function check(raw) {
         required,
         prim: 'check',
         column: 'text',
-        hints: { slots },
+        hints: {
+            slots,
+            fields: contentFields.map((f) => ({ key: f.key, ...toClient(f.type) })),
+        },
         columns,
         zod: optionalize(s, required),
     };

package/dist/shelf.d.ts

@@ -24,6 +24,7 @@ export interface ShelfDef {
     icon?: string;
     claude?: string;
     standalone?: boolean;
+    single?: boolean;
     views?: ShelfViews;
     fields: LayoutEl[];
 }

package/dist/shelf.js

@@ -68,7 +68,9 @@ export function defineShelf(m) {
     const dup = keys.find((k, i) => keys.indexOf(k) !== i);
     if (dup)
         throw new Error(`[shelf] ${m.library}/${m.shelf}: duplicate key '${dup}'`);
-    if (m.standalone !== false && !m.views?.list?.fields?.length)
+    if (m.single && !m.claude)
+        throw new Error(`[shelf] ${m.library}/${m.shelf}: single shelf requires \`claude\` — the agent cannot find it otherwise`);
+    if (m.standalone !== false && !m.single && !m.views?.list?.fields?.length)
         console.warn(`[shelf] ${m.library}/${m.shelf}: standalone shelf without an explicit views.list`);
     return m;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/sdk",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "type": "module",
   "engines": {
     "node": ">=24"