@vireo-ai/trellis-ui 0.1.59 → 0.1.61

package/README.md

@@ -1 +0,0 @@
-# Trellis UI

package/THIRD_PARTY_NOTICES.md

@@ -7,6 +7,8 @@ Trellis UI's morph engine adapts behavior and matching ideas from Alpine.js Morp
 - Alpine.js Morph — Copyright © 2019-2025 Caleb Porzio and contributors
 - Morphlex — Copyright © 2024 Joel Drapper
 - Datastar — Copyright © Star Federation
+- TypeBox (bundled in the Node theme CLI) — Copyright © 2017-2026 Haydn Paterson
+- Color.js (bundled in the Node theme CLI) — Copyright © 2021 Lea Verou, Chris Lilley
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vireo-ai/trellis-ui",
-  "version": "0.1.59",
+  "version": "0.1.61",
   "type": "module",
   "description": "Django-native UI toolkit for building realtime and interactive web apps.",
   "license": "MIT",
@@ -18,21 +18,22 @@
     "THIRD_PARTY_NOTICES.md",
     "README.md",
     "packages/client/types/**/*.d.ts",
-    "packages/client/src/styles/**/*.css",
-    "packages/client/src/components/**/*.css",
-    "packages/client/src/directives/**/*.css",
-    "packages/client/src/runtime/**/*.css",
-    "packages/server/trellis_ui/static/trellis_ui/assets/css/trellis.css",
-    "packages/server/trellis_ui/static/trellis_ui/assets/css/trellis.min.css",
-    "packages/server/trellis_ui/static/trellis_ui/assets/js/trellis.js",
-    "packages/server/trellis_ui/static/trellis_ui/assets/js/trellis.min.js",
+    "packages/client/src/**/*.css",
+    "packages/server/trellis_ui/static/trellis_ui/assets/css/*.css",
+    "packages/server/trellis_ui/static/trellis_ui/assets/js/*.js",
     "packages/server/trellis_ui/static/trellis_ui/assets/js/esm/**/*.js",
     "packages/server/trellis_ui/static/trellis_ui/assets/js/esm/**/*.js.map",
     "packages/server/trellis_ui/static/trellis_ui/assets/js/esm/**/*.json",
-    "!packages/client/types/components/manifests.d.ts",
-    "!packages/client/types/components/styles.d.ts",
+    "!packages/client/types/components/manifests.generated.d.ts",
+    "!packages/client/types/components/styles.generated.d.ts",
     "!packages/client/types/components/**/manifest.d.ts",
