import path from 'node:path' import { beforeAll, describe, expect, it } from 'vitest' import { runOxlintPluginOnSources } from './oxlint-plugin-test-runner.mjs' const pluginPath = path.resolve('config/oxlint-plugins/app-store-performance.mjs') function lintSources(sources) { return runOxlintPluginOnSources({ pluginName: 'app-store-performance', pluginPath, sources, rules: { 'app-store-performance/require-selector': 'warn', 'app-store-performance/no-identity-selector': 'warn', 'app-store-performance/no-fresh-selector-result': 'warn', 'app-store-performance/no-nested-fresh-under-shallow': 'warn' } }) } const sources = { subscriptions: ` import { useAppStore as useStore } from '@/store' const WholeStore = () => useStore() const Identity = () => useStore((state) => state) const Fresh = () => useStore((state) => ({ active: state.active })) const Conditional = () => useStore((state) => state.active ? state.items : []) const Nested = () => useStore((state) => { if (state.active) return state.items.filter(Boolean) return state.items }) `, focusedSelectors: ` import { useAppStore } from '@/store' import { useShallow as shallow } from 'zustand/react/shallow' const selectActive = (state) => state.active const Focused = () => useAppStore(selectActive) const Cached = () => useAppStore((state) => state.cachedProjection) const Shallow = () => useAppStore(shallow((state) => ({ active: state.active }))) `, namedSelectors: ` import { useAppStore } from '@/store' const EarlyFresh = () => useAppStore(selectFreshRows) const selectFreshRows = (state) => state.rows.filter(Boolean) const Stable = () => useAppStore(selectActiveId) const selectActiveId = (state) => state.activeId `, importedSelector: ` import { useAppStore } from '@/store' import { selectRows } from './selectors' const Other = () => { const selectRows = (state) => state.rows.map((row) => row.id) return selectRows } const Imported = () => useAppStore(selectRows) `, siblingStores: ` import { usePluginPanelsStore } from '@/store/plugin-panels' import { useSyncExternalStore } from 'react' const WholePanels = () => usePluginPanelsStore() const FreshPanels = () => usePluginPanelsStore((state) => ({ open: state.open })) const External = () => useSyncExternalStore(subscribe, () => ({ open: true })) `, nestedShallow: ` import { useAppStore } from '@/store' import { useShallow } from 'zustand/react/shallow' const NestedObject = () => useAppStore(useShallow((state) => ({ ids: state.rows.map((row) => row.id) }))) const NestedArray = () => useAppStore(useShallow((state) => [state.activeId, state.rows.filter(Boolean)])) const Flat = () => useAppStore(useShallow((state) => ({ activeId: state.activeId, rows: state.rows }))) `, delegatingSelectors: ` import { useAppStore } from '@/store' import { useShallow } from 'zustand/react/shallow' const buildRows = (state) => state.rows.map((row) => row.id) const Delegating = () => useAppStore((state) => buildRows(state)) const NestedDelegating = () => useAppStore(useShallow((state) => ({ ids: buildRows(state) }))) `, cachedHelpers: ` import { useAppStore } from '@/store' import { useShallow } from 'zustand/react/shallow' // The identity-caching shape: fresh only on a miss, cached otherwise. const selectCachedRows = (state) => cache.get(state.key) ?? state.rows.filter(Boolean) const Cached = () => useAppStore((state) => selectCachedRows(state)) const CachedNested = () => useAppStore(useShallow((state) => ({ rows: selectCachedRows(state) }))) // An unknown helper cannot be resolved, so it must not be guessed at. const External = () => useAppStore((state) => externalBuild(state)) ` } const diagnosticsBySource = new Map() beforeAll(() => { const fixtures = Object.values(sources) lintSources(fixtures).forEach((diagnostics, index) => { diagnosticsBySource.set(fixtures[index], diagnostics) }) }) describe('app store performance Oxlint plugin', () => { it('reports whole-store and fresh-reference subscriptions', () => { const diagnostics = diagnosticsBySource.get(sources.subscriptions) expect(diagnostics.map((diagnostic) => diagnostic.code)).toEqual([ 'app-store-performance(require-selector)', 'app-store-performance(no-identity-selector)', 'app-store-performance(no-fresh-selector-result)', 'app-store-performance(no-fresh-selector-result)', 'app-store-performance(no-fresh-selector-result)' ]) }) it('allows focused, cached, and useShallow selectors', () => { const diagnostics = diagnosticsBySource.get(sources.focusedSelectors) expect(diagnostics).toEqual([]) }) it('resolves selectors referenced by name, including ones hoisted below the call', () => { const diagnostics = diagnosticsBySource.get(sources.namedSelectors) expect(diagnostics.map((diagnostic) => diagnostic.code)).toEqual([ 'app-store-performance(no-fresh-selector-result)' ]) }) it('does not let a component-local helper resolve a same-named imported selector', () => { const diagnostics = diagnosticsBySource.get(sources.importedSelector) expect(diagnostics).toEqual([]) }) it('covers sibling store hooks but not useSyncExternalStore', () => { const diagnostics = diagnosticsBySource.get(sources.siblingStores) expect(diagnostics.map((diagnostic) => diagnostic.code)).toEqual([ 'app-store-performance(require-selector)', 'app-store-performance(no-fresh-selector-result)' ]) }) it('reports fresh references nested inside a useShallow projection', () => { const diagnostics = diagnosticsBySource.get(sources.nestedShallow) expect(diagnostics.map((diagnostic) => diagnostic.code)).toEqual([ 'app-store-performance(no-nested-fresh-under-shallow)', 'app-store-performance(no-nested-fresh-under-shallow)' ]) }) it('follows a selector one hop into a module-scope helper', () => { const diagnostics = diagnosticsBySource.get(sources.delegatingSelectors) expect(diagnostics.map((diagnostic) => diagnostic.code)).toEqual([ 'app-store-performance(no-fresh-selector-result)', 'app-store-performance(no-nested-fresh-under-shallow)' ]) }) it('does not flag a helper that returns a cached reference on some branch', () => { const diagnostics = diagnosticsBySource.get(sources.cachedHelpers) expect(diagnostics).toEqual([]) }) })