@coffer-org/web-sdk 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-export * from './types.js';
-export * from './module-ui.js';
-export * from './registry.js';
-//# sourceMappingURL=index.d.ts.map
+export * from './types.ts';
+export * from './module-ui.ts';
+export * from './registry.ts';

package/dist/index.js

@@ -1,4 +1,3 @@
-export * from './types.js';
-export * from './module-ui.js';
-export * from './registry.js';
-//# sourceMappingURL=index.js.map
+export * from "./types.js";
+export * from "./module-ui.js";
+export * from "./registry.js";

package/dist/module-ui.d.ts

@@ -1,36 +1,15 @@
-/**
- * Контракт для UI-частини модуля.
- * Кожен модуль може мати `ui.tsx` поряд з `index.ts`, де декларує:
- *   - кастомний рендер запису (замінює генеричний RecordContent)
- *   - переклади (мержаться в глобальний i18next)
- */
 import type { FC } from 'react';
-import type { FieldRenderer } from './types.js';
+import type { FieldRenderer, TemplateImporter } from './types.ts';
 export interface RecordViewProps {
     record: Record<string, unknown>;
     onEdit?: () => void;
 }
-/**
- * Що модуль публікує в ui.tsx.
- * Передай через `defineModuleUI(vault, module, { ... })`.
- */
 export interface ModuleUIBundle {
     vault: string;
     module: string;
-    /** Повністю кастомний рендер запису. Якщо є — замінює генеричний RecordContent. */
     RecordView?: FC<RecordViewProps>;
-    /**
-     * Масив рендерів типів полів, які оголошує плагін: кожен рендер несе власний kinds[].
-     * Реєструються в глобальний rendererRegistry (симетрично з core-рендерами).
-     * Так плагін-власник додає свій тип поля (фабрика + рендер) без змін у core.
-     */
     renderers?: FieldRenderer[];
-    /**
-     * Переклади, які мержаться в глобальний i18next.
-     * Ключі — коди мов (uk / ru / en).
-     */
+    templates?: Record<string, TemplateImporter<any>>;
     translations?: Partial<Record<'uk' | 'ru' | 'en', Record<string, unknown>>>;
 }
-/** Допоміжна функція — прикріплює vault/module до UI-бандла. */
 export declare function defineModuleUI(vault: string, module: string, ui: Omit<ModuleUIBundle, 'vault' | 'module'>): ModuleUIBundle;
-//# sourceMappingURL=module-ui.d.ts.map

package/dist/module-ui.js

@@ -1,5 +1,3 @@
-/** Допоміжна функція — прикріплює vault/module до UI-бандла. */
 export function defineModuleUI(vault, module, ui) {
     return { vault, module, ...ui };
 }
-//# sourceMappingURL=module-ui.js.map

package/dist/registry.d.ts

@@ -1,23 +1,18 @@
-/**
- * Єдиний реєстр рендерів полів. Кожен рендерер оголошує `kinds`, які обслуговує.
- * Резолв — суворо по `kind` (1:1). Fallback на `prim` прибрано: пропущена
- * реєстрація або колізія kind — явна помилка.
- */
 import type { FieldClient, FieldMeta, LayoutEl } from '@coffer-org/sdk/fields';
-import type { FieldRenderer, ElementRenderProps, FieldInlineProps } from './types.js';
+import type { FieldRenderer, ElementRenderProps, FieldInlineProps, BoxGeom, TemplateImporter } from './types.ts';
 import type { FC } from 'react';
 export declare const rendererRegistry: Record<string, FieldRenderer>;
-/** Реєструє рендерер під усіма його `kinds`. Дубль kind → помилка. */
 export declare function registerRenderer<P extends ElementRenderProps>(r: {
     kinds: string[];
-    layout?: 'block' | 'scalar';
+    layout?: 'block' | 'scalar' | ((field: FieldMeta) => 'block' | 'scalar');
+    box?: BoxGeom;
     Page: FC<P>;
     Inline?: FC<FieldInlineProps>;
+    keys?: FieldRenderer['keys'];
 }): void;
-/** Резолв суворо по kind. undefined → kind без рендерера. */
 export declare function resolveRenderer(field: Pick<FieldClient, 'kind'>): FieldRenderer | undefined;
-/** Повертає рядковий ідентифікатор виду layout-елемента. */
 export declare function elementKind(el: LayoutEl): string;
-/** Ширина поля в layout-сітці: апетит рендерера; дефолт scalar. */
 export declare function fieldLayout(field: FieldMeta): 'block' | 'scalar';
