@antelopejs/dms 0.5.5 → 0.6.0

package/frontend-vue/tests/time-span.test.ts

@@ -0,0 +1,37 @@
+import { describe, expect, it } from "vitest";
+import {
+  formatTimeSpan,
+  parseTimeSpan,
+  readTimeSpan,
+} from "../layers/dms-core/app/utils/formatter";
+
+const MINUTE = 60_000;
+const HOUR = 60 * MINUTE;
+
+describe("time spans", () => {
+  it("reads a clock duration, hours and minutes, seconds optional", () => {
+    expect(readTimeSpan("01:30")).toBe(HOUR + 30 * MINUTE);
+    expect(readTimeSpan("0:05")).toBe(5 * MINUTE);
+    expect(readTimeSpan("26:00:30")).toBe(26 * HOUR + 30_000);
+  });
+
+  it("reads units, joined or split by spaces or the colon it writes", () => {
+    expect(readTimeSpan("1h30m")).toBe(HOUR + 30 * MINUTE);
+    expect(readTimeSpan("1h 30m")).toBe(HOUR + 30 * MINUTE);
+    expect(readTimeSpan("1.5h")).toBe(HOUR + 30 * MINUTE);
+    expect(readTimeSpan(formatTimeSpan(HOUR + 30 * MINUTE))).toBe(
+      HOUR + 30 * MINUTE,
+    );
+  });
+
+  it("refuses anything else rather than reading it as nothing", () => {
+    for (const text of ["abc", "01:75", "1h abc", "12", ":30", "1:2"]) {
+      expect(readTimeSpan(text), text).toBeUndefined();
+    }
+  });
+
+  it("keeps parseTimeSpan's zero for what it cannot read", () => {
+    expect(parseTimeSpan("abc")).toBe(0);
+    expect(parseTimeSpan("01:30")).toBe(HOUR + 30 * MINUTE);
+  });
+});

package/frontend-vue/tests/tone.test.ts

@@ -0,0 +1,45 @@
+// @vitest-environment jsdom
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { describe, expect, it } from "vitest";
+import { createSSRApp } from "vue";
+import { renderToString } from "vue/server-renderer";
+import IconWell from "../layers/dms-ui/app/components/icon-well/IconWell.vue";
+import {
+  DMS_TONE_WELL,
+  isDmsTone,
+} from "../layers/dms-ui/app/build/utils/tone";
+
+const FORMER_TONE = /tone"?\s*[=:][^\n]*["']accent["']/i;
+
+function walk(directory: string): string[] {
+  return readdirSync(directory).flatMap((name) => {
+    const path = join(directory, name);
+    return statSync(path).isDirectory() ? walk(path) : [path];
+  });
+}
+
+describe("Tone", () => {
+  it("knows the semantic tones only", () => {
+    expect(isDmsTone("success")).toBe(true);
+    expect(isDmsTone("accent")).toBe(false);
+    expect(isDmsTone("violet")).toBe(false);
+  });
+
+  it("draws an icon well in primary by default", async () => {
+    const html = await renderToString(
+      createSSRApp(IconWell, { icon: "i-ph-star" }),
+    );
+    for (const name of DMS_TONE_WELL.primary.split(" ")) {
+      expect(html).toContain(name);
+    }
+  });
+
+  it("is never passed as accent by a DMS component", () => {
+    const offenders = walk(join(process.cwd(), "layers"))
+      .filter((path) => path.endsWith(".vue"))
+      .filter((path) => FORMER_TONE.test(readFileSync(path, "utf8")))
+      .map((path) => relative(process.cwd(), path));
+    expect(offenders).toEqual([]);
+  });
+});

package/frontend-vue/tests/unsaved-changes.test.ts

