@antelopejs/dms 0.15.1 → 0.16.1

package/frontend-vue/layers/dms-core/app/types/watch.ts

@@ -21,7 +21,6 @@ export interface WatchAction {
   component: string;
   event: string;
   functionId: string;
-  // oxlint-disable-next-line anti-slop/no-unsafe-dictionary-type -- Registered action functions own their heterogeneous parameters; no shared schema or ComponentOptionsData contract covers all public action callers.
-  params?: Record<string, unknown>;
+  params?: object;
   onParam?: WatchActionCondition | WatchActionCondition[];
 }

package/frontend-vue/layers/dms-ui/app/build/composables/form/fieldValueRule.ts

@@ -1,11 +1,64 @@
 import type { WatchAction } from "#dms-core/app/types/watch";
-import { isString, isNumber, isBoolean } from "#dms-core/app/utils/type-check";
+import { isString, isNumber, isBoolean, isObject } from "#dms-core/app/utils/type-check";
 
 /** What a `SetFieldValue` watch writes, and where. */
 export interface SetFieldValueParams {
   targetField: string;
   value?: unknown;
-  valueMap?: NonNullable<WatchAction["params"]>;
+  valueMap?: object;
+}
+
+/** The own member `key` of `source`, wrapped so that an absent one stays apart from an `undefined` one. */
+function ownMember(
+  source: object,
+  key: string,
+): { value: unknown } | undefined {
+  return isObject(source) && Object.hasOwn(source, key)
+    ? { value: source[key] }
+    : undefined;
+}
+
+/** What a field-state watch (`SetFieldDisabled`, `SetFieldHidden`, `SetFieldRequired`) sets, and on which field. */
+export interface FieldFlagParams {
+  targetField: string;
+  flag: boolean;
+}
+
+/**
+ * The params a field-state watch carries, read by the name of its flag
+ * (`setDisabled`, `setHidden`, `setRequired`). Nothing when the watch names no
+ * string `targetField`.
+ */
+export function readFieldFlagParams(
+  params: WatchAction["params"],
+  flagKey: string,
+): FieldFlagParams | undefined {
+  if (!params || !("targetField" in params)) return undefined;
+  const { targetField } = params;
+  if (!isString(targetField)) return undefined;
+  return { targetField, flag: !!ownMember(params, flagKey)?.value };
+}
+
+/**
+ * The params a `SetFieldValue` watch carries. Nothing when the watch names no
+ * string `targetField`, or a `valueMap` that is not an object.
+ */
+export function readSetFieldValueParams(
+  params: WatchAction["params"],
+): SetFieldValueParams | undefined {
+  if (!params || !("targetField" in params)) return undefined;
+  const { targetField } = params;
+  if (!isString(targetField)) return undefined;
+  const decoded: SetFieldValueParams = { targetField };
+  if ("value" in params && Object.hasOwn(params, "value")) {
+    decoded.value = params.value;
+  }
+  if ("valueMap" in params && params.valueMap) {
+    const { valueMap } = params;
+    if (!isObject(valueMap)) return undefined;
+    decoded.valueMap = valueMap;
+  }
+  return decoded;
 }
 
 /** The payload of a form's `FieldChange` event. */
