@lovince/ui-vue 0.1.0 → 0.2.0

package/dist/shared/dismiss.d.ts

@@ -1,17 +1,9 @@
 import { DismissReason, EffectEvent, EventObject } from '@lovince/ui-headless';
 type Listener = (reason: DismissReason, native: Event) => void;
 export type DismissRelay = {
-    /** For `useMachine`'s `beforeSend`: lets a consumer cancel a dismissal before the machine sees it. */
     readonly filter: (event: EventObject | EffectEvent) => boolean;
-    /** The content part registers how it reports dismissals (its emits). */
     readonly listen: (listener: Listener) => void;
 };
-/**
- * Consumers hear about a dismissal first — `escapeKeyDown`,
- * `pointerDownOutside`, `focusOutside` — and may cancel it with
- * `preventDefault()`. An Escape that does dismiss is marked handled, so
- * nothing beneath the layer reacts to it too.
- */
 export declare const createDismissRelay: () => DismissRelay;
 export declare const dismissEmit: (reason: DismissReason) => "escapeKeyDown" | "pointerDownOutside" | "focusOutside";
 export {};

package/dist/shared/element.d.ts

@@ -1,6 +1,4 @@
 import { ComponentPublicInstance, Ref } from 'vue';
 export type ElementRef = Ref<HTMLElement | ComponentPublicInstance | null | undefined>;
-/** The DOM element behind a template ref, whether it points at an element or a component. */
 export declare const toElement: (target: ElementRef | HTMLElement | null | undefined) => HTMLElement | null;
-/** Calls `onChange` with the element's real id whenever it differs from the expected one. */
 export declare const useIdWatch: (target: ElementRef | (() => HTMLElement | null), expected: () => string, onChange: (id: string) => void) => void;

package/dist/shared/floating-props.d.ts

@@ -1,6 +1,5 @@
 import { PropType } from 'vue';
 import { Align, Side } from '@lovince/ui-headless';