@@ -0,0 +1,184 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { nextTick, ref } from "vue";
+import {
+  changedFormKeys,
+  isEmptyFormValue,
+  sameFormValue,
+  snapshotFormValue,
+} from "../layers/dms-ui/app/build/composables/unsaved-changes/formValue";
+import { useFormDirty } from "../layers/dms-ui/app/composables/unsaved-changes/useFormDirty";
+import {
+  confirmLeave,
+  hasUnsavedChanges,
+  isLeavingVisit,
+  registerUnsavedChanges,
+  resetUnsavedChanges,
+} from "../layers/dms-ui/app/build/composables/unsaved-changes/registry";
+
+describe("sameFormValue", () => {
+  it("compares nested objects and lists by value", () => {
+    expect(
+      sameFormValue(
+        { street: "Rue Haute", tags: ["a", "b"], geo: { lat: 1 } },
+        { geo: { lat: 1 }, tags: ["a", "b"], street: "Rue Haute" },
+      ),
+    ).toBe(true);
+    expect(sameFormValue({ tags: ["a", "b"] }, { tags: ["b", "a"] })).toBe(
+      false,
+    );
+    expect(sameFormValue({ geo: { lat: 1 } }, { geo: { lat: 2 } })).toBe(false);
+  });
+
+  it("compares dates by their time", () => {
+    expect(sameFormValue(new Date("2026-01-01"), new Date("2026-01-01"))).toBe(
+      true,
+    );
+    expect(sameFormValue(new Date("2026-01-01"), "2026-01-01")).toBe(false);
+  });
+
+  it("treats every empty value as the same", () => {
+    for (const empty of [undefined, null, "", [], false, { a: "", b: null }]) {
+      expect(isEmptyFormValue(empty)).toBe(true);
+      expect(sameFormValue(empty, undefined)).toBe(true);
+    }
+    expect(sameFormValue(0, undefined)).toBe(false);
+    expect(sameFormValue({ enabled: true }, { enabled: false })).toBe(false);
+  });
+
+  it("lists the keys that changed", () => {
+    expect(
+      changedFormKeys({ a: "x", b: [1], c: "" }, { a: "x", b: [2], c: null }),
+    ).toEqual(["b"]);
+  });
+
+  it("snapshots detached copies, files kept as they are", () => {
+    const file = new Blob(["x"]);
+    const value = { list: [{ a: 1 }], file };
+    const copy = snapshotFormValue(value);
+    value.list[0]!.a = 2;
+    expect(copy.list[0]!.a).toBe(1);
+    expect(copy.file).toBe(file);
+  });
+});
+
+describe("useFormDirty", () => {
+  it("is dirty while a value differs and clean once restored", async () => {
+    const state = ref({ name: "Ada", tags: ["x"] });
+    const { dirty } = useFormDirty(() => state.value);
+    expect(dirty.value).toBe(false);
+
+    state.value.tags.push("y");
+    await nextTick();
+    expect(dirty.value).toBe(true);
+
+    state.value.tags.pop();
+    await nextTick();
+    expect(dirty.value).toBe(false);
+  });
+
+  it("starts over from the saved values after markClean", async () => {
+    const state = ref({ name: "Ada" });
+    const { dirty, markClean } = useFormDirty(() => state.value);
+    state.value.name = "Grace";
+    await nextTick();
+    expect(dirty.value).toBe(true);
+
+    markClean();
+    expect(dirty.value).toBe(false);
+    state.value.name = "Ada";
+    await nextTick();
+    expect(dirty.value).toBe(true);
+  });
+
+  it("compares with the caller's initial values when given", () => {
+    const saved = ref("Ada");
+    const name = ref("Ada");
+    const { dirty } = useFormDirty(() => name.value, {
+      initial: () => saved.value,
+    });
+    name.value = "Grace";
+    expect(dirty.value).toBe(true);
+    saved.value = "Grace";
+    expect(dirty.value).toBe(false);
+  });
+});
+
+describe("leave guard", () => {
+  afterEach(() => resetUnsavedChanges());
+
+  it("leaves without asking when nothing is dirty", async () => {
+    const prompt = vi.fn(async () => true);
+    registerUnsavedChanges({ isDirty: () => false }, prompt);
+    expect(await confirmLeave()).toBe(true);
+    expect(prompt).not.toHaveBeenCalled();
+  });
+
+  it("asks when dirty and keeps the form on Keep editing", async () => {
+    const prompt = vi.fn(async () => false);
+    registerUnsavedChanges({ isDirty: () => true }, prompt);
+    expect(await confirmLeave()).toBe(false);
+    expect(prompt).toHaveBeenCalledTimes(1);
+    expect(hasUnsavedChanges()).toBe(true);
+  });
+
+  it("asks once for concurrent leaves and never again once discarded", async () => {
+    let answer!: (value: boolean) => void;
+    const prompt = vi.fn(
+      () => new Promise<boolean>((resolve) => (answer = resolve)),
+    );
+    registerUnsavedChanges(
+      { isDirty: () => true, containerId: "drawer-1" },
+      prompt,
+    );
+    registerUnsavedChanges({ isDirty: () => true }, prompt);
+
+    // A drawer closing while the page navigates: one dialog for both.
+    const closing = confirmLeave({ containerId: "drawer-1" });
+    const navigating = confirmLeave();
+    answer(true);
+    expect(await closing).toBe(true);
+    expect(await navigating).toBe(true);
+    expect(prompt).toHaveBeenCalledTimes(1);
+
+    // Released: the drawer closing after the navigation asks nothing more.
+    expect(await confirmLeave({ containerId: "drawer-1" })).toBe(true);
+    expect(prompt).toHaveBeenCalledTimes(1);
+  });
+
+  it("only asks for the forms of the scope left", async () => {
+    const prompt = vi.fn(async () => true);
+    const panel = { contains: (element: unknown) => element === inside };
+    const inside = {} as Element;
+    registerUnsavedChanges(
+      { isDirty: () => true, containerId: "modal-1" },
+      prompt,
+    );
+    registerUnsavedChanges(
+      { isDirty: () => true, element: () => inside },
+      prompt,
+    );
+    expect(await confirmLeave({ containerId: "modal-2" })).toBe(true);
+    expect(prompt).not.toHaveBeenCalled();
+    expect(await confirmLeave({ within: panel as unknown as Element })).toBe(
+      true,
+    );
+    expect(prompt).toHaveBeenCalledTimes(1);
+    // The modal's form was outside the panel: still guarded.
+    expect(hasUnsavedChanges({ containerId: "modal-1" })).toBe(true);
+  });
+
+  it("guards page visits to another path only", () => {
+    const url = (path: string) => new URL(path, "http://dms.test");
+    expect(isLeavingVisit({ url: url("/b"), method: "get" }, "/a")).toBe(true);
+    expect(isLeavingVisit({ url: url("/a?tab=2"), method: "get" }, "/a")).toBe(
+      false,
+    );
+    expect(isLeavingVisit({ url: url("/b"), prefetch: true }, "/a")).toBe(
+      false,
+    );
+    expect(isLeavingVisit({ url: url("/b"), method: "post" }, "/a")).toBe(
+      false,
+    );
+    expect(isLeavingVisit(undefined, "/a")).toBe(false);
+  });
+});

