letopis 1.4.2 → 2.0.0

package/dist/demo/booking.d.ts

@@ -14,13 +14,19 @@ export declare const Org: import("../model.js").Model<"Org", {
             } | undefined;
         } | undefined;
     } | undefined;
-}, {} & {}, "Организация">;
+}, {} & {}, "Организация", {}, "Org">;
 export declare const Person: import("../model.js").Model<"Person", {
     name: string;
     phone: string;
 }, {
     readonly Org: string;
-} & {}, "Контрагент">;
+} & {}, "Контрагент", {
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, "Person">;
 export declare const Staff: import("../model.js").Model<"Staff", Omit<{
     name: string;
     phone: string;
@@ -30,7 +36,13 @@ export declare const Staff: import("../model.js").Model<"Staff", Omit<{
     specialization?: string | undefined;
 }, Omit<{
     readonly Org: string;
-} & {}, never> & {} & {}, "Мастер">;
+} & {}, never> & {} & {}, "Мастер", Omit<{
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, never> & {}, "Person" | "Staff">;
 export declare const Customer: import("../model.js").Model<"Customer", Omit<{
     name: string;
     phone: string;
@@ -39,7 +51,13 @@ export declare const Customer: import("../model.js").Model<"Customer", Omit<{
     notes?: string | undefined;
 }, Omit<{
     readonly Org: string;
-} & {}, never> & {} & {}, "Клиент">;
+} & {}, never> & {} & {}, "Клиент", Omit<{
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, never> & {}, "Person" | "Customer">;
 export declare const Location: import("../model.js").Model<"Location", {
     address: string;
     coordinates?: {
@@ -49,13 +67,25 @@ export declare const Location: import("../model.js").Model<"Location", {
     description?: string | undefined;
 }, {
     readonly Org: string;
-} & {}, "Локация">;
+} & {}, "Локация", {
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, "Location">;
 export declare const Element: import("../model.js").Model<"Element", {
     name: string;
     description?: string | undefined;
 }, {
     readonly Org: string;
-} & {}, "Элемент">;
+} & {}, "Элемент", {
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, "Element">;
 export declare const Service: import("../model.js").Model<"Service", Omit<{
     name: string;
     description?: string | undefined;
@@ -63,7 +93,13 @@ export declare const Service: import("../model.js").Model<"Service", Omit<{
     duration?: number | undefined;
 }, Omit<{
     readonly Org: string;
-} & {}, never> & {} & {}, "Услуга">;
+} & {}, never> & {} & {}, "Услуга", Omit<{
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, never> & {}, "Service" | "Element">;
 export declare const Product: import("../model.js").Model<"Product", Omit<{
     name: string;
     description?: string | undefined;
@@ -72,7 +108,13 @@ export declare const Product: import("../model.js").Model<"Product", Omit<{
     sku?: string | undefined;
 }, Omit<{
     readonly Org: string;
-} & {}, never> & {} & {}, "Товар">;
+} & {}, never> & {} & {}, "Товар", Omit<{
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, never> & {}, "Element" | "Product">;
 export declare const Complex: import("../model.js").Model<"Complex", Omit<{
     name: string;
     description?: string | undefined;
@@ -81,28 +123,62 @@ export declare const Complex: import("../model.js").Model<"Complex", Omit<{
     duration: number;
 }, Omit<{
     readonly Org: string;
-} & {}, never> & {} & {}, "Комплекс">;
+} & {}, never> & {} & {}, "Комплекс", Omit<{
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, never> & {}, "Element" | "Complex">;
 export declare const Schedule: import("../model.js").Model<"Schedule", {
     name: string;
     year: number;
     month: number;
 }, {
     readonly Org: string;
-} & {}, "Расписание">;
+} & {}, "Расписание", {
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, "Schedule">;
 export declare const Folder: import("../model.js").Model<"Folder", {
     name: string;
 }, {
     readonly Org: string;
 } & {
     readonly Parent?: string | undefined;
-}, "Папка">;
+}, "Папка", {
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+    readonly Parent: {
+        targets: "Folder";
+        many: false;
+        required: false;
+    };
+}, "Folder">;
 export declare const address: import("../model.js").Model<"address", {
     default: boolean;
     schedule_info?: string | undefined;
 }, {
     readonly Staff: string;
     readonly Location: string;
-} & {}, "адрес">;
+} & {}, "адрес", {
+    readonly Staff: {
+        targets: "Staff";
+        many: false;
+        required: true;
+    };
+    readonly Location: {
+        targets: "Location";
+        many: false;
+        required: true;
+    };
+}, "address">;
 export declare const slot: import("../model.js").Model<"slot", {
     start_datetime: string;
     end_datetime: string;
@@ -110,7 +186,23 @@ export declare const slot: import("../model.js").Model<"slot", {
     readonly Staff: string;
     readonly Location: string;
     readonly Schedule: string;
-} & {}, "окно">;
+} & {}, "окно", {
+    readonly Staff: {
+        targets: "Staff";
+        many: false;
+        required: true;
+    };
+    readonly Location: {
+        targets: "Location";
+        many: false;
+        required: true;
+    };
+    readonly Schedule: {
+        targets: "Schedule";
+        many: false;
+        required: true;
+    };
+}, "slot">;
 export declare const booking: import("../model.js").Model<"booking", Omit<{
     start_datetime: string;
     end_datetime: string;
@@ -124,32 +216,98 @@ export declare const booking: import("../model.js").Model<"booking", Omit<{
     readonly Item: string;
 } & {
     readonly Customer?: string | undefined;
-}, "запись">;
+}, "запись", Omit<{
+    readonly Staff: {
+        targets: "Staff";
+        many: false;
+        required: true;
+    };
+    readonly Location: {
+        targets: "Location";
+        many: false;
+        required: true;
+    };
+    readonly Schedule: {
+        targets: "Schedule";
+        many: false;
+        required: true;
+    };
+}, "Customer" | "Item"> & {
+    readonly Item: {
+        targets: "Element";
+        many: false;
+        required: true;
+    };
+    readonly Customer: {
+        targets: "Customer";
+        many: false;
+        required: false;
+    };
+}, "booking" | "slot">;
 export declare const content: import("../model.js").Model<"content", {
     order: number;
 }, {
     readonly Folder: string;
     readonly Item: string;
-} & {}, "содержимое">;
+} & {}, "содержимое", {
+    readonly Folder: {
+        targets: "Folder";
+        many: false;
+        required: true;
+    };
+    readonly Item: {
+        targets: "Element";
+        many: false;
+        required: true;
+    };
+}, "content">;
 export declare const compo: import("../model.js").Model<"compo", {
     order: number;
     quantity: number;
 }, {
     readonly Complex: string;
     readonly Part: string;
-} & {}, "состав">;
+} & {}, "состав", {
+    readonly Complex: {
+        targets: "Complex";
+        many: false;
+        required: true;
+    };
+    readonly Part: {
+        targets: "Service" | "Product";
+        many: false;
+        required: true;
+    };
+}, "compo">;
 export declare const skill: import("../model.js").Model<"skill", {
     level: "basic" | "intermediate" | "advanced" | "expert";
 }, {
     readonly Staff: string;
     readonly Service: string;
-} & {}, "навык">;
+} & {}, "навык", {
+    readonly Staff: {
+        targets: "Staff";
+        many: false;
+        required: true;
+    };
+    readonly Service: {
+        targets: "Service";
+        many: false;
+        required: true;
+    };
+}, "skill">;
 export declare const price: import("../model.js").Model<"price", {
     note: string;
     amounts: Partial<Record<"RUB" | "USD" | "EUR" | "AED", number>>;
 }, {
     readonly Item: string;
-} & {}, "цена">;
+} & {}, "цена", {
+    readonly Item: {
+        targets: "Element";
+        many: false;
+        required: true;
+    };
+}, "price">;
 /** Все классы в порядке «предок раньше потомка». */
 export declare const BOOKING: readonly [import("../model.js").Model<"Org", {
     name: string;
@@ -166,12 +324,18 @@ export declare const BOOKING: readonly [import("../model.js").Model<"Org", {
             } | undefined;
         } | undefined;
     } | undefined;
-}, {} & {}, "Организация">, import("../model.js").Model<"Person", {
+}, {} & {}, "Организация", {}, "Org">, import("../model.js").Model<"Person", {
     name: string;
     phone: string;
 }, {
     readonly Org: string;
-} & {}, "Контрагент">, import("../model.js").Model<"Staff", Omit<{
+} & {}, "Контрагент", {
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, "Person">, import("../model.js").Model<"Staff", Omit<{
     name: string;
     phone: string;
 }, "description" | "photo" | "specialization"> & {
@@ -180,7 +344,13 @@ export declare const BOOKING: readonly [import("../model.js").Model<"Org", {
     specialization?: string | undefined;
 }, Omit<{
     readonly Org: string;
-} & {}, never> & {} & {}, "Мастер">, import("../model.js").Model<"Customer", Omit<{
+} & {}, never> & {} & {}, "Мастер", Omit<{
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, never> & {}, "Person" | "Staff">, import("../model.js").Model<"Customer", Omit<{
     name: string;
     phone: string;
 }, "notes" | "preferred_contact"> & {
@@ -188,7 +358,13 @@ export declare const BOOKING: readonly [import("../model.js").Model<"Org", {
     notes?: string | undefined;
 }, Omit<{
     readonly Org: string;
-} & {}, never> & {} & {}, "Клиент">, import("../model.js").Model<"Location", {
+} & {}, never> & {} & {}, "Клиент", Omit<{
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, never> & {}, "Person" | "Customer">, import("../model.js").Model<"Location", {
     address: string;
     coordinates?: {
         lat: number;
@@ -197,19 +373,37 @@ export declare const BOOKING: readonly [import("../model.js").Model<"Org", {
     description?: string | undefined;
 }, {
     readonly Org: string;
-} & {}, "Локация">, import("../model.js").Model<"Element", {
+} & {}, "Локация", {
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, "Location">, import("../model.js").Model<"Element", {
     name: string;
     description?: string | undefined;
 }, {
     readonly Org: string;
-} & {}, "Элемент">, import("../model.js").Model<"Service", Omit<{
+} & {}, "Элемент", {
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, "Element">, import("../model.js").Model<"Service", Omit<{
     name: string;
     description?: string | undefined;
 }, "duration"> & {
     duration?: number | undefined;
 }, Omit<{
     readonly Org: string;
-} & {}, never> & {} & {}, "Услуга">, import("../model.js").Model<"Product", Omit<{
+} & {}, never> & {} & {}, "Услуга", Omit<{
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, never> & {}, "Service" | "Element">, import("../model.js").Model<"Product", Omit<{
     name: string;
     description?: string | undefined;
 }, "sku" | "unit"> & {
@@ -217,7 +411,13 @@ export declare const BOOKING: readonly [import("../model.js").Model<"Org", {
     sku?: string | undefined;
 }, Omit<{
     readonly Org: string;
-} & {}, never> & {} & {}, "Товар">, import("../model.js").Model<"Complex", Omit<{
+} & {}, never> & {} & {}, "Товар", Omit<{
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, never> & {}, "Element" | "Product">, import("../model.js").Model<"Complex", Omit<{
     name: string;
     description?: string | undefined;
 }, "duration" | "cost"> & {
@@ -225,32 +425,82 @@ export declare const BOOKING: readonly [import("../model.js").Model<"Org", {
     duration: number;
 }, Omit<{
     readonly Org: string;
-} & {}, never> & {} & {}, "Комплекс">, import("../model.js").Model<"Schedule", {
+} & {}, never> & {} & {}, "Комплекс", Omit<{
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, never> & {}, "Element" | "Complex">, import("../model.js").Model<"Schedule", {
     name: string;
     year: number;
     month: number;
 }, {
     readonly Org: string;
-} & {}, "Расписание">, import("../model.js").Model<"Folder", {
+} & {}, "Расписание", {
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+}, "Schedule">, import("../model.js").Model<"Folder", {
     name: string;
 }, {
     readonly Org: string;
 } & {
     readonly Parent?: string | undefined;
-}, "Папка">, import("../model.js").Model<"address", {
+}, "Папка", {
+    readonly Org: {
+        targets: "Org";
+        many: false;
+        required: true;
+    };
+    readonly Parent: {
+        targets: "Folder";
+        many: false;
+        required: false;
+    };
+}, "Folder">, import("../model.js").Model<"address", {
     default: boolean;
     schedule_info?: string | undefined;
 }, {
     readonly Staff: string;
     readonly Location: string;
-} & {}, "адрес">, import("../model.js").Model<"slot", {
+} & {}, "адрес", {
+    readonly Staff: {
+        targets: "Staff";
+        many: false;
+        required: true;
+    };
+    readonly Location: {
+        targets: "Location";
+        many: false;
+        required: true;
+    };
+}, "address">, import("../model.js").Model<"slot", {
     start_datetime: string;
     end_datetime: string;
 }, {
     readonly Staff: string;
     readonly Location: string;
     readonly Schedule: string;
-} & {}, "окно">, import("../model.js").Model<"booking", Omit<{
+} & {}, "окно", {
+    readonly Staff: {
+        targets: "Staff";
+        many: false;
+        required: true;
+    };
+    readonly Location: {
+        targets: "Location";
+        many: false;
+        required: true;
+    };
+    readonly Schedule: {
+        targets: "Schedule";
+        many: false;
+        required: true;
+    };
+}, "slot">, import("../model.js").Model<"booking", Omit<{
     start_datetime: string;
     end_datetime: string;
 }, "notes"> & {
@@ -263,27 +513,93 @@ export declare const BOOKING: readonly [import("../model.js").Model<"Org", {
     readonly Item: string;
 } & {
     readonly Customer?: string | undefined;
-}, "запись">, import("../model.js").Model<"content", {
+}, "запись", Omit<{
+    readonly Staff: {
+        targets: "Staff";
+        many: false;
+        required: true;
+    };
+    readonly Location: {
+        targets: "Location";
+        many: false;
+        required: true;
+    };
+    readonly Schedule: {
+        targets: "Schedule";
+        many: false;
+        required: true;
+    };
+}, "Customer" | "Item"> & {
+    readonly Item: {
+        targets: "Element";
+        many: false;
+        required: true;
+    };
+    readonly Customer: {
+        targets: "Customer";
+        many: false;
+        required: false;
+    };
+}, "booking" | "slot">, import("../model.js").Model<"content", {
     order: number;
 }, {
     readonly Folder: string;
     readonly Item: string;
-} & {}, "содержимое">, import("../model.js").Model<"compo", {
+} & {}, "содержимое", {
+    readonly Folder: {
+        targets: "Folder";
+        many: false;
+        required: true;
+    };
+    readonly Item: {
+        targets: "Element";
+        many: false;
+        required: true;
+    };
+}, "content">, import("../model.js").Model<"compo", {
     order: number;
     quantity: number;
 }, {
     readonly Complex: string;
     readonly Part: string;
-} & {}, "состав">, import("../model.js").Model<"skill", {
+} & {}, "состав", {
+    readonly Complex: {
+        targets: "Complex";
+        many: false;
+        required: true;
+    };
+    readonly Part: {
+        targets: "Service" | "Product";
+        many: false;
+        required: true;
+    };
+}, "compo">, import("../model.js").Model<"skill", {
     level: "basic" | "intermediate" | "advanced" | "expert";
 }, {
     readonly Staff: string;
     readonly Service: string;
-} & {}, "навык">, import("../model.js").Model<"price", {
+} & {}, "навык", {
+    readonly Staff: {
+        targets: "Staff";
+        many: false;
+        required: true;
+    };
+    readonly Service: {
+        targets: "Service";
+        many: false;
+        required: true;
+    };
+}, "skill">, import("../model.js").Model<"price", {
     note: string;
     amounts: Partial<Record<"RUB" | "USD" | "EUR" | "AED", number>>;
 }, {
     readonly Item: string;
-} & {}, "цена">];
+} & {}, "цена", {
+    readonly Item: {
+        targets: "Element";
+        many: false;
+        required: true;
+    };
+}, "price">];
 /** Текст lib/sql/seed.booking.sql: строки Class системного арендатора, записанные владельцем. */
 export declare function bookingSeedSql(models?: readonly AnyModel[]): string;

package/dist/describe.d.ts

@@ -0,0 +1,47 @@
+import type { Registry } from './registry.js';
+/** Описание модели: ответ `letopis_model`. */
+export interface ModelDescription {
+    schema: string;
+    tenant: string | null;
+    classes: {
+        name: string;
+        kind: 'hub' | 'link';
+        alias?: string;
+        abstract: boolean;
+        parent?: string;
+        ancestors: string[];
+        system: boolean;
+        fields: Record<string, unknown>;
+        required: string[];
+        /** Условия по нескольким полям (`fields.anyOf` описания с учётом наследования): хотя бы одно должно выполняться. */
+        anyOf?: unknown[];
+        /** Условия по нескольким полям (`fields.oneOf`): ровно одно должно выполняться. */
+        oneOf?: unknown[];
+        ends: Record<string, unknown>;
+        key: string[];
+        history: boolean;
+        ownerDefault: string;
+        cache?: {
+            ttl?: number;
+        };
+        meta: Record<string, unknown>;
+        /**
+         * Рабочие цепочки из реестра (план 2.0, этап 3, п. 7), текст TypeScript. `create` — создать: поля ключа и
+         * обязательные поля без умолчания с образцами значений (`examples` из JSON Schema поля, `const`, `default`, первое
+         * из `enum`, иначе по типу), обязательные концы и концы ключа — слотами; у абстрактного и
+         * системного класса его нет. `find` — найти: по ключу — `first()`, иначе по обязательному полю — `rows()`.
+         * `neighbors` — перейти к соседям: по каждому концу класса и к классам, чьи концы ведут на него. `'<id Класс>'` —
+         * место для id объекта этого класса или его потомка (`'<id A|B>'` — любого из них, `'<id Класс #2>'` — второго).
+         */
+        examples: {
+            create?: string;
+            find: string;
+            neighbors: string[];
+        };
+    }[];
+}
+/**
+ * Описание модели арендатора вместе с метаданными классов (этап 6, п. 12) и примерами цепочек (план 2.0, этап 3, п. 7):
+ * reg — реестр подключения (классы арендатора сессии и System), schema и tenant — схема установки и арендатор сессии.
+ */
+export declare function describeModel(reg: Registry, schema: string, tenant: string | null): ModelDescription;