@almadar/ui 6.58.0 → 6.61.0

package/dist/components/index.js

@@ -1,23 +1,22 @@
+export { keyChord, mergeCaptureTables, useAgentChat, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useKeyboardRouter, useNavStack, usePreview, useRenderInterpolation, useTraitListens, useUIEvents, useValidation } from '../chunk-EIIQGOZW.js';
 export { assertUniqueSlotsPerHost } from '../chunk-O2EIWXWE.js';
-export { keyChord, mergeCaptureTables, useAgentChat, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useKeyboardRouter, useNavStack, usePreview, useRenderInterpolation, useTraitListens, useUIEvents, useValidation } from '../chunk-MZIDOJMD.js';
-export { I18nProvider, SharedEntityStoreContext, createSharedEntityStore, createTranslate, runTickFrame, useFormatContext, useRenderI18n, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useTranslate } from '../chunk-N7JIG57B.js';
-export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-VHTJRS2N.js';
-import '../chunk-YYYHH5BA.js';
-import { GridPicker, Icon, Button, FormSection, Select, JsonTreeEditor, ThemedPortal, Switch, Input } from '../chunk-I2ZNE5TD.js';
-export { ALL_PRESETS, Accordion, Card2 as ActionCard, ActionPalette, ActionTile, ActivationBlock, AgentActivityFeed, AgentActivityRow, AgentChatFeed, AgentThinkingRow, Alert, AlgoGraphCanvas, AlgorithmCanvas, AnimatedCounter, AnimatedGraphic, AnimatedReveal, Aside, AtlasImage, AtlasPanel, AuthLayout, Avatar, Badge, BehaviorView, BiologyCanvas, BloomQuizBlock, BranchingLogicBuilder, Breadcrumb, Button, ButtonGroup, COMPACT_MEDIA_QUERY, CalendarGrid, Canvas, Canvas2D, Card, CardBody, CardContent, CardFooter, CardHeader, CardTitle, Carousel, Center, ChangeList, Chart, ChartLegend, ChatBar, Checkbox, ChemistryCanvas, ChoiceButton, CodeBlock, CodeRunnerPanel, CollapsibleSection, CommandPalette, CommitRow, ConditionalWrapper, ConfettiEffect, ConfirmDialog, ConnectionBlock, Container, ContentRenderer, ControlButton, ControlGrid, CounterTemplate, DEFAULT_LIKERT_OPTION_KEYS, DEFAULT_MATRIX_COLUMN_KEYS, DIAMOND_TOP_Y, DashboardGrid, DashboardLayout, DataGrid, DataList, DateRangePicker, DateRangeSelector, DayCell, DetailPanel, Dialog, DialogueBubble, Divider, DocBreadcrumb, DocPagination, DocSearch, DocSidebar, DocTOC, DockLayout, DocumentDetails, DocumentPanel, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, ELEMENT_SELECTED_EVENT, EdgeDecoration, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EmojiPicker, EmptyState, ErrorBoundary, ErrorState, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FeatureCard, FeatureGrid, FileTree, FilterGroup, FilterPill, Flex, FlipCard, FlipContainer, FloatingActionButton, FloatingToolbar, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, FxOverlay, GameAudioContext, GameAudioCue, GameAudioProvider, GameAudioToggle, GameHud, GameIcon, GameMenu, GameShell, Gantt, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, GridPicker, Header, HealthBar, Icon, IconButton, Image, ImportPreviewTree, ImportProgress, ImportSourcePicker, InfiniteScrollSentinel, Input, InputGroup, JazariStateMachine, JsonTreeEditor, Label, LawReferenceTooltip, LearningCanvas, LearningScene3D, Lightbox, LikertScale, LineChart, LoadingState, MapView, MarkdownContent, MasterDetailLayout, MathCanvas, MatrixQuestion, MediaGallery, Menu, Meter, Modal, ModalSlot, ModuleCard, Navigation, NumberStepper, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, PageTransition, Pagination, PatternTile, PhysicsCanvas, Popover, PositionedCanvas, ProgressBar, ProgressDots, PullToRefresh, QrScanner, QuizBlock, Radio, RangeSlider, ReflectionBlock, RelationSelect, RepeatableFormSection, ReplyTree, RichTextEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreDisplay, SearchInput, Section, SectionHeader, SegmentRenderer, Select, SequenceBar, SidePanel, Sidebar, SignaturePad, SimpleGrid, Skeleton, SkeletonTree, SlotContentRenderer, SocialProof, SortableList, Spacer, Sparkline, Spinner, Split, SplitPane, StarRating, StatBadge, StatCard, StatDisplay, StateGraph, StateJsonView, StateMachineView, StatusBar, StatusDot, SubagentTracePanel, SvgBranch, SvgConnection, SvgFlow, SvgGrid, SvgLobe, SvgMesh, SvgMorph, SvgNode, SvgPulse, SvgRing, SvgShield, SvgStack, SwipeableRow, Switch, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, TableView, Tabs, TagInput, TerrainPalette, TextHighlight, Textarea, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TopNavItem, TraitFrame, TraitSlot, TraitStateViewer, TrendIndicator, TypewriterText, UISlotComponent, UISlotRenderer, UploadDropZone, VersionDiff, ViolationAlert, VoteStack, WizardContainer, WizardNavigation, WizardProgress, activityRowFacts, applyCompletion, applySuggestions, arrowBetween, billboardLabel, boardEntity, bool, calculateAttackTargets, calculateValidMoves, createInitialGameState, createUnitAnimationState, cylinderBetween, dispatchCommandPaletteCommand, get3DClickPayload, getCurrentFrame, getTileDimensions, groupIntoConversations, inferDirection, isoToScreen, makeAsset, makeAssetMap, meshSphere, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, parseEditFocus, pendulum, projectileMotion, registerCodeLanguageLoader, renderPatternValue, resolveFrame, resolveSheetDirection, rows, sanitizeRichHtml, screenToIso, springOscillator, str, tickAnimationState, toCodeLanguage, transitionAnimation, unitHealth, unitPosition, unitTeam, useAtlasSliceDataUrl, useCamera, useCompactLayout, useDockLayout, useGameAudio, useGameAudioContext, useImageCache, useUnitSpriteAtlas, vec2 } from '../chunk-I2ZNE5TD.js';
-import { VStack, HStack, Box } from '../chunk-HA7CJWQX.js';
-export { Box, HStack, Stack, VStack } from '../chunk-HA7CJWQX.js';
-import { Typography } from '../chunk-4ZGXIW3B.js';
-export { Typography } from '../chunk-4ZGXIW3B.js';
-export { ALMADAR_DND_MIME, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useDraggable, useDropZone, useInfiniteScroll, useLongPress, useMediaQuery, usePrefersReducedMotion, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-I5QOYW2Z.js';
+import { GridPicker, Icon, Button, FormSection, Select, JsonTreeEditor, ThemedPortal, Switch, Input } from '../chunk-6PV4LASE.js';
+export { ALL_PRESETS, Accordion, Card2 as ActionCard, ActionPalette, ActionTile, ActivationBlock, AgentActivityFeed, AgentActivityRow, AgentChatFeed, AgentThinkingRow, Alert, AlgoGraphCanvas, AlgorithmCanvas, AnimatedCounter, AnimatedGraphic, AnimatedReveal, Aside, AtlasImage, AtlasPanel, AuthLayout, Avatar, Badge, BehaviorView, BiologyCanvas, BloomQuizBlock, BranchingLogicBuilder, Breadcrumb, Button, ButtonGroup, COMPACT_MEDIA_QUERY, CalendarGrid, Canvas, Canvas2D, Card, CardBody, CardContent, CardFooter, CardHeader, CardTitle, Carousel, Center, ChangeList, Chart, ChartLegend, ChatBar, Checkbox, ChemistryCanvas, ChoiceButton, CodeBlock, CodeRunnerPanel, CollapsibleSection, CommandPalette, CommitRow, ConditionalWrapper, ConfettiEffect, ConfirmDialog, ConnectionBlock, Container, ContentRenderer, ControlButton, ControlGrid, CounterTemplate, DEFAULT_LIKERT_OPTION_KEYS, DEFAULT_MATRIX_COLUMN_KEYS, DIAMOND_TOP_Y, DashboardGrid, DashboardLayout, DataGrid, DataList, DateRangePicker, DateRangeSelector, DayCell, DetailPanel, Dialog, DialogueBubble, Divider, DocBreadcrumb, DocPagination, DocSearch, DocSidebar, DocTOC, DockLayout, DocumentDetails, DocumentPanel, DocumentViewer, StateMachineView as DomStateMachineVisualizer, DrawShapeLayer, DrawSprite, DrawSpriteLayer, DrawText, DrawTextLayer, Drawer, DrawerSlot, ELEMENT_SELECTED_EVENT, EdgeDecoration, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EmojiPicker, EmptyState, ErrorBoundary, ErrorState, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FeatureCard, FeatureGrid, FileTree, FilterGroup, FilterPill, Flex, FlipCard, FlipContainer, FloatingActionButton, FloatingToolbar, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, FxOverlay, GameAudioContext, GameAudioCue, GameAudioProvider, GameAudioToggle, GameHud, GameIcon, GameMenu, GameShell, Gantt, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, GridPicker, Header, HealthBar, Icon, IconButton, Image, ImportPreviewTree, ImportProgress, ImportSourcePicker, InfiniteScrollSentinel, Input, InputGroup, JazariStateMachine, JsonTreeEditor, Label, LawReferenceTooltip, LearningCanvas, LearningScene3D, Lightbox, LikertScale, LineChart, LoadingState, MapView, MarkdownContent, MasterDetailLayout, MathCanvas, MatrixQuestion, MediaGallery, Menu, Meter, Modal, ModalSlot, ModuleCard, Navigation, NumberStepper, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, PageTransition, Pagination, PatternTile, PhysicsCanvas, Popover, PositionedCanvas, ProgressBar, ProgressDots, PullToRefresh, QrScanner, QuizBlock, Radio, RangeSlider, ReflectionBlock, RelationSelect, RepeatableFormSection, ReplyTree, RichTextEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreDisplay, SearchInput, Section, SectionHeader, SegmentRenderer, Select, SequenceBar, SidePanel, Sidebar, SignaturePad, SimpleGrid, Skeleton, SkeletonTree, SlotContentRenderer, SocialProof, SortableList, Spacer, Sparkline, Spinner, Split, SplitPane, StarRating, StatBadge, StatCard, StatDisplay, StateGraph, StateJsonView, StateMachineView, StatusBar, StatusDot, SubagentTracePanel, SvgBranch, SvgConnection, SvgFlow, SvgGrid, SvgLobe, SvgMesh, SvgMorph, SvgNode, SvgPulse, SvgRing, SvgShield, SvgStack, SwipeableRow, Switch, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, TableView, Tabs, TagInput, TerrainPalette, TextHighlight, Textarea, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TopNavItem, TraitFrame, TraitSlot, TraitStateViewer, TrendIndicator, TypewriterText, UISlotComponent, UISlotRenderer, UploadDropZone, VersionDiff, ViolationAlert, VoteStack, WizardContainer, WizardNavigation, WizardProgress, activityRowFacts, applyCompletion, applySuggestions, arrowBetween, billboardLabel, boardEntity, bool, calculateAttackTargets, calculateValidMoves, createInitialGameState, createUnitAnimationState, cylinderBetween, dispatchCommandPaletteCommand, get3DClickPayload, getCurrentFrame, getTileDimensions, groupIntoConversations, inferDirection, isoToScreen, makeAsset, makeAssetMap, meshSphere, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, parseEditFocus, pendulum, projectileMotion, registerCodeLanguageLoader, renderPatternValue, resolveFrame, resolveSheetDirection, rows, sanitizeRichHtml, screenToIso, springOscillator, str, tickAnimationState, toCodeLanguage, transitionAnimation, unitHealth, unitPosition, unitTeam, useAtlasSliceDataUrl, useCamera, useCompactLayout, useDockLayout, useGameAudio, useGameAudioContext, useImageCache, useUnitSpriteAtlas, vec2 } from '../chunk-6PV4LASE.js';
+import { VStack, HStack, Box } from '../chunk-MGN6B6OQ.js';
+export { Box, DrawFxLayer, DrawGroup, DrawMesh, DrawShape, DrawSkinnedMesh, HStack, Stack, VStack } from '../chunk-MGN6B6OQ.js';
+import { Typography } from '../chunk-KZRAMPM6.js';
+export { Typography } from '../chunk-KZRAMPM6.js';
+export { ALMADAR_DND_MIME, I18nProvider, SharedEntityStoreContext, claimDelivery, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAuthContext, useCanvasGestures, useDragReorder, useDraggable, useDropZone, useFormatContext, useInfiniteScroll, useLongPress, useMediaQuery, usePageHead, usePrefersReducedMotion, usePullToRefresh, useQuerySingleton, useRenderI18n, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTranslate } from '../chunk-UTSDPJUP.js';
+import '../chunk-CB64IOYD.js';
 export { useTapReveal } from '../chunk-XJTHMW4G.js';
 export { useEmitEvent, useEventBus, useEventListener } from '../chunk-CHNC4UYE.js';
-export { Presence, parseLessonSegments, parseMarkdownWithCodeBlocks, usePresence } from '../chunk-KJGVLXEN.js';
-import '../chunk-Q47ZN2DW.js';
+export { parseLessonSegments, parseMarkdownWithCodeBlocks } from '../chunk-N4IJS5DD.js';
+export { Presence, usePresence } from '../chunk-N23SVGTH.js';
 import { cn, domPassthrough } from '../chunk-64WACXM7.js';
 export { cn } from '../chunk-64WACXM7.js';
-import '../chunk-723MJUU3.js';
-import '../chunk-LZRW6GXG.js';
+import '../chunk-6ZCU3BQN.js';
+import '../chunk-FYX64CDL.js';
+export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-L3MTZ3RH.js';
 import { getKnownPatterns, getPatternDefinition } from '../chunk-PQKU62LK.js';
 import '../chunk-PEST66PN.js';
 import '../chunk-QPXIAUJD.js';

package/dist/context/index.cjs

@@ -395,6 +395,13 @@ function useUISlotManager() {
       setSources((prev) => {
         const slotSources = prev[slot];
         if (!slotSources || !(sourceKey in slotSources)) {
+          const embedded = traitIndexRef.current.get(sourceTrait);
+          if (embedded !== void 0 && embedded.slot === slot) {
+            unindexTrait(sourceTrait);
+            notifyTraitSubscribers(sourceTrait, null);
+            log.info("slot:cleared-embedded", { slot, sourceTrait, lastPatternType: embedded.pattern });
+            return prev;
+          }
           log.debug("slot:clear-noop", { slot, sourceTrait, reason: !slotSources ? "no-slot" : "no-source" });
           return prev;
         }
@@ -592,6 +599,7 @@ var BUILT_IN_THEMES = [
   { name: "mid-century", displayName: "Mid-Century Modern", hasLightMode: true, hasDarkMode: true },
   { name: "minimalist", displayName: "Minimalist", hasLightMode: true, hasDarkMode: true },
   { name: "mudcloth", displayName: "Mudcloth", hasLightMode: true, hasDarkMode: true },
+  { name: "nata", displayName: "Nata", hasLightMode: true, hasDarkMode: true },
   { name: "neon", displayName: "Neon", hasLightMode: true, hasDarkMode: true },
   { name: "neumorphic", displayName: "Neumorphic", hasLightMode: true, hasDarkMode: true },
   { name: "newsprint", displayName: "Newsprint", hasLightMode: true, hasDarkMode: true },
@@ -599,6 +607,7 @@ var BUILT_IN_THEMES = [
   { name: "orb", displayName: "Orb", hasLightMode: true, hasDarkMode: true },
   { name: "pixel", displayName: "Pixel Quest", hasLightMode: true, hasDarkMode: true },
   { name: "prism", displayName: "Prism", hasLightMode: true, hasDarkMode: true },
+  { name: "rawi", displayName: "Rawi", hasLightMode: true, hasDarkMode: true },
   { name: "retro", displayName: "Retro", hasLightMode: true, hasDarkMode: true },
   { name: "risograph", displayName: "Risograph", hasLightMode: true, hasDarkMode: true },
   { name: "scandi", displayName: "Scandinavian", hasLightMode: true, hasDarkMode: true },
@@ -930,7 +939,13 @@ var SURFACE_VARS = [
   { cssVar: "--surface-card-image", key: "cardImage" },
   { cssVar: "--surface-page-image", key: "pageImage" },
   { cssVar: "--surface-page-image-size", key: "pageImageSize" },
-  { cssVar: "--surface-diagram", key: "diagram" }
+  { cssVar: "--surface-diagram", key: "diagram" },
+  { cssVar: "--surface-edge-mask", key: "edgeMask" },
+  { cssVar: "--surface-edge-height", key: "edgeHeight" },
+  { cssVar: "--surface-texture-mask", key: "textureMask" },
+  { cssVar: "--surface-texture-size", key: "textureSize" },
+  { cssVar: "--surface-accent-image", key: "accentImage" },
+  { cssVar: "--surface-scrim", key: "scrim" }
 ];
 var DIAGRAM_VARS = [
   { cssVar: "--diagram-stroke-thin", key: "strokeThin" },

package/dist/context/index.js

@@ -1,5 +1,5 @@
-import { useUISlotManager } from '../chunk-VHTJRS2N.js';
-export { resolveThemeForRuntime, themeTokensToCssVars } from '../chunk-V3FGTQUE.js';
+export { resolveThemeForRuntime, themeTokensToCssVars } from '../chunk-ZR45FGW3.js';
+import { useUISlotManager } from '../chunk-L3MTZ3RH.js';
 import '../chunk-PEST66PN.js';
 import '../chunk-QPXIAUJD.js';
 import { createContext, useMemo, useContext, useState, useEffect, useCallback } from 'react';
@@ -70,6 +70,7 @@ var BUILT_IN_THEMES = [
   { name: "mid-century", displayName: "Mid-Century Modern", hasLightMode: true, hasDarkMode: true },
   { name: "minimalist", displayName: "Minimalist", hasLightMode: true, hasDarkMode: true },
   { name: "mudcloth", displayName: "Mudcloth", hasLightMode: true, hasDarkMode: true },
+  { name: "nata", displayName: "Nata", hasLightMode: true, hasDarkMode: true },
   { name: "neon", displayName: "Neon", hasLightMode: true, hasDarkMode: true },
   { name: "neumorphic", displayName: "Neumorphic", hasLightMode: true, hasDarkMode: true },
   { name: "newsprint", displayName: "Newsprint", hasLightMode: true, hasDarkMode: true },
@@ -77,6 +78,7 @@ var BUILT_IN_THEMES = [
   { name: "orb", displayName: "Orb", hasLightMode: true, hasDarkMode: true },
   { name: "pixel", displayName: "Pixel Quest", hasLightMode: true, hasDarkMode: true },
   { name: "prism", displayName: "Prism", hasLightMode: true, hasDarkMode: true },
+  { name: "rawi", displayName: "Rawi", hasLightMode: true, hasDarkMode: true },
   { name: "retro", displayName: "Retro", hasLightMode: true, hasDarkMode: true },
   { name: "risograph", displayName: "Risograph", hasLightMode: true, hasDarkMode: true },
   { name: "scandi", displayName: "Scandinavian", hasLightMode: true, hasDarkMode: true },

package/dist/hooks/index.cjs

@@ -1374,6 +1374,13 @@ function useUISlotManager() {
       setSources((prev) => {
         const slotSources = prev[slot];
         if (!slotSources || !(sourceKey in slotSources)) {
+          const embedded = traitIndexRef.current.get(sourceTrait);
+          if (embedded !== void 0 && embedded.slot === slot) {
+            unindexTrait(sourceTrait);
+            notifyTraitSubscribers(sourceTrait, null);
+            log10.info("slot:cleared-embedded", { slot, sourceTrait, lastPatternType: embedded.pattern });
+            return prev;
+          }
           log10.debug("slot:clear-noop", { slot, sourceTrait, reason: !slotSources ? "no-slot" : "no-source" });
           return prev;
         }
@@ -1529,6 +1536,21 @@ function endPending(key) {
 }
 React.createContext(null);
 
+// lib/bus-claim.ts
+var claims = /* @__PURE__ */ new WeakMap();
+function claimDelivery(source, trait, event) {
+  if (source === void 0) return true;
+  const key = `${trait}\0${event}`;
+  const seen = claims.get(source);
+  if (seen === void 0) {
+    claims.set(source, /* @__PURE__ */ new Set([key]));
+    return true;
+  }
+  if (seen.has(key)) return false;
+  seen.add(key);
+  return true;
+}
+
 // hooks/useUIEvents.ts
 var UI_PREFIX = "UI:";
 function useUIEvents(dispatch, traitName, validEvents, eventBusInstance) {
@@ -1547,6 +1569,7 @@ function useUIEvents(dispatch, traitName, validEvents, eventBusInstance) {
         if (event.source && event.source.dispatched) {
           return;
         }
+        if (!claimDelivery(event.source, traitName, smEvent)) return;
         const pendingKey = event.source?.pendingKey;
         const settled = dispatch(smEvent, event.payload);
         if (pendingKey !== void 0 && settled instanceof Promise) {
@@ -1868,7 +1891,6 @@ var en_default = {
   "aria.upvote": "Upvote",
   "aria.downvote": "Downvote",
   "aria.qrScanner": "QR scanner",
-  "aria.mockScanDev": "Mock scan (dev)",
   "aria.openMenu": "Open menu",
   "aria.closeMenu": "Close menu",
   "aria.openSidebar": "Open sidebar",
@@ -2066,7 +2088,6 @@ var en_default = {
   "qrScanner.pauseScanning": "Pause scanning",
   "qrScanner.switchToFrontCamera": "Switch to front camera",
   "qrScanner.switchToRearCamera": "Switch to rear camera",
-  "qrScanner.mockScan": "Mock Scan",
   "docSearch.placeholder": "Search documentation...",
   "stateMachine.loading": "Loading state machine\u2026",
   "stateMachine.noStateMachine": "No state machine to visualize",
@@ -3129,7 +3150,6 @@ var ar_default = {
   "aria.upvote": "\u062A\u0635\u0648\u064A\u062A \u0625\u064A\u062C\u0627\u0628\u064A",
   "aria.downvote": "\u062A\u0635\u0648\u064A\u062A \u0633\u0644\u0628\u064A",
   "aria.qrScanner": "\u0645\u0627\u0633\u062D QR",
-  "aria.mockScanDev": "\u0645\u0633\u062D \u062A\u062C\u0631\u064A\u0628\u064A (\u062A\u0637\u0648\u064A\u0631)",
   "aria.openMenu": "\u0641\u062A\u062D \u0627\u0644\u0642\u0627\u0626\u0645\u0629",
   "aria.closeMenu": "\u0625\u063A\u0644\u0627\u0642 \u0627\u0644\u0642\u0627\u0626\u0645\u0629",
   "aria.openSidebar": "\u0641\u062A\u062D \u0627\u0644\u0634\u0631\u064A\u0637 \u0627\u0644\u062C\u0627\u0646\u0628\u064A",
@@ -3327,7 +3347,6 @@ var ar_default = {
   "qrScanner.pauseScanning": "\u0625\u064A\u0642\u0627\u0641 \u0627\u0644\u0645\u0633\u062D \u0645\u0624\u0642\u062A\u064B\u0627",
   "qrScanner.switchToFrontCamera": "\u0627\u0644\u062A\u0628\u062F\u064A\u0644 \u0625\u0644\u0649 \u0627\u0644\u0643\u0627\u0645\u064A\u0631\u0627 \u0627\u0644\u0623\u0645\u0627\u0645\u064A\u0629",
   "qrScanner.switchToRearCamera": "\u0627\u0644\u062A\u0628\u062F\u064A\u0644 \u0625\u0644\u0649 \u0627\u0644\u0643\u0627\u0645\u064A\u0631\u0627 \u0627\u0644\u062E\u0644\u0641\u064A\u0629",
-  "qrScanner.mockScan": "\u0645\u0633\u062D \u062A\u062C\u0631\u064A\u0628\u064A",
   "docSearch.placeholder": "\u0627\u0644\u0628\u062D\u062B \u0641\u064A \u0627\u0644\u0648\u062B\u0627\u0626\u0642...",
   "stateMachine.loading": "\u062C\u0627\u0631\u064D \u062A\u062D\u0645\u064A\u0644 \u0622\u0644\u0629 \u0627\u0644\u062D\u0627\u0644\u0629\u2026",
   "stateMachine.noStateMachine": "\u0644\u0627 \u062A\u0648\u062C\u062F \u0622\u0644\u0629 \u062D\u0627\u0644\u0629 \u0644\u0639\u0631\u0636\u0647\u0627",
@@ -4388,7 +4407,6 @@ var sl_default = {
   "aria.upvote": "Glasuj za",
   "aria.downvote": "Glasuj proti",
   "aria.qrScanner": "QR skener",
-  "aria.mockScanDev": "Simuliraj skeniranje (dev)",
   "aria.openMenu": "Odpri meni",
   "aria.closeMenu": "Zapri meni",
   "aria.openSidebar": "Odpri stransko vrstico",
@@ -4586,7 +4604,6 @@ var sl_default = {
   "qrScanner.pauseScanning": "Za\u010Dasno ustavi skeniranje",
   "qrScanner.switchToFrontCamera": "Preklopi na sprednjo kamero",
   "qrScanner.switchToRearCamera": "Preklopi na zadnjo kamero",
-  "qrScanner.mockScan": "Preizkusno skeniranje",
   "docSearch.placeholder": "Iskanje po dokumentaciji...",
   "stateMachine.loading": "Nalaganje stanjskega stroja\u2026",
   "stateMachine.noStateMachine": "Ni stanjskega stroja za prikaz",
@@ -6248,6 +6265,60 @@ function useGitHubBranches(owner, repo, enabled = true) {
     // 1 minute
   });
 }
+var OWNED = "data-orb-head";
+var shellTitle;
+function ownedTag(tag, attrs) {
+  const el = document.createElement(tag);
+  for (const [k, v] of Object.entries(attrs)) el.setAttribute(k, v);
+  el.setAttribute(OWNED, "");
+  return el;
+}
+function usePageHead(input) {
+  const { messages, locale } = useTranslate();
+  const title = input ? core.resolvePageMeta(input.title, (k) => messages?.[k]) : void 0;
+  const description = input ? core.resolvePageMeta(input.description, (k) => messages?.[k]) : void 0;
+  const isPublic = input?.access !== "authenticated" && input?.indexing !== "noindex";
+  const canonical = input?.origin !== void 0 ? `${input.origin.replace(/\/+$/, "")}${input.path}` : void 0;
+  const siteName = input?.siteName;
+  const active = input !== null;
+  const originBase = input?.origin?.replace(/\/+$/, "");
+  const hreflang = [];
+  if (originBase !== void 0) {
+    for (const alt of input?.alternates ?? []) hreflang.push([alt.locale, `${originBase}${alt.path}`]);
+    const fallback = input?.alternates?.find((alt) => alt.locale === input.defaultLocale);
+    if (fallback !== void 0) hreflang.push(["x-default", `${originBase}${fallback.path}`]);
+  }
+  const hreflangKey = hreflang.map(([lang, href]) => `${lang} ${href}`).join("\n");
+  React.useEffect(() => {
+    if (!active || typeof document === "undefined") return void 0;
+    shellTitle ?? (shellTitle = document.title);
+    document.title = title ?? siteName ?? shellTitle;
+    const tags = [];
+    if (!isPublic) tags.push(ownedTag("meta", { name: "robots", content: "noindex" }));
+    if (isPublic && description !== void 0) {
+      tags.push(ownedTag("meta", { name: "description", content: description }));
+      tags.push(ownedTag("meta", { property: "og:description", content: description }));
+    }
+    if (isPublic && title !== void 0) tags.push(ownedTag("meta", { property: "og:title", content: title }));
+    if (isPublic && canonical !== void 0) {
+      tags.push(ownedTag("link", { rel: "canonical", href: canonical }));
+      tags.push(ownedTag("meta", { property: "og:url", content: canonical }));
+    }
+    if (isPublic && siteName !== void 0) tags.push(ownedTag("meta", { property: "og:site_name", content: siteName }));
+    if (isPublic) tags.push(ownedTag("meta", { property: "og:locale", content: locale }));
+    if (isPublic && hreflangKey !== "") {
+      for (const line of hreflangKey.split("\n")) {
+        const space = line.indexOf(" ");
+        tags.push(ownedTag("link", { rel: "alternate", hreflang: line.slice(0, space), href: line.slice(space + 1) }));
+      }
+    }
+    for (const stale of Array.from(document.head.querySelectorAll(`[${OWNED}]`))) stale.remove();
+    for (const tag of tags) document.head.appendChild(tag);
+    return () => {
+      for (const tag of tags) tag.remove();
+    };
+  }, [active, title, description, isPublic, canonical, siteName, locale, hreflangKey]);
+}
 
 Object.defineProperty(exports, "useNavStack", {
   enumerable: true,
@@ -6257,6 +6328,7 @@ exports.ALMADAR_DND_MIME = ALMADAR_DND_MIME;
 exports.DEFAULT_SLOTS = DEFAULT_SLOTS;
 exports.I18nProvider = I18nProvider;
 exports.SharedEntityStoreContext = SharedEntityStoreContext;
+exports.claimDelivery = claimDelivery;
 exports.createSharedEntityStore = createSharedEntityStore;
 exports.createTranslate = createTranslate;
 exports.keyChord = keyChord;
@@ -6288,6 +6360,7 @@ exports.useInfiniteScroll = useInfiniteScroll;
 exports.useKeyboardRouter = useKeyboardRouter;
 exports.useLongPress = useLongPress;
 exports.useMediaQuery = useMediaQuery;
+exports.usePageHead = usePageHead;
 exports.usePrefersReducedMotion = usePrefersReducedMotion;
 exports.usePreview = usePreview;
 exports.usePullToRefresh = usePullToRefresh;

package/dist/hooks/index.d.ts

@@ -1,4 +1,4 @@
-import { OrbitalSchema, FieldValue, EventPayload, BusEventSource, BusEventListener, EntityFrameState, EntityFieldWrite } from '@almadar/core';
+import { OrbitalSchema, FieldValue, EventPayload, BusEventSource, BusEventListener, EntityFrameState, EntityFieldWrite, PageMeta, PageAccess, PageIndexing, LocaleAlternate } from '@almadar/core';
 export { BusEvent, BusEventListener, BusEventSource, BusEventListener as EventListener, UISlot, Unsubscribe } from '@almadar/core';
 import { E as EventBusContextType } from '../NavStackContext-04NLdXsY.js';
 export { a as NavStackApi, u as useNavStack } from '../NavStackContext-04NLdXsY.js';
@@ -569,6 +569,17 @@ interface TraitListenSpec<E extends string> {
 }
 declare function useTraitListens<E extends string>(dispatch: (event: E, payload?: EventPayload) => void, listens: readonly TraitListenSpec<E>[], eventBusInstance?: ReturnType<typeof useEventBus>): void;
 
+/**
+ * At-most-once delivery: one physical emit reaches a trait once per triggered
+ * event. Every key one emit fans to (scope-chain bubbling, a listen route)
+ * carries the same `source` object, so the first delivery to a (trait, event)
+ * claims it and the rest are the same event again. A sourceless emit is never
+ * deduplicated. Shared by the runtime ingress (`useBusIngress`), `useUIEvents`
+ * and compiled listens.
+ */
+
+declare function claimDelivery(source: BusEventSource | undefined, trait: string, event: string): boolean;
+
 /** Notification callback fired after a `commit()` for the subscribed entity id. */
 type SharedEntitySubscriber = () => void;
 /**
@@ -1082,4 +1093,34 @@ declare function useGitHubBranches(owner: string, repo: string, enabled?: boolea
     branches: string[];
 }>, Error>;
 
-export { ALMADAR_DND_MIME, type AuthContextValue, type AuthUser, type CanvasGestureCallbacks, type CanvasGestureHandlers, type CompileResult, type CompileStage, type DragReorderResult, type DraggablePayload, EventBusContextType, type Extension, type ExtensionManifest, type FileSystemFile, type FileSystemStatus, type GitHubRepo, type GitHubStatus, type I18nContextValue, I18nProvider, type InfiniteScrollOptions, type InfiniteScrollResult, type LongPressHandlers, type LongPressOptions, type OpenFile, type Positioned, type PullToRefreshOptions, type PullToRefreshResult, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, type QueryState, type RenderI18n, type RenderInterpolationHandle, type RenderInterpolationOptions, type SelectedFile, type SharedEntityStore, SharedEntityStoreContext, type SharedEntitySubscriber, type SharedEntityWriter, type SwipeGestureOptions, type SwipeGestureResult, type SwipeHandlers, type TapRevealOptions, type TapRevealResult, type TraitListenSpec, type TranslateFunction, type UseCanvasGesturesOptions, type UseCompileResult, type UseDraggableOptions, type UseDraggableResult, type UseDropZoneOptions, type UseDropZoneResult, type UseExtensionsOptions, type UseExtensionsResult, type UseFileEditorOptions, type UseFileEditorResult, type UseFileSystemResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useFormatContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useMediaQuery, usePrefersReducedMotion, usePreview, usePullToRefresh, useQuerySingleton, useRenderI18n, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation };
+/**
+ * The active page's document head on client navigation — the same declared
+ * contract the build writes into each route document: title, description,
+ * canonical, social tags and the robots directive, with `i18n/t` metadata
+ * resolved from the active locale's catalog. The tags it writes are marked
+ * and replaced on every page change; entering an `authenticated` or
+ * `noindex` page drops the public tags and declares `noindex`.
+ *
+ * @packageDocumentation
+ */
+
+interface PageHeadInput {
+    title?: PageMeta;
+    description?: PageMeta;
+    access?: PageAccess;
+    indexing?: PageIndexing;
+    /** The app's `origin:`, for the canonical URL. */
+    origin?: string;
+    /** The app's `siteName:` — the document title of a page that declares none. */
+    siteName?: string;
+    /** The concrete path on screen. */
+    path: string;
+    /** The page's translations (`localeAlternates`), written as hreflang links. */
+    alternates?: readonly LocaleAlternate[];
+    /** The app's first locale, the `x-default` alternate. */
+    defaultLocale?: string;
+}
+/** Writes `input`'s head into the document; `null` writes nothing. */
+declare function usePageHead(input: PageHeadInput | null): void;
+
+export { ALMADAR_DND_MIME, type AuthContextValue, type AuthUser, type CanvasGestureCallbacks, type CanvasGestureHandlers, type CompileResult, type CompileStage, type DragReorderResult, type DraggablePayload, EventBusContextType, type Extension, type ExtensionManifest, type FileSystemFile, type FileSystemStatus, type GitHubRepo, type GitHubStatus, type I18nContextValue, I18nProvider, type InfiniteScrollOptions, type InfiniteScrollResult, type LongPressHandlers, type LongPressOptions, type OpenFile, type PageHeadInput, type Positioned, type PullToRefreshOptions, type PullToRefreshResult, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, type QueryState, type RenderI18n, type RenderInterpolationHandle, type RenderInterpolationOptions, type SelectedFile, type SharedEntityStore, SharedEntityStoreContext, type SharedEntitySubscriber, type SharedEntityWriter, type SwipeGestureOptions, type SwipeGestureResult, type SwipeHandlers, type TapRevealOptions, type TapRevealResult, type TraitListenSpec, type TranslateFunction, type UseCanvasGesturesOptions, type UseCompileResult, type UseDraggableOptions, type UseDraggableResult, type UseDropZoneOptions, type UseDropZoneResult, type UseExtensionsOptions, type UseExtensionsResult, type UseFileEditorOptions, type UseFileEditorResult, type UseFileSystemResult, claimDelivery, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useFormatContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useMediaQuery, usePageHead, usePrefersReducedMotion, usePreview, usePullToRefresh, useQuerySingleton, useRenderI18n, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation };

package/dist/hooks/index.js

@@ -1,11 +1,10 @@
-export { keyChord, mergeCaptureTables, useAgentChat, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useKeyboardRouter, useNavStack, usePreview, useRenderInterpolation, useTraitListens, useUIEvents, useValidation } from '../chunk-MZIDOJMD.js';
-export { I18nProvider, SharedEntityStoreContext, createSharedEntityStore, createTranslate, runTickFrame, useFormatContext, useRenderI18n, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useTranslate } from '../chunk-N7JIG57B.js';
-export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-VHTJRS2N.js';
-import '../chunk-YYYHH5BA.js';
-export { ALMADAR_DND_MIME, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useDraggable, useDropZone, useInfiniteScroll, useLongPress, useMediaQuery, usePrefersReducedMotion, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-I5QOYW2Z.js';
+export { keyChord, mergeCaptureTables, useAgentChat, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useKeyboardRouter, useNavStack, usePreview, useRenderInterpolation, useTraitListens, useUIEvents, useValidation } from '../chunk-EIIQGOZW.js';
+export { ALMADAR_DND_MIME, I18nProvider, SharedEntityStoreContext, claimDelivery, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAuthContext, useCanvasGestures, useDragReorder, useDraggable, useDropZone, useFormatContext, useInfiniteScroll, useLongPress, useMediaQuery, usePageHead, usePrefersReducedMotion, usePullToRefresh, useQuerySingleton, useRenderI18n, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTranslate } from '../chunk-UTSDPJUP.js';
+import '../chunk-CB64IOYD.js';
 export { useTapReveal } from '../chunk-XJTHMW4G.js';
 export { useEmitEvent, useEventBus, useEventListener } from '../chunk-CHNC4UYE.js';
-import '../chunk-723MJUU3.js';
-import '../chunk-LZRW6GXG.js';
+import '../chunk-6ZCU3BQN.js';
+import '../chunk-FYX64CDL.js';
+export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-L3MTZ3RH.js';
 import '../chunk-PEST66PN.js';
 import '../chunk-QPXIAUJD.js';