@object-ui/app-shell 11.2.0 → 11.4.0

package/dist/views/studio-design/metadataError.d.ts

@@ -0,0 +1,23 @@
+import type { MetadataValidationIssue } from '@object-ui/data-objectstack';
+/** Pull structured validation issues off a caught error (empty if none). */
+export declare function extractIssues(e: unknown): MetadataValidationIssue[];
+/**
+ * Format a caught save/publish error for a banner/toast. When the error carries
+ * spec-validation issues, list them (one field per line) so the user sees the
+ * offending fields; otherwise fall back to the plain message. Rendered with
+ * `whitespace-pre-line` so the lines show as a list.
+ */
+export declare function formatMetadataError(e: unknown): string;
+/** A single failed draft from a publish response's `data.failed[]`. */
+export interface PublishFailure {
+    type: string;
+    name: string;
+    error: string;
+    issues?: MetadataValidationIssue[];
+}
+/**
+ * Format the `failed[]` from a partial publish (the server returns 200 with the
+ * drafts that DIDN'T go live). Each failed draft gets a heading and, when the
+ * failure was a validation error, its field-anchored issues indented below.
+ */
+export declare function formatPublishFailures(failed: PublishFailure[]): string;

package/dist/views/studio-design/metadataError.js

@@ -0,0 +1,44 @@
+// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.
+//
+// Turn a metadata save/publish failure into a FIELD-ANCHORED message. The
+// framework validates a draft against its spec and returns structured issues
+// (`error.details.issues: [{ path, message }]`, surfaced on `MetadataError.issues`
+// by the client); a publish carries per-draft failures in `data.failed[]`. These
+// helpers render "which field, and why" instead of a single opaque banner line —
+// the point of surfacing validation at the save/publish moment.
+/** Pull structured validation issues off a caught error (empty if none). */
+export function extractIssues(e) {
+    const issues = e?.issues;
+    return Array.isArray(issues) ? issues : [];
+}
+/** One issue → a single field-anchored line: `• fields.amount.type — Required`. */
+function issueLine(i) {
+    return `• ${i.path && i.path.length > 0 ? i.path : '(root)'} — ${i.message}`;
+}
+/**
+ * Format a caught save/publish error for a banner/toast. When the error carries
+ * spec-validation issues, list them (one field per line) so the user sees the
+ * offending fields; otherwise fall back to the plain message. Rendered with
+ * `whitespace-pre-line` so the lines show as a list.
+ */
+export function formatMetadataError(e) {
+    const issues = extractIssues(e);
+    if (issues.length > 0)
+        return issues.map(issueLine).join('\n');
+    const err = e;
+    return err?.message ?? String(e);
+}
+/**
+ * Format the `failed[]` from a partial publish (the server returns 200 with the
+ * drafts that DIDN'T go live). Each failed draft gets a heading and, when the
+ * failure was a validation error, its field-anchored issues indented below.
+ */
+export function formatPublishFailures(failed) {
+    return failed
+        .map((f) => {
+        const head = `${f.type}/${f.name}: ${f.error}`;
+        const issues = Array.isArray(f.issues) ? f.issues : [];
+        return [head, ...issues.map((i) => `  ${issueLine(i)}`)].join('\n');
+    })
+        .join('\n');
+}

package/dist/views/studio-design/packages-io.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Package-list helpers shared by the Studio package switcher and the builder
+ * landing page.
+ *
+ * Writability is a DISPLAY heuristic — kernel packages (scope system/cloud)
+ * are hidden, `scope: 'project'` marks a read-only code package (authoring is
+ * refused server-side by the ADR-0070 D4 gate), and a scope-less entry is a
+ * database base package (writable). The gate stays the authority; this only
+ * sets expectations up front.
+ */
+export interface PkgEntry {
+    id: string;
+    name: string;
+    writable: boolean;
+}
+export declare function parsePackages(payload: unknown): PkgEntry[];
+export declare function fetchPackages(): Promise<PkgEntry[]>;
+/** Create a writable base package (POST /packages {id, name}). */
+export declare function createBasePackage(id: string, name: string): Promise<void>;
+/**
+ * Duplicate a package into a NEW writable base (ADR-0070 D4 — the Airtable
+ * "duplicate base" gesture; POST /packages/:id/duplicate). This is how a
+ * read-only code package becomes a customizable starting point: objects are
+ * re-namespaced and intra-package references rewritten server-side.
+ */
+export declare function duplicatePackage(sourceId: string, targetId: string, targetName?: string): Promise<void>;
+export declare const PACKAGE_ID_RE: RegExp;

