@vuetify/v0 0.2.1 → 1.0.0-alpha.1

package/dist/{useFeatures-D9bGOvh4.mjs → useFeatures-wgMwaQ5W.mjs}

@@ -1,10 +1,10 @@
 import { isArray, isBoolean, isFunction, isObject } from "./utilities/index.mjs";
-import { o as createPluginContext } from "./useLogger-Daz-Zr0z.mjs";
-import { t as createTokens } from "./createTokens-CHTawmud.mjs";
-import { t as createGroup } from "./createGroup-CzRZ9COh.mjs";
+import { o as createPluginContext } from "./useLogger-DFIRqm-N.mjs";
+import { t as createTokens } from "./createTokens-oJAeh262.mjs";
+import { t as createGroup } from "./createGroup-BC2nfttd.mjs";
 import "./flagsmith-DQnnahG5.mjs";
 import "./launchdarkly-2_48EJ1_.mjs";
-import "./posthog-Ccm8FQfD.mjs";
+import "./posthog-CPvNHMUb.mjs";
 //#region src/composables/useFeatures/adapters/generic/index.ts
 var FeaturesAdapter = class {};
 //#endregion
@@ -27,6 +27,15 @@ var FeaturesAdapter = class {};
 *
 * Inheritance chain: createRegistry → createSelection → createGroup → createFeatures
 * Integrates with createTokens for token-based features.