-/** Placement props every floating part takes; the content syncs them into its machine. */
 export declare const floatingProps: {
     readonly side: {
         readonly type: PropType<Side>;

package/dist/shared/list.d.ts

@@ -1,16 +1,9 @@
 import { ListEnv } from '@lovince/ui-headless';
 import { ElementRef } from './element';
 export type ListBinding = ListEnv & {
-    /** Spread onto each item so it is found in DOM order. */
     readonly itemAttrs: Readonly<Record<string, string>>;
-    /** Items call this as they mount and unmount, so connect re-reads the list. */
     readonly track: () => void;
 };
-/**
- * The list environment a connect function needs, read from the DOM. A DOM
- * query is not reactive, so items announce themselves and a version counter
- * makes every reader recompute — the default tab stop appears once items exist.
- */
 export declare const useListEnv: (container: ElementRef, options?: {
     readonly includeHidden?: boolean;
     readonly label?: "text" | "tree";

package/dist/shared/machine.d.ts

@@ -4,34 +4,17 @@ export type Controlled<C> = {
     readonly [K in keyof C]?: () => C[K] | undefined;
 };
 export type UseMachineOptions<S extends string, C, E extends EventObject> = {
-    /** Controlled context: a getter per field, `undefined` meaning the machine owns it. */
     readonly controlled?: Controlled<C>;
-    /** Reacts to accepted changes — typically emitting `update:*`. */
     readonly onChange?: (next: Snapshot<S, C>, previous: Snapshot<S, C>) => void;
-    /** Runs before any event reaches the machine, effects' included; return false to drop it (a cancelled dismissal). */
     readonly beforeSend?: (event: E | EffectEvent) => boolean;
 };
 export type MachineBinding<S extends string, C, E extends EventObject> = {
     readonly snapshot: ShallowRef<Snapshot<S, C>>;
     readonly send: (event: E | EffectEvent) => void;
     readonly sync: (partial: Partial<C>) => void;
-    /** Call when a part that an effect needs has mounted. */
     readonly refresh: () => void;
-    /** The page's facts for `connect` — measured by the DOM layer, never by the adapter. */
     readonly query: DomQuery;
     readonly service: Service<S, C, E>;
 };
-/**
- * Runs an engine machine inside a component. The machine decides; this only
- * subscribes, feeds controlled props in, and plugs in the DOM layer's effect
- * handlers. Effects start on mount, so a server render runs none.
- */
 export declare const useMachine: <S extends string, C, E extends EventObject>(machine: Machine<S, C, E>, context: NoInfer<C>, options?: UseMachineOptions<S, C, E>) => MachineBinding<S, C, E>;
-/**
- * Engine part props in Vue's terms. Handlers are named like DOM events in the
- * engine (`onKeyDown`) and Vue wants them lower-cased after `on`
- * (`onKeydown`), or it listens for `key-down`. `false` is dropped, since Vue
- * would render `disabled="false"` on a non-button, which still disables it.
- * The engine's `type: 'button'` applies only when the part renders a button.
- */
 export declare const normalizeProps: (props: PartProps, as?: string | Component) => Record<string, unknown>;

package/dist/shared/parts.d.ts

@@ -1,8 +1,7 @@
 import { InjectionKey } from 'vue';
 import { ariaChecked, openState, CheckedState } from '@lovince/ui-headless';
-/** Injects a compound component's context, failing loudly when a part is used outside its root. */
 export declare const useContext: <T>(key: InjectionKey<T>, part: string, root: string) => T;
-export { Portal } from './portal';
+export { LvPortal } from './portal';
 export { ariaChecked, openState, type CheckedState };
 export declare const checkedState: (checked: CheckedState) => "checked" | "unchecked" | "indeterminate";
 export declare const dataFlag: (on: boolean) => "" | undefined;

package/dist/shared/portal.d.ts

@@ -1,17 +1,9 @@
 import { PropType } from 'vue';
-/**
- * Teleports its content, but only once mounted. A server render never emits
- * content for a `body` target, so hydrating a Teleport there finds no anchors
- * and Vue removes the siblings it mistakes for teleported nodes — the whole
- * app root included. Rendering nothing until mounted keeps server and client
- * in agreement; overlays are closed on first render, so nothing is lost.
- */
-export declare const Portal: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+export declare const LvPortal: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     to: {
         type: PropType<string | HTMLElement>;
         default: string;
     };
-    /** Render in place instead of teleporting. */
     disabled: {
         type: BooleanConstructor;
         default: boolean;
@@ -23,7 +15,6 @@ export declare const Portal: import('vue').DefineComponent<import('vue').Extract
         type: PropType<string | HTMLElement>;
         default: string;
     };
-    /** Render in place instead of teleporting. */
     disabled: {
         type: BooleanConstructor;
         default: boolean;

package/dist/shared/primitive.d.ts

@@ -1,11 +1,5 @@
 import { Component, PropType, VNode } from 'vue';
-/**
- * Renders its single child with this component's attributes merged in:
- * classes and styles concatenate, handlers chain, and for any other attribute
- * the child's own value wins, because it is what the consumer wrote. This is
- * what `asChild` means — behaviour attaches to your element, not a wrapper.
- */
-export declare const Slot: import('vue').DefineComponent<{}, () => VNode<import('vue').RendererNode, import('vue').RendererElement, {
+export declare const LvSlot: import('vue').DefineComponent<{}, () => VNode<import('vue').RendererNode, import('vue').RendererElement, {
     [key: string]: any;
 }> | null, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export declare const primitiveProps: {
@@ -28,8 +22,7 @@ export declare const buttonPrimitiveProps: {
         readonly default: false;
     };
 };
-/** A polymorphic element: `as` swaps the tag or component, `asChild` renders the child instead. */
-export declare const Primitive: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+export declare const LvPrimitive: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     readonly as: {
         readonly type: PropType<string | Component>;
         readonly default: "div";
@@ -53,5 +46,4 @@ export declare const Primitive: import('vue').DefineComponent<import('vue').Extr
     readonly as: string | Component;
     readonly asChild: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
-/** `type="button"` only when the part really renders a button, so a form never submits by accident. */
 export declare const buttonType: (as: string | Component) => "button" | undefined;

package/dist/shared/roving.d.ts

@@ -0,0 +1,14 @@
+import { ComputedRef, Ref } from 'vue';
+import { Direction, Orientation, RovingApi } from '@lovince/ui-headless';
+import { ListBinding } from './list';
+export type RovingBinding = {
+    readonly api: ComputedRef<RovingApi>;
+    readonly list: ListBinding;
+    readonly root: Ref<null>;
+};
+export declare const useRoving: (options: {
+    readonly orientation: () => Orientation;
+    readonly dir: () => Direction;
+    readonly loop: () => boolean;
+    readonly disabled: () => boolean;
+}) => RovingBinding;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovince/ui-vue",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Accessible headless Vue 3 components for Lovince UI — Disclosure, Checkbox, Tabs and Dialog, unstyled.",
   "type": "module",
   "license": "MIT",
@@ -54,6 +54,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./icon": {
+      "types": "./dist/icon.d.ts",
+      "import": "./dist/icon.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -61,10 +65,19 @@
     "typecheck": "vue-tsc --noEmit"
   },
   "dependencies": {
-    "@lovince/ui-headless": "^0.1.0",
-    "@lovince/ui-dom": "^0.1.0"
+    "@lovince/ui-headless": "^0.2.0",
+    "@lovince/ui-dom": "^0.2.0"
   },
   "peerDependencies": {
+    "@lovince/icons": "^1.3.1",
     "vue": "^3.5.0"
+  },
+  "peerDependenciesMeta": {
+    "@lovince/icons": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@lovince/icons": "^1.4.0"
   }
 }