package/dist/views/studio-design/packages-io.js

@@ -0,0 +1,61 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+export function parsePackages(payload) {
+    const root = payload?.data ?? payload;
+    const raw = Array.isArray(root) ? root : (root?.packages ?? []);
+    const out = [];
+    for (const p of raw) {
+        if (!p || typeof p !== 'object')
+            continue;
+        const m = (p.manifest ?? {});
+        const id = String(m.id ?? p.id ?? '');
+        if (!id)
+            continue;
+        const scope = typeof m.scope === 'string' ? m.scope : '';
+        if (scope === 'system' || scope === 'cloud')
+            continue; // kernel — not app packages
+        out.push({ id, name: String(m.name ?? id), writable: scope !== 'project' });
+    }
+    return out;
+}
+export async function fetchPackages() {
+    const res = await fetch('/api/v1/packages', {
+        credentials: 'include',
+        headers: { Accept: 'application/json' },
+        cache: 'no-store',
+    });
+    if (!res.ok)
+        throw new Error(`HTTP ${res.status}`);
+    return parsePackages(await res.json());
+}
+/** Create a writable base package (POST /packages {id, name}). */
+export async function createBasePackage(id, name) {
+    const res = await fetch('/api/v1/packages', {
+        method: 'POST',
+        credentials: 'include',
+        headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+        body: JSON.stringify({ id, name }),
+    });
+    const payload = (await res.json().catch(() => null));
+    if (!res.ok || payload?.success === false) {
+        throw new Error(payload?.error?.message || `HTTP ${res.status}`);
+    }
+}
+/**
+ * Duplicate a package into a NEW writable base (ADR-0070 D4 — the Airtable
+ * "duplicate base" gesture; POST /packages/:id/duplicate). This is how a
+ * read-only code package becomes a customizable starting point: objects are
+ * re-namespaced and intra-package references rewritten server-side.
+ */
+export async function duplicatePackage(sourceId, targetId, targetName) {
+    const res = await fetch(`/api/v1/packages/${encodeURIComponent(sourceId)}/duplicate`, {
+        method: 'POST',
+        credentials: 'include',
+        headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+        body: JSON.stringify({ targetPackageId: targetId, ...(targetName ? { targetName } : {}) }),
+    });
+    const payload = (await res.json().catch(() => null));
+    if (!res.ok || payload?.success === false) {
+        throw new Error(payload?.error?.message || `HTTP ${res.status}`);
+    }
+}
+export const PACKAGE_ID_RE = /^[a-z][a-z0-9_.-]*(\.[a-z0-9_-]+)+$/;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/app-shell",
-  "version": "11.2.0",
+  "version": "11.4.0",
   "type": "module",
   "license": "MIT",
   "description": "Minimal application shell for ObjectUI - framework-agnostic rendering engine",
