@almadar/ui 6.52.0 → 6.53.0

package/locales/ar.json

@@ -110,6 +110,7 @@
   "aria.removeFilter": "إزالة الفلتر",
   "aria.closeDrawer": "إغلاق اللوحة",
   "aria.closePanel": "إغلاق اللوحة",
+  "aria.dockPanel": "اللوحة الجانبية",
   "aria.previousImage": "الصورة السابقة",
   "aria.nextImage": "الصورة التالية",
   "aria.dismiss": "تجاهل",
@@ -131,6 +132,7 @@
   "aria.openMenu": "فتح القائمة",
   "aria.closeMenu": "إغلاق القائمة",
   "aria.openSidebar": "فتح الشريط الجانبي",
+  "aria.openRow": "فتح العنصر {{position}}",
   "sidebar.expand": "توسيع الشريط الجانبي",
   "sidebar.collapse": "طي الشريط الجانبي",
   "sidebar.close": "إغلاق الشريط الجانبي",
@@ -1180,5 +1182,49 @@
   "aria.walkTraitDone": "مكتمل",
   "aria.walkTraitPending": "قيد الانتظار",
   "aria.walkGraph": "مخطط الحالات لـ {{trait}}: من {{from}} إلى {{to}}",
-  "aria.loading": "جارٍ التحميل"
+  "aria.loading": "جارٍ التحميل",
+  "agentActivity.toolCall": "استدعاء {{tool}}",
+  "agentActivity.toolResult": "نتيجة {{tool}}",
+  "agentActivity.toolRows": "{{count}} صفوف",
+  "agentActivity.thinking": "جارٍ التفكير…",
+  "agentActivity.analyzed": "تم تحليل طلبك — {{organism}}",
+  "agentActivity.renamed": "إعادة تسمية {{from}} ← {{to}}",
+  "agentActivity.deleted": "إزالة {{orbitalName}}",
+  "agentActivity.roster": "تخطيط {{count}} من الوحدات",
+  "agentActivity.orbitalStarted": "جارٍ العمل على {{orbitalName}}…",
+  "agentActivity.orbitalStartedSettled": "بدأ العمل على {{orbitalName}}",
+  "agentActivity.orbitalDone": "{{orbitalName}} جاهز",
+  "agentActivity.orbitalCounts": "{{traitCount}} سمات، {{transitionCount}} انتقالات",
+  "agentActivity.change.orbital-added": "تمت إضافة {{orbitalName}}",
+  "agentActivity.change.orbital-removed": "تمت إزالة {{orbitalName}}",
+  "agentActivity.change.entity-fields-changed": "تم تغيير حقول بيانات {{orbitalName}}",
+  "agentActivity.change.trait-added": "تمت إضافة سلوك إلى {{orbitalName}}",
+  "agentActivity.change.trait-removed": "تمت إزالة سلوك من {{orbitalName}}",
+  "agentActivity.change.state-machine-changed": "تم تغيير تدفق {{orbitalName}}",
+  "agentActivity.change.guard-changed": "تم تغيير قاعدة في {{orbitalName}}",
+  "agentActivity.change.effect-changed": "تم تغيير ما يفعله {{orbitalName}}",
+  "agentActivity.change.render-ui-changed": "تم تغيير تصميم {{orbitalName}}",
+  "agentActivity.change.event-wiring-changed": "تم تغيير اتصالات {{orbitalName}}",
+  "agentActivity.change.page-changed": "تم تغيير صفحات {{orbitalName}}",
+  "agentActivity.change.behavior-composed": "تم دمج سلوك في {{orbitalName}}",
+  "agentActivity.done": "تم — {{count}} من الوحدات جاهزة",
+  "agentActivity.cancelled": "تم الإلغاء",
+  "agentActivity.jump": "عرض",
+  "agentActivity.emptyTitle": "لا يوجد نشاط بعد",
+  "agentActivity.emptyDescription": "أرسل رسالة وسيظهر عمل الوكيل هنا.",
+  "agentActivity.fileOperation": "{{operation}}",
+  "agentActivity.schemaDiff": "تم تعديل {{filePath}}",
+  "agentActivity.coordinatorDecision": "تم اختيار {{organism}}",
+  "agentActivity.change.trait-config-changed": "تم تغيير إعدادات {{orbitalName}}",
+  "agentActivity.change.theme-changed": "تم تغيير سمة {{orbitalName}}",
+  "agentActivity.llmResponse": "استجابة LLM خام",
+  "agentActivity.llmDuration": "{{seconds}} ث",
+  "agentActivity.llmTokens": "{{prompt}} داخل / {{completion}} خارج",
+  "agentActivity.llmResponseLabel": "الاستجابة",
+  "agentActivity.llmSystemPrompt": "موجّه النظام",
+  "agentActivity.llmUserPrompt": "موجّه المستخدم",
+  "agentActivity.llmToolCalls": "استدعاءات الأدوات",
+  "agentActivity.showRawLlm": "LLM خام",
+  "agentActivity.earlierConversations": "المحادثات السابقة ({{count}})",
+  "agentActivity.earlierActivity": "نشاط سابق"
 }

