@vireo-ai/trellis-ui 0.1.62 → 0.1.63

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vireo-ai/trellis-ui",
-  "version": "0.1.62",
+  "version": "0.1.63",
   "type": "module",
   "description": "Django-native UI toolkit for building realtime and interactive web apps.",
   "license": "MIT",
@@ -28,6 +28,7 @@
     "packages/theme-engine/generated/schemas/*.json",
     "packages/theme-engine/generated/knobs/v1/**/*.json",
     "packages/theme-engine/skills/create-trellis-theme/**",
+    "packages/client/skills/compose-trellis-ui/**",
     "packages/theme-engine/THEME_AUTHORING.md",
     "packages/client/src/styles/fonts/**/*",
     "packages/theme-engine/fonts/**/*"

package/packages/client/skills/compose-trellis-ui/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: compose-trellis-ui
+description: Create, revise, or audit Django screens and reusable Cotton compositions in applications using Trellis.
+---
+
+# Compose Trellis UI
+
+Focus on composition, spacing, content, and UI flow. Component documentation defines the APIs; `UI.md` records project composition conventions and direction; theme configuration owns parametric visual choices. Trust Trellis styling defaults, light/dark treatments, and built-in accessible interactions. Supply the labels, relationships, and reading order needed by the composition, preserving those component behaviors.
+
+## Read the project direction
+
+Read the application's `UI.md` before composing or auditing. If it is missing, bootstrap it from the codebase and running application using [Project UI guidance](references/project-ui.md). Read that reference also when recording a new convention or reconciling a changed preference with existing usage. Explicit user direction takes precedence over inferred conventions.
+
+## Design around the user's task
+
+- Establish what the person needs to understand or accomplish. Let that determine the content, actions, and hierarchy.
+- Every added element should help someone act, make a decision, understand content, or understand the current state. Omit elements without a clear purpose.
+- Do not invent dashboard metrics, summary cards, explanatory panels, badges, or secondary actions merely to fill out a screen. Add them when the brief or workflow establishes their value.
+- Present information where it becomes useful. Keep frequent actions accessible; disclose secondary details when needed without hiding essential context.
+- Use familiar patterns and consistent terminology. Reuse established application compositions before introducing another pattern.
+- Write labels and supporting text concisely. Avoid repeating information already clear from the page title, surrounding content, or control.
+- Use visual emphasis to communicate importance. Whitespace is acceptable; it does not need another component.
+- Preserve information and feedback people need to complete the task, including accessible labels, errors, and recovery actions.
+- Restraint must preserve substance. Remove unnecessary presentation without omitting information or actions needed for the task.
+
+These principles draw on [Apple's design principles](https://developer.apple.com/design/human-interface-guidelines/design-principles), applied here to Trellis application composition.
+
+## Component and styling rules
+
+- Preserve component styling defaults unless a visual change serves a clear purpose. Deliberately use padding, margin, gap, and other public spacing props or theme-backed layout utilities to establish consistent alignment, grouping, and room to breathe.
+- Verify props and slots in available documentation, contracts, and templates. Do not invent APIs or recreate component behavior.
+- Omit `as` unless behavior, accessibility, or document structure needs another element.
+- Components own internal typography, padding, states, and interactions. Give each label, action, gap, and surface boundary one owner; avoid duplicate content and stacked gap/margin rules.
+- Trust the Trellis styling system. Default to the public styling API through components and follow theme principles, including in new Cotton components.
+- If a new Cotton component needs styling beyond that API, theme-backed Tailwind utilities are an option for keeping styling co-located with markup.
+- Adding Tailwind overrides to existing components requires user approval. Custom CSS is a last resort and requires user approval, including for new Cotton components. Show the proposed styling change and explain why the existing API cannot express it before requesting approval. Existing explicit authorization covers the agreed change.
+
+## Create or revise
+
+1. Establish the task, reading order, relevant content states, and project direction. Read the relevant documentation guides, component examples, and public API. For an existing screen, inspect its current rendered behavior first; preserve routes, form behavior, data, and actions unless the requested change includes them.
+2. Build the structure through public props with deliberate spacing, representative content, and domain terminology. Check realistic content lengths, collection volumes, and relevant empty, loading, and error states. Preserve substantive content when simplifying.
+3. Render and inspect the affected composition, using screenshots to assess alignment, spacing, hierarchy, and wrapping. Refine through component choice, grouping, and justified props.
+4. Review by subtraction: remove or consolidate redundant content, competing actions, unnecessary containers, and decoration without purpose. Verify that the task remains understandable and usable.
+5. Apply the verification criteria below. Recheck after correcting observed defects.
+
+## Audit
+
+Read the relevant documentation and inspect the existing composition in source and rendered output. Use the same task, styling, and verification criteria as creation. An audit request produces findings; implement corrections when the user requests fixes.
+
+Report concrete problems with their location, evidence, effect on the task, and proposed correction. Distinguish observed defects from optional preferences or suggestions. Prioritize blocked tasks and unclear hierarchy before minor visual details. Avoid speculative findings when the relevant rendered state cannot be inspected; state the limitation. Report when there are no actionable findings.
+
+## Verification
+
+Verify that the task and primary action, where applicable, are clear; related content shares consistent alignment and spacing; text is readable; and content does not unexpectedly clip or overflow. Check that controls and relevant feedback remain usable.
+
+When working from a visual reference, compare the rendered composition against its alignment anchors, spacing relationships, and proportions; matching the same elements is insufficient. Reproduce those relationships through deliberate layout and spacing choices while retaining Trellis theme treatments.
+
+Judge the rendered result rather than assuming the source expresses the intended hierarchy. Name visible problems precisely, such as a detached action or inconsistent content edge, and re-inspect the affected state after correcting them. Automated checks supplement this review.
+
+Exercise viewport sizes, content lengths, and interaction states relevant to the change. Tokens handle light/dark; separate mode reviews are not required by this skill.
+
+Correct observed defects and verify again. Report anything that could not be checked; writing markup or taking a screenshot alone does not establish that these criteria are met.
+
+## Documentation
+
+The docs teach Trellis APIs and usage for humans and agents. Read only the topics needed for the task; use component examples and blocks as starting points, not required page recipes. Verify props, slots, transitions, and browser methods in the component reference rather than copying an explanation into this skill.
+
+Resolve these paths against the actual Trellis documentation origin supplied by the project, its tooling, or the running docs site. They are documentation paths, not routes to add to the consuming application. Do not invent a deployed hostname. If docs are unavailable, inspect the installed public contracts and templates and report the limitation.
+
+Start with `/llms.txt` to discover the current documentation, then fetch only the Markdown pages relevant to the task. Prefer these text endpoints for API and usage research; avoid loading rendered documentation into context by default.
+
+| Need | Markdown documentation path |
+| --- | --- |
+| Discover guides, blocks, components, and their Markdown URLs | [`/llms.txt`](/llms.txt) |
+| Understand Trellis and its application model | [`/pages/how-trellis-works.md`](/pages/how-trellis-works.md) |
+| Send hypermedia requests and return HTML updates or Python effects | [`/pages/requests.md`](/pages/requests.md) |
+| Render Django forms with Trellis controls | [`/pages/forms-bridge.md`](/pages/forms-bridge.md) |
+| Use local state, component methods, events, and transition hooks | [`/pages/working-with-alpine.md`](/pages/working-with-alpine.md) |
+| Understand theme configuration and visual relationships | [`/pages/theme-foundations.md`](/pages/theme-foundations.md) |
+| Configure a theme | [`/pages/theme.md`](/pages/theme.md) |
+
+Follow the component and block Markdown URLs listed in `/llms.txt`; component references use `/components/<slug>.md`, and blocks use `/pages/<slug>.md`. When visual understanding or interaction review is needed, open the corresponding rendered documentation page or linked demo in a browser; Markdown does not replace visual verification of the application being composed.
+
+Project conventions and `UI.md` bootstrap/migration guidance remain in [Project UI guidance](references/project-ui.md). Component facts and composition teaching belong in the docs.

package/packages/client/skills/compose-trellis-ui/references/project-ui.md

@@ -0,0 +1,40 @@
+# Project UI guidance
+
+`UI.md` is the application's persistent memory for composition choices and user direction. Read it at the application root or the user's chosen location. Keep its format free; follow the user's way of recording ideas.
+
+## What belongs here
+
+Record reusable decisions that spare the user from repeating instructions, with their scope and useful examples. These could include:
+
+- Use icon-only, full-radius button toolbars on application pages.
+- Use pill tabs with keyboard shortcuts and tooltips.
+- Use flush tables when they share a content edge with the surrounding section.
+- For marketing pages, prefer a narrow content window with substantial isometric animation, drawing on supplied Heroku or Linear references.
+
+These are examples of project preferences, not defaults for every Trellis application. Verify the actual component API before translating a preference into props or markup. Keep rough ideas and references without treating them as settled requirements.
+
+Keep accent colors, palettes, font settings, radius scales, light/dark values, and other parametric visual configuration in the theme. Do not duplicate them in `UI.md` or prescribe CSS to reproduce them. Component APIs and reusable Trellis usage guidance belong in the docs; this skill owns the agent workflow. Link to existing reusable compositions instead of copying their implementation.
+
+## Bootstrap a missing file
+
+Inspect before writing. A missing `UI.md` is a reason to gather project evidence, not to invent a design direction or block the requested task on a lengthy interview.
+
+1. Read application instructions, existing design notes, reusable Cotton components, representative templates, and relevant theme configuration. Use the theme to understand what it already controls; do not transcribe its values.
+2. Use focused subagents for independent investigations: recurring component usage and layout patterns; reusable compositions and their callers; representative application flows and states. Scale the split to the codebase, avoiding duplicate work. Ask for source locations, recurrence, exceptions, and uncertainty. If delegation is unavailable, perform those investigations directly.
+3. Use the running application to inspect representative screens and complete relevant flows. Capture screenshots that support the observed compositions, including narrow layouts or alternate content states where they affect the convention. Coordinate browser work so investigators do not operate the same session concurrently.
+4. Reconcile source findings with the rendered evidence. Repeated, consistent usage can establish an inferred convention without requiring separate approval for each finding. Note its scope and exceptions; an isolated occurrence or visible defect is not an application-wide rule.
+5. Write a concise initial `UI.md` in the application. Include useful inferred conventions, explicit user preferences already supplied, and unresolved questions where they matter. Identify which conclusions are inferred and retain source locations and screenshot references sufficient to review them. Summarize the starting point for the user and invite corrections while continuing the authorized task.
+
+If the application cannot be run, record source-backed observations as provisional and state that rendered verification is missing. Do not invent screenshots or visual conclusions. For a new application without existing compositions, record available user direction and let conventions emerge from actual work.
+
+Read an existing `UI.md` before changing it. Preserve unrelated content; if its purpose conflicts, propose another name or location. Do not create an application `UI.md` in the toolkit repository during skill maintenance. When deliberately testing this workflow against the docs site, treat that site as the application and scope findings to it.
+
+## Maintain conventions and migration scope
+
+- Explicit user instructions supersede inferred usage. Update the affected decision rather than accumulating contradictory rules, and keep named exceptions intact unless the user changes them.
+- Distinguish a local change from a convention change. A request to change one screen applies there; language such as “always,” “every page,” or “replace throughout” establishes broader scope.
+- When a new instruction changes a recorded convention, audit comparable instances and shared compositions to identify the affected scope. Prefer changing the shared composition when it owns the behavior.
+- If the user authorizes an application-wide migration, make the matching changes and verify representative callers. Do not ask for the same authorization again.
+- If migration scope is unclear, show the affected usages and a concrete migration proposal, then confirm before changing other screens. Complete the clearly authorized local work while that question is pending. Audit discovery alone does not authorize a wider migration.
+- Keep the record accurate during partial migrations: distinguish the desired convention from remaining older usage. Preserve the reason and scope when the user deliberately keeps an exception.
+- Record useful new composition decisions as they emerge. Keep unresolved ideas visibly tentative and remove superseded guidance. Do not turn every implementation detail into a rule.

package/packages/client/src/styles/generated/theme-fonts.css

@@ -1,5 +1,5 @@
 /* Generated by packages/theme-engine/scripts/generate-default-css.mjs. */
-/* Theme ce1519e51694cda9; CSS 7d8da2bed88e82b9. */
+/* Theme e16cba3eb864dee4; CSS 7d8da2bed88e82b9. */
 @import "../fonts/inter/5.3.0/font.css";
 
 @import "../fonts/fira-code/5.3.0/font.css";

package/packages/client/src/styles/generated/theme-palette.css

@@ -1,5 +1,5 @@
 /* Generated by packages/theme-engine/scripts/generate-default-css.mjs. */
-/* Theme ce1519e51694cda9; CSS ee552bf4218d63b7. */
+/* Theme e16cba3eb864dee4; CSS ee552bf4218d63b7. */
 @theme {
   --color-canvas: transparent;
   --color-accent-1: transparent;

package/packages/client/src/styles/generated/theme-runtime.css

@@ -1,5 +1,5 @@
 /* Generated by packages/theme-engine/scripts/generate-default-css.mjs. */
-/* Theme ce1519e51694cda9; CSS 46ad585b96fd4632. */
+/* Theme e16cba3eb864dee4; CSS 88769b376e50f0b1. */
 @theme {
   --color-separator: transparent;
   --color-separator-muted: transparent;
@@ -280,36 +280,39 @@
   --color-surface-8-ink: transparent;
   --color-surface-8-ink-muted: transparent;
   --color-surface-8-ink-subtle: transparent;
-  --shadow-depth-workspace-0: none;
-  --shadow-depth-workspace-1: none;
-  --shadow-depth-workspace-2: none;
-  --shadow-depth-workspace-3: none;
-  --shadow-depth-workspace-4: none;
-  --shadow-depth-workspace-5: none;
-  --shadow-depth-workspace-6: none;
-  --shadow-depth-workspace-7: none;
-  --shadow-depth-workspace-8: none;
-  --shadow-depth-chrome-0: none;
-  --shadow-depth-chrome-1: none;
-  --shadow-depth-chrome-2: none;
-  --shadow-depth-chrome-3: none;
-  --shadow-depth-chrome-4: none;
-  --shadow-depth-chrome-5: none;
-  --shadow-depth-chrome-6: none;
-  --shadow-depth-chrome-7: none;
-  --shadow-depth-chrome-8: none;
-  --shadow-elevation-0: none;
-  --shadow-elevation-1: none;
-  --shadow-elevation-2: none;
-  --shadow-elevation-3: none;
-  --shadow-elevation-4: none;
-  --shadow-elevation-5: none;
-  --shadow-elevation-6: none;
-  --shadow-elevation-7: none;
-  --shadow-elevation-8: none;
   --color-interaction-disabled-ink: transparent;
 }
 
+@theme reference {
+  --shadow-depth-workspace-0: var(--shadow-depth-workspace-0);
+  --shadow-depth-workspace-1: var(--shadow-depth-workspace-1);
+  --shadow-depth-workspace-2: var(--shadow-depth-workspace-2);
+  --shadow-depth-workspace-3: var(--shadow-depth-workspace-3);
+  --shadow-depth-workspace-4: var(--shadow-depth-workspace-4);
+  --shadow-depth-workspace-5: var(--shadow-depth-workspace-5);
+  --shadow-depth-workspace-6: var(--shadow-depth-workspace-6);
+  --shadow-depth-workspace-7: var(--shadow-depth-workspace-7);
+  --shadow-depth-workspace-8: var(--shadow-depth-workspace-8);
+  --shadow-depth-chrome-0: var(--shadow-depth-chrome-0);
+  --shadow-depth-chrome-1: var(--shadow-depth-chrome-1);
+  --shadow-depth-chrome-2: var(--shadow-depth-chrome-2);
+  --shadow-depth-chrome-3: var(--shadow-depth-chrome-3);
+  --shadow-depth-chrome-4: var(--shadow-depth-chrome-4);
+  --shadow-depth-chrome-5: var(--shadow-depth-chrome-5);
+  --shadow-depth-chrome-6: var(--shadow-depth-chrome-6);
+  --shadow-depth-chrome-7: var(--shadow-depth-chrome-7);
+  --shadow-depth-chrome-8: var(--shadow-depth-chrome-8);
+  --shadow-elevation-0: var(--shadow-elevation-0);
+  --shadow-elevation-1: var(--shadow-elevation-1);
+  --shadow-elevation-2: var(--shadow-elevation-2);
+  --shadow-elevation-3: var(--shadow-elevation-3);
+  --shadow-elevation-4: var(--shadow-elevation-4);
+  --shadow-elevation-5: var(--shadow-elevation-5);
+  --shadow-elevation-6: var(--shadow-elevation-6);
+  --shadow-elevation-7: var(--shadow-elevation-7);
+  --shadow-elevation-8: var(--shadow-elevation-8);
+}
+
 :root, .light, .dark {
 
 }
@@ -600,6 +603,7 @@
   --color-intent-neutral-focus-width: 1px;
   --color-intent-success-focus-width: 1px;
   --color-intent-warning-focus-width: 1px;
+  --background-text-selection: oklch(56.6817% 0.186805 255.023 / 0.25);
   --background-interaction-selection-accent: oklch(50.7563% 0.185449 257.696 / 0.118811);
   --background-interaction-selection-accent-hover: oklch(50.7563% 0.185449 257.696 / 0.167052);
   --background-interaction-selection-danger: oklch(50.7345% 0.20819 29.2339 / 0.120444);
@@ -929,6 +933,7 @@
   --color-intent-neutral-focus-width: 1px;
   --color-intent-success-focus-width: 1px;
   --color-intent-warning-focus-width: 1px;
+  --background-text-selection: oklch(56.6817% 0.186805 255.023 / 0.25);
   --background-interaction-selection-accent: oklch(77.6317% 0.121666 245.606 / 0.0588726);
   --background-interaction-selection-accent-hover: oklch(77.6317% 0.121666 245.606 / 0.0872552);
   --background-interaction-selection-danger: oklch(78.4251% 0.125337 22.7638 / 0.0561766);
@@ -1259,6 +1264,7 @@
   --color-intent-neutral-focus-width: 1px;
   --color-intent-success-focus-width: 1px;
   --color-intent-warning-focus-width: 1px;
+  --background-text-selection: oklch(56.6817% 0.186805 255.023 / 0.25);
   --background-interaction-selection-accent: oklch(77.6317% 0.121666 245.606 / 0.0588726);
   --background-interaction-selection-accent-hover: oklch(77.6317% 0.121666 245.606 / 0.0872552);
   --background-interaction-selection-danger: oklch(78.4251% 0.125337 22.7638 / 0.0561766);

package/packages/client/src/styles/theme-support.css

@@ -9,6 +9,13 @@
 @custom-variant ui-active (&:is(:active, :focus-visible, [data-active], [data-highlighted]));
 @custom-variant ui-selected (&:is([data-selected="true"], [aria-selected="true"], [data-current], [aria-current]:not([aria-current="false"]), [data-checked], [aria-checked="true"], [data-pressed], [aria-pressed="true"]));
 
+@layer base {
+  ::selection {
+    background-color: var(--background-text-selection);
+    color: var(--color-text-selection-ink, currentColor);
+  }
+}
+
 /* Bundled SVG icon templates use a shared transparent-shape utility. */
 @source inline("fill-none");
 

package/packages/client/types/components/import-flow/contract.d.ts

@@ -1,6 +1,7 @@
 type ImportFlowProps = {
     id: string;
     session: string;
+    action: string;
     step: 'upload' | 'schema' | 'mapping' | 'review' | 'preview';
     revision: number;
     busy: boolean;

package/packages/client/types/core.d.ts

@@ -6,7 +6,7 @@ export { coreRuntime, ui };
 export default coreRuntime;
 export type { CoreRuntimePlugin };
 export { bool, createAlpineMachine, createMachine, decodeProps, defineAlpineData, defineManifest, defineSchemaManifest, defineProps, defineStyles, json, mergeBindings, number, oneOf, propsFromSchema, resolveStyle, string, createTransitionCoordinator, defineHook, } from './runtime';
-export type { AlpineMachine, AlpineMachineOwner, AlpinePropsChangedEvent, AlpineDataFactory, AlpineDataRegistrar, CodecFn, ComponentManifest, CreateAlpineMachineOptions, DecodePropsOptions, Machine, MachineConfig, MachineEffect, MachineEffectList, MachineEffectRef, MachineEntry, MachineEvent, MachineEventObject, MachineGuard, MachineOptions, MachineReducer, MachineReducerList, MachineReducerRef, MachineScope, MachineSnapshot, MachineStateConfig, MachineStateValue, MachineTransition, MachineTransitionDefinition, MachineUpdate, DefineManifestOptions, DefineSchemaManifestOptions, DefineStylesOptions, ManifestPart, ManifestProp, ManifestPropDetails, ManifestToken, ManualComponentManifest, MachineFactoryScope, BindingInput, PropState, PropsFromSchemaOptions, MergeBindingsOptions, ResolveStyleOptions, SchemaPropDetails, SchemaComponentManifest, SchemaToProps, StyleDefinition, StylePart, StyleProps, TrellisAlpineComponent, AnyTransitionHook, TransitionCallback, TransitionContext, TransitionCoordinator, TransitionCoordinatorOptions, TransitionEventCreator, TransitionForHook, TransitionHookDefinition, UiGetOptions, UiRequestOptions, UiRuntime, } from './runtime';
+export type { AlpineMachine, AlpineMachineOwner, AlpinePropsChangedEvent, AlpineDataFactory, AlpineDataRegistrar, CodecFn, ComponentManifest, CreateAlpineMachineOptions, DecodePropsOptions, Machine, MachineConfig, MachineEffect, MachineEffectList, MachineEffectRef, MachineEntry, MachineEvent, MachineEventObject, MachineGuard, MachineOptions, MachineReducer, MachineReducerList, MachineReducerRef, MachineScope, MachineSnapshot, MachineStateConfig, MachineStateValue, MachineTransition, MachineTransitionDefinition, MachineUpdate, DefineManifestOptions, DefineSchemaManifestOptions, DefineStylesOptions, ManifestPart, ManifestProp, ManifestPropDetails, ManifestToken, ManualComponentManifest, MachineFactoryScope, BindingInput, PropState, PropsFromSchemaOptions, MergeBindingsOptions, ResolveStyleOptions, SchemaPropDetails, SchemaComponentManifest, SchemaToProps, StyleDefinition, StylePart, StyleProps, TrellisAlpineComponent, AnyTransitionHook, TransitionCallback, TransitionContext, TransitionCoordinator, TransitionCoordinatorOptions, TransitionEventCreator, TransitionForHook, TransitionHookDefinition, UiGetOptions, UiRequestOptions, UiRuntime, UiTheme, ThemeMode, ResolvedThemeMode, } from './runtime';
 export { registerTransitionDirective } from './directives/transition';
 export type { AnimationRecipe, AnimationPhase, AnimationContext } from './motion/registry';
 export type { MotionConfiguration } from './motion/config';

package/packages/client/types/runtime/index.d.ts

@@ -23,7 +23,7 @@ export { defineStyles, resolveStyle, type DefineStylesOptions, type ResolveStyle
 export { del as deleteRequest, get, post, put, registerRequestRuntime, type RequestLifecycleDetail, type RequestMethod, type RequestOptions, type RequestResult, } from './engine/request';
 export { replaceFragmentChildren, replaceFragmentChildrenNow, type FragmentAlpine, type ReplaceFragmentOptions, } from './engine/fragment';
 export { applyStreamPatches, applyUiEffect, applyUiEffects, connectStream, dispatchStreamEvent, registerStream, type PatchMode, type StreamEventPayload, type StreamPatchPayload, type UiEffectPayload, } from './engine/stream';
-export { applyThemeMode, createThemeStore, registerThemeStore, type ResolvedThemeMode, type ThemeChangeDetail, type ThemeStore, type ThemeMode, } from './theme';
+export { applyThemeMode, createTheme, type ResolvedThemeMode, type ThemeChangeDetail, type UiTheme, type ThemeMode, } from './theme';
 export { acquireDocumentScrollLock } from './scroll-lock';
 export { registerUiMagic, ui, type UiGetOptions, type UiRequestOptions, type UiRuntime } from './ui';
 export { createVirtualWindowController, fixedAxisWindowAdapter, type FixedAxisInputDetail, type FixedAxisScrollTarget, type FixedAxisWindowAdapter, type FixedAxisWindow, type FixedAxisWindowInput, type VirtualAxis, type VirtualAxisWindow, type VirtualScrollAlign, type VirtualWindowAdapter, type VirtualWindowBase, type VirtualWindowController, type VirtualWindowControllerOptions, type VirtualWindowKind, type VirtualWindowRequest, type VirtualWindowSnapshot, } from './virtual-window';

package/packages/client/types/runtime/theme.d.ts

@@ -8,15 +8,17 @@ type ThemeChangeDetail = {
     dark: boolean;
     on: boolean;
 };
-type ThemeStore = {
+type UiTheme = {
     mode: ThemeMode;
     resolved: ResolvedThemeMode;
+    readonly isLight: boolean;
+    readonly isDark: boolean;
+    readonly isSystem: boolean;
     readonly dark: boolean;
     readonly on: boolean;
     set: (mode: ThemeMode) => void;
     toggle: () => void;
 };
 declare const applyThemeMode: (mode: ThemeMode) => ThemeChangeDetail;
-declare const createThemeStore: () => ThemeStore;
-declare const registerThemeStore: (AlpineInstance: AlpineType) => void;
-export { applyThemeMode, createThemeStore, registerThemeStore, type ResolvedThemeMode, type ThemeChangeDetail, type ThemeStore, type ThemeMode, };
+declare const createTheme: (reactive: AlpineType["reactive"]) => UiTheme;
+export { applyThemeMode, createTheme, type ResolvedThemeMode, type ThemeChangeDetail, type UiTheme, type ThemeMode, };

package/packages/client/types/runtime/ui.d.ts

@@ -1,5 +1,6 @@
 import type Alpine from 'alpinejs';
 import { animate } from '../motion';
+import { type UiTheme } from './theme';
 import { type NavigationHistory, type RequestOptions, type RequestResult } from './engine/request';
 import type { UiSortableService } from './drag-and-drop/sortable';
 type UiRequestOptions = RequestOptions & {
@@ -18,6 +19,7 @@ type UiRuntime = {
     readonly isFetching: boolean;
     readonly animate: typeof animate;
     readonly sortable: UiSortableService;
+    readonly theme: UiTheme;
 };
 type UiCapabilities = {
     sortable?: UiSortableService;

package/packages/server/trellis_ui/static/trellis_ui/assets/js/esm/build-metadata.json

@@ -62,11 +62,11 @@
         "packages/client/src/capabilities/shortcut.entry.generated.ts"
       ]
     },
-    "capabilities/sortable-Do3a0LA9.js": {
+    "capabilities/sortable-CgP1efhO.js": {
       "entry": true,
       "facade": "/Users/tristanrobinette/PycharmProjects/django_ui/packages/client/src/capabilities/sortable.entry.generated.ts",
       "imports": [
-        "chunks/capability-sortable-Bm1phXnj.js"
+        "chunks/capability-sortable-CpUAUTdh.js"
       ],
       "dynamicImports": [],
       "modules": [
@@ -136,7 +136,7 @@
         "packages/client/src/components/checkbox/styles.ts"
       ]
     },
-    "components/data-grid-Dm3rQfQ_.js": {
+    "components/data-grid-Cr9kEoo9.js": {
       "entry": true,
       "facade": "/Users/tristanrobinette/PycharmProjects/django_ui/packages/client/src/components/data-grid/entry.generated.ts",
       "imports": [
@@ -148,7 +148,7 @@
         "chunks/cleanup-manager-D9QiZF_Q.js",
         "chunks/alpine-data-Dvc_bXq6.js",
         "chunks/cursor-data-source-DdiMUeJM.js",
-        "chunks/capability-sortable-Bm1phXnj.js",
+        "chunks/capability-sortable-CpUAUTdh.js",
         "chunks/capability-resizable-DPMSJ1AR.js",
         "chunks/common-DnEHZCqy.js",
         "chunks/layout-mHPk9rxi.js"
@@ -728,7 +728,7 @@
         "packages/client/src/components/virtualizer/index.ts"
       ]
     },
-    "core-CX4J7tsN.js": {
+    "core-CbDVD_pk.js": {
       "entry": true,
       "facade": "/Users/tristanrobinette/PycharmProjects/django_ui/packages/client/src/core.ts",
       "imports": [
@@ -739,8 +739,7 @@
         "chunks/dom-invalidation-Dw6clnS4.js",
         "chunks/codecs-CQ7olTJL.js",
         "chunks/machine-Do4tL7nc.js",
-        "chunks/ui-CZ7fEQL2.js",
-        "chunks/preferences-BZyZ-kK6.js",
+        "chunks/ui-CVVSxrtG.js",
         "chunks/alpine-data-Dvc_bXq6.js",
         "chunks/styles-CX2j92ex.js",
         "chunks/merge-bindings-BtqW3UgP.js"
@@ -753,8 +752,7 @@
         "packages/client/src/directives/transition.ts",
         "packages/client/src/runtime/confirm.ts",
         "packages/client/src/runtime/manifest.ts",
-        "packages/client/src/runtime/morph-engine.ts",
-        "packages/client/src/runtime/theme.ts"
+        "packages/client/src/runtime/morph-engine.ts"
       ]
     },
     "chunks/alpine-data-Dvc_bXq6.js": {
@@ -819,7 +817,7 @@
         "packages/client/src/capabilities/shortcut.ts"
       ]
     },
-    "chunks/capability-sortable-Bm1phXnj.js": {
+    "chunks/capability-sortable-CpUAUTdh.js": {
       "entry": false,
       "facade": null,
       "imports": [
@@ -833,7 +831,7 @@
         "chunks/codecs-CQ7olTJL.js",
         "chunks/machine-Do4tL7nc.js",
         "chunks/focus-BvBkrIcj.js",
-        "chunks/ui-CZ7fEQL2.js",
+        "chunks/ui-CVVSxrtG.js",
         "chunks/floating-ui.dom-B05VsV_p.js",
         "chunks/common-DnEHZCqy.js"
       ],
@@ -1632,7 +1630,7 @@
         "packages/client/src/runtime/styles.ts"
       ]
     },
-    "chunks/ui-CZ7fEQL2.js": {
+    "chunks/ui-CVVSxrtG.js": {
       "entry": false,
       "facade": null,
       "imports": [
@@ -1645,7 +1643,8 @@
         "chunks/morph-Cq3V_23_.js",
         "chunks/dom-invalidation-Dw6clnS4.js",
         "chunks/machine-Do4tL7nc.js",
-        "chunks/focus-BvBkrIcj.js"
+        "chunks/focus-BvBkrIcj.js",
+        "chunks/preferences-BZyZ-kK6.js"
       ],
       "dynamicImports": [],
       "modules": [
@@ -1653,6 +1652,7 @@
         "packages/client/src/runtime/engine/navigation.ts",
         "packages/client/src/runtime/engine/request.ts",
         "packages/client/src/runtime/engine/stream.ts",
+        "packages/client/src/runtime/theme.ts",
         "packages/client/src/runtime/ui.ts"
       ]
     },

package/packages/server/trellis_ui/static/trellis_ui/assets/js/esm/capabilities/sortable-CgP1efhO.js

@@ -0,0 +1,2 @@
+import{n as e,r as t,t as n}from"../chunks/capability-sortable-CpUAUTdh.js";var r=n;export{t as createSortableRegistry,r as default,n as registerSortableCapability,e as registerSortableDirective};
+//# sourceMappingURL=sortable-CgP1efhO.js.map

package/packages/server/trellis_ui/static/trellis_ui/assets/js/esm/capabilities/{sortable-Do3a0LA9.js.map → sortable-CgP1efhO.js.map}

@@ -1 +1 @@
-{"version":3,"file":"sortable-Do3a0LA9.js","names":[],"sources":["../../../../../../../../client/src/capabilities/sortable.entry.generated.ts"],"sourcesContent":["// Generated by scripts/generate_component_entries.mjs from packages/client/component-entries.json.\n// Do not edit by hand.\nimport {registerSortableCapability} from './sortable';\n\nexport default registerSortableCapability;\nexport * from './sortable';\n"],"mappings":"4EAIA,IAAA,EAAe"}
+{"version":3,"file":"sortable-CgP1efhO.js","names":[],"sources":["../../../../../../../../client/src/capabilities/sortable.entry.generated.ts"],"sourcesContent":["// Generated by scripts/generate_component_entries.mjs from packages/client/component-entries.json.\n// Do not edit by hand.\nimport {registerSortableCapability} from './sortable';\n\nexport default registerSortableCapability;\nexport * from './sortable';\n"],"mappings":"4EAIA,IAAA,EAAe"}

package/packages/server/trellis_ui/static/trellis_ui/assets/js/esm/capabilities/sortable.js

@@ -1,2 +1,2 @@
-export * from "./sortable-Do3a0LA9.js";
-export {default} from "./sortable-Do3a0LA9.js";
+export * from "./sortable-CgP1efhO.js";
+export {default} from "./sortable-CgP1efhO.js";