feat: add vite-layers

2026-06-07 17:34:31 +07:00
parent aa3148f4e4
commit ecc958c9f0
94 changed files with 4149 additions and 248 deletions
@@ -0,0 +1,134 @@
+import { fileURLToPath } from 'node:url'
+import { dirname, resolve } from 'node:path'
+import { describe, expect, it } from 'vitest'
+import { createLayerHooks } from '../src/hooks'
+import { featuresDts, generateTsConfig } from '../src/tsconfig'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const fixture = (p: string) => resolve(here, 'fixtures', p)
+
+describe('generateTsConfig', () => {
+  it('maps @/* and ~/* to every layer srcDir in priority order (first-match = runtime resolver)', async () => {
+    const { tsconfig } = await generateTsConfig(fixture('stack/app'))
+    const paths = tsconfig.compilerOptions!.paths as Record<string, string[]>
+    // genDir is <app>/.vite-layers, so each src is one level up + the layer path
+    expect(paths['@/*']).toEqual([
+      '../src/*', // stack/app/src
+      '../../base/src/*', // stack/base/src
+      '../../core/src/*', // stack/core/src
+    ])
+    expect(paths['~/*']).toEqual(paths['@/*'])
+  })
+
+  it('maps ~~/@@ to the project root (bare + wildcard)', async () => {
+    const { tsconfig } = await generateTsConfig(fixture('stack/app'))
+    const paths = tsconfig.compilerOptions!.paths as Record<string, string[]>
+    expect(paths['~~']).toEqual(['..'])
+    expect(paths['~~/*']).toEqual(['../*'])
+    expect(paths['@@']).toEqual(paths['~~'])
+  })
+
+  it('emits #layers/<name>/* per layer rootDir', async () => {
+    const { tsconfig } = await generateTsConfig(fixture('stack/app'))
+    const paths = tsconfig.compilerOptions!.paths as Record<string, string[]>
+    expect(paths['#layers/app/*']).toEqual(['../*'])
+    expect(paths['#layers/base/*']).toEqual(['../../base/*'])
+    expect(paths['#layers/core/*']).toEqual(['../../core/*'])
+  })
+
+  it('includes every layer srcDir glob', async () => {
+    const { tsconfig } = await generateTsConfig(fixture('stack/app'))
+    expect(tsconfig.include).toEqual(
+      expect.arrayContaining(['../src/**/*', '../../base/src/**/*', '../../core/src/**/*']),
+    )
+  })
+
+  it('sets framework-neutral defaults with no Vue/JSX specifics', async () => {
+    const { tsconfig } = await generateTsConfig(fixture('stack/app'))
+    const co = tsconfig.compilerOptions!
+    expect(co.moduleResolution).toBe('Bundler')
+    expect(co.strict).toBe(true)
+    expect(co).not.toHaveProperty('baseUrl') // deprecated in TS 6; paths resolve relative to the file
+    expect(co).not.toHaveProperty('jsx')
+    expect(co).not.toHaveProperty('jsxImportSource')
+  })
+
+  it('merges per-layer `tsConfig` from app.config.ts across the stack (like Nuxt typescript.tsConfig)', async () => {
+    const { tsconfig } = await generateTsConfig(fixture('tsconfig-cfg/app'))
+    const co = tsconfig.compilerOptions as Record<string, unknown>
+    expect(co.strict).toBe(false) // app layer overrides the default `true`
+    expect(co.lib).toContain('ESNext') // from the app layer
+    expect(co.types).toContain('node') // inherited from the base layer
+    expect(co.moduleResolution).toBe('Bundler') // untouched default
+    expect((co.paths as Record<string, string[]>)['@/*']).toBeDefined()
+  })
+
+  it('opts.tsConfig wins over per-layer tsConfig and defaults, but never the generated paths', async () => {
+    const { tsconfig } = await generateTsConfig(fixture('stack/app'), {
+      tsConfig: { compilerOptions: { strict: false, jsx: 'preserve', paths: { evil: ['/hax'] } } },
+    })
+    const co = tsconfig.compilerOptions as Record<string, unknown>
+    expect(co.strict).toBe(false) // user wins over default
+    expect(co.jsx).toBe('preserve') // user can add options
+    const paths = co.paths as Record<string, string[]>
+    expect(paths.evil).toBeUndefined() // generated paths are authoritative
+    expect(paths['@/*']).toBeDefined()
+  })
+
+  it('generates a separate node tsconfig for config files (node-side, no DOM, no paths)', async () => {
+    const r = await generateTsConfig(fixture('stack/app'))
+    expect(r.nodeFile.replace(/\\/g, '/')).toMatch(/\/\.vite-layers\/tsconfig\.node\.json$/)
+    const co = r.nodeTsconfig.compilerOptions as Record<string, unknown>
+    expect(co.lib).toEqual(['ESNext']) // no DOM
+    expect(co.paths).toEqual({}) // config files don't use @/
+    expect(co.noEmit).toBe(true)
+    // includes app.config / vite.config of each layer (app + base + core)
+    expect(r.nodeTsconfig.include).toEqual(
+      expect.arrayContaining([
+        expect.stringMatching(/app\.config\.\*$/),
+        expect.stringMatching(/vite\.config\.\*$/),
+      ]),
+    )
+    // ...and the app config no longer pulls in config files
+    expect((r.tsconfig.include ?? []).some(p => p.includes('app.config'))).toBe(false)
+  })
+
+  it('lets a tsconfig:generate hook mutate the node tsconfig', async () => {
+    const hooks = createLayerHooks()
+    hooks.hook('tsconfig:generate', ctx => void (ctx.nodeTsconfig.compilerOptions!.removeComments = true))
+    const r = await generateTsConfig(fixture('stack/app'), { hooks })
+    expect((r.nodeTsconfig.compilerOptions as Record<string, unknown>).removeComments).toBe(true)
+  })
+
+  it('includes ./features.d.ts and returns its generated content + path', async () => {
+    const r = await generateTsConfig(fixture('stack/app'))
+    expect(r.tsconfig.include).toContain('./features.d.ts')
+    expect(r.dtsFile.replace(/\\/g, '/')).toMatch(/\/\.vite-layers\/features\.d\.ts$/)
+    expect(r.dts).toContain('const __FEATURES__:')
+  })
+
+  it('reuses a provided stack instead of resolving again (O2)', async () => {
+    const stack = {
+      merged: { features: { onlyInFake: true } },
+      layers: [
+        { rootDir: fixture('stack/app'), srcDir: resolve(fixture('stack/app'), 'src'), name: 'FAKELAYER', config: {} },
+      ],
+    }
+    const r = await generateTsConfig(fixture('stack/app'), { stack: stack as never })
+    const paths = r.tsconfig.compilerOptions!.paths as Record<string, string[]>
+    expect(Object.keys(paths)).toContain('#layers/FAKELAYER/*') // proves the fake stack was used
+    expect(r.dts).toContain('onlyInFake: boolean')
+  })
+})
+
+describe('featuresDts', () => {
+  it('renders a typed __FEATURES__ global (nested, primitives, quoted non-identifier keys)', () => {
+    const dts = featuresDts({ billing: true, nested: { enabled: false }, 'kebab-flag': true, count: 2 })
+    expect(dts).toContain('declare global')
+    expect(dts).toContain('const __FEATURES__:')
+    expect(dts).toContain('billing: boolean')
+    expect(dts).toContain('nested: { enabled: boolean }')
+    expect(dts).toContain('"kebab-flag": boolean')
+    expect(dts).toContain('count: number')
+  })
+})