@codemonster-ru/vueforge-core 1.3.3 → 1.4.0

package/README.md

@@ -8,7 +8,7 @@ Stable foundation layer for the VueForge design system.
 
 ## Current scope
 
-Version `1.3.0` focuses on:
+Version `1.3.x` focuses on:
 
 - Vue 3 library build with Vite
 - TypeScript declarations
@@ -21,22 +21,75 @@ Version `1.3.0` focuses on:
 
 ```ts
 import { createApp } from "vue";
-import VueForge from "@codemonster-ru/vueforge-core";
+import VueForgeCore from "@codemonster-ru/vueforge-core";
 
 const app = createApp(App);
 
-app.use(VueForge);
+app.use(VueForgeCore);
+```
+
+## Recommended Theme Setup
+
+VueForge theme setup has two layers that work together:
+
+- token preset configuration through `app.use(VueForgeCore, { theme })`
+- theme mode selection through `VfThemeProvider` and `useTheme()`
+
+```ts
+import { createApp } from "vue";
+import App from "./App.vue";
+import VueForgeCore, {
+  defaultThemePreset,
+} from "@codemonster-ru/vueforge-core";
+
+const app = createApp(App);
+
+app.use(VueForgeCore, {
+  theme: {
+    preset: defaultThemePreset,
+    extend: {
+      colorPrimary: "#ff5a36",
+    },
+  },
+  defaultTheme: "system",
+  themeStorageKey: "vf-theme",
+});
+```
+
+```vue
+<script setup lang="ts">
+import { VfThemeProvider } from "@codemonster-ru/vueforge-core";
+</script>
+
+<template>
+  <VfThemeProvider>
+    <App />
+  </VfThemeProvider>
+</template>
+```
+
+```ts
+import { useTheme } from "@codemonster-ru/vueforge-core";
+
+const { theme, resolvedTheme, setTheme, toggleTheme } = useTheme();
+
+setTheme("dark");
+setTheme("light");
+setTheme("system");
+toggleTheme();
 ```
 
 ## Theme Overrides
 
 ```ts
 import { createApp } from "vue";
-import VueForge, { defaultThemePreset } from "@codemonster-ru/vueforge-core";
+import VueForgeCore, {
+  defaultThemePreset,
+} from "@codemonster-ru/vueforge-core";
 
 const app = createApp(App);
 
-app.use(VueForge, {
+app.use(VueForgeCore, {
   theme: {
     preset: defaultThemePreset,
     extend: {
@@ -46,6 +99,9 @@ app.use(VueForge, {
 });
 ```
 
+`VfThemeProvider` reads theme-mode defaults from the plugin config when its own
+props are not set. Provider props still win when you need local overrides.
+
 For the full theme runtime and preset API, see [Theme API](./docs/theme-api.md).
 
 ## Theme Architecture
@@ -69,7 +125,7 @@ This means `vueforge-core` is still the easiest way to consume the default VueFo
 Use the full package when you need VueForge components, styles, and theme runtime together.
 
 ```ts
-import VueForge from "@codemonster-ru/vueforge-core";
+import VueForgeCore from "@codemonster-ru/vueforge-core";
 ```
 
 Use foundation-only entry points when another package, such as `vueforge-layouts`, needs shared responsive or platform helpers without depending on the full UI surface.
@@ -96,7 +152,7 @@ Available subpaths:
 ### Stability
 
 - Stable UI API: components exported from the root package
-- Stable theme API: `VueForge`, `createVueForge`, `defaultThemePreset`, `createThemePreset`
+- Stable theme API: `VueForgeCore`, `createVueForgeCore`, `VfThemeProvider`, `useTheme`, `defaultThemePreset`, `createThemePreset`
 - Stable foundation API: breakpoint constants and foundation composables from `./foundation`
 
 For the full foundation contract, see [Foundation API](./docs/foundation-api.md).

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { default, VueForge, createVueForge } from './plugin';
+export { default, VueForgeCore, createVueForgeCore } from './plugin';
 export { default as VfThemeProvider } from './providers/VfThemeProvider.vue';
 export { VfAccordion, VfAlert, VfBadge, VfButton, VfCard, VfCheckbox, VfDrawer, VfDialog, VfDivider, VfDropdown, VfIconButton, VfInput, VfLink, VfNavMenu, VfPanel, VfPopover, VfRadio, VfSwitch, VfTag, VfTabs, VfTextarea, VfTooltip, } from './components';
 export { useClickOutside, useDisclosure, useEscapeKey, useFloating, useFocusTrap, useId, useTheme, } from './composables';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gCAAgC,CAAC;AACxC,OAAO,+BAA+B,CAAC;AACvC,OAAO,yBAAyB,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EACL,WAAW,EACX,OAAO,EACP,OAAO,EACP,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,EACP,SAAS,EACT,OAAO,EACP,QAAQ,EACR,KAAK,EACL,MAAM,EACN,UAAU,EACV,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,KAAK,EACL,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gCAAgC,CAAC;AACxC,OAAO,+BAA+B,CAAC;AACvC,OAAO,yBAAyB,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EACL,WAAW,EACX,OAAO,EACP,OAAO,EACP,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,EACP,SAAS,EACT,OAAO,EACP,QAAQ,EACR,KAAK,EACL,MAAM,EACN,UAAU,EACV,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,KAAK,EACL,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/plugin.d.ts

