ropav 0.5.0 → 0.7.0

package/README.md

@@ -1,20 +1,43 @@
 # Ropav
 
 A Vue 3 component library built on [Vue Vapor](https://github.com/vuejs/core-vapor), styled by
-[`@ropav/styles`](packages/styles) and Tailwind CSS v4. Published on npm as
-[`ropav`](https://www.npmjs.com/package/ropav).
+[`@ropav/styles`](https://www.npmjs.com/package/@ropav/styles) and Tailwind CSS v4. Published on
+npm as [`ropav`](https://www.npmjs.com/package/ropav).
+
+**[Documentation](https://ropav.netlify.app)** · [Components](https://ropav.netlify.app/components/)
+· [Theming](https://ropav.netlify.app/theming/) · [Storybook](https://ropav-storybook.netlify.app)
 
 > Ropav is a port of [HeroUI v3](https://github.com/heroui-inc/heroui) to Vue Vapor: the style layer is
 > vendored from `@heroui/styles@3.2.4`, the behaviour layer is re-implemented from React Aria.
 
 ## Packages
 
-| Package              | Description                                      |
-| -------------------- | ------------------------------------------------ |
-| `packages/ropav`     | The component library                            |
-| `packages/styles`    | CSS + `tv()` variants (`@ropav/styles`)          |
-| `packages/storybook` | Storybook — the only place to see components run |
-| `packages/testing`   | Shared test harness (jsdom + Playwright browser) |
+| Package              | Description                                           |
+| -------------------- | ----------------------------------------------------- |
+| `packages/ropav`     | The component library                                 |
+| `packages/styles`    | CSS + `tv()` variants (`@ropav/styles`)               |
+| `packages/docs`      | The documentation site                                |
+| `packages/storybook` | Storybook — every component, documented here or not   |
+| `packages/testing`   | Shared test harness (jsdom + Playwright browser)      |
+
+## Calendar systems
+
+The calendars, fields and pickers build **Gregorian** dates whatever calendar the locale asks
+for — a deliberate default, and about bundle weight rather than correctness. An app serving a
+locale that uses another system opts in:
+
+```vue
+<script setup lang="ts">
+import { DatePicker, createCalendar } from "ropav";
+</script>
+
+<template>
+  <DatePicker :create-calendar="createCalendar" />
+</template>
+```
+
+Why it works that way, and how to opt in for only some systems, is in
+[Calendar systems](https://ropav.netlify.app/guide/calendar-systems).
 
 ## Development
 
@@ -24,7 +47,7 @@ Requires Node.js 22+ and pnpm 10+.
 pnpm i --hoist   # install
 pnpm dev         # Storybook on http://127.0.0.1:6006
 pnpm build       # build every package
-pnpm lint        # ESLint
+pnpm lint        # oxlint
 pnpm typecheck   # vue-tsc
 pnpm test        # Vitest — jsdom + browser (needs `playwright install chromium` once)
 ```

package/dist/components/accordion/index.d.ts

@@ -5,195 +5,7 @@ import AccordionItem from "./accordion-item.js";
 import AccordionPanel from "./accordion-panel.js";
 import AccordionRoot from "./accordion-root.js";
 import AccordionTrigger from "./accordion-trigger.js";
-export declare const Accordion: ((__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-    attrs: any;
-    slots: {
-        default?: () => unknown;
-    };
-    emit: ((evt: "expandedChange", keys: Set<import("../../index.js").DisclosureKey>) => void) & ((evt: "update:expandedKeys", keys: Set<import("../../index.js").DisclosureKey>) => void);
-}, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-    props: import('vue').PublicProps & {
-        class?: string;
-        allowsMultipleExpanded?: boolean;
-        defaultExpandedKeys?: Iterable<import("../../index.js").DisclosureKey>;
-        expandedKeys?: Iterable<import("../../index.js").DisclosureKey>;
-        hideSeparator?: boolean;
-        isDisabled?: boolean;
-        variant?: import("@ropav/styles").AccordionVariants["variant"];
-        onExpandedChange?: ((keys: Set<import("../../index.js").DisclosureKey>) => any) | undefined;
-        "onUpdate:expandedKeys"?: ((keys: Set<import("../../index.js").DisclosureKey>) => any) | undefined;
-    } & (typeof globalThis extends {
-        __VLS_PROPS_FALLBACK: infer P;
-    } ? P : {});
-    expose: (exposed: {}) => void;
-    attrs: any;
-    slots: {
-        default?: () => unknown;
-    };
-    emit: ((evt: "expandedChange", keys: Set<import("../../index.js").DisclosureKey>) => void) & ((evt: "update:expandedKeys", keys: Set<import("../../index.js").DisclosureKey>) => void);
-}>) => import('vue').VNode & {
-    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-}) & {
-    Body: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-    Heading: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-    Indicator: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-    Item: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-            id?: string;
-            isDisabled?: boolean;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-    Panel: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-            role?: string;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-    Root: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: ((evt: "expandedChange", keys: Set<import("../../index.js").DisclosureKey>) => void) & ((evt: "update:expandedKeys", keys: Set<import("../../index.js").DisclosureKey>) => void);
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-            allowsMultipleExpanded?: boolean;
-            defaultExpandedKeys?: Iterable<import("../../index.js").DisclosureKey>;
-            expandedKeys?: Iterable<import("../../index.js").DisclosureKey>;
-            hideSeparator?: boolean;
-            isDisabled?: boolean;
-            variant?: import("@ropav/styles").AccordionVariants["variant"];
-            onExpandedChange?: ((keys: Set<import("../../index.js").DisclosureKey>) => any) | undefined;
-            "onUpdate:expandedKeys"?: ((keys: Set<import("../../index.js").DisclosureKey>) => any) | undefined;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: ((evt: "expandedChange", keys: Set<import("../../index.js").DisclosureKey>) => void) & ((evt: "update:expandedKeys", keys: Set<import("../../index.js").DisclosureKey>) => void);
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-    Trigger: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-};
-export { AccordionRoot, AccordionItem, AccordionHeading, AccordionTrigger, AccordionPanel, AccordionIndicator, AccordionBody, };
-export type { AccordionRootProps, AccordionRootProps as AccordionProps, AccordionItemProps, AccordionHeadingProps, AccordionTriggerProps, AccordionPanelProps, AccordionIndicatorProps, AccordionBodyProps, } from "./accordion.types.js";
+export { AccordionRoot as Accordion, AccordionItem, AccordionHeading, AccordionTrigger, AccordionPanel, AccordionIndicator, AccordionBody, };
+export type { AccordionRootProps as AccordionProps, AccordionItemProps, AccordionHeadingProps, AccordionTriggerProps, AccordionPanelProps, AccordionIndicatorProps, AccordionBodyProps, } from "./accordion.types.js";
 export { accordionVariants } from "@ropav/styles";
 export type { AccordionVariants } from "@ropav/styles";

package/dist/components/accordion/index.js

@@ -6,15 +6,4 @@ import accordion_panel_default from "./accordion-panel.js";
 import accordion_root_default from "./accordion-root.js";
 import accordion_trigger_default from "./accordion-trigger.js";
 import { accordionVariants } from "@ropav/styles";
-//#region src/components/accordion/index.ts
-var Accordion = Object.assign(accordion_root_default, {
-	Body: accordion_body_default,
-	Heading: accordion_heading_default,
-	Indicator: accordion_indicator_default,
-	Item: accordion_item_default,
-	Panel: accordion_panel_default,
-	Root: accordion_root_default,
-	Trigger: accordion_trigger_default
-});
-//#endregion
-export { Accordion, accordion_body_default as AccordionBody, accordion_heading_default as AccordionHeading, accordion_indicator_default as AccordionIndicator, accordion_item_default as AccordionItem, accordion_panel_default as AccordionPanel, accordion_root_default as AccordionRoot, accordion_trigger_default as AccordionTrigger, accordionVariants };
+export { accordion_root_default as Accordion, accordion_body_default as AccordionBody, accordion_heading_default as AccordionHeading, accordion_indicator_default as AccordionIndicator, accordion_item_default as AccordionItem, accordion_panel_default as AccordionPanel, accordion_trigger_default as AccordionTrigger, accordionVariants };

package/dist/components/alert/alert-indicator.js

@@ -21,7 +21,7 @@ var alert_indicator_vue_vue_type_script_setup_true_vapor_true_lang_default = /*@
 		* The branch is what keeps parity with React's `{children ?? getDefaultIcon()}`: `<slot>` fallback
 		* content runs whenever the slot renders nothing, so a caller who declares the slot and returns
 		* nothing — `[]`, or a condition that is false — would get the built-in icon here while React
-		* renders empty. Same reason as `Select.Indicator`, and it also keeps the icon out of fallback
+		* renders empty. Same reason as `SelectIndicator`, and it also keeps the icon out of fallback
 		* content, which drops the slots of components a VDOM host nests inside.
 		*/
 		const hasSlot = computed(() => Boolean(callerSlots["default"]));

package/dist/components/alert/index.d.ts

@@ -3,136 +3,7 @@ import AlertDescription from "./alert-description.js";
 import AlertIndicator from "./alert-indicator.js";
 import AlertRoot from "./alert-root.js";
 import AlertTitle from "./alert-title.js";
-export declare const Alert: ((__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-    attrs: any;
-    slots: {
-        default?: () => unknown;
-    };
-    emit: {};
-}, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-    props: import('vue').PublicProps & {
-        class?: string;
-        status?: import("@ropav/styles").AlertVariants["status"];
-    } & (typeof globalThis extends {
-        __VLS_PROPS_FALLBACK: infer P;
-    } ? P : {});
-    expose: (exposed: {}) => void;
-    attrs: any;
-    slots: {
-        default?: () => unknown;
-    };
-    emit: {};
-}>) => import('vue').VNode & {
-    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-}) & {
-    Content: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-    Description: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-    Indicator: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-    Root: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-            status?: import("@ropav/styles").AlertVariants["status"];
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-    Title: (__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>['props'], __VLS_ctx?: {
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>['expose'], __VLS_setup?: Promise<{
-        props: import('vue').PublicProps & {
-            class?: string;
-        } & (typeof globalThis extends {
-            __VLS_PROPS_FALLBACK: infer P;
-        } ? P : {});
-        expose: (exposed: {}) => void;
-        attrs: any;
-        slots: {
-            default?: () => unknown;
-        };
-        emit: {};
-    }>) => import('vue').VNode & {
-        __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-    };
-};
-export { AlertContent, AlertDescription, AlertIndicator, AlertRoot, AlertTitle };
-export type { AlertContentProps, AlertDescriptionProps, AlertIndicatorProps, AlertRootProps, AlertRootProps as AlertProps, AlertTitleProps, } from "./alert.types.js";
+export { AlertContent, AlertDescription, AlertIndicator, AlertRoot as Alert, AlertTitle };
+export type { AlertContentProps, AlertDescriptionProps, AlertIndicatorProps, AlertRootProps as AlertProps, AlertTitleProps, } from "./alert.types.js";
 export { alertVariants } from "@ropav/styles";
 export type { AlertVariants } from "@ropav/styles";

package/dist/components/alert/index.js

@@ -4,13 +4,4 @@ import alert_indicator_default from "./alert-indicator.js";
 import alert_root_default from "./alert-root.js";
 import alert_title_default from "./alert-title.js";
 import { alertVariants } from "@ropav/styles";
-//#region src/components/alert/index.ts
-var Alert = Object.assign(alert_root_default, {
-	Content: alert_content_default,
-	Description: alert_description_default,
-	Indicator: alert_indicator_default,
-	Root: alert_root_default,
-	Title: alert_title_default
-});
-//#endregion
-export { Alert, alert_content_default as AlertContent, alert_description_default as AlertDescription, alert_indicator_default as AlertIndicator, alert_root_default as AlertRoot, alert_title_default as AlertTitle, alertVariants };
+export { alert_root_default as Alert, alert_content_default as AlertContent, alert_description_default as AlertDescription, alert_indicator_default as AlertIndicator, alert_title_default as AlertTitle, alertVariants };

package/dist/components/alert-dialog/alert-dialog-close.js

@@ -18,7 +18,7 @@ var alert_dialog_close_vue_vue_type_script_setup_true_vapor_true_lang_default =
 		* one of them should also be an answer.
 		*
 		* The close runs *before* the button's own handler, which is the order `composePressResponder`
-		* chains them in — so `<AlertDialog.Close><Button @click="remove"/></AlertDialog.Close>` removes and
+		* chains them in — so `<AlertDialogClose><Button @click="remove"/></AlertDialogClose>` removes and
 		* closes.
 		*/
 		providePressResponder({

package/dist/components/alert-dialog/alert-dialog-heading.js

@@ -25,8 +25,8 @@ var alert_dialog_heading_vue_vue_type_script_setup_true_vapor_true_lang_default
 			class: () => styles.value,
 			"data-slot": "alert-dialog-heading"
 		}, extend(() => {
-			return createSlot("default", null, null, 36);
-		}, { _: 8 }), 1);
+			return createSlot("default", null, null, 4);
+		}, { _: 1 }), 1);
 	}
 });
 //#endregion

package/dist/components/alert-dialog/alert-dialog.types.d.ts

@@ -66,7 +66,7 @@ export interface AlertDialogDialogProps {
     class?: string;
 }
 export interface AlertDialogDialogSlotProps {
-    /** Closes the dialog, for a control inside it that is not an `AlertDialog.Close`. */
+    /** Closes the dialog, for a control inside it that is not an `AlertDialogClose`. */
     close: () => void;
 }
 export interface AlertDialogHeaderProps {