-    "!packages/client/types/components/**/styles.d.ts"
+    "!packages/client/types/components/**/styles.d.ts",
+    "!packages/client/types/components/runtime-docs.generated.d.ts",
+    "packages/theme-engine/dist/trellis.js",
+    "packages/theme-engine/generated/schemas/*.json",
+    "packages/theme-engine/generated/knobs/v1/**/*.json",
+    "packages/theme-engine/skills/create-trellis-theme/**",
+    "packages/theme-engine/THEME_AUTHORING.md"
   ],
   "exports": {
     ".": {
@@ -98,44 +99,52 @@
     "@types/node": "^25.9.8",
     "alpinejs": "^3.17.4",
     "jsdom": "^29.1.1",
+    "postcss": "8.5.28",
+    "postcss-value-parser": "4.2.0",
     "tailwindcss": "^4.3.3",
     "typescript": "^6.0.3",
     "vite": "^8.3.0",
     "vitest": "^4.1.11"
   },
+  "bin": {
+    "trellis": "./packages/theme-engine/dist/trellis.js"
+  },
   "scripts": {
-    "generate:component-entries": "node scripts/generate_component_entries.mjs",
-    "analyze:runtime": "node scripts/analyze_runtime_build.mjs",
-    "check:runtime-boundary": "node scripts/generate_asset_registry.mjs --check && node scripts/check_runtime_boundary.mjs",
-    "verify:packed-consumer": "node scripts/verify_packed_consumer.mjs",
-    "typecheck": "pnpm run generate:component-entries && tsc --noEmit",
-    "test:unit": "pnpm run generate:component-entries && vitest run --configLoader runner --no-file-parallelism",
-    "test:python": "uv run pytest tests/server",
-    "test:browser": "playwright test",
-    "test": "pnpm run test:unit && pnpm run test:python && pnpm run test:browser",
-    "test:watch": "pnpm run generate:component-entries && vitest --configLoader runner",
+    "generate:component-entries": "node scripts/build.mjs generate:component-entries",
+    "analyze:runtime": "node scripts/build.mjs analyze:runtime",
+    "check:runtime-boundary": "node scripts/build.mjs check:runtime-boundary",
+    "verify:packed-consumer": "node scripts/build.mjs verify:packed-consumer",
+    "typecheck": "node scripts/build.mjs typecheck",
+    "test:unit": "node scripts/build.mjs test:unit",
+    "test:python": "node scripts/build.mjs test:python",
+    "test:browser": "node scripts/build.mjs test:browser",
+    "test": "node scripts/build.mjs test",
+    "test:watch": "node scripts/build.mjs test:watch",
     "trellis": "node packages/theme-engine/dist/cli.js",
     "prek": "uv run prek",
-    "clean:types": "node -e \"require('node:fs').rmSync('packages/client/types', { recursive: true, force: true })\"",
-    "build:theme": "pnpm --filter @vireo-ai/trellis-theme-engine run build && node packages/theme-engine/scripts/generate-default-css.mjs && node packages/theme-engine/scripts/generate-theme-knobs.mjs",
-    "build:docs-theme": "pnpm trellis theme build docs/trellis/themes/default/theme.json",
-    "build:sources": "pnpm run build:theme && pnpm run build:manifests",
-    "build:manifests": "vite build --config vite.manifests.config.ts --configLoader runner && python3 scripts/generate_ui_events.py",
-    "build:runtime-docs": "pnpm run build:manifests && pnpm run build:types && pnpm run generate:runtime-docs",
-    "generate:runtime-docs": "vite build --config vite.runtime-docs.config.ts --configLoader runner && api-extractor run --local && node scripts/generate_component_runtime_docs.mjs",
-    "build:types": "pnpm run generate:component-entries && pnpm run clean:types && tsc -p tsconfig.build.json && node scripts/rewrite_declaration_aliases.mjs",
-    "build:js": "pnpm run generate:component-entries && vite build --configLoader runner && node scripts/copy_minified_js_alias.mjs && vite build --config vite.esm.config.ts --configLoader runner && node scripts/generate_asset_registry.mjs && pnpm run analyze:runtime && pnpm run build:types",
-    "build:css": "pnpm run build:sources && tailwindcss -i ./packages/client/src/styles/static.css -o ./packages/server/trellis_ui/static/trellis_ui/assets/css/trellis.css && tailwindcss -i ./packages/client/src/styles/static.css -o ./packages/server/trellis_ui/static/trellis_ui/assets/css/trellis.min.css --minify",
-    "build:package": "pnpm run build:css && pnpm run build:js",
-    "build:docs": "pnpm --dir docs run build",
-    "build": "pnpm run build:package && pnpm run build:docs",
-    "check": "pnpm run build:package && pnpm run generate:runtime-docs && pnpm run typecheck && pnpm test",
-    "check:packages": "pnpm --filter @vireo-ai/trellis-theme-engine run verify:package && pnpm run check:runtime-boundary && pnpm run verify:packed-consumer && uv build --sdist --wheel",
-    "check:release": "pnpm run check && pnpm run check:packages",
+    "clean:types": "node scripts/build.mjs clean:types",
+    "build:theme": "node scripts/build.mjs build:theme",
+    "build:docs-theme": "node scripts/build.mjs build:docs-theme",
+    "build:sources": "node scripts/build.mjs build:sources",
+    "build:manifests": "node scripts/build.mjs build:manifests",
+    "build:runtime-docs": "node scripts/build.mjs build:runtime-docs",
+    "generate:runtime-docs": "node scripts/build.mjs generate:runtime-docs",
+    "build:types": "node scripts/build.mjs build:types",
+    "build:js": "node scripts/build.mjs build:js",
+    "build:css": "node scripts/build.mjs build:css",
+    "build:package": "node scripts/build.mjs build:package",
+    "build:docs": "node scripts/build.mjs build:docs",
+    "build": "node scripts/build.mjs build",
+    "check": "node scripts/build.mjs check",
+    "check:packages": "node scripts/build.mjs check:packages",
+    "check:release": "node scripts/build.mjs check:release",
     "release": "node scripts/release.mjs",
     "publish:npm": "pnpm run check:release && pnpm publish dist/trellis-ui.tgz --access public --ignore-scripts",
-    "publish:pypi": "pnpm run build:package && uv build --sdist --wheel && uv publish dist/django_trellis-${npm_package_version}.tar.gz dist/django_trellis-${npm_package_version}-py3-none-any.whl",
+    "publish:pypi": "node scripts/build.mjs python:pack && uv publish dist/django_trellis-${npm_package_version}.tar.gz dist/django_trellis-${npm_package_version}-py3-none-any.whl",
     "publish:all": "pnpm run check:release && pnpm publish dist/trellis-ui.tgz --access public --ignore-scripts && uv publish dist/django_trellis-${npm_package_version}.tar.gz dist/django_trellis-${npm_package_version}-py3-none-any.whl",
-    "dev:css": "pnpm run build:sources && tailwindcss -i ./packages/client/src/styles/static.css -o ./packages/server/trellis_ui/static/trellis_ui/assets/css/trellis.min.css --minify --watch"
+    "dev:css": "pnpm run build:sources && pnpm run \"/^dev:css:(compile|assets)$/\"",
+    "dev:css:compile": "tailwindcss -i ./packages/client/src/styles/static.css -o ./packages/server/trellis_ui/static/trellis_ui/assets/css/trellis.min.css --minify --watch",
+    "dev:css:assets": "node scripts/generate_static_asset_registry.mjs --watch",
+    "build:cli": "node scripts/build.mjs build:cli"
   }
 }

