@coffer-org/sdk 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -1,16 +1,14 @@
-/** @coffer-org/sdk — ізоморфний контракт плагінів (типи + фабрики + довідкові дані). */
-export * from './field-helpers.js';
-export * from './fields.js';
-export * from './field-presets.js';
-export * from './module.js';
-export * from './vault.js';
-export * from './extend.js';
-export * from './package.js';
-export * from './plugin.js';
-export * from './condition.js';
-export * from './countries.js';
-export * from './color-names.js';
-export * from './units.js';
-export * from './currencies.js';
-export * from './settings.js';
-//# sourceMappingURL=index.d.ts.map
+export * from './field-helpers.ts';
+export * from './fields.ts';
+export * from './field-presets.ts';
+export * from './module.ts';
+export * from './vault.ts';
+export * from './extend.ts';
+export * from './package.ts';
+export * from './plugin.ts';
+export * from './condition.ts';
+export * from './countries.ts';
+export * from './color-names.ts';
+export * from './units.ts';
+export * from './currencies.ts';
+export * from './settings.ts';

package/dist/index.js

@@ -1,16 +1,14 @@
-/** @coffer-org/sdk — ізоморфний контракт плагінів (типи + фабрики + довідкові дані). */
-export * from './field-helpers.js';
-export * from './fields.js';
-export * from './field-presets.js';
-export * from './module.js';
-export * from './vault.js';
-export * from './extend.js';
-export * from './package.js';
-export * from './plugin.js';
-export * from './condition.js';
-export * from './countries.js';
-export * from './color-names.js';
-export * from './units.js';
-export * from './currencies.js';
-export * from './settings.js';
-//# sourceMappingURL=index.js.map
+export * from "./field-helpers.js";
+export * from "./fields.js";
+export * from "./field-presets.js";
+export * from "./module.js";
+export * from "./vault.js";
+export * from "./extend.js";
+export * from "./package.js";
+export * from "./plugin.js";
+export * from "./condition.js";
+export * from "./countries.js";
+export * from "./color-names.js";
+export * from "./units.js";
+export * from "./currencies.js";
+export * from "./settings.js";

package/dist/module.d.ts

@@ -1,48 +1,12 @@
 import { z } from 'zod';