package/locales/en.json

@@ -114,6 +114,7 @@
   "aria.removeFilter": "Remove filter",
   "aria.closeDrawer": "Close drawer",
   "aria.closePanel": "Close panel",
+  "aria.dockPanel": "Side panel",
   "aria.previousImage": "Previous image",
   "aria.nextImage": "Next image",
   "aria.dismiss": "Dismiss",
@@ -135,6 +136,7 @@
   "aria.openMenu": "Open menu",
   "aria.closeMenu": "Close menu",
   "aria.openSidebar": "Open sidebar",
+  "aria.openRow": "Open item {{position}}",
   "sidebar.expand": "Expand sidebar",
   "sidebar.collapse": "Collapse sidebar",
   "sidebar.close": "Close sidebar",
@@ -1180,5 +1182,49 @@
   "aria.walkTraitDone": "completed",
   "aria.walkTraitPending": "pending",
   "aria.walkGraph": "State graph for {{trait}}: {{from}} to {{to}}",
-  "aria.loading": "Loading"
+  "aria.loading": "Loading",
+  "agentActivity.toolCall": "Called {{tool}}",
+  "agentActivity.toolResult": "{{tool}} returned",
+  "agentActivity.toolRows": "{{count}} rows",
+  "agentActivity.thinking": "Thinking…",
+  "agentActivity.analyzed": "Analyzed your request — {{organism}}",
+  "agentActivity.renamed": "Rename {{from}} → {{to}}",
+  "agentActivity.deleted": "Remove {{orbitalName}}",
+  "agentActivity.roster": "Planning {{count}} orbitals",
+  "agentActivity.orbitalStarted": "Working on {{orbitalName}}…",
+  "agentActivity.orbitalStartedSettled": "Started {{orbitalName}}",
+  "agentActivity.orbitalDone": "{{orbitalName}} ready",
+  "agentActivity.orbitalCounts": "{{traitCount}} traits, {{transitionCount}} transitions",
+  "agentActivity.change.orbital-added": "Added {{orbitalName}}",
+  "agentActivity.change.orbital-removed": "Removed {{orbitalName}}",
+  "agentActivity.change.entity-fields-changed": "Changed the data fields of {{orbitalName}}",
+  "agentActivity.change.trait-added": "Added a behavior to {{orbitalName}}",
+  "agentActivity.change.trait-removed": "Removed a behavior from {{orbitalName}}",
+  "agentActivity.change.state-machine-changed": "Changed the flow of {{orbitalName}}",
+  "agentActivity.change.guard-changed": "Changed a rule in {{orbitalName}}",
+  "agentActivity.change.effect-changed": "Changed what {{orbitalName}} does",
+  "agentActivity.change.render-ui-changed": "Changed the design of {{orbitalName}}",
+  "agentActivity.change.event-wiring-changed": "Changed the connections of {{orbitalName}}",
+  "agentActivity.change.page-changed": "Changed the pages of {{orbitalName}}",
+  "agentActivity.change.behavior-composed": "Composed a behavior into {{orbitalName}}",
+  "agentActivity.done": "Done — {{count}} orbitals ready",
+  "agentActivity.cancelled": "Cancelled",
+  "agentActivity.jump": "Show",
+  "agentActivity.emptyTitle": "No activity yet",
+  "agentActivity.emptyDescription": "Send a message and the agent's work shows up here.",
+  "agentActivity.fileOperation": "{{operation}}",
+  "agentActivity.schemaDiff": "Edited {{filePath}}",
+  "agentActivity.coordinatorDecision": "Chose {{organism}}",
+  "agentActivity.change.trait-config-changed": "Changed the settings of {{orbitalName}}",
+  "agentActivity.change.theme-changed": "Changed the theme of {{orbitalName}}",
+  "agentActivity.llmResponse": "Raw LLM response",
+  "agentActivity.llmDuration": "{{seconds}}s",
+  "agentActivity.llmTokens": "{{prompt}} in / {{completion}} out tokens",
+  "agentActivity.llmResponseLabel": "Response",
+  "agentActivity.llmSystemPrompt": "System prompt",
+  "agentActivity.llmUserPrompt": "User prompt",
+  "agentActivity.llmToolCalls": "Tool calls",
+  "agentActivity.showRawLlm": "Raw LLM",
+  "agentActivity.earlierConversations": "Earlier conversations ({{count}})",
+  "agentActivity.earlierActivity": "Earlier activity"
 }