package/frontend-vue/tests/url-interpolation.test.ts

@@ -0,0 +1,40 @@
+import { describe, expect, it } from "vitest";
+import { interpolateUrl } from "../layers/dms-core/app/utils/url-interpolation";
+
+describe("interpolateUrl", () => {
+  it("fills row fields into the URL, encoded", () => {
+    expect(
+      interpolateUrl("/items/{_id}/tag/{name}", { _id: "a1", name: "a b/c" }),
+    ).toBe("/items/a1/tag/a%20b%2Fc");
+  });
+
+  it("keeps the colon of a tenant-scoped id readable", () => {
+    expect(
+      interpolateUrl("/members/{_id}/owner", { _id: "default:29fd-11" }),
+    ).toBe("/members/default:29fd-11/owner");
+  });
+
+  it("leaves a missing field empty", () => {
+    expect(interpolateUrl("/items/{missing}", {})).toBe("/items/");
+  });
+
+  it("keeps web and mail links", () => {
+    expect(interpolateUrl("https://acme.dev/{slug}", { slug: "a" })).toBe(
+      "https://acme.dev/a",
+    );
+    expect(interpolateUrl("mailto:{email}", { email: "a@b.c" })).toBe(
+      "mailto:a%40b.c",
+    );
+  });
+
+  it("refuses a scheme the row data brings in", () => {
+    for (const site of [
+      "javascript:alert(1)",
+      "JavaScript:alert(1)",
+      "data:text/html,x",
+      "vbscript:x",
+    ]) {
+      expect(interpolateUrl("{site}", { site })).toBe("");
+    }
+  });
+});