@@ -1,4 +1,4 @@
-export declare function createVueForge(): import('vue').ObjectPlugin<any[]>;
-export declare const VueForge: import('vue').ObjectPlugin<any[]>;
-export default VueForge;
+export declare function createVueForgeCore(): import('vue').ObjectPlugin<any[]>;
+export declare const VueForgeCore: import('vue').ObjectPlugin<any[]>;
+export default VueForgeCore;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAKA,wBAAgB,cAAc,sCAc7B;AAED,eAAO,MAAM,QAAQ,mCAAmB,CAAC;AAEzC,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAKA,wBAAgB,kBAAkB,sCAqBjC;AAED,eAAO,MAAM,YAAY,mCAAuB,CAAC;AAEjD,eAAe,YAAY,CAAC"}

package/dist/providers/VfThemeProvider.vue.d.ts

@@ -1,4 +1,4 @@
-import { VfThemeMode, VfThemeProviderProps } from '../types/theme';
+import { VfThemeProviderProps } from '../types/theme';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
@@ -8,9 +8,7 @@ declare function __VLS_template(): {
     rootEl: any;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<VfThemeProviderProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<VfThemeProviderProps> & Readonly<{}>, {
-    defaultTheme: VfThemeMode;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_component: import('vue').DefineComponent<VfThemeProviderProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<VfThemeProviderProps> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/dist/providers/VfThemeProvider.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VfThemeProvider.vue.d.ts","sourceRoot":"","sources":["../../src/providers/VfThemeProvider.vue"],"names":[],"mappings":"AAkKA,OAAO,KAAK,EAEV,WAAW,EACX,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAuIvB,iBAAS,cAAc;WAoBT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AASD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;6EAOnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"VfThemeProvider.vue.d.ts","sourceRoot":"","sources":["../../src/providers/VfThemeProvider.vue"],"names":[],"mappings":"AA4KA,OAAO,KAAK,EAGV,oBAAoB,EACrB,MAAM,eAAe,CAAC;AA8IvB,iBAAS,cAAc;WAoBT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAQD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,oTAMnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/providers/vueForgeConfig.d.ts

@@ -1,7 +1,13 @@
 import { InjectionKey } from 'vue';
-import { VfResolvedThemeConfig } from '../types/theme';
+import { VfResolvedThemeConfig, VfThemeMode } from '../types/theme';
+export interface VfVueForgeThemeModeDefaults {
+    defaultTheme?: VfThemeMode;
+    storageKey?: string;
+    attribute?: string;
+}
 export interface VfVueForgeRuntimeConfig {
     theme: VfResolvedThemeConfig;
+    themeMode: VfVueForgeThemeModeDefaults;
 }
 export declare const vueForgeConfigKey: InjectionKey<VfVueForgeRuntimeConfig>;
 //# sourceMappingURL=vueForgeConfig.d.ts.map

package/dist/providers/vueForgeConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vueForgeConfig.d.ts","sourceRoot":"","sources":["../../src/providers/vueForgeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC;AACxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,uBAAuB,CAC1C,CAAC"}
+{"version":3,"file":"vueForgeConfig.d.ts","sourceRoot":"","sources":["../../src/providers/vueForgeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC;AACxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,WAAW,2BAA2B;IAC1C,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,EAAE,2BAA2B,CAAC;CACxC;AAED,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,uBAAuB,CAC1C,CAAC"}

package/dist/types/theme.d.ts

@@ -3,6 +3,9 @@ import { VfResolvedTheme, VfThemeConfig, VfThemeMode } from '@codemonster-ru/vue
 export type { VfResolvedTheme, VfResolvedThemeConfig, VfResolvedThemePreset, VfResolvedThemePresetOptions, VfThemeConfig, VfThemeMode, VfThemePreset, VfThemePresetOptions, VfThemeTokens, } from '@codemonster-ru/vueforge-theme';
 export interface VfVueForgeOptions {
     theme?: VfThemeConfig;
+    defaultTheme?: VfThemeMode;
+    themeStorageKey?: string;
+    themeAttribute?: string;
 }
 export interface VfThemeContext {
     mode: Ref<VfThemeMode>;

package/dist/types/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/types/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACZ,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,EAC5B,aAAa,EACb,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,aAAa,GACd,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACvB,aAAa,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/types/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACZ,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,EAC5B,aAAa,EACb,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,aAAa,GACd,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACvB,aAAa,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC"}