package/locales/sl.json

@@ -110,6 +110,7 @@
   "aria.removeFilter": "Odstrani filter",
   "aria.closeDrawer": "Zapri predal",
   "aria.closePanel": "Zapri ploščo",
+  "aria.dockPanel": "Stranska plošča",
   "aria.previousImage": "Prejšnja slika",
   "aria.nextImage": "Naslednja slika",
   "aria.dismiss": "Opusti",
@@ -131,6 +132,7 @@
   "aria.openMenu": "Odpri meni",
   "aria.closeMenu": "Zapri meni",
   "aria.openSidebar": "Odpri stransko vrstico",
+  "aria.openRow": "Odpri element {{position}}",
   "sidebar.expand": "Razširi stransko vrstico",
   "sidebar.collapse": "Strni stransko vrstico",
   "sidebar.close": "Zapri stransko vrstico",
@@ -1180,5 +1182,49 @@
   "aria.walkTraitDone": "končano",
   "aria.walkTraitPending": "čaka",
   "aria.walkGraph": "Graf stanj za {{trait}}: od {{from}} do {{to}}",
-  "aria.loading": "Nalaganje"
+  "aria.loading": "Nalaganje",
+  "agentActivity.toolCall": "Klic {{tool}}",
+  "agentActivity.toolResult": "{{tool}} je vrnil",
+  "agentActivity.toolRows": "Vrstic: {{count}}",
+  "agentActivity.thinking": "Razmišljam…",
+  "agentActivity.analyzed": "Zahteva analizirana — {{organism}}",
+  "agentActivity.renamed": "Preimenuj {{from}} → {{to}}",
+  "agentActivity.deleted": "Odstrani {{orbitalName}}",
+  "agentActivity.roster": "Načrtovanje {{count}} orbital",
+  "agentActivity.orbitalStarted": "Delo na {{orbitalName}}…",
+  "agentActivity.orbitalStartedSettled": "Začeto: {{orbitalName}}",
+  "agentActivity.orbitalDone": "{{orbitalName}} pripravljen",
+  "agentActivity.orbitalCounts": "{{traitCount}} lastnosti, {{transitionCount}} prehodov",
+  "agentActivity.change.orbital-added": "Dodan {{orbitalName}}",
+  "agentActivity.change.orbital-removed": "Odstranjen {{orbitalName}}",
+  "agentActivity.change.entity-fields-changed": "Spremenjena podatkovna polja {{orbitalName}}",
+  "agentActivity.change.trait-added": "Dodano vedenje v {{orbitalName}}",
+  "agentActivity.change.trait-removed": "Odstranjeno vedenje iz {{orbitalName}}",
+  "agentActivity.change.state-machine-changed": "Spremenjen tok {{orbitalName}}",
+  "agentActivity.change.guard-changed": "Spremenjeno pravilo v {{orbitalName}}",
+  "agentActivity.change.effect-changed": "Spremenjeno delovanje {{orbitalName}}",
+  "agentActivity.change.render-ui-changed": "Spremenjen videz {{orbitalName}}",
+  "agentActivity.change.event-wiring-changed": "Spremenjene povezave {{orbitalName}}",
+  "agentActivity.change.page-changed": "Spremenjene strani {{orbitalName}}",
+  "agentActivity.change.behavior-composed": "Vedenje vgrajeno v {{orbitalName}}",
+  "agentActivity.done": "Končano — {{count}} orbital pripravljenih",
+  "agentActivity.cancelled": "Preklicano",
+  "agentActivity.jump": "Pokaži",
+  "agentActivity.emptyTitle": "Še ni dejavnosti",
+  "agentActivity.emptyDescription": "Pošljite sporočilo in tukaj se bo prikazalo delo agenta.",
+  "agentActivity.fileOperation": "{{operation}}",
+  "agentActivity.schemaDiff": "Urejeno {{filePath}}",
+  "agentActivity.coordinatorDecision": "Izbrano {{organism}}",
+  "agentActivity.change.trait-config-changed": "Spremenjene nastavitve {{orbitalName}}",
+  "agentActivity.change.theme-changed": "Spremenjena tema {{orbitalName}}",
+  "agentActivity.llmResponse": "Surov odgovor LLM",
+  "agentActivity.llmDuration": "{{seconds}} s",
+  "agentActivity.llmTokens": "{{prompt}} vhodnih / {{completion}} izhodnih žetonov",
+  "agentActivity.llmResponseLabel": "Odgovor",
+  "agentActivity.llmSystemPrompt": "Sistemski poziv",
+  "agentActivity.llmUserPrompt": "Uporabniški poziv",
+  "agentActivity.llmToolCalls": "Klici orodij",
+  "agentActivity.showRawLlm": "Surovi LLM",
+  "agentActivity.earlierConversations": "Prejšnji pogovori ({{count}})",
+  "agentActivity.earlierActivity": "Prejšnja dejavnost"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "6.52.0",
+  "version": "6.53.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -126,11 +126,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.114.0",
+    "@almadar/core": "^10.115.0",
     "@almadar/evaluator": "^2.53.0",
     "@almadar/logger": "^1.15.0",
