@antelopejs/interface-dms 0.7.1 → 0.7.3

package/CHANGELOG.md

@@ -1,5 +1,91 @@
 # Changelog
 
+## v0.7.3
+
+[compare changes](https://github.com/AntelopeJS/dms/compare/interface-v0.7.2...v0.7.3)
+
+### 🚀 Enhancements
+
+- **preview:** Share simple options and document real outcomes ([#339](https://github.com/AntelopeJS/dms/pull/339))
+
+### 🩹 Fixes
+
+- **docs:** Use a sandbox-compatible temporary build database ([#326](https://github.com/AntelopeJS/dms/pull/326))
+- Install DMS frontend with the root workspace ([#322](https://github.com/AntelopeJS/dms/pull/322))
+- **modules:** Top-align card content and place readouts below descriptions ([#328](https://github.com/AntelopeJS/dms/pull/328))
+- **modules:** Reuse registered names in the store ([#330](https://github.com/AntelopeJS/dms/pull/330))
+- **playground:** Use the workspace CLI and compatible core interface ([#331](https://github.com/AntelopeJS/dms/pull/331))
+
+### 📖 Documentation
+
+- Create the DMS demo through the CLI in quickstart ([#327](https://github.com/AntelopeJS/dms/pull/327))
+
+### 🏡 Chore
+
+- **release:** @antelopejs/dms v0.9.3 ([1aaf5404](https://github.com/AntelopeJS/dms/commit/1aaf5404))
+- **docs:** Capture temporary MongoDB startup diagnostics ([#325](https://github.com/AntelopeJS/dms/pull/325))
+- **playground:** Refresh compatible dependencies ([#329](https://github.com/AntelopeJS/dms/pull/329))
+
+### ❤️ Contributors
+
+- Antony Rizzitelli <rizzitelli.antony@pm.me>
+
+## v0.7.2
+
+[compare changes](https://github.com/AntelopeJS/dms/compare/interface-v0.7.1...v0.7.2)
+
+### 🚀 Enhancements
+
+- **preview:** Live block preview page, block catalog and screenshots for the docs ([#280](https://github.com/AntelopeJS/dms/pull/280))
+
+### 🔥 Performance
+
+- **layout:** Bundle the Geist fonts and preload only the text face ([#311](https://github.com/AntelopeJS/dms/pull/311))
+- **table:** Drag with SortableJS through useSortable instead of vuedraggable ([#312](https://github.com/AntelopeJS/dms/pull/312))
+- **table-view:** Share a source read between the list and a counter asking the same ([#313](https://github.com/AntelopeJS/dms/pull/313))
+
+### 🩹 Fixes
+
+- **deps:** Move to @antelopejs/core 1.15.2, @antelopejs/interface-core 0.2.3 and @antelopejs/interface-dms 0.7.1 ([#303](https://github.com/AntelopeJS/dms/pull/303))
+- **docs:** Regenerate the block catalog for dms 0.9.2 ([#315](https://github.com/AntelopeJS/dms/pull/315))
+- **form:** Leave a failed record read's toast to the browser ([#304](https://github.com/AntelopeJS/dms/pull/304))
+- **page:** Leave a page's layout out of the components its preload looks up ([#306](https://github.com/AntelopeJS/dms/pull/306))
+- **settings:** Suggest the reader's time zone in a server-rendered region page ([#308](https://github.com/AntelopeJS/dms/pull/308))
+- **frontend:** Set the async data scope before any module's plugin reads ([#305](https://github.com/AntelopeJS/dms/pull/305))
+- **blocks:** Have refreshPageBlocks() wait for the charts and tables it refreshes ([#307](https://github.com/AntelopeJS/dms/pull/307))
+
+### 📖 Documentation
+
+- **dms:** Restructure docs with per-block pages, live previews and an AI section ([#277](https://github.com/AntelopeJS/dms/pull/277))
+- Remove the DMS 0.9 upgrade page ([#316](https://github.com/AntelopeJS/dms/pull/316))
+- **dms:** Document running the DMS inside AdonisJS ([#318](https://github.com/AntelopeJS/dms/pull/318))
+- Make the DMS 0.9 upgrade notes accurate and complete ([#310](https://github.com/AntelopeJS/dms/pull/310))
+- Streamline agent guidance ([#317](https://github.com/AntelopeJS/dms/pull/317))
+- Colocate the DMS consumer reference with its interface ([#320](https://github.com/AntelopeJS/dms/pull/320))
+- Make dense guide sections easier to scan ([#321](https://github.com/AntelopeJS/dms/pull/321))
+
+### 📦 Build
+
+- **dms:** Leave tests and tooling out of the published package ([#314](https://github.com/AntelopeJS/dms/pull/314))
+
+### 🏡 Chore
+
+- **release:** @antelopejs/dms v0.9.2 ([beb09f9d](https://github.com/AntelopeJS/dms/commit/beb09f9d))
+- **release:** Propagate published dependency floors ([#323](https://github.com/AntelopeJS/dms/pull/323))
+
+### ✅ Tests
+
+- **live:** Hold the page's data refresh while paused, not a user's ([#309](https://github.com/AntelopeJS/dms/pull/309))
+
+### 🤖 CI
+
+- **docs:** Build and verify the hosted preview playground ([#319](https://github.com/AntelopeJS/dms/pull/319))
+
+### ❤️ Contributors
+
+- Antony Rizzitelli <rizzitelli.antony@pm.me>
+- Alessandro Aloisio
+
 ## v0.7.1
 
 [compare changes](https://github.com/AntelopeJS/dms/compare/interface-v0.7.0...v0.7.1)

package/README.md

@@ -1,76 +1,78 @@
-# `@antelopejs/interface-dms`
-
 <div align="center">
-<a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue?style=for-the-badge&labelColor=000000"></a>
-<a href="https://antelopejs.com"><img src="https://img.shields.io/badge/Docs-18181B?style=for-the-badge&color=000000" alt="Documentation"></a>
+
+# @antelopejs/interface-dms
+
+<a href="https://www.npmjs.com/package/@antelopejs/interface-dms"><img alt="npm" src="https://img.shields.io/npm/v/@antelopejs/interface-dms?style=for-the-badge&labelColor=000000&color=000000"></a>
+<a href="./LICENSE"><img alt="License" src="https://img.shields.io/npm/l/@antelopejs/interface-dms?style=for-the-badge&labelColor=000000&color=000000"></a>
+<a href="https://discord.gg/sjK28QHrA7"><img alt="Discord" src="https://img.shields.io/badge/Discord-18181B?logo=discord&style=for-the-badge&color=000000"></a>
+<a href="https://dms.antelopejs.com/docs/interfaces"><img alt="Documentation" src="https://img.shields.io/badge/Docs-18181B?style=for-the-badge&color=000000"></a>
+
+The public contracts of the AntelopeJS DMS: pages and components, permissions and tenancy, authentication, notifications and HTML rendering.
+
 </div>
 
-The public contracts of the AntelopeJS DMS: pages and components, permissions
-and tenancy, authentication, notifications and HTML rendering. A module that
-extends the DMS imports them from here and never from `@antelopejs/dms`, so it
-compiles against the contract rather than against the implementation.
+## What it does
+
+- Declares pages, categories, modules and page extensions (`/page`), and the blocks they carry: forms, tables, charts and layouts (`/base`).
+- Registers permissions, guards routes, and scopes data to a tenant (`/permissions`, `/guards`, `/tenant-scoped-model`…).
+- Authenticates requests and manages users, sessions and external identities (`/auth`).
+- Declares notification categories and sends notifications (`/notifications`), and renders HTML templates server-side (`/html-render`).
+- Lets a module compile against the contract rather than against the implementation, [`@antelopejs/dms`](https://www.npmjs.com/package/@antelopejs/dms).
+
+## Install
+
+Add the interface to the module that extends the DMS:
 
 ```bash
 pnpm add @antelopejs/interface-dms
 ```
 
-## Entry points
-
-| Import                                  | What it holds                                              |
-| --------------------------------------- | ---------------------------------------------------------- |
-| `@antelopejs/interface-dms`             | the `dms` interface itself: pages, permissions, tenancy, hooks |
-| `@antelopejs/interface-dms/<module>`    | one module of it -- `/page`, `/permissions`, `/hooks`, `/db`, ... |
-| `@antelopejs/interface-dms/auth`        | authentication: users, sessions, external identities        |
-| `@antelopejs/interface-dms/base`        | the component library: forms, tables, charts, layouts       |
-| `@antelopejs/interface-dms/notifications` | notification categories, subjects and delivery             |
-| `@antelopejs/interface-dms/html-render` | server-side HTML templates                                  |
-
-`/auth`, `/base` and `/notifications` take subpaths of their own
-(`/auth/db`, `/auth/password`, `/base/table-view`, `/base/data-types`, `/notifications/builder`,
-...). The reference documentation lives in the runtime package, under
-`docs/07.interfaces/`.
-
-## One copy, always
-
-Every AntelopeJS interface is a peer dependency, and so is this one in effect:
-the host and every module have to resolve **the same installed copy**.
-
-That is stricter here than the usual "duplicate dependencies waste space". This
-package holds live state, not just types -- the page, category and extension
-registries, the permission tree, the hook registry, the data-type and block
-registries, the component slot resolvers -- and the interface proxies a module
-registers into are identified per loaded instance. A second copy gets its own
-empty registries and its own proxies: pages register into a tree nobody reads,
-permissions never reach the roles form, and hooks never fire. Nothing throws.
-
-`@antelopejs/core` checks this before constructing modules and fails with
-`Incompatible interface package resolution` when a consumer resolves a copy
-other than the canonical one, so a mismatch is caught at startup rather than
-diagnosed later. Depend on it with a wide range -- `>=0.0.1 <1.0.0`, raising the lower bound
-to the version you actually need rather than pinning an upper one -- so package
-managers can deduplicate, and never vendor or bundle this package into a module.
-`@antelopejs/dms`, which implements this interface, is the exception: it caps its
-range below the next minor, so a breaking minor of this package never reaches an
-older DMS.
-
-One more consequence worth knowing when writing a module: the runtime hands a
-module a per-context view of the values it receives through an interface, so
-reference equality does not survive the round trip. Compare registrations on a
-field, never with `===`.
-
-The same goes for *finding* a registration again, not just comparing two. A
-view has to be resolved back to the registered object by its token before it can
-be used as a key: `RegisteringProxy` looks its entries up by object reference,
-so unregistering with the view a module holds matches nothing and leaves the
-registration live -- silently, exactly like a second copy would. `RegisterPage`
-and `RegisterCategory` resolve their argument through `RegistrationIdentity`
-(`page/internal/registry`) for that reason; anything else keyed on a value
-that crossed the boundary has to do the same. The same trap catches structural comparisons:
-`isDeepStrictEqual` and `assert.deepStrictEqual` both refuse two views that hold
-equal values, so compare plain data, field by field or after a JSON round trip.
-
-## Releasing
-
-Release this package before releasing a `@antelopejs/dms` version that needs it,
-and upgrade it first on the consumer side. It has its own workflow
-(`Release DMS interface`); releasing the runtime never releases it.
+Depend on it with a wide range, such as `>=0.7.0 <1.0.0`, and never bundle or vendor it: the host and every module must resolve the same installed copy, since the package holds live registries. `@antelopejs/core` fails at startup with `Incompatible interface package resolution` when a module resolves another copy.
+
+## Quick start
+
+```ts
+import { PageController, RegisterPage, pagesCategory } from "@antelopejs/interface-dms/page";
+import { KpiCard } from "@antelopejs/interface-dms/base/kpi-card";
+
+@RegisterPage()
+export class SalesPage extends PageController("sales", {
+  displayName: "Sales",
+  icon: "i-ph-chart-line",
+  category: pagesCategory,
+}) {
+  static revenue = KpiCard({ title: "Revenue", fetchUrl: "/api/sales/revenue" });
+}
+```
+
+| Import | What it holds |
+| --- | --- |
+| `@antelopejs/interface-dms` | the core surface: pages, permissions, tenancy, hooks |
+| `@antelopejs/interface-dms/<module>` | one module of it: `/page`, `/permissions`, `/hooks`, `/db`… |
+| `@antelopejs/interface-dms/auth` | authentication: users, sessions, external identities |
+| `@antelopejs/interface-dms/base` | the component library: forms, tables, charts, layouts |
+| `@antelopejs/interface-dms/notifications` | notification categories, subjects and delivery |
+| `@antelopejs/interface-dms/html-render` | server-side HTML templates |
+
+## Compatibility
+
+| `@antelopejs/interface-dms` | `@antelopejs/dms` (implementation) |
+| --- | --- |
+| 0.7 | 0.9 |
+| 0.6 | 0.8 |
+
+## Documentation
+
+- [The DMS interface](./docs/index.md): the canonical consumer reference, shipped with this package and published at [docs/interfaces](https://dms.antelopejs.com/docs/interfaces)
+- [Core](./docs/1.core/1.introduction.md), [Auth](./docs/2.auth/1.introduction.md), [Base](./docs/3.base/1.introduction.md), [Notifications](./docs/4.notifications/1.introduction.md), [HTML Render](./docs/5.html-render/1.introduction.md)
+- [Pages and components](https://dms.antelopejs.com/docs/building/pages-and-components): the task-by-task guide
+
+An importable file is not necessarily a supported API. Paths under `internal/`, symbols tagged `@internal`, and `internal` namespaces are implementation wiring, even when the wildcard export makes them reachable. Use the public declarations and contracts documented here.
+
+## Contributing
+
+This package lives in the [`AntelopeJS/dms`](https://github.com/AntelopeJS/dms) pnpm workspace, next to the runtime that implements it. Read [CONTRIBUTING.md](https://github.com/AntelopeJS/dms/blob/main/CONTRIBUTING.md), the [repository README](https://github.com/AntelopeJS/dms#contributing) and [AGENTS.md](https://github.com/AntelopeJS/dms/blob/main/AGENTS.md), which covers what is public and what is internal. Release this package (**Release DMS interface**) before a `@antelopejs/dms` version that needs it.
+
+## License
+
+[Apache-2.0](./LICENSE)

package/dist/auth/db/models/sessions.model.d.ts

@@ -20,6 +20,7 @@ declare const SessionModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<Session>;
     fromPlainData(obj: any): Session;
     fromDatabase(obj: any): Session | undefined;
     toDatabase(obj: any): Record<string, any>;

package/dist/auth/db/models/userExternalIdentities.model.d.ts

@@ -17,6 +17,7 @@ declare const UserExternalIdentityModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<UserExternalIdentity>;
     fromPlainData(obj: any): UserExternalIdentity;
     fromDatabase(obj: any): UserExternalIdentity | undefined;
     toDatabase(obj: any): Record<string, any>;

package/dist/auth/db/models/users.model.d.ts

@@ -20,6 +20,7 @@ declare const UserModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<User>;
     fromPlainData(obj: any): User;
     fromDatabase(obj: any): User | undefined;
     toDatabase(obj: any): Record<string, any>;

package/dist/base/block-registry/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./helpers";
+export * from "./presentation";
 export * from "./registry";
 export * from "./types";

package/dist/base/block-registry/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./helpers"), exports);
+__exportStar(require("./presentation"), exports);
 __exportStar(require("./registry"), exports);
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/base/block-registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/block-registry/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,6CAA2B;AAC3B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/block-registry/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,0CAAwB"}

package/dist/base/block-registry/presentation.d.ts

@@ -0,0 +1,21 @@
+import type { BlockOptionUi, BlockTypeDescriptor } from "./types";
+/** The hints needed to decide whether an editor offers an option in simple mode. */
+export interface SimpleBlockOption {
+    ui?: Pick<BlockOptionUi, "hidden" | "advanced" | "derivedFrom"> & {
+        group?: string;
+    };
+}
+/** Shared simple-mode policy; data binding remains available in the builder. */
+export declare function IsSimpleBlockOption(option: SimpleBlockOption): boolean;
+/**
+ * Dotted paths a standalone preview can edit without replacing data or opaque
+ * values. Objects are descended into, never offered as JSON. Only enum arrays
+ * in presentation/behavior groups and closed-key scalar records are editable
+ * collections; rows, slots and other structural collections remain fixed.
+ * Scalar unions have typed controls; a rich union with an explicit scalar
+ * widget (e.g. translated text or chart color) offers that scalar only.
+ *
+ * Fixed factory options exclude their entire top-level subtree. The returned
+ * paths reference `config`; consumers must not keep another copy of the schema.
+ */
+export declare function BlockPresentationPaths(descriptor: Pick<BlockTypeDescriptor, "config" | "fixedOptions">): string[];

package/dist/base/block-registry/presentation.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsSimpleBlockOption = IsSimpleBlockOption;
+exports.BlockPresentationPaths = BlockPresentationPaths;
+/** Shared simple-mode policy; data binding remains available in the builder. */
+function IsSimpleBlockOption(option) {
+    const ui = option.ui;
+    return (!ui?.hidden && !ui?.advanced && !ui?.derivedFrom && ui?.group !== "advanced");
+}
+const PRESENTATION_WIDGETS = new Set([
+    "text",
+    "textarea",
+    "number",
+    "range",
+    "switch",
+    "select",
+    "segmented",
+    "icon",
+    "color",
+    "url",
+]);
+function isPresentation(option) {
+    return (IsSimpleBlockOption(option) &&
+        option.ui?.group !== "data" &&
+        !option.truncated &&
+        (!option.ui?.widget || PRESENTATION_WIDGETS.has(option.ui.widget)));
+}
+// A scalar widget can replace a union's structured value, so a restricted
+// descendant in any branch forbids offering that parent too.
+function hasRestrictedHints(option) {
+    if (!IsSimpleBlockOption(option) ||
+        option.ui?.group === "data" ||
+        (option.ui?.widget && !PRESENTATION_WIDGETS.has(option.ui.widget)))
+        return true;
+    const children = [
+        ...Object.values(option.properties ?? {}),
+        ...[option.items, option.values, option.keys].filter((child) => !!child),
+        ...(option.oneOf ?? []),
+        ...(option.allOf ?? []),
+        ...(option.prefixItems ?? []),
+    ];
+    return children.some(hasRestrictedHints);
+}
+function isScalar(option) {
+    if (option.truncated || option.allOf || option.prefixItems)
+        return false;
+    return (["string", "number", "boolean"].includes(option.type) ||
+        (option.type === "union" &&
+            !!option.oneOf?.length &&
+            option.oneOf.every(isScalar)));
+}
+function hasValueEditor(option) {
+    if (hasRestrictedHints(option))
+        return false;
+    if (isScalar(option))
+        return true;
+    if (option.type === "array") {
+        // Content collections can carry demonstration rows even when enum-valued.
+        return (["appearance", "behavior", "layout", "features"].includes(option.ui?.group ?? "") &&
+            !!option.items?.enum?.length &&
+            isScalar(option.items));
+    }
+    if (option.type === "record") {
+        return (!!option.keys?.enum?.length && !!option.values && isScalar(option.values));
+    }
+    // Rich text and palettes can still use the scalar widget their schema declares.
+    return (option.type === "union" &&
+        !!option.ui?.widget &&
+        !!option.oneOf?.some(isScalar));
+}
+/**
+ * Dotted paths a standalone preview can edit without replacing data or opaque
+ * values. Objects are descended into, never offered as JSON. Only enum arrays
+ * in presentation/behavior groups and closed-key scalar records are editable
+ * collections; rows, slots and other structural collections remain fixed.
+ * Scalar unions have typed controls; a rich union with an explicit scalar
+ * widget (e.g. translated text or chart color) offers that scalar only.
+ *
+ * Fixed factory options exclude their entire top-level subtree. The returned
+ * paths reference `config`; consumers must not keep another copy of the schema.
+ */
+function BlockPresentationPaths(descriptor) {
+    const paths = [];
+    const walk = (config, prefix) => {
+        for (const [key, option] of Object.entries(config)) {
+            // Dots and prototype keys cannot be represented safely by path editors.
+            if (key.includes(".") ||
+                ["__proto__", "constructor", "prototype"].includes(key))
+                continue;
+            if (!prefix && Object.hasOwn(descriptor.fixedOptions ?? {}, key))
+                continue;
+            if (!isPresentation(option))
+                continue;
+            const path = prefix ? `${prefix}.${key}` : key;
+            if (option.allOf || option.prefixItems)
+                continue;
+            if (option.type === "object" && option.properties) {
+                walk(option.properties, path);
+                continue;
+            }
+            if (hasValueEditor(option))
+                paths.push(path);
+        }
+    };
+    walk(descriptor.config, "");
+    return paths;
+}
+//# sourceMappingURL=presentation.js.map

package/dist/base/block-registry/presentation.js.map

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

package/dist/base/block-types.d.ts

@@ -22,6 +22,7 @@ import "./grid";
 import "./guard";
 import "./key-value-list";
 import "./kpi-card";
+import "./live-toggle";
 import "./meter";
 import "./nav-card-grid";
 import "./period-selector";

package/dist/base/block-types.js

@@ -38,6 +38,7 @@ require("./grid");
 require("./guard");
 require("./key-value-list");
 require("./kpi-card");
+require("./live-toggle");
 require("./meter");
 require("./nav-card-grid");
 require("./period-selector");

package/dist/base/block-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"block-types.js","sourceRoot":"","sources":["../../src/base/block-types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;GAWG;AACH,2BAAyB;AACzB,oBAAkB;AAClB,kBAAgB;AAChB,oCAAkC;AAClC,wBAAsB;AACtB,wBAAsB;AACtB,yBAAuB;AACvB,+BAA6B;AAC7B,kBAAgB;AAChB,mBAAiB;AACjB,4BAA0B;AAC1B,sBAAoB;AACpB,mBAAiB;AACjB,2BAAyB;AACzB,6BAA2B;AAC3B,yBAAuB;AACvB,kCAAgC;AAChC,qBAAmB;AACnB,mBAAiB;AACjB,wBAAsB;AACtB,iBAAe;AACf,+BAA6B;AAC7B,2BAAyB;AAEzB,2EAA2E;AAC3E,6DAA6D;AAC7D,iDAA+B;AAC/B,2DAAyC;AACzC,4DAA0C;AAC1C,yDAAuC"}
+{"version":3,"file":"block-types.js","sourceRoot":"","sources":["../../src/base/block-types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;GAWG;AACH,2BAAyB;AACzB,oBAAkB;AAClB,kBAAgB;AAChB,oCAAkC;AAClC,wBAAsB;AACtB,wBAAsB;AACtB,yBAAuB;AACvB,+BAA6B;AAC7B,kBAAgB;AAChB,mBAAiB;AACjB,4BAA0B;AAC1B,sBAAoB;AACpB,yBAAuB;AACvB,mBAAiB;AACjB,2BAAyB;AACzB,6BAA2B;AAC3B,yBAAuB;AACvB,kCAAgC;AAChC,qBAAmB;AACnB,mBAAiB;AACjB,wBAAsB;AACtB,iBAAe;AACf,+BAA6B;AAC7B,2BAAyB;AAEzB,2EAA2E;AAC3E,6DAA6D;AAC7D,iDAA+B;AAC/B,2DAAyC;AACzC,4DAA0C;AAC1C,yDAAuC"}

package/dist/base/live-toggle.d.ts

@@ -58,11 +58,11 @@ export declare const LiveToggleSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     variant?: "segmented" | "pill" | undefined;
     align?: "left" | "right" | "center" | undefined;
-    missedLabel?: string | undefined;
     showUpdatedAt?: boolean | undefined;
+    missedLabel?: string | undefined;
 }, {
     variant?: "segmented" | "pill" | undefined;
     align?: "left" | "right" | "center" | undefined;
-    missedLabel?: string | undefined;
     showUpdatedAt?: boolean | undefined;
+    missedLabel?: string | undefined;
 }>;

package/dist/base/period-selector.d.ts

@@ -141,13 +141,13 @@ export declare const PeriodSelectorSchema: z.ZodObject<{
     size?: "xs" | "sm" | "md" | "lg" | "xl" | undefined;
     variant?: "default" | "segmented" | undefined;
     rememberKey?: string | undefined;
+    align?: "left" | "right" | "center" | undefined;
     defaultPreset?: "custom" | "all" | "last-hour" | "last-24h" | "today" | "yesterday" | "last-7-days" | "last-30-days" | "last-90-days" | "this-month" | "last-month" | "this-quarter" | "last-quarter" | "ytd" | "last-year" | undefined;
     defaultComparison?: "custom" | "none" | "previous-period" | "previous-year" | undefined;
     presets?: ("custom" | "all" | "last-hour" | "last-24h" | "today" | "yesterday" | "last-7-days" | "last-30-days" | "last-90-days" | "this-month" | "last-month" | "this-quarter" | "last-quarter" | "ytd" | "last-year")[] | undefined;
     comparisons?: ("custom" | "none" | "previous-period" | "previous-year")[] | undefined;
     presetLabels?: Partial<Record<"custom" | "all" | "last-hour" | "last-24h" | "today" | "yesterday" | "last-7-days" | "last-30-days" | "last-90-days" | "this-month" | "last-month" | "this-quarter" | "last-quarter" | "ytd" | "last-year", string>> | undefined;
     comparisonLabels?: Partial<Record<"custom" | "none" | "previous-period" | "previous-year", string>> | undefined;
-    align?: "left" | "right" | "center" | undefined;
     showRangeLabel?: boolean | undefined;
     rangeLabel?: "relative" | "absolute" | undefined;
     comparisonControl?: "hidden" | "menu" | "toggle" | undefined;
@@ -157,13 +157,13 @@ export declare const PeriodSelectorSchema: z.ZodObject<{
     id?: string | undefined;
     variant?: "default" | "segmented" | undefined;
     rememberKey?: string | undefined;
+    align?: "left" | "right" | "center" | undefined;
     defaultPreset?: "custom" | "all" | "last-hour" | "last-24h" | "today" | "yesterday" | "last-7-days" | "last-30-days" | "last-90-days" | "this-month" | "last-month" | "this-quarter" | "last-quarter" | "ytd" | "last-year" | undefined;
     defaultComparison?: "custom" | "none" | "previous-period" | "previous-year" | undefined;
     presets?: ("custom" | "all" | "last-hour" | "last-24h" | "today" | "yesterday" | "last-7-days" | "last-30-days" | "last-90-days" | "this-month" | "last-month" | "this-quarter" | "last-quarter" | "ytd" | "last-year")[] | undefined;
     comparisons?: ("custom" | "none" | "previous-period" | "previous-year")[] | undefined;
     presetLabels?: Partial<Record<"custom" | "all" | "last-hour" | "last-24h" | "today" | "yesterday" | "last-7-days" | "last-30-days" | "last-90-days" | "this-month" | "last-month" | "this-quarter" | "last-quarter" | "ytd" | "last-year", string>> | undefined;
     comparisonLabels?: Partial<Record<"custom" | "none" | "previous-period" | "previous-year", string>> | undefined;
-    align?: "left" | "right" | "center" | undefined;
     showRangeLabel?: boolean | undefined;
     rangeLabel?: "relative" | "absolute" | undefined;
     comparisonControl?: "hidden" | "menu" | "toggle" | undefined;

package/dist/base/placeholder.js

@@ -15,11 +15,11 @@ exports.PlaceholderSchema = zod_1.z.object({
     height: (0, block_registry_1.ui)(zod_1.z
         .string()
         .optional()
-        .describe("How tall the box is, such as 200px; left empty, it fills its place."), { label: "Height", group: "appearance" }),
+        .describe("How tall the box is, such as 200px; left empty, it fills its place."), { label: "Height", group: "appearance", advanced: true }),
     width: (0, block_registry_1.ui)(zod_1.z
         .string()
         .optional()
-        .describe("How wide the box is, such as 300px; left empty, it fills its column."), { label: "Width", group: "appearance" }),
+        .describe("How wide the box is, such as 300px; left empty, it fills its column."), { label: "Width", group: "appearance", advanced: true }),
 });
 /**
  * Placeholder - Development Placeholder Component

package/dist/base/placeholder.js.map

@@ -1 +1 @@
-{"version":3,"file":"placeholder.js","sourceRoot":"","sources":["../../src/base/placeholder.ts"],"names":[],"mappings":";;;AAiEA,kCASC;AA1ED,4CAAgD;AAChD,6BAAwB;AACxB,qDAA+E;AAE/E,MAAM,0BAA0B,GAAG,iBAAiB,CAAC;AAwBrD,yCAAyC;AAC5B,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE;QACtE,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,SAAS;KACjB,CAAC;IACF,MAAM,EAAE,IAAA,mBAAE,EACR,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE,CACtE,EACH,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,CACzC;IACD,KAAK,EAAE,IAAA,mBAAE,EACP,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE,CACvE,EACH,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CACxC;CACF,CAA+C,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CACzB,OAA4B;IAE5B,OAAO,IAAI,4BAAgB,CAAqB,0BAA0B,CAAC;SACxE,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;SACvB,IAAI,CAAC;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;KACvB,CAAC,CAAC;AACP,CAAC;AAED,IAAA,kCAAiB,EAAC;IAChB,IAAI,EAAE,aAAa;IACnB,aAAa,EAAE,0BAA0B;IACzC,MAAM,EAAE,yBAAiB;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE,QAAQ;KAChB;CACF,CAAC,CAAC"}
+{"version":3,"file":"placeholder.js","sourceRoot":"","sources":["../../src/base/placeholder.ts"],"names":[],"mappings":";;;AAiEA,kCASC;AA1ED,4CAAgD;AAChD,6BAAwB;AACxB,qDAA+E;AAE/E,MAAM,0BAA0B,GAAG,iBAAiB,CAAC;AAwBrD,yCAAyC;AAC5B,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE;QACtE,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,SAAS;KACjB,CAAC;IACF,MAAM,EAAE,IAAA,mBAAE,EACR,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE,CACtE,EACH,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CACzD;IACD,KAAK,EAAE,IAAA,mBAAE,EACP,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE,CACvE,EACH,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CACxD;CACF,CAA+C,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CACzB,OAA4B;IAE5B,OAAO,IAAI,4BAAgB,CAAqB,0BAA0B,CAAC;SACxE,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;SACvB,IAAI,CAAC;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;KACvB,CAAC,CAAC;AACP,CAAC;AAED,IAAA,kCAAiB,EAAC;IAChB,IAAI,EAAE,aAAa;IACnB,aAAa,EAAE,0BAA0B;IACzC,MAAM,EAAE,yBAAiB;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE,QAAQ;KAChB;CACF,CAAC,CAAC"}

package/dist/base/table-view/schema.d.ts

@@ -839,17 +839,17 @@ export declare const TableViewSchema: z.ZodObject<{
         whileSorted: z.ZodOptional<z.ZodBoolean>;
         missedLabel: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        missedLabel?: string | undefined;
         whileRowOpen?: boolean | undefined;
         whileScrolled?: boolean | undefined;
         whileSearching?: boolean | undefined;
         whileSorted?: boolean | undefined;
-        missedLabel?: string | undefined;
     }, {
+        missedLabel?: string | undefined;
         whileRowOpen?: boolean | undefined;
         whileScrolled?: boolean | undefined;
         whileSearching?: boolean | undefined;
         whileSorted?: boolean | undefined;
-        missedLabel?: string | undefined;
     }>]>>;
     kanban: z.ZodOptional<z.ZodObject<{
         groupByField: z.ZodString;
@@ -1137,11 +1137,11 @@ export declare const TableViewSchema: z.ZodObject<{
     strictRuleValidation?: boolean | undefined;
     realtimeTopic?: string | string[] | undefined;
     liveHold?: boolean | {
+        missedLabel?: string | undefined;
         whileRowOpen?: boolean | undefined;
         whileScrolled?: boolean | undefined;
         whileSearching?: boolean | undefined;
         whileSorted?: boolean | undefined;
-        missedLabel?: string | undefined;
     } | undefined;
     defaultDisplay?: string | undefined;
     guards?: TableViewGuards<Record<string, unknown>> | undefined;
@@ -1352,11 +1352,11 @@ export declare const TableViewSchema: z.ZodObject<{
     realtime?: boolean | undefined;
     realtimeTopic?: string | string[] | undefined;
     liveHold?: boolean | {
+        missedLabel?: string | undefined;
         whileRowOpen?: boolean | undefined;
         whileScrolled?: boolean | undefined;
         whileSearching?: boolean | undefined;
         whileSorted?: boolean | undefined;
-        missedLabel?: string | undefined;
     } | undefined;
     defaultDisplay?: string | undefined;
     guards?: TableViewGuards<Record<string, unknown>> | undefined;

package/dist/db/internal/exportJobs.model.d.ts

@@ -24,6 +24,7 @@ declare const ExportJobModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<ExportJob>;
     fromPlainData(obj: any): ExportJob;
     fromDatabase(obj: any): ExportJob | undefined;
     toDatabase(obj: any): Record<string, any>;

package/dist/db/internal/inviteResolutions.model.d.ts

@@ -13,6 +13,7 @@ declare const InviteResolutionsModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<InviteResolution>;
     fromPlainData(obj: any): InviteResolution;
     fromDatabase(obj: any): InviteResolution | undefined;
     toDatabase(obj: any): Record<string, any>;

package/dist/db/internal/tenantLifecycle.model.d.ts

@@ -12,6 +12,7 @@ declare const TenantLifecycleModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<TenantLifecycle>;
     fromPlainData(obj: any): TenantLifecycle;
     fromDatabase(obj: any): TenantLifecycle | undefined;
     toDatabase(obj: any): Record<string, any>;

package/dist/db/models/roles.model.d.ts

@@ -12,6 +12,7 @@ declare const RoleModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<Role>;
     fromPlainData(obj: any): Role;
     fromDatabase(obj: any): Role | undefined;
     toDatabase(obj: any): Record<string, any>;

package/dist/db/models/tenantMembers.model.d.ts

@@ -12,6 +12,7 @@ declare const TenantMemberModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<TenantMember>;
     fromPlainData(obj: any): TenantMember;
     fromDatabase(obj: any): TenantMember | undefined;
     toDatabase(obj: any): Record<string, any>;