-//# sourceMappingURL=registry.d.ts.map
+export declare const multiBlock: (field: FieldMeta) => "block" | "scalar";
+export declare function registerTemplate(name: string, importer: TemplateImporter<any>): void;
+export declare function resolveTemplate(name: string): TemplateImporter | undefined;

package/dist/registry.js

@@ -1,43 +1,53 @@
 import { isField, isStatic, isButton, isDivider, isInfo, isGroup, isCollectionGroup, isEmbeddedGroup, } from '@coffer-org/sdk/fields';
 export const rendererRegistry = {};
-/** Реєструє рендерер під усіма його `kinds`. Дубль kind → помилка. */
 export function registerRenderer(r) {
     if (!r.kinds.length)
-        throw new Error('[render] рендерер без kinds');
+        throw new Error('[render] renderer without kinds');
     const stored = {
         kinds: r.kinds,
         layout: r.layout,
+        box: r.box,
         Page: r.Page,
         Inline: r.Inline,
+        keys: r.keys,
     };
     for (const kind of r.kinds) {
         if (rendererRegistry[kind])
-            throw new Error(`[render] kind '${kind}' уже зареєстровано`);
+            throw new Error(`[render] kind '${kind}' already registered`);
         rendererRegistry[kind] = stored;
     }
 }
-/** Резолв суворо по kind. undefined → kind без рендерера. */
 export function resolveRenderer(field) {
     return rendererRegistry[field.kind];
 }
-/** Повертає рядковий ідентифікатор виду layout-елемента. */
 export function elementKind(el) {
     if (isField(el))
         return el.type.kind;
     if (isStatic(el))
         return el.type.kind;
     if (isGroup(el))
-        return isCollectionGroup(el) ? 'collection' : isEmbeddedGroup(el) ? 'embedded' : 'group';
+        return el.kind ?? (isCollectionGroup(el) ? 'collection' : isEmbeddedGroup(el) ? 'embedded' : 'group');
     if (isButton(el))
         return 'button';
     if (isDivider(el))
         return 'divider';
     if (isInfo(el))
         return 'info';
-    throw new Error('[render] невідомий layout-елемент');
+    throw new Error('[render] unknown layout element');
 }
-/** Ширина поля в layout-сітці: апетит рендерера; дефолт scalar. */
 export function fieldLayout(field) {
-    return resolveRenderer(field)?.layout ?? 'scalar';
+    const layout = resolveRenderer(field)?.layout;
+    if (typeof layout === 'function')
+        return layout(field);
+    return layout ?? 'scalar';
+}
+export const multiBlock = (field) => field.hints['multi'] === true || field.hints['multiple'] === true ? 'block' : 'scalar';
+const templateRegistry = {};
+export function registerTemplate(name, importer) {
+    if (templateRegistry[name])
+        throw new Error(`[template] '${name}' already registered`);
+    templateRegistry[name] = importer;
+}
+export function resolveTemplate(name) {
+    return templateRegistry[name];
 }
-//# sourceMappingURL=registry.js.map

package/dist/types.d.ts

@@ -1,17 +1,13 @@
-/**
- * Контракт рендера типу поля. Один FieldRenderer описує, як тип поля
- *   1. малюється повним на СТОРІНЦІ запису (Page — self-contained: label/box/error/кнопки),
- *   2. стискається у клітинку таблиці (Inline — компонента, height-aware).
- *
- * Рендери (core та плагінні) реєструються в один rendererRegistry під ключем
- * `kind`. Резолв — суворо по `kind`, без fallback на `prim`.
- *
- * `Page` сам розрулює multiple через `field.hints.multiple` (helper або firstOf).
- */
 import type { FC, ReactNode } from 'react';
 import type { FieldMeta, LayoutEl, OptionItem } from '@coffer-org/sdk/fields';
-/** i18n-функція (сумісна з react-i18next `t`). */
 export type TFn = (key: string, opts?: Record<string, unknown>) => string;