-    "@almadar/runtime": "^6.100.0",
-    "@almadar/std": "^16.238.0",
+    "@almadar/runtime": "^6.101.0",
+    "@almadar/std": "^16.239.0",
     "@almadar/syntax": "^1.19.0",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
@@ -191,7 +191,7 @@
     }
   },
   "devDependencies": {
-    "@almadar-io/behaviors": "^0.16.185",
+    "@almadar-io/behaviors": "^0.16.186",
     "@almadar/eslint-plugin": "^2.21.0",
     "@react-three/drei": "^10.7.7",
     "@react-three/fiber": "^9.6.0",
@@ -255,7 +255,7 @@
   },
   "scripts": {
     "build": "rm -rf dist && NODE_OPTIONS=--max-old-space-size=8192 tsup",
-    "build:dev": "NODE_OPTIONS=--max-old-space-size=8192 UI_SKIP_DTS=1 tsup",
+    "build:dev": "rm -f dist/chunk-* && NODE_OPTIONS=--max-old-space-size=8192 UI_SKIP_DTS=1 tsup",
     "build:watch": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",

package/tailwind-preset.cjs

@@ -856,6 +856,19 @@ module.exports = {
           'backdrop-filter': 'var(--surface-backdrop, none)',
           '-webkit-backdrop-filter': 'var(--surface-backdrop, none)',
         },
+        // Content surface: the box behind a content block (table, calendar, list,
+        // chart …). Every value is a theme hook with a paint-site fallback, so a
+        // [data-theme] subtree's colors apply (never alias these on :root).
+        '.surface-content': {
+          'background-color': 'var(--surface-content-bg, var(--color-card))',
+          'background-image': 'var(--surface-card-image, none)',
+          'backdrop-filter': 'var(--surface-backdrop, none)',
+          '-webkit-backdrop-filter': 'var(--surface-backdrop, none)',
+          'border-width': 'var(--surface-content-border-width, var(--border-width, 1px))',
+          'border-color': 'var(--surface-content-border-color, var(--color-border))',
+          'border-radius': 'var(--surface-content-radius, var(--radius-container, var(--radius-md)))',
+          'box-shadow': 'var(--surface-content-shadow, var(--elevation-card, var(--shadow-sm)))',
+        },
         // Surface material on the page background (app shell / themed root).
         '.surface-page': {
           'background-image': 'var(--surface-page-image, none)',

package/themes/_base.css

@@ -226,6 +226,9 @@
     /* A busy control shows its spinner only once its action outlasts this
      * (under it the action reads as instant — no flash on fast actions). */
     --motion-busy-delay: 300ms;
+    /* An empty slot awaiting its server render shows the compiler-predicted
+     * skeleton (`block`) or nothing (`none`), fading in after the busy delay. */
+    --awaiting-skeleton-display: none;
     --motion-enter-stagger: 40ms;
     --motion-enter-rise-from-transform: translateY(12px);
     --motion-enter-scale-from-transform: scale(0.96);
@@ -233,12 +236,12 @@
     --motion-enter-slide-from-transform: translateX(calc(16px * var(--motion-enter-slide-sign)));
 
     /* ----------------------------------------------------------------
-     * Skeleton shimmer — the loading-placeholder sweep. Two color stops
-     * (base + highlight) drive the gradient; --duration-shimmer the loop.
-     * Override per theme to restyle the placeholder tone.
+     * Skeleton shimmer — the loading-placeholder sweep. A theme may set
+     * --skeleton-base / --skeleton-highlight to restyle the tone; unset, the
+     * shimmer paints the active theme's --color-muted / --color-surface
+     * (resolved at `.almadar-shimmer`, not here — a :root alias would freeze
+     * the root theme's colors for every [data-theme] subtree).
      * ---------------------------------------------------------------- */
-    --skeleton-base: var(--color-muted, rgba(128, 128, 128, 0.18));
-    --skeleton-highlight: var(--color-surface, rgba(255, 255, 255, 0.55));
     --duration-shimmer: 1.5s;
 }
 
@@ -284,6 +287,13 @@
     animation: almadar-row-pending var(--duration-fast, 150ms) var(--easing-standard, ease) var(--motion-busy-delay, 300ms) forwards;
 }
 