@@ -25,47 +25,50 @@
     "./styles.css": "./src/styles.css"
   },
   "dependencies": {
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
     "@monaco-editor/react": "^4.7.0",
-    "@objectstack/spec": "^11.0.0",
-    "@sentry/react": "^10.59.0",
+    "@objectstack/spec": "^11.7.0",
+    "@sentry/react": "^10.62.0",
     "jsonc-parser": "^3.3.1",
-    "lucide-react": "^1.21.0",
+    "lucide-react": "^1.22.0",
     "qrcode": "^1.5.4",
     "sonner": "^2.0.7",
     "zod": "^4.4.3",
-    "@object-ui/auth": "11.2.0",
-    "@object-ui/collaboration": "11.2.0",
-    "@object-ui/components": "11.2.0",
-    "@object-ui/core": "11.2.0",
-    "@object-ui/data-objectstack": "11.2.0",
-    "@object-ui/fields": "11.2.0",
-    "@object-ui/i18n": "11.2.0",
-    "@object-ui/layout": "11.2.0",
-    "@object-ui/permissions": "11.2.0",
-    "@object-ui/plugin-editor": "11.2.0",
-    "@object-ui/providers": "11.2.0",
-    "@object-ui/react": "11.2.0",
-    "@object-ui/types": "11.2.0"
+    "@object-ui/auth": "11.4.0",
+    "@object-ui/collaboration": "11.4.0",
+    "@object-ui/components": "11.4.0",
+    "@object-ui/core": "11.4.0",
+    "@object-ui/data-objectstack": "11.4.0",
+    "@object-ui/fields": "11.4.0",
+    "@object-ui/i18n": "11.4.0",
+    "@object-ui/layout": "11.4.0",
+    "@object-ui/permissions": "11.4.0",
+    "@object-ui/plugin-editor": "11.4.0",
+    "@object-ui/providers": "11.4.0",
+    "@object-ui/react": "11.4.0",
+    "@object-ui/types": "11.4.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "react-router-dom": "^6.0.0 || ^7.0.0",
-    "@object-ui/plugin-calendar": "^11.2.0",
-    "@object-ui/plugin-charts": "^11.2.0",
-    "@object-ui/plugin-chatbot": "^11.2.0",
-    "@object-ui/plugin-dashboard": "^11.2.0",
-    "@object-ui/plugin-designer": "^11.2.0",
-    "@object-ui/plugin-detail": "^11.2.0",
-    "@object-ui/plugin-form": "^11.2.0",
-    "@object-ui/plugin-grid": "^11.2.0",
-    "@object-ui/plugin-kanban": "^11.2.0",
-    "@object-ui/plugin-list": "^11.2.0",
-    "@object-ui/plugin-report": "^11.2.0",
-    "@object-ui/plugin-view": "^11.2.0"
+    "@object-ui/plugin-calendar": "^11.4.0",
+    "@object-ui/plugin-charts": "^11.4.0",
+    "@object-ui/plugin-chatbot": "^11.4.0",
+    "@object-ui/plugin-dashboard": "^11.4.0",
+    "@object-ui/plugin-designer": "^11.4.0",
+    "@object-ui/plugin-detail": "^11.4.0",
+    "@object-ui/plugin-form": "^11.4.0",
+    "@object-ui/plugin-grid": "^11.4.0",
+    "@object-ui/plugin-kanban": "^11.4.0",
+    "@object-ui/plugin-list": "^11.4.0",
+    "@object-ui/plugin-report": "^11.4.0",
+    "@object-ui/plugin-view": "^11.4.0"
   },
   "devDependencies": {
-    "@types/node": "^26.0.0",
+    "@types/node": "^26.0.1",
     "@types/qrcode": "^1.5.6",
     "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
@@ -74,19 +77,19 @@
     "react-router-dom": "^7.18.0",
     "sonner": "^2.0.7",
     "typescript": "^6.0.3",
-    "vite": "^8.0.16",
-    "@object-ui/plugin-calendar": "11.2.0",
-    "@object-ui/plugin-charts": "11.2.0",
-    "@object-ui/plugin-chatbot": "11.2.0",
-    "@object-ui/plugin-dashboard": "11.2.0",
-    "@object-ui/plugin-designer": "11.2.0",
-    "@object-ui/plugin-detail": "11.2.0",
-    "@object-ui/plugin-form": "11.2.0",
-    "@object-ui/plugin-grid": "11.2.0",
-    "@object-ui/plugin-kanban": "11.2.0",
-    "@object-ui/plugin-list": "11.2.0",
-    "@object-ui/plugin-report": "11.2.0",
-    "@object-ui/plugin-view": "11.2.0"
+    "vite": "^8.1.0",
+    "@object-ui/plugin-calendar": "11.4.0",
+    "@object-ui/plugin-charts": "11.4.0",
+    "@object-ui/plugin-chatbot": "11.4.0",
+    "@object-ui/plugin-dashboard": "11.4.0",
+    "@object-ui/plugin-designer": "11.4.0",
+    "@object-ui/plugin-detail": "11.4.0",
+    "@object-ui/plugin-form": "11.4.0",
+    "@object-ui/plugin-grid": "11.4.0",
+    "@object-ui/plugin-kanban": "11.4.0",
+    "@object-ui/plugin-list": "11.4.0",
+    "@object-ui/plugin-report": "11.4.0",
+    "@object-ui/plugin-view": "11.4.0"
   },
   "keywords": [
     "objectui",