@supermousejs/states 2.0.1 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,42 @@
1
1
  # @supermousejs/states
2
2
 
3
+ ## 2.1.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 0a1652d: fixed build architecture and updated plugin metadata
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [0a1652d]
12
+ - @supermousejs/utils@2.1.0
13
+
14
+ ## 2.0.4
15
+
16
+ ### Patch Changes
17
+
18
+ - 993dc67: Updated supemousejs packages with proper author, license and url descriptors to repo
19
+ - Updated dependencies [993dc67]
20
+ - @supermousejs/utils@2.0.4
21
+ - @supermousejs/core@2.0.4
22
+
23
+ ## 2.0.3
24
+
25
+ ### Patch Changes
26
+
27
+ - Updated dependencies
28
+ - @supermousejs/core@2.0.3
29
+ - @supermousejs/utils@2.0.3
30
+
31
+ ## 2.0.2
32
+
33
+ ### Patch Changes
34
+
35
+ - ae219a0: Update READMEs with correct link to documentation
36
+ - Updated dependencies [ae219a0]
37
+ - @supermousejs/utils@2.0.2
38
+ - @supermousejs/core@2.0.2
39
+
3
40
  ## 2.0.1
4
41
 
5
42
  ### Patch Changes
package/README.md CHANGED
@@ -38,3 +38,7 @@ app.use(States({
38
38
  <div data-supermouse-state="hover">Hover me</div>
39
39
  <div data-supermouse-state="info" data-supermouse-text="Hello">Info</div>
40
40
  ```
41
+
42
+ ## Documentation
43
+
44
+ Full documentation and interactive playground available at [supermouse](https://supermouse.vercel.app) or [check out the repo](https://github.com/Whitestar14/supermouse-js).
package/package.json CHANGED
@@ -1,15 +1,21 @@
1
1
  {
2
2
  "name": "@supermousejs/states",
3
- "version": "2.0.1",
3
+ "version": "2.1.0",
4
4
  "main": "dist/index.umd.js",
5
5
  "module": "dist/index.mjs",
6
6
  "types": "dist/index.d.ts",
7
+ "author": "O.S David",
8
+ "url": "https://github.com/Whitestar14/supermouse-js",
9
+ "license": "MIT",
7
10
  "dependencies": {
8
- "@supermousejs/core": "2.0.1",
9
- "@supermousejs/utils": "2.0.1"
11
+ "@supermousejs/utils": "2.1.0"
12
+ },
13
+ "devDependencies": {
14
+ "@supermousejs/core": "2.0.4"
15
+ },
16
+ "peerDependencies": {
17
+ "@supermousejs/core": "2.0.4"
10
18
  },
11
- "devDependencies": {},
12
- "peerDependencies": {},
13
19
  "exports": {
14
20
  ".": {
15
21
  "types": "./dist/index.d.ts",
package/src/index.ts CHANGED
@@ -1,97 +1,97 @@
1
- import { definePlugin } from '@supermousejs/utils';
2
-
3
- export interface StatesOptions {
4
- name?: string;
5
- isEnabled?: boolean;
6
- /** The default state (active when nothing else is hovered). */
7
- default: string[];
8
- /** Map of state names to lists of plugin names to enable. */
9
- states: Record<string, string[]>;
10
- /** CSS selector attribute to trigger state change. Default 'data-supermouse-state'. */
11
- attribute?: string;
12
- }
13
-
14
- export const States = (options: StatesOptions) => {
15
- const attr = options.attribute || 'data-supermouse-state';
16
-
17
- // Cache the relationships for fast lookups
18
- const allManagedPlugins = new Set<string>(); // All plugins mentioned in 'states'
19
- const defaultPlugins = new Set(options.default);
20
-
21
- // Populate the set of managed plugins (excluding defaults for now)
22
- Object.values(options.states).forEach(list => {
23
- list.forEach(p => allManagedPlugins.add(p));
24
- });
25
-
26
- let currentState = 'default';
27
- let hasInitialized = false;
28
-
29
- return definePlugin({
30
- name: 'states',
31
- // High priority: Run BEFORE visual plugins so they know if they are enabled/disabled this frame
32
- priority: -999,
33
-
34
- install(app) {
35
- // Register the trigger attribute
36
- app.registerHoverTarget(`[${attr}]`);
37
- },
38
-
39
- update(app) {
40
- // --- INITIALIZATION STEP ---
41
- // We do this in the first update tick to ensure all other plugins
42
- // have been registered via .use(), regardless of order.
43
- if (!hasInitialized) {
44
- // 1. Disable all "Special State" plugins initially
45
- allManagedPlugins.forEach(name => {
46
- if (!defaultPlugins.has(name)) {
47
- app.disablePlugin(name);
48
- }
49
- });
50
-
51
- // 2. Ensure default plugins are enabled
52
- defaultPlugins.forEach(name => {
53
- app.enablePlugin(name);
54
- });
55
-
56
- hasInitialized = true;
57
- }
58
-
59
- // --- STANDARD LOGIC ---
60
- const target = app.state.hoverTarget;
61
- let nextState = 'default';
62
-
63
- // 1. Determine Desired State
64
- if (target && target.hasAttribute(attr)) {
65
- const val = target.getAttribute(attr);
66
- if (val && options.states[val]) {
67
- nextState = val;
68
- }
69
- }
70
-
71
- // 2. Switch State (Only if changed)
72
- if (nextState !== currentState) {
73
-
74
- // A. Determine which plugins should be active
75
- const activePlugins = nextState === 'default'
76
- ? options.default
77
- : options.states[nextState];
78
-
79
- // B. Apply changes
80
- // Note: We combine default + managed to ensure we cover everyone involved
81
- const involved = new Set([...defaultPlugins, ...allManagedPlugins]);
82
-
83
- involved.forEach(pluginName => {
84
- const shouldBeActive = activePlugins.includes(pluginName);
85
-
86
- if (shouldBeActive) {
87
- app.enablePlugin(pluginName);
88
- } else {
89
- app.disablePlugin(pluginName);
90
- }
91
- });
92
-
93
- currentState = nextState;
94
- }
95
- }
96
- }, options);
1
+ import { definePlugin } from '@supermousejs/utils';
2
+
3
+ export interface StatesOptions {
4
+ name?: string;
5
+ isEnabled?: boolean;
6
+ /** The default state (active when nothing else is hovered). */
7
+ default: string[];
8
+ /** Map of state names to lists of plugin names to enable. */
9
+ states: Record<string, string[]>;
10
+ /** CSS selector attribute to trigger state change. Default 'data-supermouse-state'. */
11
+ attribute?: string;
12
+ }
13
+
14
+ export const States = (options: StatesOptions) => {
15
+ const attr = options.attribute || 'data-supermouse-state';
16
+
17
+ // Cache the relationships for fast lookups
18
+ const allManagedPlugins = new Set<string>(); // All plugins mentioned in 'states'
19
+ const defaultPlugins = new Set(options.default);
20
+
21
+ // Populate the set of managed plugins (excluding defaults for now)
22
+ Object.values(options.states).forEach(list => {
23
+ list.forEach(p => allManagedPlugins.add(p));
24
+ });
25
+
26
+ let currentState = 'default';
27
+ let hasInitialized = false;
28
+
29
+ return definePlugin({
30
+ name: 'states',
31
+ // High priority: Run BEFORE visual plugins so they know if they are enabled/disabled this frame
32
+ priority: -999,
33
+
34
+ install(app) {
35
+ // Register the trigger attribute
36
+ app.registerHoverTarget(`[${attr}]`);
37
+ },
38
+
39
+ update(app) {
40
+ // --- INITIALIZATION STEP ---
41
+ // We do this in the first update tick to ensure all other plugins
42
+ // have been registered via .use(), regardless of order.
43
+ if (!hasInitialized) {
44
+ // 1. Disable all "Special State" plugins initially
45
+ allManagedPlugins.forEach(name => {
46
+ if (!defaultPlugins.has(name)) {
47
+ app.disablePlugin(name);
48
+ }
49
+ });
50
+
51
+ // 2. Ensure default plugins are enabled
52
+ defaultPlugins.forEach(name => {
53
+ app.enablePlugin(name);
54
+ });
55
+
56
+ hasInitialized = true;
57
+ }
58
+
59
+ // --- STANDARD LOGIC ---
60
+ const target = app.state.hoverTarget;
61
+ let nextState = 'default';
62
+
63
+ // 1. Determine Desired State
64
+ if (target && target.hasAttribute(attr)) {
65
+ const val = target.getAttribute(attr);
66
+ if (val && options.states[val]) {
67
+ nextState = val;
68
+ }
69
+ }
70
+
71
+ // 2. Switch State (Only if changed)
72
+ if (nextState !== currentState) {
73
+
74
+ // A. Determine which plugins should be active
75
+ const activePlugins = nextState === 'default'
76
+ ? options.default
77
+ : options.states[nextState];
78
+
79
+ // B. Apply changes
80
+ // Note: We combine default + managed to ensure we cover everyone involved
81
+ const involved = new Set([...defaultPlugins, ...allManagedPlugins]);
82
+
83
+ involved.forEach(pluginName => {
84
+ const shouldBeActive = activePlugins.includes(pluginName);
85
+
86
+ if (shouldBeActive) {
87
+ app.enablePlugin(pluginName);
88
+ } else {
89
+ app.disablePlugin(pluginName);
90
+ }
91
+ });
92
+
93
+ currentState = nextState;
94
+ }
95
+ }
96
+ }, options);
97
97
  };
package/tsconfig.json CHANGED
@@ -1,18 +1,18 @@
1
- {
2
- "extends": "../../tsconfig.base.json",
3
- "include": [
4
- "src"
5
- ],
6
- "compilerOptions": {
7
- "outDir": "dist",
8
- "baseUrl": ".",
9
- "paths": {
10
- "@supermousejs/core": [
11
- "../core/src/index.ts"
12
- ],
13
- "@supermousejs/utils": [
14
- "../utils/src/index.ts"
15
- ]
16
- }
17
- }
1
+ {
2
+ "extends": "../../tsconfig.base.json",
3
+ "include": [
4
+ "src"
5
+ ],
6
+ "compilerOptions": {
7
+ "outDir": "dist",
8
+ "baseUrl": ".",
9
+ "paths": {
10
+ "@supermousejs/core": [
11
+ "../core/src/index.ts"
12
+ ],
13
+ "@supermousejs/utils": [
14
+ "../utils/src/index.ts"
15
+ ]
16
+ }
17
+ }
18
18
  }
package/vite.config.ts CHANGED
@@ -1,22 +1,22 @@
1
- import { defineConfig } from 'vite';
2
- import dts from 'vite-plugin-dts';
3
- import path from 'path';
4
-
5
- export default defineConfig({
6
- build: {
7
- lib: {
8
- entry: path.resolve(__dirname, 'src/index.ts'),
9
- name: 'SupermouseStates',
10
- fileName: (format) => format === 'es' ? 'index.mjs' : 'index.umd.js',
11
- },
12
- rollupOptions: {
13
- external: ['@supermousejs/core', '@supermousejs/utils'],
14
- output: {
15
- globals: {
16
- '@supermousejs/core': 'SupermouseCore'
17
- , '@supermousejs/utils': 'SupermouseUtils'}
18
- }
19
- }
20
- },
21
- plugins: [dts({ rollupTypes: true })]
1
+ import { defineConfig } from 'vite';
2
+ import dts from 'vite-plugin-dts';
3
+ import path from 'path';
4
+
5
+ export default defineConfig({
6
+ build: {
7
+ lib: {
8
+ entry: path.resolve(__dirname, 'src/index.ts'),
9
+ name: 'SupermouseStates',
10
+ fileName: (format) => format === 'es' ? 'index.mjs' : 'index.umd.js',
11
+ },
12
+ rollupOptions: {
13
+ external: ['@supermousejs/core', '@supermousejs/utils'],
14
+ output: {
15
+ globals: {
16
+ '@supermousejs/core': 'SupermouseCore'
17
+ , '@supermousejs/utils': 'SupermouseUtils'}
18
+ }
19
+ }
20
+ },
21
+ plugins: [dts({ rollupTypes: true })]
22
22
  });