+/* Awaiting-server skeleton: theme-switched, appears only once the round trip outlasts --motion-busy-delay. */
+.almadar-awaiting-skeleton {
+    display: var(--awaiting-skeleton-display, none);
+    opacity: 0;
+    animation: almadar-busy-show var(--duration-fast, 150ms) var(--easing-standard, ease) var(--motion-busy-delay, 300ms) forwards;
+}
+
 /* Slot content: plays the theme's default entry (restarted when the content changes). */
 .almadar-enter-slot {
     animation-name: var(--motion-enter-default, none);
@@ -316,9 +326,9 @@
 .almadar-shimmer {
     background-image: linear-gradient(
         90deg,
-        var(--skeleton-base) 0%,
-        var(--skeleton-highlight) 50%,
-        var(--skeleton-base) 100%
+        var(--skeleton-base, var(--color-muted)) 0%,
+        var(--skeleton-highlight, var(--color-surface)) 50%,
+        var(--skeleton-base, var(--color-muted)) 100%
     );
     background-size: 200% 100%;
     background-repeat: no-repeat;
@@ -341,3 +351,13 @@
         scroll-behavior: auto !important;
     }
 }
+
+/* The `dock` slot (a right panel that pushes the page) sets this inset while open. */
+body {
+    padding-inline-end: var(--almadar-dock-inset, 0px);
+}
+
+/* A `dock` inside a contained preview pushes that preview, not the page. */
+.ui-slot-renderer {
+    padding-inline-end: var(--almadar-dock-contained-inset, 0px);
+}

package/themes/_contract.md

