fluid-primitives 0.17.1 → 0.17.2

package/README.md

@@ -2,12 +2,54 @@
 
 # Fluid Primitives
 
-The headless component library for TYPO3 Fluid
+Unstyled, flexible and accessible UI Primitives that provide a foundation for building your own component library in Fluid.
+
+Fluid Primitives brings modern component patterns to TYPO3. Build accessible, composable UI components with the same developer experience you'd expect from React libraries like Radix or Base UI - but for Fluid templates.
+
+Full documentation can be found at [fluid-primitives.com](https://fluid-primitives.com).
+
+## What You Get
+
+**Accessible by default.** Every interactive component handles keyboard navigation, focus management, and ARIA attributes automatically via [Zag.js](https://zagjs.com/) state machines.
+
+**Composable API.** No more prop drilling. Build complex UIs by composing small, focused parts that work together.
+
+**Unstyled.** Zero design opinions. Use Tailwind, vanilla CSS, or any styling approach. You control every pixel.
+
+**Server-rendered.** Components render on the server with PHP/Fluid, then hydrate on the client. No layout shift, great for SEO.
+
+## Quick Example
+
+A tooltip with full accessibility support in just a few lines:
+
+```html
+<ui:tooltip.root>
+    <ui:tooltip.trigger>Hover me</ui:tooltip.trigger>
+    <ui:tooltip.content>Tooltip content here</ui:tooltip.content>
+</ui:tooltip.root>
+```
+
+That's it. Keyboard support, focus handling, proper ARIA attributes - all handled.
+
+## Why This Exists
+
+TYPO3 Fluid lacked an elegant solution for building robust, interactive components. The typical approach leads to bloated templates with complex conditional logic, poor accessibility, and custom JavaScript that's hard to maintain.
+
+Fluid Primitives solves this by bringing proven patterns from the modern frontend ecosystem to TYPO3, while respecting its server-first architecture.
+
+## Acknowledgments
+
+Built on the shoulders of giants:
+
+- [Zag.js](https://zagjs.com/) - The state machine foundation
+- [Radix UI](https://www.radix-ui.com/primitives) - API design inspiration
+- [Base UI](https://base-ui.com/) - Component behavior patterns
+- [Ark UI](https://ark-ui.com/) - Zag.js integration patterns
 
 ## Documentation
 
-The documentation can be found at [fluid-primitives.com](https://fluid-primitives.com).
+The full documentation can be found at [fluid-primitives.com](https://fluid-primitives.com).
 
 ## Development
 
-See [github.com/jramke/fluid-primitives.com](https://github.com/jramke/fluid-primitives.com) for the development setup.
+See [github.com/jramke/fluid-primitives.com](https://github.com/jramke/fluid-primitives.com) monorepo for the development setup.

package/dist/accordion.d.ts

@@ -1,12 +1,12 @@
 import { Component$1 as Component, Machine$1 as Machine } from "./index-BpcuNDMI.js";
 import * as accordion from "@zag-js/accordion";
-import * as _zag_js_types0 from "@zag-js/types";
+import * as _zag_js_types2 from "@zag-js/types";
 
 //#region Resources/Private/Primitives/Accordion/Accordion.d.ts
 declare class Accordion extends Component<accordion.Props, accordion.Api> {
   static name: string;
   initMachine(props: accordion.Props): Machine<any>;
-  initApi(): accordion.Api<_zag_js_types0.PropTypes<{
+  initApi(): accordion.Api<_zag_js_types2.PropTypes<{
     [x: string]: any;
   }>>;
   render(): void;

package/dist/clipboard.d.ts

@@ -1,12 +1,12 @@
 import { Component$1 as Component, Machine$1 as Machine } from "./index-BpcuNDMI.js";
 import * as clipboard from "@zag-js/clipboard";
-import * as _zag_js_types3 from "@zag-js/types";
+import * as _zag_js_types7 from "@zag-js/types";
 
 //#region Resources/Private/Primitives/Clipboard/Clipboard.d.ts
 declare class Clipboard extends Component<clipboard.Props, clipboard.Api> {
   static name: string;
   initMachine(props: clipboard.Props): Machine<any>;
-  initApi(): clipboard.Api<_zag_js_types3.PropTypes<{
+  initApi(): clipboard.Api<_zag_js_types7.PropTypes<{
     [x: string]: any;
   }>>;
   render(): void;

package/dist/collapsible.d.ts

@@ -1,12 +1,12 @@
 import { Component$1 as Component, Machine$1 as Machine } from "./index-BpcuNDMI.js";
 import * as collapsible from "@zag-js/collapsible";
-import * as _zag_js_types9 from "@zag-js/types";
+import * as _zag_js_types5 from "@zag-js/types";
 
 //#region Resources/Private/Primitives/Collapsible/Collapsible.d.ts
 declare class Collapsible extends Component<collapsible.Props, collapsible.Api> {
   static name: string;
   initMachine(props: collapsible.Props): Machine<any>;
-  initApi(): collapsible.Api<_zag_js_types9.PropTypes<{
+  initApi(): collapsible.Api<_zag_js_types5.PropTypes<{
     [x: string]: any;
   }>>;
   render(): void;

package/dist/dialog.d.ts

@@ -1,12 +1,12 @@
 import { Component$1 as Component, Machine$1 as Machine } from "./index-BpcuNDMI.js";
 import * as dialog from "@zag-js/dialog";
-import * as _zag_js_types2 from "@zag-js/types";
+import * as _zag_js_types1 from "@zag-js/types";
 
 //#region Resources/Private/Primitives/Dialog/Dialog.d.ts
 declare class Dialog extends Component<dialog.Props, dialog.Api> {
   static name: string;
   initMachine(props: dialog.Props): Machine<any>;
-  initApi(): dialog.Api<_zag_js_types2.PropTypes<{
+  initApi(): dialog.Api<_zag_js_types1.PropTypes<{
     [x: string]: any;
   }>>;
   render(): void;

package/dist/number-input.d.ts

@@ -1,13 +1,13 @@
 import { FieldAwareComponent$1 as FieldAwareComponent, FieldMachine, Machine$1 as Machine } from "./index-BpcuNDMI.js";
 import * as numberInput from "@zag-js/number-input";
-import * as _zag_js_types1 from "@zag-js/types";
+import * as _zag_js_types4 from "@zag-js/types";
 
 //#region Resources/Private/Primitives/NumberInput/NumberInput.d.ts
 declare class NumberInput extends FieldAwareComponent<numberInput.Props, numberInput.Api> {
   static name: string;
   propsWithField(props: numberInput.Props, fieldMachine: FieldMachine): numberInput.Props;
   initMachine(props: numberInput.Props): Machine<any>;
-  initApi(): numberInput.Api<_zag_js_types1.PropTypes<{
+  initApi(): numberInput.Api<_zag_js_types4.PropTypes<{
     [x: string]: any;
   }>>;
   render(): void;

package/dist/popover.d.ts

@@ -1,12 +1,12 @@
 import { Component$1 as Component, Machine$1 as Machine } from "./index-BpcuNDMI.js";
 import * as popover from "@zag-js/popover";
-import * as _zag_js_types4 from "@zag-js/types";
+import * as _zag_js_types3 from "@zag-js/types";
 
 //#region Resources/Private/Primitives/Popover/Popover.d.ts
 declare class Popover extends Component<popover.Props, popover.Api> {
   static name: string;
   initMachine(props: popover.Props): Machine<any>;
-  initApi(): popover.Api<_zag_js_types4.PropTypes<{
+  initApi(): popover.Api<_zag_js_types3.PropTypes<{
     [x: string]: any;
   }>>;
   render(): void;

package/dist/radio-group.d.ts

@@ -1,13 +1,13 @@
 import { FieldAwareComponent$1 as FieldAwareComponent, FieldMachine, Machine$1 as Machine } from "./index-BpcuNDMI.js";
 import * as radioGroup from "@zag-js/radio-group";
-import * as _zag_js_types7 from "@zag-js/types";
+import * as _zag_js_types6 from "@zag-js/types";
 
 //#region Resources/Private/Primitives/RadioGroup/RadioGroup.d.ts
 declare class RadioGroup extends FieldAwareComponent<radioGroup.Props, radioGroup.Api> {
   static name: string;
   propsWithField(props: radioGroup.Props, fieldMachine: FieldMachine): radioGroup.Props;
   initMachine(props: radioGroup.Props): Machine<any>;
-  initApi(): radioGroup.Api<_zag_js_types7.PropTypes<{
+  initApi(): radioGroup.Api<_zag_js_types6.PropTypes<{
     [x: string]: any;
   }>>;
   render(): void;

package/dist/select.d.ts

@@ -1,7 +1,7 @@
 import { FieldAwareComponent$1 as FieldAwareComponent, FieldMachine, Machine$1 as Machine } from "./index-BpcuNDMI.js";
 import * as _zag_js_collection0 from "@zag-js/collection";
 import * as select from "@zag-js/select";
-import * as _zag_js_types5 from "@zag-js/types";
+import * as _zag_js_types8 from "@zag-js/types";
 
 //#region Resources/Private/Primitives/Select/Select.d.ts
 declare class Select extends FieldAwareComponent<select.Props, select.Api> {
@@ -9,6 +9,7 @@ declare class Select extends FieldAwareComponent<select.Props, select.Api> {
   propsWithField(props: select.Props, fieldMachine: FieldMachine): select.Props;
   transformProps(props: select.Props): {
     collection: _zag_js_collection0.ListCollection<any>;
+    translations?: select.IntlTranslations | undefined;
     ids?: Partial<{
       root: string;
       content: string;
@@ -54,7 +55,7 @@ declare class Select extends FieldAwareComponent<select.Props, select.Api> {
     onInteractOutside?: ((event: select.InteractOutsideEvent) => void) | undefined;
   };
   initMachine(props: select.Props): Machine<any>;
-  initApi(): select.Api<_zag_js_types5.PropTypes<{
+  initApi(): select.Api<_zag_js_types8.PropTypes<{
     [x: string]: any;
   }>, any>;
   render: () => void;

package/dist/tabs.d.ts

@@ -1,12 +1,12 @@
 import { Component$1 as Component, Machine$1 as Machine } from "./index-BpcuNDMI.js";
 import * as tabs from "@zag-js/tabs";
-import * as _zag_js_types6 from "@zag-js/types";
+import * as _zag_js_types9 from "@zag-js/types";
 
 //#region Resources/Private/Primitives/Tabs/Tabs.d.ts
 declare class Tabs extends Component<tabs.Props, tabs.Api> {
   static name: string;
   initMachine(props: tabs.Props): Machine<any>;
-  initApi(): tabs.Api<_zag_js_types6.PropTypes<{
+  initApi(): tabs.Api<_zag_js_types9.PropTypes<{
     [x: string]: any;
   }>>;
   render: () => void;

package/dist/tooltip.d.ts

@@ -1,12 +1,12 @@
 import { Component$1 as Component, Machine$1 as Machine } from "./index-BpcuNDMI.js";
 import * as tooltip from "@zag-js/tooltip";
-import * as _zag_js_types8 from "@zag-js/types";
+import * as _zag_js_types0 from "@zag-js/types";
 
 //#region Resources/Private/Primitives/Tooltip/Tooltip.d.ts
 declare class Tooltip extends Component<tooltip.Props, tooltip.Api> {
   static name: string;
   initMachine(props: tooltip.Props): Machine<any>;
-  initApi(): tooltip.Api<_zag_js_types8.PropTypes<{
+  initApi(): tooltip.Api<_zag_js_types0.PropTypes<{
     [x: string]: any;
   }>>;
   render(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "fluid-primitives",
-    "version": "0.17.1",
+    "version": "0.17.2",
     "description": "Client-side library for Fluid Primitives.",
     "type": "module",
     "license": "MIT",
@@ -90,25 +90,25 @@
         "zod": "^4.3.6"
     },
     "dependencies": {
-        "@zag-js/accordion": "^1.35.2",
-        "@zag-js/anatomy": "^1.35.2",
-        "@zag-js/checkbox": "^1.35.2",
-        "@zag-js/clipboard": "^1.35.2",
-        "@zag-js/collapsible": "^1.35.2",
-        "@zag-js/collection": "^1.35.2",
-        "@zag-js/core": "^1.35.2",
-        "@zag-js/dialog": "^1.35.2",
-        "@zag-js/dom-query": "^1.35.2",
-        "@zag-js/number-input": "^1.35.2",
-        "@zag-js/popover": "^1.35.2",
-        "@zag-js/radio-group": "^1.35.2",
-        "@zag-js/scroll-area": "^1.35.2",
-        "@zag-js/select": "^1.35.2",
-        "@zag-js/store": "^1.35.2",
-        "@zag-js/tabs": "^1.35.2",
-        "@zag-js/tooltip": "^1.35.2",
-        "@zag-js/types": "^1.35.2",
-        "@zag-js/utils": "^1.35.2",
-        "@zag-js/vanilla": "^1.35.2"
+        "@zag-js/accordion": "^1.37.0",
+        "@zag-js/anatomy": "^1.37.0",
+        "@zag-js/checkbox": "^1.37.0",
+        "@zag-js/clipboard": "^1.37.0",
+        "@zag-js/collapsible": "^1.37.0",
+        "@zag-js/collection": "^1.37.0",
+        "@zag-js/core": "^1.37.0",
+        "@zag-js/dialog": "^1.37.0",
+        "@zag-js/dom-query": "^1.37.0",
+        "@zag-js/number-input": "^1.37.0",
+        "@zag-js/popover": "^1.37.0",
+        "@zag-js/radio-group": "^1.37.0",
+        "@zag-js/scroll-area": "^1.37.0",
+        "@zag-js/select": "^1.37.0",
+        "@zag-js/store": "^1.37.0",
+        "@zag-js/tabs": "^1.37.0",
+        "@zag-js/tooltip": "^1.37.0",
+        "@zag-js/types": "^1.37.0",
+        "@zag-js/utils": "^1.37.0",
+        "@zag-js/vanilla": "^1.37.0"
     }
 }