@happyvertical/smrt-svelte 0.40.61 → 0.40.63

package/README.md

@@ -55,7 +55,7 @@ pnpm add @happyvertical/smrt-svelte
 
 ```svelte
 <script>
-  import { PermissionCheck, permission } from '@happyvertical/smrt-svelte';
+  import { PermissionCheck, permission } from '@happyvertical/smrt-ui';
 </script>
 
 <PermissionCheck requires="admin:write">
@@ -144,22 +144,52 @@ scaffold adopts AdminShell as its default chrome exactly this way; copy its
 
 ### Entry Points
 
+This is the complete `exports` map of this package. Anything not listed is not
+importable, even if it appears in `dist/`.
+
 | Import Path | Contents |
 |-------------|----------|
-| `@happyvertical/smrt-svelte` | Provider, DataTable, permission utilities, hooks, state, components |
-| `@happyvertical/smrt-svelte/calendar` | Calendar and DayView |
-| `@happyvertical/smrt-svelte/forms` | Form inputs (TextInput, Select, MoneyInput, etc.) |
-| `@happyvertical/smrt-svelte/layout` | Layout (Container, Grid, Header, Footer, Masthead, etc.) |
-| `@happyvertical/smrt-svelte/ui` | UI primitives (Button, Card, Badge, Pagination) |
-| `@happyvertical/smrt-ui/themes` | Canonical ThemeProvider, Material/Glass/Studio/s-m-r-t presets, CSS generation |
-| `@happyvertical/smrt-ui/forms` | Provider-free foundational form controls and the agent interaction registry |
-| `@happyvertical/smrt-ui/data` | DataTable, CollectionList/ContentList, CollectionToolbar |
-| `@happyvertical/smrt-svelte/registry` | ModuleUIRegistry for agent admin panels |
+| `@happyvertical/smrt-svelte` | `Provider`, hooks (`useAppState`, `useAuth`, `useLLM`, `useSocket`, `useSTT`, `useTheme`, `useTTS`), app state/context, `ModulePanel`, and the form components below |
+| `@happyvertical/smrt-svelte/forms` | Form inputs (TextInput, Select, MoneyInput, DateTimeInput, Toggle, etc.) |
+| `@happyvertical/smrt-svelte/settings` | Server-paged settings search, selection, and list/detail layout (`SettingsCatalog`, `paginateSettingsCatalog`) |
 | `@happyvertical/smrt-svelte/workspace` | AdminShell, ShellState, tenant nav, focus tools, settings, activities, and system/app panels |
 | `@happyvertical/smrt-svelte/workspace/legacy` | Opt-in ToolsDock compatibility surface for applications migrating to AdminShell |
+| `@happyvertical/smrt-svelte/workspace/server` | Server-side workspace helpers (Node only) |
+| `@happyvertical/smrt-svelte/workspace/live` | `systemFeed` — the AdminShell system scope (jobs/schedules/dispatch) polled from an app status endpoint; deliberately carries no `smrt-web` dependency |
 | `@happyvertical/smrt-svelte/browser-ai` | Browser AI client (STT/TTS/LLM adapters, capability detection) |
 | `@happyvertical/smrt-svelte/browser-ai/svelte` | Svelte AI components (VoiceInput, CapabilityGate, etc.) |
-| `@happyvertical/smrt-svelte/styles/tokens.css` | Design tokens CSS |
+| `@happyvertical/smrt-svelte/web` | `smrt-web` live-query bindings (`liveCollection`, `activityFeed`, `useUpdateAvailable`) |
+| `@happyvertical/smrt-svelte/i18n/server` | Server-side i18n resolver (Node only) |
+
+Domain-agnostic UI lives in `@happyvertical/smrt-ui`. There is no `ui`,
+`layout`, `calendar`, `data`, `chat`, `feedback`, `registry`, `themes`, `i18n`,
+or `styles/tokens.css` subpath on `smrt-svelte`, so those specifiers only
+resolve against `smrt-ui`:
+
+| Import Path | Contents |
+|-------------|----------|
+| `@happyvertical/smrt-ui` | `PermissionCheck`, `permission` / `hasPermission` / `hasAnyPermission` / `hasAllPermissions` |
+| `@happyvertical/smrt-ui/ui` | UI primitives (Button, Card, Badge, Pagination) |
+| `@happyvertical/smrt-ui/layout` | Layout (Container, Grid, Header, Footer, Masthead, etc.) |
+| `@happyvertical/smrt-ui/calendar` | Calendar and DayView |
+| `@happyvertical/smrt-ui/data` | DataTable, CollectionList/ContentList, CollectionToolbar |
+| `@happyvertical/smrt-ui/feedback` | Modal, ConfirmDialog, LoadingOverlay, ProgressBar |
+| `@happyvertical/smrt-ui/chat` | Message bubble, reaction picker, typing indicator |
+| `@happyvertical/smrt-ui/registry` | ModuleUIRegistry for agent admin panels |
+| `@happyvertical/smrt-ui/themes` | Canonical ThemeProvider, Material/Glass/Studio/s-m-r-t presets, CSS generation |
+| `@happyvertical/smrt-ui/i18n` | Client i18n (`useI18n`, `Trans`) — the counterpart to `smrt-svelte`'s `/i18n/server` |
+| `@happyvertical/smrt-ui/styles/tokens.css` | Design tokens CSS |
+
+`forms` is the one name on both: `@happyvertical/smrt-ui/forms` holds the
+Provider-free primitives (`Input`, `Select`, `Textarea`, `Toggle`, `FormGroup`),
+and `@happyvertical/smrt-svelte/forms` re-exports those and adds the
+Provider-backed inputs, so it stays the one-stop barrel for applications.
+
+The first-generation `WorkspaceShell`, `RoleShell`, `NavTree`, and `Breadcrumbs`
+have no entry point at all. Their `.svelte` files are copied into `dist/` but no
+export subpath or barrel names them, so they cannot be imported from an
+installed package — see the [migration
+guide](./src/components/workspace/MIGRATION.md). `AdminShell` supersedes them.
 
 Legacy ToolsDock availability is presentation-only, not authorization.
 `fetchAvailability` failures intentionally keep controls usable using the

package/agents/components.md

@@ -50,20 +50,22 @@ library. Which barrel for what:
 
 | Need | Import from |
 |------|-------------|
-| Buttons, cards, badges, avatars, chips, skeletons, tooltips, dropdowns, trees, pagination | `@happyvertical/smrt-svelte/ui` (or the package root) |
+| Buttons, cards, badges, avatars, chips, skeletons, tooltips, dropdowns, trees, pagination | `@happyvertical/smrt-ui/ui` |
 | Provider-free base inputs — `Input`, `Select`, `Textarea`, `Toggle`, `FormGroup` | `@happyvertical/smrt-ui/forms` (also re-exported from `@happyvertical/smrt-svelte/forms`) |
 | Provider-free `Form` (plain `<form>` wrapper) | `@happyvertical/smrt-ui/forms` **only** — `@happyvertical/smrt-svelte/forms` exports the *rich* Provider-backed `Form` under that name, so import the plain one straight from smrt-ui |
 | Provider-backed inputs — `TextInput`, `NumberInput`, `MoneyInput`, date/measurement/address inputs, `CheckboxInput`, file upload, the rich `Form` | `@happyvertical/smrt-svelte/forms` |
-| `Modal`, `ConfirmDialog`, `LoadingOverlay`, `ProgressBar` | `@happyvertical/smrt-svelte/feedback` |
-| `Container`, `Grid`, `Header`, `Footer`, `PageHeader`, `EmptyState` | `@happyvertical/smrt-svelte/layout` |
-| Chat message bubble, reaction picker, typing indicator | `@happyvertical/smrt-svelte/chat` |
+| `Modal`, `ConfirmDialog`, `LoadingOverlay`, `ProgressBar` | `@happyvertical/smrt-ui/feedback` |
+| `Container`, `Grid`, `Header`, `Footer`, `PageHeader`, `EmptyState` | `@happyvertical/smrt-ui/layout` |
+| Chat message bubble, reaction picker, typing indicator | `@happyvertical/smrt-ui/chat` |
 | Admin shell, tenant navigation, focus tools, settings, and activities | `@happyvertical/smrt-svelte/workspace` |
 | First-generation ToolsDock during AdminShell migration | `@happyvertical/smrt-svelte/workspace/legacy` |
 | Server-paged settings search, selection, and list/detail layout | `@happyvertical/smrt-svelte/settings` |
 
-The package root re-exports `./ui`, `./forms`, etc., so `from
-'@happyvertical/smrt-svelte'` also works; prefer the specific subpath in domain
-code for tree-shaking and clarity.
+The domain-agnostic primitives are **not** re-exported by smrt-svelte: its
+`exports` map has no `./ui`, `./feedback`, `./layout`, `./chat`, or `./registry`,
+so those specifiers fail to resolve — import them from `@happyvertical/smrt-ui`.
+The smrt-svelte root does re-export `./forms`, but prefer the specific subpath
+in domain code for tree-shaking and clarity.
 
 **Consolidating an existing re-roll** — two patterns:
 

package/agents/workspace.md

@@ -18,6 +18,12 @@ compatibility. Applications that still need ToolsDock during migration may use
 the explicit `@happyvertical/smrt-svelte/workspace/legacy` subpath; keep legacy
 additions isolated there so the canonical workspace surface remains AdminShell.
 
+Of that family, only ToolsDock has an entry point. `WorkspaceShell`,
+`RoleShell`, `NavTree`, and `Breadcrumbs` are named by no subpath and no barrel,
+so they are unreachable from an installed package even though their `.svelte`
+files are copied into `dist/`. Do not document them as available API; removing
+them from the published artifact versus exporting them is tracked in #2286.
+
 **Principles**:
 - SvelteKit-agnostic core — no `$app/state` or `$app/navigation` imports
 - SSR-safe public shell import/render path; browser listeners and localStorage

package/dist/components/workspace/MIGRATION.md

@@ -5,14 +5,25 @@ The first-generation workspace family (`WorkspaceShell`, `RoleShell`,
 `@happyvertical/smrt-svelte/workspace` surface. Treat those source files as a
 migration reference while moving apps to `AdminShell`.
 
+## What is still importable
+
+Only `ToolsDock` (with `defineToolsDock`, `useToolsDock`, and the dock types)
+has a public entry point: `@happyvertical/smrt-svelte/workspace/legacy`.
+
+`WorkspaceShell`, `RoleShell`, `NavTree`, and `Breadcrumbs` have **no export
+subpath**. Their `.svelte` files are copied into `dist/`, but the package's
+`exports` map does not name them and no barrel re-exports them, so
+`import ... from '@happyvertical/smrt-svelte/…'` cannot reach them from an
+installed package — the specifier resolves to nothing exported. Read them as
+source; do not plan a migration that keeps rendering them.
+
 ## Adopting AdminShell is additive
 
-Moving to `AdminShell` is a non-breaking, opt-in change — nothing is removed
-from under you:
+Moving to `AdminShell` is a non-breaking, opt-in change for the parts that are
+still reachable:
 
-- **Existing consumers keep working.** The first-generation classes still ship
-  in this package and still render. Migrate a route or an app at your own pace;
-  there is no flag day.
+- **ToolsDock consumers keep working** through the `workspace/legacy` subpath.
+  Migrate a route or an app at your own pace; there is no flag day.
 - **Adopt by wrapping, not rewriting.** Mount `AdminShell` in a layout around
   your existing pages (`{@render children()}`). Page-level data loading is
   unchanged — in SvelteKit, keep loading data in each route's server `load` and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-svelte",
-  "version": "0.40.61",
+  "version": "0.40.63",
   "description": "Svelte 5 components for SMRT user management - auth, users, tenants, roles, permissions, groups",
   "type": "module",
   "smrtRawPrimitives": "strict",
@@ -101,14 +101,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@happyvertical/logger": "^0.85.5",
+    "@happyvertical/logger": "^0.86.1",
     "@tanstack/db": "^0.6.14",
     "@tanstack/svelte-db": "^0.1.91",
     "esm-env": "^1.2.2",
-    "@happyvertical/smrt-languages": "0.40.61",
-    "@happyvertical/smrt-types": "0.40.61",
-    "@happyvertical/smrt-ui": "0.40.61",
-    "@happyvertical/smrt-web": "0.40.61"
+    "@happyvertical/smrt-languages": "0.40.63",
+    "@happyvertical/smrt-types": "0.40.63",
+    "@happyvertical/smrt-ui": "0.40.63",
+    "@happyvertical/smrt-web": "0.40.63"
   },
   "peerDependencies": {
     "@huggingface/transformers": ">=3.8.1",