package/frontend-vue/tests/vue-inventory.test.ts

@@ -2,7 +2,7 @@ import { readFileSync, readdirSync, statSync } from "node:fs";
 import { join, relative } from "node:path";
 import { describe, expect, it } from "vitest";
 
-const EXPECTED_VUE_FILES = 144;
+const EXPECTED_VUE_FILES = 264;
 
 function walk(directory: string): string[] {
   return readdirSync(directory).flatMap((name) => {
@@ -20,12 +20,16 @@ function ownership(path: string): string | undefined {
     [/\/app\/error\.vue$/, "inertia-error-page"],
     [/\/app\/emails\/.*\.vue$/, "server-email-template"],
   ];
-  return owners.find(([pattern]) => pattern.test(path))?.[1];
+  // Forward slashes on every OS, so the patterns also match Windows paths.
+  const normalized = path.replaceAll("\\", "/");
+  return owners.find(([pattern]) => pattern.test(normalized))?.[1];
 }
 
 describe("Vue source inventory", () => {
   it("contains only Vue frontend source files", () => {
-    const files = walk(join(process.cwd(), "layers"));
+    const files = walk(join(process.cwd(), "layers")).map((path) =>
+      path.replaceAll("\\", "/"),
+    );
     expect(files.filter((path) => path.includes("/server/"))).toEqual([]);
   });
 
@@ -37,7 +41,7 @@ describe("Vue source inventory", () => {
     expect(files.filter((path) => !ownership(path))).toEqual([]);
     expect(
       files.filter((path) => ownership(path) === "server-email-template"),
-    ).toHaveLength(8);
+    ).toHaveLength(10);
   });
 
   it("exposes entries for the frontend adapter", () => {
@@ -52,18 +56,29 @@ describe("Vue source inventory", () => {
       '"./layers/**/app/custom-layouts/**/*.vue"',
     );
     expect(frontendModule).toContain('"./layers/**/app/error.vue"');
+    expect(frontendModule).toContain('componentPrefix: "Dms"');
     expect(frontendModule).toContain(
-      "sdk.registerComponent(`Dms${pascalCase(name)}`, component)",
+      "sdk.registerComponent(pascalCase(name), component)",
     );
+    for (const [name, alias] of [
+      ["ActivityFeed", "ActivityFeedBlock"],
+      ["Section", "SectionBlock"],
+      ["FieldRow", "FieldRowBlock"],
+    ]) {
+      expect(frontendModule).toContain(`${name}: "${alias}"`);
+    }
     expect(frontendModule).toContain('.replace(/\\/index$/, "")');
     expect(frontendModule).toContain(
       "sdk.registerErrorPage(lazyComponent(loader), loader)",
     );
 
-    const entries = walk(join(root, "layers")).filter(
-      (path) =>
-        path.includes("/app/custom-pages/") || path.endsWith("/app/error.vue"),
-    );
+    const entries = walk(join(root, "layers"))
+      .map((path) => path.replaceAll("\\", "/"))
+      .filter(
+        (path) =>
+          path.includes("/app/custom-pages/") ||
+          path.endsWith("/app/error.vue"),
+      );
     expect(entries).not.toHaveLength(0);
     expect(
       entries.every((path) => path.endsWith(".vue") && statSync(path).isFile()),

package/frontend-vue/vitest.config.ts

@@ -9,6 +9,12 @@ export default defineConfig({
       "#dms-core": resolve(__dirname, "layers/dms-core"),
       "#dms-ui": resolve(__dirname, "layers/dms-ui"),
       "#dms-layout": resolve(__dirname, "layers/dms-layout"),
+      // Mocked by the tests that reach it: the engine runs in the generated
+      // application, not under Vitest.
+      "#dms/frontend-module": resolve(
+        __dirname,
+        "node_modules/@antelopejs/dms-frontend/templates/vue/frontend-module.ts",
+      ),
       "#shortcuts-aggregated": resolve(
         __dirname,
         "layers/dms-ui/app/config/shortcuts-registry.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms",
-  "version": "0.5.5",
+  "version": "0.6.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AntelopeJS/dms.git"
@@ -12,6 +12,7 @@
     "!dist/.tsbuildinfo",
     "frontend-vue",
     "skills",
+    "data",
     "package.json",
     "README.md",
     "CHANGELOG.md",
@@ -33,10 +34,10 @@
     "@antelopejs/interface-api": ">=0.0.13 <1.0.0",
     "@antelopejs/interface-api-util": ">=0.1.2 <1.0.0",
     "@antelopejs/interface-core": ">=0.1.1 <1.0.0",
-    "@antelopejs/interface-data-api": ">=0.1.9 <1.0.0",
+    "@antelopejs/interface-data-api": ">=0.2.0 <1.0.0",
     "@antelopejs/interface-database": ">=0.1.8 <1.0.0",
     "@antelopejs/interface-database-decorators": ">=0.1.7 <1.0.0",
-    "@antelopejs/interface-dms": ">=0.3.5 <0.4.0",
+    "@antelopejs/interface-dms": ">=0.4.0 <0.5.0",
     "@antelopejs/interface-email": ">=0.0.5 <1.0.0",
     "@antelopejs/interface-file-storage": ">=0.1.3 <1.0.0",
     "archiver": "^7.0.1",
@@ -44,6 +45,7 @@
     "defu": "^6.1.4",
     "ignore": "^7.0.5",
     "jsonwebtoken": "^9.0.3",
+    "mmdb-lib": "^3.0.3",
     "node-cron": "^4.2.1",
     "randomstring": "^1.3.1",
     "semver": "^7.7.2",
@@ -52,7 +54,7 @@
     "zod": "~3.24.2"
   },
   "devDependencies": {
-    "@antelopejs/core": ">=1.10.1 <2",
+    "@antelopejs/core": ">=1.13.4 <2",
     "@antelopejs/tooling-configs": ">=0.0.7 <1.0.0",
     "@types/archiver": "^6.0.4",
     "@types/chai": "^4.3.20",
@@ -94,7 +96,7 @@
     "@antelopejs/interface-redis": ">=0.0.8 <1.0.0"
   },
   "peerDependencies": {
-    "@antelopejs/core": ">=1.10.1 <2"
+    "@antelopejs/core": ">=1.13.2 <2"
   },
   "peerDependenciesMeta": {
     "@antelopejs/core": {
@@ -114,6 +116,7 @@
     "test:integration": "pnpm run build && DMS_TEST_DIR=dist/test/integration ajs module test .",
     "test:watch": "tsc -w & tsc-alias -w",
     "release": "pnpm --filter @antelopejs/interface-dms build && pnpm --dir frontend-vue install --frozen-lockfile && release-it",
+    "country-database": "node scripts/fetch-country-database.mjs",
     "knip": "knip --dependencies",
     "knip:all": "knip"
   }

package/skills/dms/REFERENCE.md

@@ -12,7 +12,7 @@ List a section to see its files:
 | `docs/01.getting-started/` | Intro, installation, quickstart, tutorial, **architecture**, the built-in dashboard |
 | `docs/02.building/` | Project setup (**the common case**), every config key, pages & components, navigation, actions, backend services (hooks, notifications, realtime, replayable jobs, HTML/email rendering, export jobs), localization, frontend layer & `ajs dms` CLI, distributable modules, deployment, troubleshooting |
 | `docs/03.auth-and-tenancy/` | Auth flows (JWT, 2FA, invites), decorators & RBAC, multi-tenant data, SaaS mode |
-| `docs/04.components/` | Component catalog: charts/widgets, layout, forms, tables, tree, DataTypes, DataController, file storage |
+| `docs/04.components/` | Component catalog: charts/widgets, layout, forms, tables, DataTypes, DataController, file storage |
 | `docs/05.extending-the-dashboard/` | Dashboard chrome, theming, custom DataTypes (frontend side), table-view displays, component events, period filtering |
 | `docs/06.frontend-composables/` | Composables a custom frontend module's Vue calls: auth'd requests, realtime, page context, UI toolkit |
 | `docs/07.interfaces/` | The contract reference for `@antelopejs/interface-dms`, one folder per domain: `core`, `auth`, `base`, `notifications`, `html-render` |

package/skills/dms/SKILL.md

@@ -28,7 +28,7 @@ For the framework underneath (the core, `ajs` CLI, interfaces as versioned contr
   loading the DMS via `antelope.config.ts`, registering *its own* pages and data — **dms-project**.
   Rarer: a **distributable module** (like `dms-database`) — **dms-module**. Same APIs; only packaging.
 - **Pages are classes; UI is data.** A page extends `PageController(id, opts)` decorated with
-  `@RegisterPage()`. Its **static fields are components** — `Form`, `TableView`, `Tree`, `Chart*`,
+  `@RegisterPage()`. Its **static fields are components** — `Form`, `TableView`, `Chart*`,
   `Grid`, `KpiCard`, … — fluent builders producing a **serializable description**, not live UI: the
   frontend renders it. **Components fetch their own data** via URLs (`fetchUrl`, `submitUrl`, …) —
   routes often declared `@Get`/`@Post` on the same page class; the backend stays the source of truth.

package/skills/dms-auth/SKILL.md

@@ -49,7 +49,8 @@ route. This optional-auth-returns-200 behavior has caused a real token-refresh b
 ## Protecting pages
 
 A page's auth comes from its `PageController` options (see **dms-pages**): `publicAccess:
-true` (no auth), `authOnly: true` (login only), default (login **and** the auto-derived page
+true` (no auth), `authOnly: true` (login only), `memberAccess: true` (every signed-in member
+holds the page, its components and actions without a role grant), default (login **and** the auto-derived page
 permission), `permission: …` (a specific `Partial<Permission> | Action`),
 `noComponentPermissions: true` (skip per-component permission derivation). Routes under a
 controller that a page or `DataController` wraps **inherit** its auth — don't re-add login

package/skills/dms-module/SKILL.md

@@ -79,7 +79,7 @@ module's frontend; without it the module is backend-only.
 
 `renderer` names the framework (Vue 3), not a loader release. The `@antelopejs/dms-frontend`
 releases the frontend module runs on go in the frontend module's own `package.json`, as
-`"engines": { "@antelopejs/dms-frontend": ">=0.3.2 <0.4.0" }`: the loader refuses the module
+`"engines": { "@antelopejs/dms-frontend": ">=0.4.0 <0.5.0" }`: the loader refuses the module
 outside that range. Cap it below the next loader minor while the loader is 0.x.
 
 ## Navigation & access — module pages are owner-only

package/skills/dms-pages/REFERENCE.md

@@ -5,7 +5,7 @@ catalog.
 
 ## Component builders
 
-Main builders: `Form`; `TableView(controller, options)`; `Tree`; the charts (`ChartLine`,
+Main builders: `Form`; `TableView(controller, options)`; the charts (`ChartLine`,
 `ChartArea`, `ChartBar`, `ChartColumn`, `ChartDonut`, `ChartPie`, `ChartScatter`,
 `ChartMixed`, `ChartRadar`, `ChartRadialBar`, `ChartHeatmap`, `ChartCandlestick`, usually
 inside `ChartCard`); layout `Grid` + `GridRow`, `HStack` / `VStack` / `Spacer`, `Tab`,
@@ -18,9 +18,9 @@ behavioral DSL — permissioned `.action()`s and `.watch()` reactivity — see
 ## DataTypes
 
 A field's `type` is a **DataType instance**: `new DefaultDataTypes.StringType({ … })`. The
-catalog (21 built in, `@antelopejs/interface-dms/base/data-types`): `String`, `Number`, `Date`,
+catalog (19 built in, `@antelopejs/interface-dms/base/data-types`): `String`, `Number`, `Date`,
 `Boolean`, `Select`, `Price`, `Percentage`, `Email`, `Color`, `Password`, `Url`, `Phone`,
-`Tree`, `Relation`, `CascaderRelation`, `Address`, `Permissions`, `RichText`, `StringTime`,
+`Relation`, `CascaderRelation`, `Address`, `RichText`, `StringTime`,
 `File`, `Image` (each as `<Name>Type`), plus `StatusType` via the `data-types` barrel. The
 same types drive TableView columns and filters — options per type are in
 `docs/04.components/08.data-types.md`. Custom types: subclass `DataType`, decorate with

package/skills/dms-pages/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dms-pages
-description: Declares admin pages and composes backend-driven UI on the AntelopeJS DMS. Use when adding a dashboard screen, writing a @RegisterPage / PageController class, composing Form / TableView / Tree / Chart / Grid builders imported from @antelopejs/interface-dms/base, or choosing DataTypes and wiring the routes and DataControllers that feed them.
+description: Declares admin pages and composes backend-driven UI on the AntelopeJS DMS. Use when adding a dashboard screen, writing a @RegisterPage / PageController class, composing Form / TableView / Chart / Grid builders imported from @antelopejs/interface-dms/base, or choosing DataTypes and wiring the routes and DataControllers that feed them.
 category: dashboard
 tags: [pages, components, forms, tables, data-types, navigation]
 ---
@@ -33,7 +33,7 @@ export class RecipesPage extends PageController("recipes", {
 `options` is the `MenuOptions` shape (`@antelopejs/interface-dms/page`): `displayName`, `icon`,
 `module` and/or `category` (at least one required; a module page's explicit category must
 descend from the module's root), `urlSlug` (defaults to the id), `order`, `description`, `hidden`,
-`type`, plus auth knobs (`publicAccess`, `authOnly`, `permission`, `noComponentPermissions` —
+`type`, plus auth knobs (`publicAccess`, `authOnly`, `memberAccess`, `permission`, `noComponentPermissions` —
 see **dms-auth**). `Category(id, options)` returns a `CategoryInfo` to pass as a page's
 `category`; `RegisterModule({ id, … })` creates a module root that pages attach to via
 `module: "<id>"`. Module pages live under `MODULE_URL_PREFIX` (`/modules`), e.g.
@@ -61,11 +61,12 @@ export class SubmitRecipePage extends PageController("submit-recipe", { displayN
     ],
     submitUrl: "/api/recipes",   // a route — often declared on this same class
     submitUrlMethod: HttpMethod.post,
+    kind: "action",              // sends something new each time; omit for a record form (save bar)
   });
 }
 ```
 
-The full catalog — `Form`, `TableView`, `Tree`, the charts, layout containers, dashboard
+The full catalog — `Form`, `TableView`, the charts, layout containers, dashboard
 widgets, `CustomComponent` — plus nesting rules and the behavioral DSL (permissioned
 `.action()`s, `.watch()` reactivity) is in [REFERENCE.md](REFERENCE.md).
 
@@ -93,7 +94,7 @@ with `@RegisterDataController()` (both from `@antelopejs/interface-data-api`).
 class-level `@ColumnGroup(id, config)`), `@Listable` / `@Sortable` from
 `@antelopejs/interface-data-api/metadata`. Read a
 real one first: `@antelopejs/interface-dms/data-controllers` (`members`); guide in
-`docs/04.components/09.data-controller.md` (+ `06.tables.md`). Database rows carry **`_id`**
+`docs/04.components/09.data-controller.md` (+ `06.tables/`). Database rows carry **`_id`**
 as the primary key — return and type it as `_id`, never alias to `id`.
 
 ## DataTypes

package/frontend-vue/antelope.config.json

@@ -1,5 +0,0 @@
-{
-  "url": "http://127.0.0.1:5010",
-  "entry": "/dms/frontend",
-  "sitelayout": "/dms/sitelayout"
-}