@weave-kit/engine 0.1.0

package/dist/infrastructure/event/bus.js

@@ -0,0 +1,86 @@
+import { EVENT_TYPES, } from '../../core/provider/event/index.js';
+const RECORD_EVENT_TYPES = {
+    created: EVENT_TYPES.RECORD_CREATED,
+    updated: EVENT_TYPES.RECORD_UPDATED,
+    deleted: EVENT_TYPES.RECORD_DELETED,
+};
+/**
+ * In-process event bus with a bounded replay ring buffer. `publish` assigns a
+ * monotonically increasing `seq` (the SSE replay anchor) and delivers to all
+ * current listeners synchronously. The ring buffer is in-memory only: after a
+ * process restart `replay` reports `gap` for any non-empty `afterSeq`, which
+ * the SSE adapter turns into a `schema.changed` nudge (client refetches via
+ * REST). A listener throwing never breaks the bus.
+ */
+export function createEventBus(options = {}) {
+    const maxEvents = options.maxEvents ?? 1000;
+    let seq = 0;
+    const listeners = new Set();
+    const buffer = [];
+    const bus = {
+        publish(input) {
+            seq += 1;
+            const event = { seq, ts: new Date(), type: input.type, payload: input.payload };
+            buffer.push(event);
+            if (buffer.length > maxEvents)
+                buffer.shift();
+            for (const listener of [...listeners]) {
+                try {
+                    listener(event);
+                }
+                catch {
+                    // listener errors never break the bus (best-effort delivery)
+                }
+            }
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        replay(afterSeq, listener) {
+            if (afterSeq < 0)
+                return 'ok'; // no replay requested
+            if (buffer.length === 0)
+                return afterSeq === 0 ? 'ok' : 'gap'; // restart: nothing retained
+            if (afterSeq < buffer[0].seq - 1)
+                return 'gap'; // ring overflowed the requested window
+            for (const event of buffer) {
+                if (event.seq > afterSeq)
+                    listener(event);
+            }
+            return 'ok';
+        },
+        lastSeq() {
+            return seq;
+        },
+        close() {
+            listeners.clear();
+            buffer.length = 0;
+            seq = 0;
+        },
+    };
+    return bus;
+}
+/** narrow publisher facade injected into data-access / audit / assembly */
+export function publisherOf(bus) {
+    return {
+        publishRecordChange(action, object, id) {
+            bus.publish({ type: RECORD_EVENT_TYPES[action], payload: { object, id } });
+        },
+        publishAudit(event) {
+            bus.publish({ type: EVENT_TYPES.AUDIT_EVENT, payload: { event } });
+        },
+        publishSchemaChanged() {
+            bus.publish({ type: EVENT_TYPES.SCHEMA_CHANGED, payload: { kind: 'schema' } });
+        },
+        publishSchemaDrift(payload) {
+            bus.publish({ type: EVENT_TYPES.SCHEMA_DRIFT, payload });
+        },
+        publishLifecycle(kind) {
+            bus.publish({ type: EVENT_TYPES.LIFECYCLE_SHUTDOWN, payload: { kind } });
+        },
+    };
+}
+//# sourceMappingURL=bus.js.map

package/dist/infrastructure/event/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../../../src/infrastructure/event/bus.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/event/index.d.ts

@@ -0,0 +1,3 @@
+export { createEventBus, publisherOf } from './bus.js';
+export type { EventBusOptions } from './bus.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/event/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/infrastructure/event/index.js

@@ -0,0 +1,2 @@
+export { createEventBus, publisherOf } from './bus.js';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/event/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/event/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/infrastructure/identity.d.ts

@@ -0,0 +1,10 @@
+import type { RbacSubject } from '../core/rbac/index.js';
+import type { IdentityResolver } from '../core/provider/identity/index.js';
+/**
+ * Default identity resolver backed by a static directory of subjects.
+ * Exact-match on the reference; unknown refs (and empty directories) resolve
+ * to null so callers can reject. MCP assembly may override with a custom
+ * `resolveIdentity`.
+ */
+export declare function createIdentityResolver(identities: Record<string, RbacSubject>): IdentityResolver;
+//# sourceMappingURL=identity.d.ts.map

package/dist/infrastructure/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/infrastructure/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,gBAAgB,CAEhG"}

package/dist/infrastructure/identity.js

@@ -0,0 +1,10 @@
+/**
+ * Default identity resolver backed by a static directory of subjects.
+ * Exact-match on the reference; unknown refs (and empty directories) resolve
+ * to null so callers can reject. MCP assembly may override with a custom
+ * `resolveIdentity`.
+ */
+export function createIdentityResolver(identities) {
+    return (ref) => identities[ref] ?? null;
+}
+//# sourceMappingURL=identity.js.map

package/dist/infrastructure/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/infrastructure/identity.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAuC;IAC5E,OAAO,CAAC,GAAW,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AAClD,CAAC"}

package/dist/infrastructure/index.d.ts

@@ -0,0 +1,8 @@
+export { createIdentityResolver } from './identity.js';
+export { createAlerts, createConsoleAlertSink, createSlackAlertSink, createWebhookAlertSink } from './alerts/index.js';
+export { ALERT_CHANNELS } from './alerts/index.js';
+export type { AlertsConfig, AlertChannel } from './alerts/index.js';
+export type { SlackAlertSinkOptions, WebhookAlertSinkOptions } from './alerts/index.js';
+export { createEventBus, publisherOf } from './event/index.js';
+export type { EventBusOptions } from './event/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACvH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/infrastructure/index.js

@@ -0,0 +1,5 @@
+export { createIdentityResolver } from './identity.js';
+export { createAlerts, createConsoleAlertSink, createSlackAlertSink, createWebhookAlertSink } from './alerts/index.js';
+export { ALERT_CHANNELS } from './alerts/index.js';
+export { createEventBus, publisherOf } from './event/index.js';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACvH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/layout-format.d.ts

@@ -0,0 +1,283 @@
+import type { MetadataField, ObjectDescriptor } from './core/object/describe.js';
+import type { MessageKey } from './core/i18n/en.js';
+/**
+ * Page layout format (hybrid: app-level pages live flat as `pages/<id>.layout.json`
+ * — e.g. `pages/app.layout.json` — while object pages live in per-object dirs
+ * `pages/<object>/<view>.layout.json` mirroring `objects/<name>/`) — engine-owned
+ * single source (D11/D13/D15, SU-4b/SU-4c, SU-7c). Pure types + pure functions,
+ * zero runtime imports (browser-safe via `@weave-kit/engine/layout` subpath —
+ * consumers like `@weave-kit/ui` re-export these). Field entries are
+ * reference-only: `{ui_id, object, field}` point at schema fields; every
+ * attribute comes from `schema.json`. Naming: content blocks (field/tabs/
+ * accordion/grid/section/subtable/list/blocks) vs shell blocks (sidebar/outlet/
+ * dialog). Object binding happens only via `LayoutField`/`LayoutSubtable`/
+ * `LayoutList` — generic blocks never bind an object.
+ *
+ * **Hard rule**: this file must stay import-free at runtime — only `import
+ * type` (erased at compile time). Guarded by `tests/unit/values-browser-safe.test.ts`.
+ */
+export declare const VIEWPORTS: {
+    readonly DESKTOP: "desktop";
+    readonly MOBILE: "mobile";
+};
+export type Viewport = (typeof VIEWPORTS)[keyof typeof VIEWPORTS];
+/** page classes — drive addressing (path shape), validation profile and lifecycle rules */
+export declare const PAGE_KINDS: {
+    readonly SHELL: "shell";
+    readonly OBJECT: "object";
+    readonly CUSTOM: "custom";
+};
+export type PageKind = (typeof PAGE_KINDS)[keyof typeof PAGE_KINDS];
+/** object page layout variants — mirror the physical layout files (`show`/`list`) */
+export declare const OBJECT_LAYOUT_VIEWS: {
+    readonly SHOW: "show";
+    readonly LIST: "list";
+};
+export type ObjectLayoutView = (typeof OBJECT_LAYOUT_VIEWS)[keyof typeof OBJECT_LAYOUT_VIEWS];
+/**
+ * Stable reference to an internal page — the host resolves it to a runtime URL
+ * (never a handwritten path). Sidebar items and other references hold a
+ * `PageRef` instead of a URL so custom-page renames stay atomic.
+ */
+export interface PageRef {
+    kind: Exclude<PageKind, 'shell'>;
+    id: string;
+}
+/** a field entry — resolved to a schema field via `object` + `field` (ui_id 消歧) */
+export interface LayoutField {
+    ui_id: string;
+    type: 'field';
+    object: string;
+    field: string;
+    /** display label — required; defaults to the referenced `field` name when authored */
+    label: string;
+}
+export interface LayoutTab {
+    ui_id: string;
+    label: string;
+    columns?: number;
+    /** a tab is a general container — any blocks (including `fields` containers) */
+    children: LayoutNode[];
+}
+export interface LayoutTabs {
+    ui_id: string;
+    type: 'tabs';
+    tabs: LayoutTab[];
+}
+export interface LayoutAccordion {
+    ui_id: string;
+    type: 'accordion';
+    label?: string;
+    children: LayoutNode[];
+}
+export interface LayoutGridColumn {
+    ui_id: string;
+    type: 'column';
+    /** controls stacked vertically inside this column */
+    children: LayoutNode[];
+}
+export interface LayoutGrid {
+    ui_id: string;
+    type: 'grid';
+    /** one vertical stack (zone) per column — count defines the number of columns */
+    columns: LayoutGridColumn[];
+    /** horizontal gap between columns (px) */
+    gap?: number;
+    /** vertical gap between stacked controls inside a column (px) */
+    rowGap?: number;
+}
+export interface LayoutSection {
+    ui_id: string;
+    type: 'section';
+    label?: string;
+    columns?: number;
+    children: LayoutNode[];
+}
+/**
+ * Composite field container — the ONLY place `field` entries may be added
+ * (strict rule). It is a composite block: `children` holds one or more `grid`
+ * blocks, and fields live inside those grids' columns (`fields > grid > column
+ * > field`). The legacy flat `columns` attribute is removed — column layout is
+ * owned by the inner `grid`.
+ */
+export interface LayoutFields {
+    ui_id: string;
+    type: 'fields';
+    label?: string;
+    children: LayoutNode[];
+}
+/** child-object list bound to the parent record (details) — read-only in v1 */
+export interface LayoutSubtable {
+    ui_id: string;
+    type: 'subtable';
+    object: string;
+    columns?: string[];
+}
+/**
+ * First-class object list (collection page / custom-page table) — distinct from
+ * `subtable` (detail-page child table bound to a parent record). Runs the
+ * `list.client.js` lifecycle (own query/pagination/filter/sort/row actions).
+ */
+export interface LayoutList {
+    ui_id: string;
+    type: 'list';
+    object: string;
+    columns?: string[];
+    pageSize?: number;
+    /** default sort applied to this list instance (NocoBase "sorting rules" minimal form) */
+    defaultSort?: {
+        field: string;
+        dir: 'asc' | 'desc';
+    };
+}
+/**
+ * display block (governance + CRUD detail share these). Generic blocks never
+ * bind an object — object binding happens via `LayoutField`/`LayoutSubtable`/
+ * `LayoutList`. A runtime `object` key is rejected by the profile validator.
+ */
+export interface LayoutBlock {
+    ui_id: string;
+    type: 'filterbar' | 'statcard' | 'toolbar' | 'detail-panel' | 'timeline' | 'diffview';
+    label?: string;
+    /** block-specific props (open) */
+    [key: string]: unknown;
+}
+/**
+ * Sidebar nav **data** as stored in layout.json — no active flags (that is a UI
+ * render concern; `@weave-kit/ui`'s `NavItem` is a superset with optional
+ * `icon`/`active`, so these items are directly assignable to it). `icon` is a
+ * **name string** resolved to a component by the UI layer (the engine stays
+ * headless — it never imports icon components).
+ * Exactly one of `page`/`href` must be set (enforced by the profile validator).
+ */
+export interface SidebarItem {
+    label: string;
+    /** icon name (lucide-style), resolved to a component by `@weave-kit/ui` */
+    icon?: string;
+    /** built-in route / legacy config / external link */
+    href?: string;
+    /** internal page target (PageRef) */
+    page?: PageRef;
+    badge?: string;
+    disabled?: boolean;
+    children?: SidebarItem[];
+}
+export interface SidebarGroups {
+    label?: string;
+    items: SidebarItem[];
+    /**
+     * dynamic group kind — `objects` lists every registry object (read-only,
+     * runtime-derived; `items` is ignored when set)
+     */
+    kind?: 'objects';
+}
+/** shell: app navigation (sidebar; TopNav deprecated — no `top` variant) */
+export interface LayoutSidebar {
+    ui_id: string;
+    type: 'sidebar';
+    groups: SidebarGroups[];
+    /** brand wordmark shown instead of the default ("WeaveKit") when set */
+    appName?: string;
+    /** brand logo URL/data-URI (replaces the wordmark image) */
+    logo?: string;
+}
+/** shell: content outlet — the current routed page renders here */
+export interface LayoutOutlet {
+    ui_id: string;
+    type: 'outlet';
+    name: string;
+}
+/**
+ * Self-contained modal container (SU-7c v5): content is authored inline as
+ * `children` — there is no page reference. The runtime opens the modal and
+ * renders `children` inside (LayoutView). Replaces the legacy `{ref:{page}}`
+ * "dialog opens another page" model (D15 override).
+ */
+export interface LayoutDialog {
+    ui_id: string;
+    type: 'dialog';
+    title?: string;
+    children: LayoutNode[];
+}
+export type LayoutNode = LayoutField | LayoutTabs | LayoutAccordion | LayoutGrid | LayoutSection | LayoutFields | LayoutSubtable | LayoutList | LayoutBlock | LayoutSidebar | LayoutOutlet | LayoutDialog;
+export interface ViewportLayout {
+    mode: 'vertical' | 'horizontal';
+    layout: LayoutNode[];
+}
+export interface LayoutFile {
+    viewports: Partial<Record<Viewport, ViewportLayout>>;
+}
+/**
+ * Pick the layout for the current viewport, falling back to `desktop` when the
+ * requested viewport is absent (D11 决策 1b). `undefined` → render flat.
+ */
+export declare function getViewportLayout(layout: LayoutFile | undefined, viewport: Viewport): ViewportLayout | undefined;
+/**
+ * Resolve a field entry `{ object, field }` to the real schema field via the
+ * object descriptor. Unknown/ignored fields (RBAC `fields.exclude` are already
+ * stripped server-side) resolve to `undefined` → the entry is not rendered.
+ * The `object` discriminates same-named fields across child objects (D13).
+ */
+export declare function resolveFieldEntry(entry: {
+    object: string;
+    field: string;
+}, descriptor: (object: string) => ObjectDescriptor | undefined): MetadataField | undefined;
+/** validation profile — derived from PageKind (+ object view) */
+export declare const LAYOUT_PROFILES: {
+    readonly SHELL: "shell";
+    readonly OBJECT_SHOW: "object-show";
+    readonly OBJECT_LIST: "object-list";
+    readonly CUSTOM: "custom";
+};
+export type LayoutProfile = (typeof LAYOUT_PROFILES)[keyof typeof LAYOUT_PROFILES];
+/** map a page kind (+ object view) onto the validation profile */
+export declare function layoutProfileFor(kind: PageKind, view?: ObjectLayoutView): LayoutProfile;
+/** allowed node types for a profile — single source the designer palette filter is checked against */
+export declare function allowedNodeTypesForProfile(profile: LayoutProfile): ReadonlySet<string>;
+/** a validation finding — `key` is an i18n message key; `path` locates the node */
+export interface LayoutIssue {
+    key: MessageKey;
+    path: string;
+    params: Record<string, unknown>;
+}
+/**
+ * Page source address — discriminated by kind; drives the path-mirrored layout
+ * API (`/pages/<path>`, e.g. `app.layout` / `<id>/layout` /
+ * `tickets/show.layout` / `tickets/list.layout`).
+ */
+export type LayoutAddress = {
+    kind: 'shell';
+} | {
+    kind: 'custom';
+    id: string;
+} | {
+    kind: 'object';
+    id: string;
+    view: ObjectLayoutView;
+} | {
+    kind: 'page-face';
+    page: string;
+    object: string;
+    face: string;
+};
+/** the `/pages/<path>` path segment mirroring the physical file under `pages/` */
+export declare function layoutPagePath(addr: LayoutAddress): string;
+/** parse a `/pages/<path>` segment back into an address; `undefined` when malformed.
+ *  Custom pages live in directories (`<id>/layout`); the legacy flat
+ *  `<id>.layout` form is rejected (see `weave pages:migrate`). Page-scoped
+ *  object faces (`<page>/objects/<object>/<face>.layout`) are 千人千面 faces. */
+export declare function parseLayoutPagePath(path: string): LayoutAddress | undefined;
+export interface LayoutValidationOptions {
+    /** object names present in the registry (validates field/subtable/list `object`) */
+    objects?: ReadonlySet<string>;
+    /** listable (flat) field names per object (validates `columns`) */
+    listableFields?: (object: string) => readonly string[] | undefined;
+}
+/**
+ * Profile-aware pure validation of a whole layout file (SU-7c): allowed node
+ * types per profile, per-viewport `ui_id` uniqueness, container/dialog children,
+ * object bindings, sidebar target conflict, shell outlet presence. Returns
+ * findings — the REST layer maps them onto localized `SchemaError`s.
+ */
+export declare function validateLayoutProfile(layout: LayoutFile, profile: LayoutProfile, options?: LayoutValidationOptions): LayoutIssue[];
+//# sourceMappingURL=layout-format.d.ts.map

package/dist/layout-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-format.d.ts","sourceRoot":"","sources":["../src/layout-format.ts"],"names":[],"mappings":"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"}