@@ -236,6 +236,11 @@ These separate artistic styles (Art Deco vs Win95 vs wabi-sabi) along dimensions
 | `surface.cardImage` | `--surface-card-image` | `.surface-material`: `background-image` over the card color | `none` |
 | `surface.pageImage` | `--surface-page-image` | `.surface-page` (app shells, themed orbital roots) | `none` |
 | `surface.pageImageSize` | `--surface-page-image-size` | `.surface-page` | `auto` |
+| `surface.contentBg` | `--surface-content-bg` | `.surface-content`: the background behind every content block (table, calendar, list, chart …) and the default `Card` | `--color-card` |
+| `surface.contentBorderWidth` | `--surface-content-border-width` | `.surface-content` | `--border-width` |
+| `surface.contentBorderColor` | `--surface-content-border-color` | `.surface-content` | `--color-border` |
+| `surface.contentRadius` | `--surface-content-radius` | `.surface-content` | `--radius-container` |
+| `surface.contentShadow` | `--surface-content-shadow` | `.surface-content` | `--elevation-card` |
 
 | `motion.shapes.modalEnter` / `modalExit` | `--motion-modal-enter-from-transform` / `--motion-modal-exit-to-transform` | `Modal` (every modal slot: runtime, contained preview, compiled) | `scale(.96) translateY(8px)` / `scale(.92) translateY(16px)` |
 | `motion.shapes.popoverEnter` / `popoverExit` | `--motion-popover-enter-from-transform` / `--motion-popover-exit-to-transform` | `Popover`, menus | `scale(.95)` |

package/dist/Typography-7FRZOS2H.js

@@ -1,5 +0,0 @@
-export { Typography } from './chunk-CLSLVFSP.js';
-import './chunk-IN3BVW2Z.js';
-import './chunk-V5AGW2JN.js';
-import './chunk-WB2A6V3I.js';
-import './chunk-QPXIAUJD.js';

package/dist/{avl-3d-context-DLteNEwu.d.ts → avl-3d-context-MAt_NuU9.d.ts}

@@ -45,12 +45,12 @@ declare const AVL_3D_COLORS: {
     readonly lightAmbient: "var(--color-info)";
     readonly lightDirectional: string;
     readonly lightFill: string;
-    readonly "op:effect": string;
-    readonly "op:collection": string;
-    readonly "op:logic": string;
     readonly "op:control": string;
     readonly "op:arithmetic": string;
     readonly "op:comparison": string;
+    readonly "op:logic": string;
+    readonly "op:effect": string;
+    readonly "op:collection": string;
     readonly "op:std-math": string;
     readonly "op:std-str": string;
     readonly "op:std-array": string;

package/dist/{chunk-IN3BVW2Z.js → chunk-64WACXM7.js}

@@ -1,20 +1,6 @@
 import { clsx } from 'clsx';
 import { extendTailwindMerge } from 'tailwind-merge';
 
-// lib/domPassthrough.ts
-var GLOBAL_ATTRIBUTES = /* @__PURE__ */ new Set(["role", "id", "lang", "dir", "tabIndex"]);
-function domPassthrough(props) {
-  const out = {};
-  for (const [key, value] of Object.entries(props)) {
-    if (key.startsWith("aria-") || key.startsWith("data-") || GLOBAL_ATTRIBUTES.has(key)) {
-      if (typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === void 0) {
-        out[key] = value;
-      }
-    }
-  }
-  return out;
-}
-
 // lib/theme-scale.ts
 var THEME_SCALE_KEYS = {
   height: ["button-sm", "button-md", "button-lg", "input-sm", "input-md", "input-lg", "row-compact", "row-normal", "row-spacious", "icon-default"],
@@ -47,4 +33,18 @@ function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
 
+// lib/domPassthrough.ts
+var GLOBAL_ATTRIBUTES = /* @__PURE__ */ new Set(["role", "id", "lang", "dir", "tabIndex"]);
+function domPassthrough(props) {
+  const out = {};
+  for (const [key, value] of Object.entries(props)) {
+    if (key.startsWith("aria-") || key.startsWith("data-") || GLOBAL_ATTRIBUTES.has(key)) {
+      if (typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === void 0) {
+        out[key] = value;
+      }
+    }
+  }
+  return out;
+}
+
 export { cn, domPassthrough };