package/packages/client/src/components/field/styles.css

@@ -104,7 +104,8 @@
     box-shadow: 0 0 0 var(--color-intent-accent-focus-width) var(--color-intent-accent-focus);
   }
 
-  [data-ui-control][data-ui-control-recipe="field"] :is(input, select, textarea, button):disabled {
+  /* Nested actions own their paired ink and disabled attenuation. */
+  [data-ui-control][data-ui-control-recipe="field"] :is(input, select, textarea, button):disabled:not([data-ui-action-recipe]) {
     color: inherit;
     opacity: 1;
     -webkit-text-fill-color: currentColor;

package/packages/client/src/styles/components.css

@@ -6,6 +6,7 @@
   ::part(...), :has(...), native quirks, or child-order selectors.
 */
 
+@import "./motion.css";
 @import "../runtime/drag-and-drop/resize-handle.css";
 @import "../components/brand/styles.css";
 @import "../components/app/styles.css";

package/packages/client/src/styles/static.css

@@ -1,4 +1,3 @@
 @import "./generated/theme-fonts.css";
 @import "tailwindcss" source(none);
 @import "./theme.css";
-@import "./motion.css";

package/packages/client/types/assets/full-runtime.generated.d.ts

@@ -1,2 +1,2 @@
-declare const fullRuntimeAssetIds: readonly ["trellis:core", "trellis:motion", "trellis:resizable", "trellis:sortable", "trellis:shortcut", "trellis:accordion", "trellis:button", "trellis:checkbox", "trellis:date-picker", "trellis:direct-upload", "trellis:dropdown", "trellis:field", "trellis:file-upload", "trellis:formset", "trellis:import-mapper", "trellis:input", "trellis:keybinding", "trellis:modal", "trellis:panels", "trellis:radio", "trellis:scroll-area", "trellis:select", "trellis:sidebar", "trellis:slider", "trellis:switch", "trellis:tabs", "trellis:toast", "trellis:tooltip", "trellis:data-grid", "trellis:virtualizer", "trellis:table"];
+declare const fullRuntimeAssetIds: readonly ["trellis:core", "trellis:motion", "trellis:anchor", "trellis:resizable", "trellis:sortable", "trellis:shortcut", "trellis:accordion", "trellis:button", "trellis:checkbox", "trellis:date-picker", "trellis:direct-upload", "trellis:dropdown", "trellis:field", "trellis:file-upload", "trellis:formset", "trellis:import-mapper", "trellis:input", "trellis:keybinding", "trellis:modal", "trellis:panels", "trellis:radio", "trellis:scroll-area", "trellis:select", "trellis:sidebar", "trellis:slider", "trellis:switch", "trellis:tabs", "trellis:toast", "trellis:tooltip", "trellis:data-grid", "trellis:virtualizer", "trellis:table"];
 export { fullRuntimeAssetIds };

package/packages/client/types/capabilities/anchor.d.ts

@@ -0,0 +1,7 @@
+import type { Alpine as AlpineType } from 'alpinejs';
+import { registerAnchorDirective } from '../directives/anchor';
+declare const registerAnchorCapability: (AlpineInstance: AlpineType) => void;
+export { registerAnchorDirective, registerAnchorCapability };
+export type { AnchorRectangle, AnchorTarget } from '../directives/anchor';
+export { createAnchoredPopover, createAnchoredPopoverSurface, } from '../runtime/anchored-popover';
+export type { AnchoredPopover, AnchoredPopoverOptions, AnchoredPopoverSurface, PopoverAlign, PopoverSide, } from '../runtime/anchored-popover';

package/packages/client/types/capabilities/anchor.entry.generated.d.ts

@@ -0,0 +1,3 @@
+import { registerAnchorCapability } from './anchor';
+export default registerAnchorCapability;
+export * from './anchor';

package/packages/client/types/components/accordion/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const accordionRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { accordionRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/checkbox/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const checkboxRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { checkboxRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/data-grid/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const dataGridRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { dataGridRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/date-picker/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const datePickerRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { datePickerRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/direct-upload/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const directUploadRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { directUploadRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/dropdown/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const dropdownRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { dropdownRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/entry.generated.d.ts

@@ -31,6 +31,7 @@ export * from './data-grid/entry.generated';
 export * from './virtualizer/entry.generated';
 export * from './table/entry.generated';
 export * from '../capabilities/motion';
+export * from '../capabilities/anchor';
 export * from '../capabilities/resizable';
 export * from '../capabilities/sortable';
 export * from '../capabilities/shortcut';

package/packages/client/types/components/field/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const fieldRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { fieldRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/file-upload/index.d.ts

@@ -1,3 +1,4 @@
+import type Alpine from 'alpinejs';
 import { type AlpineMachine, type TransitionForHook, type TrellisAlpineComponent } from '../../runtime';
 import { type FileUploadProps } from './contract';
 import { fileUploadHooks, type FileTransferStatus, type FileUploadContext, type FileUploadMetadata, type FileUploadRecord } from './machine';
@@ -38,7 +39,7 @@ type FileUploadData = AlpineMachine<FileUploadContext, FileUploadProps, typeof f
     init(): void;
     destroy(): void;
 };
-declare const UiFileUpload: () => TrellisAlpineComponent<FileUploadData>;
-declare const registerFileUpload: import("../../runtime").AlpineDataRegistrar;
+declare const UiFileUpload: (AlpineInstance: Alpine.Alpine) => TrellisAlpineComponent<FileUploadData>;
+declare const registerFileUpload: (AlpineInstance: Alpine.Alpine) => void;
 export { registerFileUpload, UiFileUpload };
 export type { FileTransferStatus, FileUploadData, FileUploadMetadata, FileUploadRecord, FileUploadTransition, UiFileUploadApi, };

package/packages/client/types/components/file-upload/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const fileUploadRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { fileUploadRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/formset/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const formsetRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { formsetRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/image/contract.d.ts

@@ -6,7 +6,7 @@ declare const imageSchema: {
     src: import("../../runtime/codecs").StringCodec;
     alt: import("../../runtime/codecs").StringCodec;
     fit: import("../../runtime/codecs").OneOfCodec<"fill" | "contain" | "none" | "cover" | "scale-down">;
-    loading: import("../../runtime/codecs").OneOfCodec<"eager" | "lazy">;
+    loading: import("../../runtime/codecs").OneOfCodec<"lazy" | "eager">;
     decoding: import("../../runtime/codecs").OneOfCodec<"auto" | "sync" | "async">;
     class: import("../../runtime/codecs").StringCodec;
     imageClass: import("../../runtime/codecs").StringCodec;

package/packages/client/types/components/modal/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const modalRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { modalRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/panels/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const panelsRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { panelsRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/radio/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const radioRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { radioRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/scroll-area/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const scrollAreaRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { scrollAreaRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/select/index.d.ts

@@ -1,3 +1,4 @@
+import type Alpine from 'alpinejs';
 import { type AlpineMachine, type TransitionForHook, type TrellisAlpineComponent } from '../../runtime';
 import { type BindingObject } from '../../runtime/merge-bindings';
 import { type SelectProps } from './contract';
@@ -48,7 +49,7 @@ type SelectData = AlpineMachine<SelectContext, SelectProps, typeof selectHooks>
     init(): void;
     destroy(): void;
 };
-declare const UiSelect: () => TrellisAlpineComponent<SelectData>;
-declare const registerSelect: import("../../runtime").AlpineDataRegistrar;
+declare const UiSelect: (AlpineInstance: Alpine.Alpine) => TrellisAlpineComponent<SelectData>;
+declare const registerSelect: (AlpineInstance: Alpine.Alpine) => void;
 export { registerSelect, UiSelect };
 export type { SelectData, SelectTransition, UiSelectApi };

package/packages/client/types/components/select/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const selectRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { selectRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/sidebar/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const sidebarRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { sidebarRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/slider/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const sliderRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { sliderRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/switch/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const switchRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { switchRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/tabs/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const tabsRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { tabsRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/toast/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const toastRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { toastRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/tooltip/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const tooltipRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { tooltipRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/components/virtualizer/runtime-docs.d.ts

@@ -1,2 +1,3 @@
 declare const virtualizerRuntimeDocs: import("../../docs/transition-docs").ComponentTransitionDocs;
 export { virtualizerRuntimeDocs };
+export declare const runtimeDocs: readonly [import("../../docs/transition-docs").ComponentTransitionDocs];

package/packages/client/types/directives/anchor.d.ts

@@ -0,0 +1,26 @@
+import type Alpine from 'alpinejs';
+/** Viewport-relative CSS pixels. Zero-sized rectangles can anchor a caret. */
+type AnchorRectangle = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+type AnchorTarget = Element | AnchorRectangle | null;
+/**
+ * Registers x-anchor="element | {x, y, width, height} | null" in Alpine.
+ *
+ * Modifiers: .top/.bottom/.left/.right, .start/.center/.end, .gap.N, .offset.N.
+ * Defaults: bottom-center, 8px gap, 0px cross-axis offset. Uses fixed positioning
+ * and Trellis's shared flip, shift (5px padding), size, and placement metadata.
+ *
+ * x-show, hidden, and native popover visibility remain application-owned. Hidden
+ * surfaces pause positioning; null detaches without hiding or clearing the last
+ * position. Rectangle replacements and field edits are reactive. Scroll/resize
+ * refresh positioning, but applications must supply updated viewport rectangles
+ * when their source moves. Element references use Floating UI's autoUpdate.
+ * Teardown removes observers/listeners and invalidates pending position writes.
+ */
+declare const registerAnchorDirective: (AlpineInstance: Alpine.Alpine) => void;
+export { registerAnchorDirective };
+export type { AnchorRectangle, AnchorTarget };

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

@@ -1,3 +1,4 @@
+export { registerAnchorDirective, type AnchorRectangle, type AnchorTarget } from './anchor';
 export { registerBoundsDirective } from './bounds';
 export { registerLayoutDirective } from './layout';
 export { registerRequestDirective } from './request';

package/packages/client/types/runtime/anchored-popover.d.ts

@@ -1,13 +1,15 @@
+import { type ReferenceElement, type Strategy } from '@floating-ui/dom';
 type PopoverSide = 'top' | 'bottom' | 'left' | 'right';
 type PopoverAlign = 'start' | 'center' | 'end';
 type AnchoredPopoverOptions = {
-    reference: () => HTMLElement;
+    reference: () => ReferenceElement;
     floating: () => HTMLElement;
     position: () => PopoverSide;
     align: () => PopoverAlign;
     gap: () => number;
     offset: () => number;
     matchReferenceWidth?: boolean;
+    strategy?: Strategy;
 };
 type AnchoredPopover = {
     mounted(): boolean;
@@ -22,7 +24,7 @@ type AnchoredPopoverSurface = {
     sync(): void;
     destroy(): void;
 };
-declare const createAnchoredPopover: ({ reference, floating, position: getPosition, align: getAlign, gap, offset, matchReferenceWidth, }: AnchoredPopoverOptions) => AnchoredPopover;
+declare const createAnchoredPopover: ({ reference, floating, position: getPosition, align: getAlign, gap, offset, matchReferenceWidth, strategy, }: AnchoredPopoverOptions) => AnchoredPopover;
 declare const createAnchoredPopoverSurface: (options: AnchoredPopoverOptions) => AnchoredPopoverSurface;
 export { createAnchoredPopover, createAnchoredPopoverSurface };
 export type { AnchoredPopover, AnchoredPopoverOptions, AnchoredPopoverSurface, PopoverAlign, PopoverSide };

package/packages/client/types/runtime/item-template.d.ts

@@ -0,0 +1,13 @@
+import type Alpine from 'alpinejs';
+/** A mounted, scoped template owns its Alpine tree until removal. */
+type TemplateInstance<T extends Record<string, unknown>> = {
+    readonly element: HTMLElement;
+    readonly template: HTMLTemplateElement;
+    update(scope: T): void;
+    mount(container: HTMLElement, before?: Node | null): void;
+    destroy(): void;
+};
+declare const createTemplateInstance: <T extends Record<string, unknown>>(AlpineInstance: Alpine.Alpine, template: HTMLTemplateElement, initialScope: T) => TemplateInstance<T>;
+declare const findItemTemplate: (root: HTMLElement, attribute: string) => HTMLTemplateElement | undefined;
+export { createTemplateInstance, findItemTemplate };
+export type { TemplateInstance };