+*
+* @example
+* ```ts
+* import { useFeatures } from '@vuetify/v0'
+*
+* const features = useFeatures()
+* features.register({ id: 'new-checkout', value: true })
+* console.log(features.variation('new-checkout'))
+* ```
 */
 /**
 * Creates a new features instance.
@@ -54,7 +63,7 @@ function createFeatures(_options = {}) {
 	const tokens = createTokens(features, { flat: true });
 	const registry = createGroup({
 		...options,
-		reactive: true
+		events: true
 	});
 	for (const [id, { value }] of tokens.entries()) register({
 		id,

package/dist/{useLocale-BRQTt3Ka.mjs → useLocale-qMmVnAwS.mjs}

@@ -1,8 +1,8 @@
-import { o as createPluginContext } from "./useLogger-Daz-Zr0z.mjs";
-import { r as flatten, t as createTokens } from "./createTokens-CHTawmud.mjs";
-import { t as createSingle } from "./createSingle-C7IGUjP6.mjs";
-import { t as Vuetify0LocaleAdapter } from "./v0-D-AEQbvj.mjs";
-import "./adapters-_DyP1X4U.mjs";
+import { o as createPluginContext } from "./useLogger-DFIRqm-N.mjs";
+import { r as flatten, t as createTokens } from "./createTokens-oJAeh262.mjs";
+import { t as createSingle } from "./createSingle-BHxHLZeg.mjs";
+import { t as Vuetify0LocaleAdapter } from "./v0-I2mHxD9T.mjs";
+import "./adapters-DegUcfkd.mjs";
 //#region src/composables/useLocale/index.ts
 /**
 * @module useLocale
@@ -20,6 +20,15 @@ import "./adapters-_DyP1X4U.mjs";
 * - Adapter pattern for integration with i18n providers (VueI18nLocaleAdapter included)
 *
 * Integrates with createSingle for locale selection and createTokens for message resolution.
+*
+* @example
+* ```ts
+* import { useLocale } from '@vuetify/v0'
+*
+* const { t, n } = useLocale()
+* console.log(t('$v0.greeting', { name: 'World' }))
+* console.log(n(1234.56))
+* ```
 */
 /**
 * Creates a new locale instance.

package/dist/{useLogger-Daz-Zr0z.mjs → useLogger-DFIRqm-N.mjs}

@@ -1,9 +1,9 @@
-import { s as __LOGGER_ENABLED__, t as IN_BROWSER } from "./globals-BrRJkuSY.mjs";
-import { isNullOrUndefined } from "./utilities/index.mjs";
-import { i as useContext, n as createContext, t as createTrinity } from "./createTrinity-vvXk0ARD.mjs";
-import { t as Vuetify0LoggerAdapter } from "./v0-Bno8FQ_F.mjs";
-import "./adapters-Cd8NDs18.mjs";
-import { hasInjectionContext, watch } from "vue";
+import { s as __LOGGER_ENABLED__, t as IN_BROWSER } from "./globals-Berkg6mP.mjs";
+import { isNullOrUndefined, isUndefined } from "./utilities/index.mjs";
+import { i as useContext, t as createTrinity } from "./createTrinity-BTCs1pYx.mjs";
+import { t as Vuetify0LoggerAdapter } from "./v0-CNitYI9N.mjs";
+import "./adapters-Da2twiUn.mjs";
+import { hasInjectionContext, inject, watch } from "vue";
 //#region src/composables/createPlugin/index.ts
 /**
 * @module createPlugin
@@ -20,6 +20,17 @@ import { hasInjectionContext, watch } from "vue";
 * Also exports `createPluginContext` — a higher-level factory that generates the standard
 * context/plugin/consumer triple for plugin composables, eliminating boilerplate.
 * Supports `persist()` / `restore()` lifecycle hooks for saving and rehydrating plugin state.
+*
+* @example
+* ```ts
+* import { createPlugin } from '@vuetify/v0'
+*
+* const plugin = createPlugin({
+*   namespace: 'v0:my-plugin',
+*   provide: app => app.provide('my-key', { greet: () => 'hello' }),
+* })
+* // app.use(plugin)
+* ```
 */
 const INSTALLED = Symbol.for("v0:installed-plugins");
 function getInstalled(app) {
@@ -94,12 +105,7 @@ function getPersistedStorage() {
 function createPluginContext(defaultNamespace, factory, config) {
 	function createXContext(_options = {}) {
 		const { namespace = defaultNamespace, persist: _persist, ...options } = _options;
-		const [_use, _provide] = createContext(namespace);
-		const context = factory(options);
-		function provide(_context = context, app) {
-			return _provide(_context, app);
-		}
-		return createTrinity(_use, provide, context);
+		return createTrinity(namespace, factory(options));
 	}
 	function createXPlugin(_options = {}) {
 		const { namespace = defaultNamespace, persist: shouldPersist, ...options } = _options;
@@ -124,18 +130,20 @@ function createPluginContext(defaultNamespace, factory, config) {
 					const storage = getPersistedStorage();
 					const key = deriveKey(namespace);
 					const stored = storage.get(key);
-					watch(() => config.persist(context), (val) => {
+					const stop = watch(() => config.persist(context), (val) => {
 						stored.value = val;
 					});
+					app.onUnmount(stop);
 				}
 			} : void 0
 		});
 	}
 	function useX(namespace = defaultNamespace) {
 		if (config?.fallback) {
-			const instance = config.fallback(namespace);
-			if (!hasInjectionContext()) return instance;
-			return useContext(namespace, instance);
+			if (!hasInjectionContext()) return config.fallback(namespace);
+			const provided = inject(namespace, void 0);
+			if (!/* @__PURE__ */ isUndefined(provided)) return provided;
+			return config.fallback(namespace);
 		}
 		return useContext(namespace);
 	}
@@ -163,6 +171,15 @@ function createPluginContext(defaultNamespace, factory, config) {
 * - Context logging support
 *
 * Uses adapter pattern to abstract logging implementation.
+*
+* @example
+* ```ts
+* import { useLogger } from '@vuetify/v0'
+*
+* const logger = useLogger()
+* logger.info('hello')
+* logger.warn('careful')
+* ```
 */
 /**
 * Creates a new logger instance.

package/dist/{usePermissions-Yp3guoLH.mjs → usePermissions-tZhkBJmq.mjs}

@@ -1,6 +1,6 @@
-import { o as createPluginContext } from "./useLogger-Daz-Zr0z.mjs";
-import { t as createTokens } from "./createTokens-CHTawmud.mjs";
-import { t as toArray } from "./toArray-doLQVI56.mjs";
+import { o as createPluginContext } from "./useLogger-DFIRqm-N.mjs";
+import { t as createTokens } from "./createTokens-oJAeh262.mjs";
+import { t as toArray } from "./toArray-BA_JxFPv.mjs";
 import { t as Vuetify0PermissionAdapter } from "./v0-4OQBCeda.mjs";
 import "./adapters-BhNTUuxE.mjs";
 //#region src/composables/usePermissions/index.ts
@@ -20,6 +20,14 @@ import "./adapters-BhNTUuxE.mjs";
 * - Adapter pattern for custom permission systems
 *
 * Built on createTokens for flexible permission configuration.
+*
+* @example
+* ```ts
+* import { usePermissions } from '@vuetify/v0'
+*
+* const permissions = usePermissions()
+* console.log(permissions.can('admin', 'edit', 'users'))
+* ```
 */
 /**
 * Creates a new permissions instance.

package/dist/{useRules-BFPH7q8w.mjs → useRules-D3UXEtu7.mjs}

@@ -1,6 +1,6 @@
 import { instanceExists, isFunction, isObject } from "./utilities/index.mjs";
-import { o as createPluginContext } from "./useLogger-Daz-Zr0z.mjs";
-import { a as useLocale } from "./useLocale-BRQTt3Ka.mjs";
+import { o as createPluginContext } from "./useLogger-DFIRqm-N.mjs";
+import { a as useLocale } from "./useLocale-qMmVnAwS.mjs";
 //#region src/composables/useRules/adapters/standard.ts
 /**
 * Type guard for Standard Schema objects.
@@ -54,6 +54,14 @@ function toRule(schema) {
 * - `false` — validation fails, error message resolved from locale (`$rules.<name>`)
 *
 * Integrates with createValidation for rule resolution, useLocale for i18n.
+*
+* @example
+* ```ts
+* import { useRules } from '@vuetify/v0'
+*
+* const rules = useRules()
+* const validators = rules.resolve(['required', v => v.length > 3 || 'Too short'])
+* ```
 */
 /**
 * Wraps an alias predicate so that `false` results are

package/dist/{useTheme-zRa0Nh_g.mjs → useTheme-BeD__R8t.mjs}

@@ -1,9 +1,9 @@
 import { foreground } from "./utilities/index.mjs";
-import { o as createPluginContext } from "./useLogger-Daz-Zr0z.mjs";
-import { r as flatten, t as createTokens } from "./createTokens-CHTawmud.mjs";
-import { t as createSingle } from "./createSingle-C7IGUjP6.mjs";
-import { t as V0StyleSheetThemeAdapter } from "./v0-CcV0VwYd.mjs";
-import "./adapters-BzRMo72Y.mjs";
+import { o as createPluginContext } from "./useLogger-DFIRqm-N.mjs";
+import { r as flatten, t as createTokens } from "./createTokens-oJAeh262.mjs";
+import { t as createSingle } from "./createSingle-BHxHLZeg.mjs";
+import { t as V0StyleSheetThemeAdapter } from "./v0-6XptGYVx.mjs";
+import "./adapters-CiCexgsk.mjs";
 import { computed, shallowRef, toRef } from "vue";
 //#region src/composables/useTheme/index.ts
 /**
@@ -24,6 +24,15 @@ import { computed, shallowRef, toRef } from "vue";
 * - Theme cycling
 *
 * Integrates with createSingle for selection and createTokens for color resolution.
+*
+* @example
+* ```ts
+* import { useTheme } from '@vuetify/v0'
+*
+* const theme = useTheme()
+* theme.select('dark')
+* console.log(theme.isDark.value) // true
+* ```
 */
 /**
 * Creates a new theme instance.

package/dist/utilities/index.mjs

@@ -1,4 +1,4 @@
-import { t as IN_BROWSER } from "../globals-BrRJkuSY.mjs";
+import { t as IN_BROWSER } from "../globals-Berkg6mP.mjs";
 import * as Vue from "vue";
 import { useId as useId$1 } from "vue";
 //#region src/utilities/color.ts
@@ -9,7 +9,7 @@ function hexToRgb(hex) {
 		const g = Number.parseInt(clean[1] + clean[1], 16);
 		const b = Number.parseInt(clean[2] + clean[2], 16);
 		const a = clean.length === 4 ? Number.parseInt(clean[3] + clean[3], 16) : void 0;
-		return a === void 0 ? {
+		return /* @__PURE__ */ isUndefined(a) ? {
 			r,
 			g,
 			b
@@ -24,7 +24,7 @@ function hexToRgb(hex) {
 	const g = Number.parseInt(clean.slice(2, 4), 16);
 	const b = Number.parseInt(clean.slice(4, 6), 16);
 	const a = clean.length === 8 ? Number.parseInt(clean.slice(6, 8), 16) : void 0;
-	return a === void 0 ? {
+	return /* @__PURE__ */ isUndefined(a) ? {
 		r,
 		g,
 		b
@@ -41,7 +41,7 @@ function rgbToHex({ r, g, b, a }) {
 		g,
 		b
 	].map((c) => c.toString(16).padStart(2, "0")).join("");
-	if (a !== void 0) return hex + a.toString(16).padStart(2, "0");
+	if (!/* @__PURE__ */ isUndefined(a)) return hex + a.toString(16).padStart(2, "0");
 	return hex;
 }
 //#endregion
@@ -379,7 +379,7 @@ function isSymbol(item) {
 function isNaN(item) {
 	return /* @__PURE__ */ isNumber(item) && Number.isNaN(item);
 }
-const UNSAFE_KEYS = new Set([
+const UNSAFE_KEYS = /* @__PURE__ */ new Set([
 	"__proto__",
 	"constructor",
 	"prototype"

package/dist/{v0-CcV0VwYd.mjs → v0-6XptGYVx.mjs}

@@ -1,6 +1,6 @@
-import { t as IN_BROWSER } from "./globals-BrRJkuSY.mjs";
+import { t as IN_BROWSER } from "./globals-Berkg6mP.mjs";
 import { isNull, isString } from "./utilities/index.mjs";
-import { t as ThemeAdapter } from "./adapter-Drq1v5wV.mjs";
+import { t as ThemeAdapter } from "./adapter-DtgIrQsG.mjs";
 import { onScopeDispose, watch } from "vue";
 //#region src/composables/useTheme/adapters/v0.ts
 /**

package/dist/{v0-DOq_Ia5H.mjs → v0-BG7RhKBv.mjs}

@@ -1,5 +1,5 @@
-import { t as DataTableAdapter } from "./adapter-CCIeOzqr.mjs";
-import { t as createPagination } from "./createPagination-Tp4C4He8.mjs";
+import { t as DataTableAdapter } from "./adapter-CDpOQ8sn.mjs";
+import { t as createPagination } from "./createPagination-qvJkcTUY.mjs";
 import { computed, toRef, watch } from "vue";
 //#region src/composables/createDataTable/adapters/v0.ts
 /**

package/dist/{v0-Bno8FQ_F.mjs → v0-CNitYI9N.mjs}

@@ -1,4 +1,4 @@
-import { t as IN_BROWSER } from "./globals-BrRJkuSY.mjs";
+import { t as IN_BROWSER } from "./globals-Berkg6mP.mjs";
 import { isFunction } from "./utilities/index.mjs";
 //#region src/composables/useLogger/adapters/v0.ts
 /**

package/dist/{v0-BpgPZ1qB.d.mts → v0-CWXUkMY0.d.mts}

@@ -1,4 +1,4 @@
-import { n as LocaleAdapterContext, t as LocaleAdapter } from "./adapter-CcHB7rs3.mjs";
+import { n as LocaleAdapterContext, t as LocaleAdapter } from "./adapter-DoziXEzS.mjs";
 
 //#region src/composables/useLocale/adapters/v0.d.ts
 /**

package/dist/{v0-BAG8p0si.d.mts → v0-Dzw5OwNo.d.mts}

@@ -1,4 +1,4 @@
-import { i as DataTableAdapterResult, n as DataTableAdapterContext, t as DataTableAdapter } from "./adapter-BZjmDNJF.mjs";
+import { i as DataTableAdapterResult, n as DataTableAdapterContext, t as DataTableAdapter } from "./adapter-J7ude3gO.mjs";
 
 //#region src/composables/createDataTable/adapters/v0.d.ts
 declare class ClientAdapter<T extends Record<string, unknown>> extends DataTableAdapter<T> {

package/dist/{v0-D-AEQbvj.mjs → v0-I2mHxD9T.mjs}

@@ -1,4 +1,4 @@
-import { t as IN_BROWSER } from "./globals-BrRJkuSY.mjs";
+import { t as IN_BROWSER } from "./globals-Berkg6mP.mjs";
 import { isObject, isString, isUndefined } from "./utilities/index.mjs";
 //#region src/composables/useLocale/adapters/v0.ts
 /**

package/dist/{virtual-BaQWQ9ji.d.mts → virtual-BCOfxnRS.d.mts}

@@ -1,4 +1,4 @@
-import { i as DataTableAdapterResult, n as DataTableAdapterContext, t as DataTableAdapter } from "./adapter-BZjmDNJF.mjs";
+import { i as DataTableAdapterResult, n as DataTableAdapterContext, t as DataTableAdapter } from "./adapter-J7ude3gO.mjs";
 
 //#region src/composables/createDataTable/adapters/virtual.d.ts
 declare class VirtualAdapter<T extends Record<string, unknown>> extends DataTableAdapter<T> {

package/dist/{virtual-D1HwNBLS.mjs → virtual-To-dSw2_.mjs}

@@ -1,5 +1,5 @@
-import { t as DataTableAdapter } from "./adapter-CCIeOzqr.mjs";
-import { t as createPagination } from "./createPagination-Tp4C4He8.mjs";
+import { t as DataTableAdapter } from "./adapter-CDpOQ8sn.mjs";
+import { t as createPagination } from "./createPagination-qvJkcTUY.mjs";
 import { toRef, watch } from "vue";
 //#region src/composables/createDataTable/adapters/virtual.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vuetify/v0",
-  "version": "0.2.1",
+  "version": "1.0.0-alpha.1",
   "description": "A meta UI framework for building applications, component libraries, and design systems with Vue 3",
   "license": "MIT",
   "types": "./dist/index.d.mts",
@@ -52,17 +52,18 @@
     "@ant-design/colors": "^8.0.1",
     "@flagsmith/flagsmith": "^11.0.0",
     "@material/material-color-utilities": "^0.4.0",
-    "@vue/compiler-dom": "^3.5.31",
+    "@vue/compiler-dom": "^3.5.32",
     "@vue/test-utils": "^2.4.6",
-    "launchdarkly-js-client-sdk": "^3.9.0",
-    "posthog-js": "^1.364.1",
+    "concurrently": "^9.2.1",
+    "launchdarkly-js-client-sdk": "^3.9.1",
+    "posthog-js": "^1.365.0",
     "tsdown": "^0.21.7",
     "tsx": "4.21.0",
     "typescript": "6.0.2",
     "unplugin-vue": "^7.1.1",
-    "vue": "3.5.31",
+    "vue": "3.5.32",
     "vue-component-meta": "3.2.6",
-    "vue-i18n": "^11.3.0"
+    "vue-i18n": "^11.3.1"
   },
   "imports": {
     "#v0/*": {
@@ -125,7 +126,9 @@
     "@js-temporal/polyfill": "0.5.1"
   },
   "scripts": {
-    "build": "tsdown && pnpm generate:web-types",
+    "build": "concurrently --names tsdown,webtypes --kill-others-on-fail --prefix-colors cyan,magenta 'pnpm build:tsdown' 'pnpm build:web-types'",
+    "build:tsdown": "tsdown",
+    "build:web-types": "tsx scripts/generate-web-types.ts",
     "generate:web-types": "tsx scripts/generate-web-types.ts",
     "typecheck": "vue-tsc --noEmit --incremental"
   }

package/SKILL.md

@@ -1,95 +0,0 @@
----
-name: vuetify0
-description: Build with @vuetify/v0 headless composables and components for Vue 3. Use when creating selection state (single, multi, grouped, stepped), form validation, tab/dialog/popover UI, provide/inject context, registries, virtual scrolling, pagination, keyboard shortcuts, resize observers, theming, breakpoints, or SSR-safe browser detection. Triggers on v0, vuetify0, headless components, or WAI-ARIA patterns.
----
-
-# Vuetify0 - Headless Composables & Components
-
-Transform Vue 3 apps with unstyled, logic-focused building blocks for design systems.
-
-## Quick Start
-
-```bash
-pnpm install @vuetify/v0
-```
-
-No global plugin required. Import only what you need:
-
-```ts
-import { createSelection } from '@vuetify/v0/composables'
-import { Tabs } from '@vuetify/v0/components'
-```
-
-## Core Decision Tree
-
-**Before writing custom logic**, check if v0 already provides it:
-
-| Need | Use |
-|------|-----|
-| Single item selection | `createSingle` |
-| Multi-item selection | `createSelection` |
-| Selection with "select all" | `createGroup` |
-| Step wizard / carousel | `createStep` |
-| Form validation | `createForm` |
-| Shared state (provide/inject) | `createContext` |
-| Browser utilities | `IN_BROWSER`, `useBreakpoints`, `useMediaQuery` |
-
-## Component Architecture
-
-All components are **headless** (unstyled) and follow WAI-ARIA patterns:
-
-```vue
-<script setup>
-import { Tabs } from '@vuetify/v0/components'
-</script>
-
-<template>
-  <Tabs.Root v-model="active">
-    <Tabs.List>
-      <Tabs.Item value="overview">Overview</Tabs.Item>
-    </Tabs.List>
-    <Tabs.Panel value="overview">Content</Tabs.Panel>
-  </Tabs.Root>
-</template>
-```
-
-**Available components**: Dialog, Tabs, ExpansionPanel, Checkbox, Radio, Popover, Pagination, Select, Slider, Splitter, Switch, Avatar, Breadcrumbs, Form, Input, Scrim
-
-## Essential Patterns
-
-### Selection State
-```ts
-// Single selection (tabs, theme picker)
-const single = createSingle({ mandatory: 'force' })
-
-// Multi-selection (tags, filters)
-const selection = createSelection({ multiple: true })
-
-// Group with "select all" (data tables)
-const group = createGroup()
-```
-
-### Context Sharing
-```ts
-// Type-safe provide/inject
-const [useTheme, provideTheme] = createContext<Theme>('Theme')
-```
-
-### Form Validation
-```ts
-const form = createForm()
-form.register({ id: 'email', rules: [required, email] })
-```
-
-## Anti-Patterns
-
-**Don't reinvent these wheels:**
-
-- **Custom selection logic** → Use `createSelection`
-- **Manual provide/inject** → Use `createContext`
-- **SSR checks** → Use `IN_BROWSER` constant
-
-## Resources
-
-- **Vuetify MCP** for structured API access: `claude mcp add vuetify-mcp https://mcp.vuetifyjs.com/mcp`
-- **Live docs**: https://0.vuetifyjs.com

package/dist/adapters-BbNfjyvY.mjs

@@ -1,5 +0,0 @@
-import "./adapter-CCIeOzqr.mjs";
-import "./v0-DOq_Ia5H.mjs";
-import "./server-CIftA0pK.mjs";
-import "./virtual-D1HwNBLS.mjs";
-export {};

package/dist/adapters-BzRMo72Y.mjs

@@ -1,4 +0,0 @@
-import "./adapter-Drq1v5wV.mjs";
-import "./v0-CcV0VwYd.mjs";
-import "./unhead--58lO3Z-.mjs";
-export {};

package/dist/adapters-_DyP1X4U.mjs

@@ -1,2 +0,0 @@
-import "./v0-D-AEQbvj.mjs";
-export {};