@@ -38,10 +91,8 @@ export function resolveFieldValueWrite(
   if (payload?.initial) return undefined;
   if (params.valueMap) {
     const key = payload?.value;
-    if (!isMapKey(key) || !Object.hasOwn(params.valueMap, String(key))) {
-      return undefined;
-    }
-    return { value: params.valueMap[String(key)] };
+    if (!isMapKey(key)) return undefined;
+    return ownMember(params.valueMap, String(key));
   }
   if (!Object.hasOwn(params, "value")) return undefined;
   return { value: params.value };

package/frontend-vue/layers/dms-ui/app/build/composables/form/registerFormFunctions.ts

@@ -1,6 +1,7 @@
 import {
   type FieldChangePayload,
-  type SetFieldValueParams,
+  readFieldFlagParams,
+  readSetFieldValueParams,
   resolveFieldValueWrite,
 } from "./fieldValueRule";
 import type { WatchActionFunction } from "#dms-core/app/types/watch";
@@ -13,16 +14,14 @@ function createFieldSetMutator(stateKey: FieldSetStateKey, flagKey: string) {
     _eventData: ComponentEventData,
     componentState: Parameters<WatchActionFunction>[2],
   ) => {
-    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- WatchAction permits absent or arbitrary params; neither inference nor the registration's function type proves targetField, so retain this unchecked action boundary.
-    const params = action.params as NonNullable<WatchAction["params"]> & {
-      targetField: string;
-    };
+    const params = readFieldFlagParams(action.params, flagKey);
+    if (!params) return;
     const current =
       // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- Watch actions can replace these open state entries; preserve the existing unchecked iterable conversion and falsy fallback.
       (componentState.value[stateKey] as Set<string>) || new Set();
     const nextSet = new Set(current);
 
-    if (params[flagKey]) {
+    if (params.flag) {
       nextSet.add(params.targetField);
     } else {
       nextSet.delete(params.targetField);
@@ -37,9 +36,8 @@ function setFieldValue(
   eventData: ComponentEventData,
   componentState: Parameters<WatchActionFunction>[2],
 ) {
-  // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- WatchAction does not correlate the function ID with SetFieldValueParams; deriving the handler type still leaves this unchecked parameter handoff.
-  const params = action.params as NonNullable<WatchAction["params"]> &
-    SetFieldValueParams;
+  const params = readSetFieldValueParams(action.params);
+  if (!params) return;
   const write = resolveFieldValueWrite(
     params,
     // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- Watch actions also receive arbitrary component events; FieldChangePayload's owner does not validate eventData.data, and filtering events would change behavior.

package/frontend-vue/layers/dms-ui/app/entries/composables/form/registerFormFunctions.ts

@@ -0,0 +1 @@
+export * from "../../../build/composables/form/registerFormFunctions";

package/frontend-vue/lazy-plugin.ts

@@ -0,0 +1,18 @@
+import type { DmsAppContext } from "#dms/frontend-module";
+
+type AppContextRunner = Pick<DmsAppContext, "runWithContext">;
+
+/**
+ * A plugin whose file loads on demand. The renderer runs a plugin's setup inside
+ * the app's context, which ends at the first `await`, so the loaded plugin runs
+ * inside it again: a composable that injects (`useToast`, `useDmsState`) would
+ * otherwise warn that `inject()` was called outside `setup()` and get no value.
+ */
+export function lazyPlugin<Context extends AppContextRunner>(
+  load: () => Promise<{ default: (context: Context) => unknown }>,
+): (context: Context) => Promise<void> {
+  return async (context) => {
+    const plugin = await load();
+    await context.runWithContext(() => plugin.default(context));
+  };
+}

package/frontend-vue/package.json

@@ -11,7 +11,7 @@
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.6.5",
   "engines": {
-    "@antelopejs/dms-frontend": ">=0.9.2 <0.10.0"
+    "@antelopejs/dms-frontend": ">=0.10.0 <0.11.0"
   },
   "scripts": {
     "typecheck": "ajs dms verify-source --layer \"$PWD\" --local-package @antelopejs/dms=.. --local-package @antelopejs/interface-dms=../../interface-dms",
@@ -77,7 +77,7 @@
   },
   "devDependencies": {
     "@antelopejs/core": ">=1.16.0 <2",
-    "@antelopejs/dms-frontend": ">=0.9.2 <0.10.0",
+    "@antelopejs/dms-frontend": ">=0.10.0 <0.11.0",
     "@eslint/js": "^8.57.0",
     "@inertiajs/vue3": "^3.7.0",
     "@nuxt/ui": "4.10.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms",
-  "version": "0.15.1",
+  "version": "0.16.1",
   "description": "AntelopeJS DMS. Plug in your PostgreSQL, MongoDB or RethinkDB database and your coding agent builds a back office and analytics dashboard as typed TypeScript. Real-time updates on the data the DMS manages.",
   "keywords": [
     "antelopejs",
@@ -38,9 +38,11 @@
   "dmsFrontend": "dist/frontend-module.js",
   "files": [
     "bin",
+    "!bin/tsconfig.json",
     "dist",
     "!dist/.tsbuildinfo",
     "!dist/test",
+    "checks",
     "frontend-vue",
     "!frontend-vue/tests",
     "!frontend-vue/vitest.config.ts",
@@ -69,13 +71,13 @@
   },
   "dependencies": {
     "2fa": "^0.1.2",
-    "@antelopejs/interface-api": ">=0.0.15 <1.0.0",
-    "@antelopejs/interface-api-util": ">=0.1.3 <1.0.0",
-    "@antelopejs/interface-core": ">=0.2.6 <1.0.0",
-    "@antelopejs/interface-data-api": ">=0.5.0 <1.0.0",
-    "@antelopejs/interface-database": ">=0.1.11 <1.0.0",
-    "@antelopejs/interface-database-decorators": ">=0.1.12 <1.0.0",
-    "@antelopejs/interface-dms": ">=0.10.4 <0.11.0",
+    "@antelopejs/interface-api": ">=0.2.0 <1.0.0",
+    "@antelopejs/interface-api-util": ">=0.3.0 <1.0.0",
+    "@antelopejs/interface-core": ">=0.4.0 <1.0.0",
+    "@antelopejs/interface-data-api": ">=0.6.0 <1.0.0",
+    "@antelopejs/interface-database": ">=0.3.0 <1.0.0",
+    "@antelopejs/interface-database-decorators": ">=0.2.0 <1.0.0",
+    "@antelopejs/interface-dms": ">=0.12.0 <0.13.0",
     "@antelopejs/interface-email": ">=0.0.6 <1.0.0",
     "@antelopejs/interface-file-storage": ">=0.1.4 <1.0.0",
     "archiver": "^7.0.1",
@@ -92,7 +94,7 @@
   },
   "devDependencies": {
     "@antelopejs/core": ">=1.17.0 <2",
-    "@antelopejs/tooling-configs": "0.2.0",
+    "@antelopejs/tooling-configs": "0.2.18",
     "@types/archiver": "^6.0.4",
     "@types/chai": "^4.3.20",
     "@types/jsonwebtoken": "^9.0.10",
@@ -115,7 +117,8 @@
     "rimraf": "^6.1.3",
     "tsc-alias": "^1.9.1",
     "typescript": "^6.0.3",
-    "vue": "^3.5.18"
+    "vue": "^3.5.18",
+    "@antelopejs/api": "^1.7.0"
   },
   "exports": {
     ".": {
@@ -123,7 +126,10 @@
       "default": "./dist/index.js"
     },
     "./package.json": "./package.json",
-    "./checks/api-error-presentation": "./frontend-vue/scripts/check-api-error-presentation.mjs",
+    "./checks/api-error-presentation": {
+      "types": "./checks/api-error-presentation.d.mts",
+      "default": "./frontend-vue/scripts/check-api-error-presentation.mjs"
+    },
     "./interfaces/*": null
   },
   "publishConfig": {
@@ -132,7 +138,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "optionalDependencies": {
-    "@antelopejs/interface-dms-automation": ">=0.4.0 <1.0.0",
+    "@antelopejs/interface-dms-automation": ">=0.6.0 <1.0.0",
     "@antelopejs/interface-redis": ">=0.0.9 <1.0.0"
   },
   "peerDependencies": {
@@ -151,7 +157,7 @@
     "frontend:start": "pnpm --dir playground frontend:start",
     "typecheck": "node scripts/unless-prebuilt.mjs pnpm --filter @antelopejs/interface-dms build && tsc --noEmit",
     "test": "node scripts/unless-prebuilt.mjs pnpm run build && NODE_OPTIONS=\"${NODE_OPTIONS:+$NODE_OPTIONS }--require=\\\"$PWD/scripts/backend-runtime-boundaries.cjs\\\"\" ajs module test .",
-    "test:unit": "node scripts/unless-prebuilt.mjs pnpm run build && node scripts/backend-checks.cjs && DMS_TEST_DIR=dist/test/unit NODE_OPTIONS=\"${NODE_OPTIONS:+$NODE_OPTIONS }--require=\\\"$PWD/scripts/backend-runtime-boundaries.cjs\\\"\" ajs module test .",
+    "test:unit": "node scripts/unless-prebuilt.mjs pnpm run build && node scripts/backend-checks.cjs && node scripts/backend-checks.test.mjs && node scripts/docs-scripts.test.mjs && node scripts/json-record.test.mjs && DMS_TEST_DIR=dist/test/unit NODE_OPTIONS=\"${NODE_OPTIONS:+$NODE_OPTIONS }--require=\\\"$PWD/scripts/backend-runtime-boundaries.cjs\\\"\" ajs module test .",
     "test:integration": "node scripts/unless-prebuilt.mjs pnpm run build && DMS_TEST_DIR=dist/test/integration NODE_OPTIONS=\"${NODE_OPTIONS:+$NODE_OPTIONS }--require=\\\"$PWD/scripts/backend-runtime-boundaries.cjs\\\"\" 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",

package/skills/dms-project/SKILL.md

@@ -18,10 +18,11 @@ the **ajs-cli** skill; full walkthrough: `docs/02.building/01.project-setup.md`.
 ## Starting a new application
 
 Use [template-dms-demo](https://github.com/AntelopeJS/template-dms-demo) for the default
-CLI-owned backend and Nuxt dashboard. Follow `docs/01.getting-started/03.quickstart.md`
-through first-admin setup before adding pages. Use
+CLI-owned backend and Nuxt dashboard: `npx @antelopejs/core project init <dir> --template dms-demo` (needs Git on `PATH`).
+Follow `docs/01.getting-started/03.quickstart.md` through first-admin setup (the onboarding
+address with the setup token that the backend prints) before adding pages. Use
 [template-dms-adonis](https://github.com/AntelopeJS/template-dms-adonis) only when
-AdonisJS must own the process (**embedded** mode, below; walkthrough:
+AdonisJS must own the process (`--template dms-adonis`; **embedded** mode, below; walkthrough:
 `docs/01.getting-started/07.adonisjs.md`). Evaluate these existing templates before proposing another.
 
 Preserve the package names declared by the template. Both templates ship `.claude/settings.json`, which makes Claude Code offer the