+export type TemplateProps<D = unknown> = {
+    data: D;
+    t: TFn;
+};
+export type TemplateImporter<D = any> = () => Promise<{
+    default: import('react').FC<TemplateProps<D>>;
+}>;
 export type FieldMode = 'view' | 'edit' | 'create';
 export interface RecordCtx {
     vault: string;
@@ -19,8 +15,6 @@ export interface RecordCtx {
     recordId: string | null;
 }
 export interface ElementRenderProps {
-    /** Сирий layout-елемент. Опційний: старі FieldSlot-калери ще не передають;
-     *  компонувальник завжди передає (element-рендерери покладаються через el!). */
     el?: LayoutEl;
     field?: FieldMeta;
     value: unknown;
@@ -38,24 +32,27 @@ export interface ElementRenderProps {
 export interface FieldRenderProps extends ElementRenderProps {
     field: FieldMeta;
 }
-/** Props компактного рендера клітинки (таблиця/картка). */
 export interface FieldInlineProps {
     field: FieldMeta;
     value: unknown;
-    /** Висота (px), у яку вписатись; вирівнювання завжди по центру. Корисно для картинок. */
     height?: number;
 }
 export type BoxGeom = 'inline' | 'textarea' | 'title' | 'none';
+export interface FieldKey {
+    value: string;
+    rawValue: unknown;
+    label: string;
+    sort?: string;
+}
+export interface FieldKeyCtx {
+    t: TFn;
+    labelMap?: Map<string, string>;
+}
 export interface FieldRenderer {
-    /** Які kind обслуговує цей елемент. 1:1 з рендерером. */
     kinds: string[];
-    /** Просторовий апетит у layout-сітці. default 'scalar' (клітинка ~1/3).
-     *  'block' = на всю ширину сторінки/форми. */
-    layout?: 'block' | 'scalar';
-    /** Повне поле на СТОРІНЦІ запису: label + Pencil/✓/✕ + box + помилка + required. */
+    layout?: 'block' | 'scalar' | ((field: FieldMeta) => 'block' | 'scalar');
+    box?: BoxGeom;
     Page: FC<ElementRenderProps>;
-    /** Компактний рендер клітинки — КОМПОНЕНТА (не рядок), height-aware, центр по
-     *  вертикалі, вміє картинки. Реюзабельна в інших рендерерах. */
     Inline?: FC<FieldInlineProps>;
+    keys?: (value: unknown, field: FieldMeta, ctx: FieldKeyCtx) => FieldKey[];
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@coffer-org/web-sdk",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
   "files": [
     "dist"
   ],
@@ -21,7 +24,7 @@
     "postpack": "node ../../scripts/swap-exports.mjs src"
   },
   "dependencies": {
-    "@coffer-org/sdk": "^1.1.0"
+    "@coffer-org/sdk": "^1.2.0"
   },
   "peerDependencies": {
     "react": ">=19",

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/module-ui.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"module-ui.d.ts","sourceRoot":"","sources":["../src/module-ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,UAAU,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC;IACjC;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7E;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,QAAQ,CAAC,GAC3C,cAAc,CAEhB"}

package/dist/module-ui.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"module-ui.js","sourceRoot":"","sources":["../src/module-ui.ts"],"names":[],"mappings":"AAoCA,gEAAgE;AAChE,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,MAAc,EACd,EAA4C;IAE5C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;AAClC,CAAC"}

package/dist/registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAW/E,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAEhC,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAM,CAAC;AAElE,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,EAAE,CAAC,EAAE;IAChE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACZ,MAAM,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC;CAC/B,GAAG,IAAI,CAYP;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,aAAa,GAAG,SAAS,CAE3F;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAQhD;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAEhE"}

package/dist/registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,OAAO,EACP,iBAAiB,EACjB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,CAAC,MAAM,gBAAgB,GAAkC,EAAE,CAAC;AAElE,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAA+B,CAK9D;IACC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACpE,MAAM,MAAM,GAAkB;QAC5B,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,IAAI,EAAE,CAAC,CAAC,IAAyC;QACjD,MAAM,EAAE,CAAC,CAAC,MAAM;KACjB,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,gBAAgB,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,qBAAqB,CAAC,CAAC;QACzF,gBAAgB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IAClC,CAAC;AACH,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,eAAe,CAAC,KAAgC;IAC9D,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,EAAY;IACtC,IAAI,OAAO,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;IACrC,IAAI,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;IACtC,IAAI,OAAO,CAAC,EAAE,CAAC;QAAE,OAAO,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1G,IAAI,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClC,IAAI,SAAS,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IACpC,IAAI,MAAM,CAAC,EAAE,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACvD,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,WAAW,CAAC,KAAgB;IAC1C,OAAO,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,QAAQ,CAAC;AACpD,CAAC"}

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE9E,kDAAkD;AAClD,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;AAE1E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC;oFACgF;IAChF,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;kDAC8C;IAC9C,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,oFAAoF;IACpF,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC7B;oEACgE;IAChE,MAAM,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC;CAC/B"}

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}