-import type { FieldMeta, LayoutEl } from './fields.js';
-import type { FieldClient, GroupEl, PseudoEl } from './fields.js';
-/**
- * Ієрархія: vault → module → type (в контенті)
- *
- * - vault:  namespace проекту             ('things', 'health')
- * - module: ідентифікатор схеми + таблиці ('item', 'vitamin')    ← це поле
- * - type:   класифікація запису в контенті ('device', 'drone')   ← поле в сутності
- */
-/**
- * Три контексти відображення запису. Кожен модуль може оголосити, які поля
- * показувати в кожному з них:
- *
- *   1. inline — компактне представлення ОДНОГО запису в маленькому місці:
- *      привязка людини (ім'я + прізвище), чип, елемент списку зв'язків.
- *      Може містити image/images-поле → показується як аватар + текст.
- *      Default: ['name'].
- *
- *   2. table  — колонки таблиці-списку, де не влазять усі поля.
- *      Default: явний views.table (без евристики).
- *
- *   3. full   — усі поля (неявно). Сторінка запису показує все.
- */
+import type { FieldMeta, LayoutEl, ColumnType } from './fields.ts';
+import type { FieldClient, GroupEl, PseudoEl } from './fields.ts';
 export interface ModuleViews {
-    /** Явний ключ поля-заголовка запису. Якщо не заданий — резолвиться (див. titleKey). */
     title?: string;
-    /** Компактне представлення одного запису. Напр. ['logo','name','surname']. */
     inline?: string[];
-    /** Колонки таблиці-списку. Напр. ['name','price','inStock']. */
     table?: string[];
-    /**
-     * Поля-кандидати для групувальної панелі списку (override авто-евристики).
-     * Список і порядок використовуються як є. Напр. ['type','brand'].
-     */
     groupBy?: string[];
-    /** Поле групування, обране у панелі за замовчуванням. Напр. 'type'. */
     defaultGroupBy?: string;
-    /**
-     * Рендер запису як опції select (record-джерело). Трійка:
-     *   icon     — ключ поля-іконки (image→avatar, select-зі-swatch→колір, інакше icon)
-     *   title    — ключ або масив ключів; рендериться Inline-логікою
-     *   subtitle — ключ поля-технічного значення
-     * Відсутній → fallback: title = inline-ключі, icon = inline-image, без subtitle.
-     */
     select?: {
         icon?: string;
         title: string | string[];
@@ -55,102 +19,49 @@ export interface ModuleDef {
     label: string;
     icon?: string;
     claude?: string;
-    /**
-     * Якщо false — модуль не відображається в навігації.
-     * Використовується для sub-модулів (рейси, проживання тощо),
-     * які існують тільки як зв'язані записи батьківського модуля.
-     * За замовчуванням: true.
-     */
     standalone?: boolean;
-    /** Набори полів для трьох контекстів відображення (inline / table / full). */
     views?: ModuleViews;
     fields: LayoutEl[];
 }
-/** Плоскі пари [storageKey, FieldMeta] колонок батьківської таблиці.
- *  layout-група → плоско; embedded-група → префікс `key__`; collection → пропуск. */
 export declare function fieldEntries(items: LayoutEl[]): [string, FieldMeta][];
+export declare function storageColumns(key: string, field: FieldMeta): [string, ColumnType][];
 export interface CollectionEntry {
-    /** Storage-ключ collection-групи (ім'я під child-таблицю). */
     key: string;
     group: GroupEl;
 }
-/** Усі collection-групи (рекурсивно крізь layout та embedded). Top-level зверху. */
 export declare function collectionGroups(items: LayoutEl[]): CollectionEntry[];
-/** Мапа key → FieldMeta (кеш по масиву). */
 export declare function fieldMap(items: LayoutEl[]): Record<string, FieldMeta>;
 export declare function defineModule(m: ModuleDef): ModuleDef;
 export declare const SYSTEM_FIELDS: readonly ["id", "createdAt", "updatedAt"];
-/**
- * Контракт реальної сутності:
- *   id — uuid (ЄДИНЕ обов'язкове системне поле, авто).
- * Решта (включно з name) — звичайні поля у ModuleDef.fields.
- * created_at/updated_at — системна інфраструктура (поза fields, авто-керована).
- */
-/**
- * Ключ поля-заголовка запису (таблиці, пікери зв'язків, інлайни, заголовок форми).
- * Пріоритет: views.title → перший не-image inline → 'name' (якщо є) →
- * перше текстове поле → 'id'.
- */
 export declare function titleKey(m: ModuleDef): string;
-/** Заголовок запису (значення поля titleKey, fallback id). */
 export declare function recordTitle(m: ModuleDef, record: Record<string, unknown>): string;
 export declare const isImageKind: (kind: string) => boolean;
-/** Ключі текстових колонок модуля (придатних для LIKE-пошуку). Виключає virtual, image, relation. */
 export declare function textSearchKeys(m: ModuleDef): string[];
-/**
- * Поля для компактного представлення одного запису (привязка / чип / елемент списку).
- * Пріоритет: views.inline → [titleKey(m)].
- */
 export declare function inlineKeys(m: ModuleDef): string[];
-/** Перше image-поле серед inline-полів (аватар у компактному представленні). */
 export declare function inlineImageKey(m: ModuleDef): string | undefined;
-/** Текстова частина компактного представлення (без зображень), напр. "Іван Петренко". */
 export declare function inlineText(m: ModuleDef, row: Record<string, unknown>): string;
-/**
- * Колонки для таблиці-списку.
- * Єдине джерело: views.table. Без евристик і showInTable.
- */
 export declare function tableKeys(m: ModuleDef): string[];
-/**
- * Поля-кандидати для групувальної панелі списку.
- * Пріоритет: views.groupBy (список і порядок як є, лише реальні не-virtual поля).
- * Інакше евристика: select | checkbox | relation + текстові поля. Текстові з
- * завеликою кардинальністю відсіює клієнт за фактичними даними (core про дані
- * не знає).
- */
 export declare function groupableFields(m: ModuleDef): string[];
-/**
- * Поле групування за замовчуванням (обране у панелі при відкритті).
- * Пріоритет: views.defaultGroupBy (якщо реальне) → перший із groupableFields.
- */
 export declare function defaultGroupField(m: ModuleDef): string | undefined;
-/**
- * Спільна побудова zod-shape з layout-полів (virtual пропускаються).
- * partial=true → кожне поле опціональне (для PATCH-семантики оновлення).
- *
- * Примітка: для optional-полів zod уже опціоналізований (optionalize),
- * для required та boolean (default) `.optional()` обов'язковий у partial-режимі;
- * повторний `.optional()` на вже-опціональній схемі — ідемпотентний no-op,
- * тому застосовуємо його до всіх полів у partial-режимі (поведінка незмінна).
- */
-/** zod-shape запису: скаляри/layout плоско; embedded → nested object; collection → array. */
 export declare function buildShape(fields: LayoutEl[], partial: boolean): z.ZodRawShape;
-export declare function buildZodObject(m: ModuleDef): z.ZodObject<z.ZodRawShape>;
-export declare function buildZodObjectPartial(m: ModuleDef): z.ZodObject<z.ZodRawShape>;
+export declare function buildZodObject(m: ModuleDef): z.ZodTypeAny;
+export declare function buildZodObjectPartial(m: ModuleDef): z.ZodTypeAny;
 export interface StaticElClient {
     el: 'static';
     type: FieldClient;
     value: unknown;
+    computed?: boolean;
 }
-export type LayoutElClient = {
-    key: string;
-    type: FieldClient;
-} | (Omit<GroupEl, 'fields'> & {
+export type GroupElClient = Omit<GroupEl, 'fields'> & {
     fields: ({
         key: string;
         type: FieldClient;
-    } | StaticElClient | PseudoEl)[];
-}) | StaticElClient | PseudoEl;
+    } | StaticElClient | GroupElClient | PseudoEl)[];
+};
+export type LayoutElClient = {
+    key: string;
+    type: FieldClient;
+} | GroupElClient | StaticElClient | PseudoEl;
 export declare function layoutToClient(items: LayoutEl[]): LayoutElClient[];
 export declare function moduleToClient(m: ModuleDef): {
     module: string;
@@ -161,4 +72,3 @@ export declare function moduleToClient(m: ModuleDef): {
     standalone: boolean | undefined;
     fields: LayoutElClient[];
 };
-//# sourceMappingURL=module.d.ts.map

package/dist/module.js

@@ -1,8 +1,7 @@
 import { z } from 'zod';
-import { toClient, isField, isGroup, isStatic, isCollectionGroup, isEmbeddedGroup } from './fields.js';
-// ─── Helpers доступу до полів ────────────────────────────────────────────────
-/** Плоскі пари [storageKey, FieldMeta] колонок батьківської таблиці.
- *  layout-група → плоско; embedded-група → префікс `key__`; collection → пропуск. */
+import { toClient, isField, isGroup, isStatic, isCollectionGroup, isEmbeddedGroup } from "./fields.js";
+import { resolveFlag } from "./condition.js";
+import { parseUrl } from "./fields/url.js";
 export function fieldEntries(items) {
     const out = [];
     for (const it of items) {
@@ -11,7 +10,7 @@ export function fieldEntries(items) {
         }
         else if (isGroup(it)) {
             if (isCollectionGroup(it))
-                continue; // живе в child-таблиці
+                continue;
             const prefix = it.key ? `${it.key}__` : '';
             for (const [sub, fm] of fieldEntries(it.fields)) {
                 out.push([prefix + sub, fm]);
@@ -20,7 +19,11 @@ export function fieldEntries(items) {
     }
     return out;
 }
-/** Усі collection-групи (рекурсивно крізь layout та embedded). Top-level зверху. */
+export function storageColumns(key, field) {
+    if (field.columns)
+        return Object.entries(field.columns).map(([sub, col]) => [`${key}__${sub}`, col]);
+    return [[key, field.column]];
+}
 export function collectionGroups(items) {
     const out = [];
     for (const it of items) {
@@ -30,14 +33,12 @@ export function collectionGroups(items) {
             out.push({ key: it.key, group: it });
         }
         else {
-            // layout або embedded — спускаємось глибше шукати collection
             out.push(...collectionGroups(it.fields));
         }
     }
     return out;
 }
 const mapCache = new WeakMap();
-/** Мапа key → FieldMeta (кеш по масиву). */
 export function fieldMap(items) {
     let m = mapCache.get(items);
     if (!m) {
@@ -50,24 +51,12 @@ export function defineModule(m) {
     const keys = fieldEntries(m.fields).map(([k]) => k);
     const dup = keys.find((k, i) => keys.indexOf(k) !== i);
     if (dup)
-        throw new Error(`[module] ${m.vault}/${m.module}: дубльований key '${dup}'`);
-    // name — звичайне поле (оголошується у fields де треба); системне лише id.
+        throw new Error(`[module] ${m.vault}/${m.module}: duplicate key '${dup}'`);
     if (m.standalone !== false && !m.views?.table?.length)
-        console.warn(`[module] ${m.vault}/${m.module}: standalone-модуль без явного views.table`);
+        console.warn(`[module] ${m.vault}/${m.module}: standalone module without an explicit views.table`);
     return m;
 }
 export const SYSTEM_FIELDS = ['id', 'createdAt', 'updatedAt'];
-/**
- * Контракт реальної сутності:
- *   id — uuid (ЄДИНЕ обов'язкове системне поле, авто).
- * Решта (включно з name) — звичайні поля у ModuleDef.fields.
- * created_at/updated_at — системна інфраструктура (поза fields, авто-керована).
- */
-/**
- * Ключ поля-заголовка запису (таблиці, пікери зв'язків, інлайни, заголовок форми).
- * Пріоритет: views.title → перший не-image inline → 'name' (якщо є) →
- * перше текстове поле → 'id'.
- */
 export function titleKey(m) {
     if (m.views?.title)
         return m.views.title;
@@ -82,40 +71,31 @@ export function titleKey(m) {
         return firstText[0];
     return 'id';
 }
-/** Заголовок запису (значення поля titleKey, fallback id). */
 export function recordTitle(m, record) {
     return String(record[titleKey(m)] ?? record['id'] ?? '');
 }
-/** Поля, які існують і не віртуальні (фільтр для view-наборів, заданих вручну). */
 function realKeys(m, keys) {
     const fm = fieldMap(m.fields);
     return keys.filter((k) => fm[k] && !fm[k].virtual);
 }
-const IMAGE_KINDS = new Set(['image', 'media']);
+const IMAGE_KINDS = new Set(['image', 'media', 'avatar', 'cover']);
 export const isImageKind = (kind) => IMAGE_KINDS.has(kind);
 const isTextPrim = (p) => p === 'string' || p === 'text';
-/** Ключі текстових колонок модуля (придатних для LIKE-пошуку). Виключає virtual, image, relation. */
 export function textSearchKeys(m) {
     return fieldEntries(m.fields)
-        .filter(([, f]) => !f.virtual && isTextPrim(f.prim))
+        .filter(([, f]) => !f.virtual && f.kind !== 'password' && isTextPrim(f.prim))
         .map(([k]) => k);
 }
-/**
- * Поля для компактного представлення одного запису (привязка / чип / елемент списку).
- * Пріоритет: views.inline → [titleKey(m)].
- */
 export function inlineKeys(m) {
     const ks = m.views?.inline?.length ? realKeys(m, m.views.inline) : [];
     if (ks.length)
         return ks;
     return [titleKey(m)];
 }
-/** Перше image-поле серед inline-полів (аватар у компактному представленні). */
 export function inlineImageKey(m) {
     const fm = fieldMap(m.fields);
     return inlineKeys(m).find((k) => fm[k] && isImageKind(fm[k].kind));
 }
-/** Текстова частина компактного представлення (без зображень), напр. "Іван Петренко". */
 export function inlineText(m, row) {
     const fm = fieldMap(m.fields);
     const parts = inlineKeys(m).reduce((acc, k) => {
@@ -128,39 +108,21 @@ export function inlineText(m, row) {
     }, []);
     return parts.join(' ').trim() || recordTitle(m, row);
 }
-/**
- * Колонки для таблиці-списку.
- * Єдине джерело: views.table. Без евристик і showInTable.
- */
 export function tableKeys(m) {
-    // Заголовок (titleKey) — завжди перша колонка; решта з views.table (без дублю).
     const tk = titleKey(m);
     const rest = m.views?.table?.length
         ? realKeys(m, m.views.table.filter((k) => k !== tk))
         : [];
     return [tk, ...rest];
 }
-// ─── Групування у панелі списку ──────────────────────────────────────────────
-/** Примітиви, придатні для групування «з коробки» (категоріальні за типом). */
 const GROUPABLE_PRIMS = new Set(['select', 'checkbox', 'relation']);
-/**
- * Поля-кандидати для групувальної панелі списку.
- * Пріоритет: views.groupBy (список і порядок як є, лише реальні не-virtual поля).
- * Інакше евристика: select | checkbox | relation + текстові поля. Текстові з
- * завеликою кардинальністю відсіює клієнт за фактичними даними (core про дані
- * не знає).
- */
 export function groupableFields(m) {
     if (m.views?.groupBy?.length)
         return realKeys(m, m.views.groupBy);
     return fieldEntries(m.fields)
-        .filter(([, f]) => !f.virtual && (GROUPABLE_PRIMS.has(f.prim) || isTextPrim(f.prim)))
+        .filter(([, f]) => !f.virtual && GROUPABLE_PRIMS.has(f.prim))
         .map(([k]) => k);
 }
-/**
- * Поле групування за замовчуванням (обране у панелі при відкритті).
- * Пріоритет: views.defaultGroupBy (якщо реальне) → перший із groupableFields.
- */
 export function defaultGroupField(m) {
     const dg = m.views?.defaultGroupBy;
     if (dg) {
@@ -170,16 +132,6 @@ export function defaultGroupField(m) {
     }
     return groupableFields(m)[0];
 }
-/**
- * Спільна побудова zod-shape з layout-полів (virtual пропускаються).
- * partial=true → кожне поле опціональне (для PATCH-семантики оновлення).
- *
- * Примітка: для optional-полів zod уже опціоналізований (optionalize),
- * для required та boolean (default) `.optional()` обов'язковий у partial-режимі;
- * повторний `.optional()` на вже-опціональній схемі — ідемпотентний no-op,
- * тому застосовуємо його до всіх полів у partial-режимі (поведінка незмінна).
- */
-/** zod-shape запису: скаляри/layout плоско; embedded → nested object; collection → array. */
 export function buildShape(fields, partial) {
     const shape = {};
     for (const it of fields) {
@@ -195,40 +147,57 @@ export function buildShape(fields, partial) {
                 shape[it.key] = partial ? arr.optional() : it.required ? arr : arr.optional();
             }
             else if (isEmbeddedGroup(it)) {
-                const inner = z.object(buildShape(it.fields, partial)).passthrough();
+                let inner = z.object(buildShape(it.fields, partial)).passthrough();
+                if (it.kind === 'url') {
+                    inner = z.preprocess((v) => (typeof v === 'string' ? (parseUrl(v) ?? {}) : v), inner);
+                }
                 shape[it.key] = partial ? inner.optional() : it.required ? inner : inner.optional();
             }
             else {
-                // layout group — діти плоско в той самий shape
                 Object.assign(shape, buildShape(it.fields, partial));
             }
         }
     }
     return shape;
 }
+const isEmpty = (v) => v == null || v === '' || (Array.isArray(v) && v.length === 0);
+function withConditionalRequired(base, m, partial) {
+    return base.superRefine((data, ctx) => {
+        for (const [key, f] of fieldEntries(m.fields)) {
+            if (f.virtual)
+                continue;
+            if (key.includes('__'))
+                continue;
+            if (partial && !(key in data))
+                continue;
+            if (f.required === true)
+                continue;
+            if (!resolveFlag(f.required, data))
+                continue;
+            if (isEmpty(data[key]))
+                ctx.addIssue({ code: 'custom', path: [key], message: JSON.stringify({ code: 'required' }) });
+        }
+    });
+}
 export function buildZodObject(m) {
-    return z.object(buildShape(m.fields, false));
+    return withConditionalRequired(z.object(buildShape(m.fields, false)), m, false);
 }
 export function buildZodObjectPartial(m) {
-    return z.object(buildShape(m.fields, true));
+    return withConditionalRequired(z.object(buildShape(m.fields, true)), m, true);
+}
+function elToClient(it) {
+    if (isField(it))
+        return { key: it.key, type: toClient(it.type) };
+    if (isStatic(it)) {
+        const fn = typeof it.value === 'function';
+        return { el: 'static', type: toClient(it.type), value: fn ? null : it.value, computed: fn || undefined };
+    }
+    if (isGroup(it))
+        return { ...it, fields: it.fields.map(elToClient) };
+    return it;
 }
 export function layoutToClient(items) {
-    return items.map((it) => {
-        if (isField(it))
-            return { key: it.key, type: toClient(it.type) };
-        if (isStatic(it))
-            return { el: 'static', type: toClient(it.type), value: it.value };
-        if (isGroup(it))
-            return {
-                ...it,
-                fields: it.fields.map((s) => isField(s)
-                    ? { key: s.key, type: toClient(s.type) }
-                    : isStatic(s)
-                        ? { el: 'static', type: toClient(s.type), value: s.value }
-                        : s),
-            };
-        return it;
-    });
+    return items.map(elToClient);
 }
 export function moduleToClient(m) {
     return {
@@ -241,4 +210,3 @@ export function moduleToClient(m) {
         fields: layoutToClient(m.fields),
     };
 }
-//# sourceMappingURL=module.js.map

package/dist/package.d.ts

@@ -1,30 +1,13 @@
-/**
- * Контракт пакету модулів.
- *
- * Кожен модуль-пакет (src/modules/<name>/index.ts) повинен виконувати default export
- * типу ModulePackage. Реєстр збирає всі пакети через assemblePackages.
- *
- * Три точки розширення:
- *   vaults       — нові vault'и, що визначаються цим пакетом
- *   vaultModules — ModuleDef'и, що ін'єктуються в vault'и інших пакетів
- *   extends_     — нові extends
- */
-import type { VaultBundle } from './vault.js';
-import type { ModuleDef } from './module.js';
-import type { ExtendDef } from './extend.js';
+import type { VaultBundle } from './vault.ts';
+import type { ModuleDef } from './module.ts';
+import type { ExtendDef } from './extend.ts';
 export interface ModulePackage {
     vaults?: VaultBundle[];
     vaultModules?: ModuleDef[];
     extends_?: ExtendDef[];
 }
-/**
- * Збирає пакети в єдиний реєстр.
- * Порядок масиву важливий: vaultModules ін'єктуються тільки в vault'и,
- * що вже оголошені в packages (попередніх або поточному).
- */
 export declare function assemblePackages(packages: ModulePackage[]): {
     vaults: VaultBundle[];
     modules: ModuleDef[];
     extends_: ExtendDef[];
 };
-//# sourceMappingURL=package.d.ts.map

package/dist/package.js

@@ -1,31 +1,26 @@
-/**
- * Збирає пакети в єдиний реєстр.
- * Порядок масиву важливий: vaultModules ін'єктуються тільки в vault'и,
- * що вже оголошені в packages (попередніх або поточному).
- */
+import { fallbackVault } from "./vault.js";
 export function assemblePackages(packages) {
-    // Збираємо власні vault'и в Map (копія, щоб не мутувати оригінал)
-    const vaultMap = new Map();
+    const metaMap = new Map();
     for (const pkg of packages) {
         for (const bundle of pkg.vaults ?? []) {
-            vaultMap.set(bundle.meta.id, { ...bundle, modules: [...bundle.modules] });
+            if (!metaMap.has(bundle.meta.id))
+                metaMap.set(bundle.meta.id, { ...bundle.meta });
         }
     }
-    // Ін'єкція vaultModules в існуючі vault'и
+    const modules = [];
     for (const pkg of packages) {
-        for (const mod of pkg.vaultModules ?? []) {
-            const bundle = vaultMap.get(mod.vault);
-            if (bundle) {
-                bundle.modules.push(mod);
-            }
-            // Якщо vault не знайдено — пакет-залежність не підключено, ігноруємо
-        }
+        for (const bundle of pkg.vaults ?? [])
+            modules.push(...bundle.modules);
+        modules.push(...(pkg.vaultModules ?? []));
     }
-    const vaults = [...vaultMap.values()];
+    const ids = new Set([...metaMap.keys(), ...modules.map((m) => m.vault)]);
+    const vaults = [...ids].map((id) => ({
+        meta: metaMap.get(id) ?? fallbackVault(id),
+        modules: modules.filter((m) => m.vault === id),
+    }));
     return {
         vaults,
-        modules: vaults.flatMap((v) => v.modules),
+        modules,
         extends_: packages.flatMap((pkg) => pkg.extends_ ?? []),
     };
 }
-//# sourceMappingURL=package.js.map

package/dist/plugin.d.ts

@@ -1,77 +1,37 @@
-/**
- * Плагінна модель. Кожен домен — самодостатній плагін зі своїм внеском у схему,
- * власними міграціями/сидами та залежностями від інших плагінів.
- *
- * Цей файл — ІЗОМОРФНА частина (і сервер, і клієнт): лише декларативний маніфест
- * (id / version / dependsOn + внески vaults/modules/extends). Серверні хуки
- * життєвого циклу (міграції/seed/init/teardown) живуть окремо у server-only шарі
- * (див. src/server/plugin-runtime.ts), щоб не тягнути ORM/node у чисте ядро.
- */
-import type { VaultBundle } from './vault.js';
-import type { ModuleDef } from './module.js';
-import type { ExtendDef } from './extend.js';
-import type { OptionItem } from './fields.js';
-import type { SettingsDef } from './settings.js';
-/**
- * Внесок плагіна до колекцій поля іншого модуля (по vault/module/field).
- * Вливається у саме поле при compose → form/display/table/zod бачать єдине джерело.
- *   - options:     для prim:'select'
- *   - suggestions: для tags (string + suggestions)
- */
+import type { VaultBundle } from './vault.ts';
+import type { ModuleDef } from './module.ts';
+import type { ExtendDef } from './extend.ts';
+import type { OptionItem } from './fields.ts';
+import type { SettingsDef } from './settings.ts';
 export interface FieldContrib {
     vault: string;
     module: string;
-    /** key поля у цільовому модулі. */
     field: string;
     options?: OptionItem[];
     suggestions?: string[];
 }
-/**
- * Іменований список опцій — глобальна бібліотека варіантів.
- * Плагіни реєструють списки (countries, colors, …).
- * Поле field.select({ source: 'countries' }) отримує опції звідси, а не inline.
- */
 export interface NamedOptionList {
     name: string;
     options: OptionItem[];
 }
 export interface PluginManifest {
-    /** Машинний id плагіна (= namespace журналу міграцій). */
     id: string;
-    /** Semver плагіна (для журналу/діагностики). */
     version: string;
-    /** Id плагінів, від яких залежить цей (мають бути зареєстровані раніше). */
     dependsOn: string[];
     vaults?: VaultBundle[];
     vaultModules?: ModuleDef[];
     extends_?: ExtendDef[];
-    /** Внески до select/type-опцій полів інших модулів. */
     fieldContribs?: FieldContrib[];
-    /** Глобальні іменовані списки опцій (countries, colors, …). */
     optionLists?: NamedOptionList[];
-    /** Налаштування плагіна — зберігаються як singleton-запис у _settings__<id>. */
     settings?: SettingsDef;
 }
-/** Базовий плагін: неявна залежність КОЖНОГО іншого плагіна (не вказується у dependsOn). */
 export declare const BASE_PLUGIN = "core";
 export declare function definePlugin(p: PluginManifest): PluginManifest;
-/**
- * Топологічне сортування плагінів за dependsOn.
- * Залежність від core мається на увазі за замовчуванням — її не треба вказувати
- * у dependsOn, але core завжди сортується першим.
- * Кидає помилку на відсутню залежність або цикл.
- */
 export declare function topoSortPlugins(plugins: PluginManifest[]): PluginManifest[];
 export interface AssembledPlugins {
-    /** Плагіни в топологічному порядку (для міграцій/seed/init). */
     order: PluginManifest[];
     vaults: VaultBundle[];
     modules: ModuleDef[];
     extends_: ExtendDef[];
 }
-/**
- * Збирає плагіни в єдиний реєстр у залежнісному порядку.
- * Порядок більше не залежить від ручного впорядкування масиву — лише від dependsOn.
- */
 export declare function assemblePlugins(plugins: PluginManifest[]): AssembledPlugins;
-//# sourceMappingURL=plugin.d.ts.map