@jasonshimmy/vite-plugin-cer-app 0.2.0 → 0.4.0

package/docs/rendering-modes.md

@@ -83,7 +83,7 @@ dist/
 
 ```ts
 export const handler: (req, res) => void  // main request handler
-export { apiRoutes, middleware, plugins, layouts, routes }
+export { apiRoutes, plugins, layouts }
 export default handler
 ```
 
@@ -93,8 +93,7 @@ export default handler
 export default defineConfig({
   mode: 'ssr',
   ssr: {
-    dsd: true,        // Declarative Shadow DOM (eliminates FOUC)
-    streaming: false, // true = stream response; false = buffer full HTML
+    dsd: true, // Declarative Shadow DOM (eliminates FOUC)
   },
 })
 ```
@@ -242,7 +241,7 @@ Any CDN or static host. Upload the entire `dist/` directory (excluding `dist/ser
 | Dynamic routes | Yes | Yes | Requires `ssg.paths` |
 | API routes | Separate deploy | Same process | Separate deploy |
 | `useHead()` SSR injection | No | Yes | Yes |
-| Streaming | No | Optional | No |
+| Streaming | No | No | No |
 
 ---
 

package/docs/testing.md

@@ -223,12 +223,12 @@ Use in a page:
 ```ts
 // app/pages/index.ts
 component('page-index', () => {
-  const greeting = inject('greeting')
+  const greeting = useInject<string>('greeting')
   return html`<p>${greeting}</p>`
 })
 ```
 
-**Expected:** Page shows the injected string.
+**Expected:** Page shows the injected string in all three modes (SPA, SSR, SSG). `useInject` is auto-imported — no explicit import needed.
 
 ---
 
@@ -428,7 +428,7 @@ cat dist/items/1/index.html  # should contain "Item 1"
 
 ## 14. Run the automated test suite
 
-The framework ships with 211 unit and integration tests:
+The framework ships with unit and integration tests. Run them with:
 
 ```sh
 cd /path/to/@jasonshimmy/vite-plugin-cer-app

package/e2e/kitchen-sink/app/pages/(auth)/protected.ts

@@ -1,9 +1,5 @@
 component('page-protected', () => {
-  // inject() works for SSR and client-side navigations; fall back to the
-  // globalThis store for SSG where router-view loads the chunk before
-  // cer-layout-view has had a chance to call provide().
-  const appProvides = (globalThis as any).__cerPluginProvides as Map<string, unknown> | undefined
-  const greeting = inject<string>('ks-greeting') ?? appProvides?.get('ks-greeting') as string | undefined ?? 'No greeting'
+  const greeting = useInject<string>('ks-greeting', 'No greeting')
 
   return html`
     <div>

package/e2e/kitchen-sink/cer-auto-imports.d.ts

@@ -40,6 +40,7 @@ declare global {
 
   const useHead: typeof import('@jasonshimmy/vite-plugin-cer-app/composables')['useHead']
   const usePageData: typeof import('@jasonshimmy/vite-plugin-cer-app/composables')['usePageData']
+  const useInject: typeof import('@jasonshimmy/vite-plugin-cer-app/composables')['useInject']
 
   const useKsCounter: typeof import('./app/composables/useKsCounter')['useKsCounter']
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jasonshimmy/vite-plugin-cer-app",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Nuxt-style meta-framework for @jasonshimmy/custom-elements-runtime",
   "type": "module",
   "keywords": [

package/src/__tests__/plugin/build-ssr.test.ts

@@ -133,6 +133,16 @@ describe('build-ssr generateServerEntryCode (template content)', () => {
   it('sets Content-Type header on response', () => {
     expect(src).toContain('text/html; charset=utf-8')
   })
+
+  it('template initializes plugins and sets globalThis.__cerPluginProvides', () => {
+    expect(src).toContain('__cerPluginProvides')
+    expect(src).toContain('_pluginProvides')
+    expect(src).toContain('_pluginsReady')
+  })
+
+  it('template awaits _pluginsReady before handling each request', () => {
+    expect(src).toContain('await _pluginsReady')
+  })
 })
 
 describe('buildSSR', () => {

package/src/__tests__/plugin/cer-app-plugin.test.ts

@@ -37,6 +37,7 @@ vi.mock('../../plugin/virtual/error.js', () => ({ generateErrorCode: vi.fn().moc
 vi.mock('../../plugin/transforms/auto-import.js', () => ({ autoImportTransform: vi.fn().mockReturnValue(null) }))
 
 import { cerApp } from '../../plugin/index.js'
+import { APP_ENTRY_TEMPLATE } from '../../runtime/app-template.js'
 
 
 type TestPlugin = {
@@ -142,6 +143,12 @@ describe('cerApp plugin — resolveId hook', () => {
     expect(plugin.resolveId('virtual:cer-error')).toBe('\0virtual:cer-error')
   })
 
+  it('resolves /.cer/app.ts to \\0cer-app-entry (virtual, bypasses fs security)', () => {
+    const plugin = getCerPlugin()
+    plugin.config({ root: '/project' }, { command: 'serve', mode: 'development' })
+    expect(plugin.resolveId('/.cer/app.ts')).toBe('\0cer-app-entry')
+  })
+
   it('returns undefined for unknown ids', () => {
     const plugin = getCerPlugin()
     plugin.config({ root: '/project' }, { command: 'serve', mode: 'development' })
@@ -150,6 +157,14 @@ describe('cerApp plugin — resolveId hook', () => {
 })
 
 describe('cerApp plugin — load hook', () => {
+  it('loads \\0cer-app-entry with APP_ENTRY_TEMPLATE content', async () => {
+    const plugin = getCerPlugin()
+    plugin.config({ root: '/project' }, { command: 'serve', mode: 'development' })
+    plugin.configResolved(FAKE_RESOLVED)
+    const result = await plugin.load('\0cer-app-entry')
+    expect(result).toBe(APP_ENTRY_TEMPLATE)
+  })
+
   it('returns null for unknown resolved ids', async () => {
     const plugin = getCerPlugin()
     plugin.config({ root: '/project' }, { command: 'serve', mode: 'development' })

package/src/__tests__/plugin/dev-server.test.ts

@@ -48,7 +48,7 @@ function makeConfig(overrides: Partial<ResolvedCerConfig> = {}): ResolvedCerConf
     serverApiDir: '/project/server/api',
     serverMiddlewareDir: '/project/server/middleware',
     port: 3000,
-    ssr: { dsd: true, streaming: false },
+    ssr: { dsd: true },
     ssg: { routes: 'auto', concurrency: 2, fallback: false },
     router: {},
     jitCss: { content: [], extendedColors: false },

package/src/__tests__/plugin/dts-generator.test.ts

@@ -163,6 +163,11 @@ describe('generateAutoImportDts', () => {
     expect(dts).toContain("const usePageData: typeof import('@jasonshimmy/vite-plugin-cer-app/composables')['usePageData']")
   })
 
+  it('declares useInject as a framework global', async () => {
+    const dts = await generateAutoImportDts(ROOT, COMPOSABLES_DIR)
+    expect(dts).toContain("const useInject: typeof import('@jasonshimmy/vite-plugin-cer-app/composables')['useInject']")
+  })
+
   it('declares when directive as a global', async () => {
     const dts = await generateAutoImportDts(ROOT, COMPOSABLES_DIR)
     expect(dts).toContain("const when: typeof import('@jasonshimmy/custom-elements-runtime/directives')['when']")

package/src/__tests__/plugin/entry-server-template.test.ts

@@ -0,0 +1,24 @@
+import { describe, it, expect } from 'vitest'
+import { readFileSync } from 'node:fs'
+import { resolve } from 'pathe'
+
+const src = readFileSync(
+  resolve(import.meta.dirname, '../../runtime/entry-server-template.ts'),
+  'utf-8',
+)
+
+describe('entry-server-template (ENTRY_SERVER_TEMPLATE content)', () => {
+  it('template imports plugins from virtual:cer-plugins', () => {
+    expect(src).toContain('virtual:cer-plugins')
+  })
+
+  it('template initializes plugins and sets globalThis.__cerPluginProvides', () => {
+    expect(src).toContain('__cerPluginProvides')
+    expect(src).toContain('_pluginProvides')
+    expect(src).toContain('_pluginsReady')
+  })
+
+  it('template awaits _pluginsReady before handling each request', () => {
+    expect(src).toContain('await _pluginsReady')
+  })
+})

package/src/__tests__/plugin/generated-dir.test.ts

@@ -17,7 +17,6 @@ import { existsSync, writeFileSync, mkdirSync, readFileSync, appendFileSync } fr
 import {
   GENERATED_DIR_NAME,
   getGeneratedDir,
-  resolveAppEntry,
   resolveHtmlEntry,
   generateDefaultHtml,
   writeGeneratedDir,
@@ -49,18 +48,6 @@ describe('getGeneratedDir', () => {
   })
 })
 
-describe('resolveAppEntry', () => {
-  it('returns user app/app.ts when it exists', () => {
-    vi.mocked(existsSync).mockReturnValue(true)
-    expect(resolveAppEntry(mockConfig)).toBe(`${ROOT}/app/app.ts`)
-  })
-
-  it('returns .cer/app.ts when user app/app.ts is absent', () => {
-    vi.mocked(existsSync).mockReturnValue(false)
-    expect(resolveAppEntry(mockConfig)).toBe(`${ROOT}/.cer/app.ts`)
-  })
-})
-
 describe('resolveHtmlEntry', () => {
   it('returns user index.html when it exists', () => {
     vi.mocked(existsSync).mockReturnValue(true)
@@ -74,26 +61,19 @@ describe('resolveHtmlEntry', () => {
 })
 
 describe('generateDefaultHtml', () => {
-  it('references /app/app.ts when user entry exists', () => {
-    vi.mocked(existsSync).mockReturnValue(true)
-    const html = generateDefaultHtml(mockConfig)
-    expect(html).toContain('/app/app.ts')
-    expect(html).not.toContain('/.cer/app.ts')
-  })
-
-  it('references /.cer/app.ts when user entry is absent', () => {
-    vi.mocked(existsSync).mockReturnValue(false)
-    const html = generateDefaultHtml(mockConfig)
+  it('always references /.cer/app.ts', () => {
+    const html = generateDefaultHtml()
     expect(html).toContain('/.cer/app.ts')
+    expect(html).not.toContain('/app/app.ts')
   })
 
   it('includes <cer-layout-view> mount point', () => {
-    const html = generateDefaultHtml(mockConfig)
+    const html = generateDefaultHtml()
     expect(html).toContain('<cer-layout-view>')
   })
 
   it('is valid HTML with doctype', () => {
-    const html = generateDefaultHtml(mockConfig)
+    const html = generateDefaultHtml()
     expect(html).toContain('<!DOCTYPE html>')
   })
 })
@@ -112,28 +92,17 @@ describe('writeGeneratedDir', () => {
     expect(mkdirSync).not.toHaveBeenCalled()
   })
 
-  it('writes .cer/app.ts when app/app.ts does not exist', () => {
-    // Only the .cer dir check needs to return true to skip mkdirSync — but we
-    // want the user entry check to return false. Use a counter.
-    let callCount = 0
-    vi.mocked(existsSync).mockImplementation(() => {
-      callCount++
-      // First call: .cer/ dir → true (already exists, skip mkdir)
-      // Second call: app/app.ts → false (absent, write template)
-      // Subsequent calls: false (no .gitignore)
-      return callCount === 1
-    })
+  it('always writes .cer/app.ts', () => {
     writeGeneratedDir(mockConfig)
     const paths = vi.mocked(writeFileSync).mock.calls.map(([p]) => String(p))
     expect(paths.some(p => p.endsWith('/.cer/app.ts'))).toBe(true)
   })
 
-  it('skips writing .cer/app.ts when app/app.ts exists', () => {
-    // existsSync always returns true — dir exists, user entry exists
+  it('always writes .cer/app.ts even when .cer/ dir already exists', () => {
     vi.mocked(existsSync).mockReturnValue(true)
     writeGeneratedDir(mockConfig)
     const paths = vi.mocked(writeFileSync).mock.calls.map(([p]) => String(p))
-    expect(paths.some(p => p.endsWith('/.cer/app.ts'))).toBe(false)
+    expect(paths.some(p => p.endsWith('/.cer/app.ts'))).toBe(true)
   })
 
   it('always writes .cer/index.html', () => {

package/src/__tests__/plugin/resolve-config.test.ts

@@ -84,11 +84,6 @@ describe('resolveConfig', () => {
     expect(cfg.ssr.dsd).toBe(false)
   })
 
-  it('defaults ssr.streaming to false', () => {
-    const cfg = resolveConfig({}, ROOT)
-    expect(cfg.ssr.streaming).toBe(false)
-  })
-
   it('defaults ssg.routes to "auto"', () => {
     const cfg = resolveConfig({}, ROOT)
     expect(cfg.ssg.routes).toBe('auto')

package/src/__tests__/plugin/transforms/auto-import.test.ts

@@ -221,6 +221,13 @@ describe('autoImportTransform — framework composable injection', () => {
     expect(count).toBe(1)
   })
 
+  it('injects useInject import when useInject is used', () => {
+    const code = "component('page-about', () => { const svc = useInject('my-service'); return html`<div></div>` })"
+    const result = autoImportTransform(code, '/project/app/pages/about.ts', opts)!
+    expect(result).toContain(`from ${FRAMEWORK_PKG}`)
+    expect(result).toContain('useInject')
+  })
+
   it('injects usePageData for root-level convention files (loading.ts, error.ts)', () => {
     const code = "component('page-loading', () => { const d = usePageData(); return html`<div></div>` })"
     const result = autoImportTransform(code, '/project/app/loading.ts', opts)!

package/src/__tests__/runtime/use-inject-client.test.ts

@@ -0,0 +1,67 @@
+/**
+ * @vitest-environment happy-dom
+ *
+ * Tests for useInject — client-side path.
+ *
+ * Runs in happy-dom so `document` is defined, putting useInject() on the
+ * client branch. inject() from the runtime is mocked since it requires a
+ * live component context that doesn't exist in unit tests.
+ */
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest'
+
+vi.mock('@jasonshimmy/custom-elements-runtime', () => ({
+  inject: vi.fn(),
+}))
+
+import { inject } from '@jasonshimmy/custom-elements-runtime'
+import { useInject } from '../../runtime/composables/use-inject.js'
+
+const _g = globalThis as Record<string, unknown>
+
+describe('useInject — client-side', () => {
+  beforeEach(() => {
+    delete _g['__cerPluginProvides']
+    vi.mocked(inject).mockReturnValue(undefined)
+  })
+
+  afterEach(() => {
+    delete _g['__cerPluginProvides']
+  })
+
+  it('returns the value from inject() when the component context has it', () => {
+    vi.mocked(inject).mockReturnValue('injected-value')
+    expect(useInject('my-key')).toBe('injected-value')
+  })
+
+  it('falls back to __cerPluginProvides when inject() returns undefined', () => {
+    _g['__cerPluginProvides'] = new Map([['my-key', 'plugin-provided']])
+    expect(useInject('my-key')).toBe('plugin-provided')
+  })
+
+  it('inject() result takes priority over __cerPluginProvides', () => {
+    vi.mocked(inject).mockReturnValue('inject-wins')
+    _g['__cerPluginProvides'] = new Map([['my-key', 'global-value']])
+    expect(useInject('my-key')).toBe('inject-wins')
+  })
+
+  it('returns defaultValue when inject() and provides both miss', () => {
+    expect(useInject('missing', 'default')).toBe('default')
+  })
+
+  it('returns undefined when inject() and provides both miss with no defaultValue', () => {
+    expect(useInject('missing')).toBeUndefined()
+  })
+
+  it('returns defaultValue when inject() returns undefined and key is absent from provides', () => {
+    _g['__cerPluginProvides'] = new Map()
+    expect(useInject('missing', 42)).toBe(42)
+  })
+
+  it('is generic and preserves the typed shape from inject()', () => {
+    interface Service { call(): string }
+    const svc: Service = { call: () => 'ok' }
+    vi.mocked(inject).mockReturnValue(svc)
+    const result = useInject<Service>('svc')
+    expect(result?.call()).toBe('ok')
+  })
+})

package/src/__tests__/runtime/use-inject.test.ts

@@ -0,0 +1,66 @@
+/**
+ * Tests for useInject — server-side (SSR/SSG) path.
+ *
+ * This file runs in the default 'node' environment where `document` is
+ * undefined, so useInject() always takes the SSR branch: reading from
+ * globalThis.__cerPluginProvides.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
+import { useInject } from '../../runtime/composables/use-inject.js'
+
+const _g = globalThis as Record<string, unknown>
+
+describe('useInject — server-side (SSR/SSG)', () => {
+  beforeEach(() => {
+    delete _g['__cerPluginProvides']
+  })
+
+  afterEach(() => {
+    delete _g['__cerPluginProvides']
+  })
+
+  it('returns value from __cerPluginProvides when key is present', () => {
+    _g['__cerPluginProvides'] = new Map([['my-service', { greet: () => 'hello' }]])
+    const result = useInject<{ greet(): string }>('my-service')
+    expect(typeof result?.greet).toBe('function')
+    expect(result?.greet()).toBe('hello')
+  })
+
+  it('returns defaultValue when key is absent from the provides map', () => {
+    _g['__cerPluginProvides'] = new Map()
+    expect(useInject('missing', 'fallback')).toBe('fallback')
+  })
+
+  it('returns undefined when key is absent and no defaultValue is given', () => {
+    _g['__cerPluginProvides'] = new Map()
+    expect(useInject('missing')).toBeUndefined()
+  })
+
+  it('returns undefined when __cerPluginProvides is not set at all', () => {
+    expect(useInject('my-service')).toBeUndefined()
+  })
+
+  it('returns defaultValue when __cerPluginProvides is not set and defaultValue is given', () => {
+    expect(useInject('my-service', 'default')).toBe('default')
+  })
+
+  it('is generic and preserves the typed shape', () => {
+    interface Store { count: number }
+    const store: Store = { count: 42 }
+    _g['__cerPluginProvides'] = new Map([['store', store]])
+    const result = useInject<Store>('store')
+    expect(result?.count).toBe(42)
+  })
+
+  it('is safe to call multiple times — does not consume the value', () => {
+    _g['__cerPluginProvides'] = new Map([['key', 'value']])
+    expect(useInject('key')).toBe('value')
+    expect(useInject('key')).toBe('value')
+  })
+
+  it('supports multiple keys independently', () => {
+    _g['__cerPluginProvides'] = new Map([['a', 1], ['b', 2]])
+    expect(useInject('a')).toBe(1)
+    expect(useInject('b')).toBe(2)
+  })
+})

package/src/__tests__/types/config.test.ts

@@ -12,7 +12,7 @@ describe('defineConfig', () => {
   })
 
   it('preserves nested ssr config', () => {
-    const config = { ssr: { dsd: false, streaming: true } }
+    const config = { ssr: { dsd: false } }
     expect(defineConfig(config)).toEqual(config)
   })
 

package/src/cli/create/index.ts

@@ -179,6 +179,10 @@ async function generateInlineTemplate(
 ): Promise<void> {
   await mkdir(join(targetDir, 'app/pages'), { recursive: true })
   await mkdir(join(targetDir, 'app/layouts'), { recursive: true })
+  await mkdir(join(targetDir, 'app/components'), { recursive: true })
+  await mkdir(join(targetDir, 'app/composables'), { recursive: true })
+  await mkdir(join(targetDir, 'app/plugins'), { recursive: true })
+  await mkdir(join(targetDir, 'app/middleware'), { recursive: true })
 
   // package.json
   await writeFile(
@@ -215,13 +219,6 @@ async function generateInlineTemplate(
     'utf-8',
   )
 
-  // app/app.ts
-  await writeFile(
-    join(targetDir, 'app/app.ts'),
-    `import '@jasonshimmy/custom-elements-runtime/css'\nimport 'virtual:cer-jit-css'\nimport 'virtual:cer-components'\nimport routes from 'virtual:cer-routes'\nimport layouts from 'virtual:cer-layouts'\nimport plugins from 'virtual:cer-plugins'\nimport { hasLoading, loadingTag } from 'virtual:cer-loading'\nimport { hasError, errorTag } from 'virtual:cer-error'\nimport { component, ref, provide, useOnConnected, useOnDisconnected, registerBuiltinComponents } from '@jasonshimmy/custom-elements-runtime'\nimport { initRouter } from '@jasonshimmy/custom-elements-runtime/router'\nimport { enableJITCSS } from '@jasonshimmy/custom-elements-runtime/jit-css'\n\nregisterBuiltinComponents()\nenableJITCSS()\n\nconst router = initRouter({ routes })\n\nconst isNavigating = ref(false)\nconst currentError = ref(null)\n;(globalThis as any).resetError = () => { currentError.value = null; router.replace(router.getCurrent().path) }\nconst _push = router.push.bind(router)\nconst _replace = router.replace.bind(router)\nrouter.push = async (path) => { isNavigating.value = true; currentError.value = null; try { await _push(path) } catch (err) { currentError.value = err instanceof Error ? err.message : String(err) } finally { isNavigating.value = false } }\nrouter.replace = async (path) => { isNavigating.value = true; currentError.value = null; try { await _replace(path) } catch (err) { currentError.value = err instanceof Error ? err.message : String(err) } finally { isNavigating.value = false } }\n\nconst _pluginProvides = new Map()\n;(globalThis as any).__cerPluginProvides = _pluginProvides\n\ncomponent('cer-layout-view', () => {\n  for (const [key, value] of _pluginProvides) { provide(key, value) }\n  const current = ref(router.getCurrent())\n  let unsub: (() => void) | undefined\n  useOnConnected(() => { unsub = router.subscribe((s: typeof current.value) => { current.value = s }) })\n  useOnDisconnected(() => { unsub?.(); unsub = undefined })\n  if (currentError.value !== null) {\n    if (hasError && errorTag) return { tag: errorTag, props: { attrs: { error: String(currentError.value) } }, children: [] }\n    return { tag: 'div', props: { attrs: { style: 'padding:2rem;font-family:monospace' } }, children: [String(currentError.value)] }\n  }\n  if (isNavigating.value && hasLoading && loadingTag) return { tag: loadingTag, props: {}, children: [] }\n  const matched = router.matchRoute(current.value.path)\n  const layoutName = (matched?.route as any)?.meta?.layout ?? 'default'\n  const layoutTag = (layouts as Record<string, string>)[layoutName]\n  const routerView = { tag: 'router-view', props: {}, children: [] }\n  return layoutTag ? { tag: layoutTag, props: {}, children: [routerView] } : routerView\n})\n\nfor (const plugin of plugins ?? []) {\n  if (plugin && typeof plugin.setup === 'function') {\n    await plugin.setup({ router, provide: (key: string, value: unknown) => { _pluginProvides.set(key, value) }, config: {} })\n  }\n}\n\nif (typeof window !== 'undefined') {\n  const _initMatch = router.matchRoute(window.location.pathname)\n  if (_initMatch?.route?.load) {\n    try { await _initMatch.route.load() } catch { /* non-fatal */ }\n  }\n}\n\nif (typeof window !== 'undefined') {\n  await _replace(window.location.pathname + window.location.search + window.location.hash)\n  delete (globalThis as any).__CER_DATA__\n}\n\nexport { router }\n`,
-    'utf-8',
-  )
-
   // app/pages/index.ts
   await writeFile(
     join(targetDir, 'app/pages/index.ts'),
@@ -236,10 +233,17 @@ async function generateInlineTemplate(
     'utf-8',
   )
 
+  // .gitignore
+  await writeFile(
+    join(targetDir, '.gitignore'),
+    `# Dependencies\nnode_modules/\n\n# Build output\ndist/\n\n# CER App generated directory\n.cer/\n\n# Environment variables\n.env.local\n.env.*.local\n\n# Editor\n.vscode/\n.idea/\n*.suo\n*.sw?\n\n# OS\n.DS_Store\nThumbs.db\n\n# Logs\n*.log\n`,
+    'utf-8',
+  )
+
   // index.html
   await writeFile(
     join(targetDir, 'index.html'),
-    `<!DOCTYPE html>\n<html lang="en">\n  <head>\n    <meta charset="UTF-8">\n    <meta name="viewport" content="width=device-width, initial-scale=1.0">\n    <title>${projectName}</title>\n  </head>\n  <body>\n    <cer-layout-view></cer-layout-view>\n    <script type="module" src="/app/app.ts"></script>\n  </body>\n</html>\n`,
+    `<!DOCTYPE html>\n<html lang="en">\n  <head>\n    <meta charset="UTF-8">\n    <meta name="viewport" content="width=device-width, initial-scale=1.0">\n    <title>${projectName}</title>\n  </head>\n  <body>\n    <cer-layout-view></cer-layout-view>\n    <script type="module" src="/.cer/app.ts"></script>\n  </body>\n</html>\n`,
     'utf-8',
   )
 }

package/src/cli/create/templates/spa/.gitignore.tpl

@@ -0,0 +1,25 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# CER App generated directory
+.cer/
+
+# Environment variables
+.env.local
+.env.*.local
+
+# Editor
+.vscode/
+.idea/
+*.suo
+*.sw?
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log

package/src/cli/create/templates/spa/index.html.tpl

@@ -7,6 +7,6 @@
   </head>
   <body>
     <cer-layout-view></cer-layout-view>
-    <script type="module" src="/app/app.ts"></script>
+    <script type="module" src="/.cer/app.ts"></script>
   </body>
 </html>

package/src/cli/create/templates/ssg/.gitignore.tpl

@@ -0,0 +1,25 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# CER App generated directory
+.cer/
+
+# Environment variables
+.env.local
+.env.*.local
+
+# Editor
+.vscode/
+.idea/
+*.suo
+*.sw?
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log

package/src/cli/create/templates/ssg/index.html.tpl

@@ -7,6 +7,6 @@
   </head>
   <body>
     <cer-layout-view></cer-layout-view>
-    <script type="module" src="/app/app.ts"></script>
+    <script type="module" src="/.cer/app.ts"></script>
   </body>
 </html>

package/src/cli/create/templates/ssr/.gitignore.tpl

@@ -0,0 +1,25 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# CER App generated directory
+.cer/
+
+# Environment variables
+.env.local
+.env.*.local
+
+# Editor
+.vscode/
+.idea/
+*.suo
+*.sw?
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log

package/src/cli/create/templates/ssr/cer.config.ts.tpl

@@ -4,7 +4,6 @@ export default defineConfig({
   mode: 'ssr',
   ssr: {
     dsd: true,
-    streaming: true,
   },
   autoImports: { components: true, composables: true, directives: true, runtime: true },
 })

package/src/cli/create/templates/ssr/index.html.tpl

@@ -7,6 +7,6 @@
   </head>
   <body>
     <cer-layout-view></cer-layout-view>
-    <script type="module" src="/app/app.ts"></script>
+    <script type="module" src="/.cer/app.ts"></script>
   </body>
 </html>

package/src/plugin/build-ssr.ts

@@ -50,6 +50,23 @@ registerBuiltinComponents()
 // minimal set (<, >, & …) and re-escapes everything else.
 registerEntityMap(entitiesJson)
 
+// Run plugins once at server startup so their provide() values are available
+// to useInject() during every SSR/SSG render pass.
+const _pluginProvides = new Map()
+;(globalThis).__cerPluginProvides = _pluginProvides
+const _pluginsReady = (async () => {
+  const _bootstrapRouter = initRouter({ routes })
+  for (const plugin of plugins) {
+    if (plugin && typeof plugin.setup === 'function') {
+      await plugin.setup({
+        router: _bootstrapRouter,
+        provide: (key, value) => _pluginProvides.set(key, value),
+        config: {},
+      })
+    }
+  }
+})()
+
 // Load the Vite-built client index.html (dist/client/index.html) so every SSR
 // response includes the client-side scripts needed for hydration and routing.
 // The server bundle lives at dist/server/server.js, so ../client resolves correctly.
@@ -119,6 +136,7 @@ function _mergeWithClientTemplate(ssrHtml, clientTemplate) {
 // synchronously right before renderToStringWithJITCSS — guaranteeing that
 // concurrent renders (SSG concurrency > 1) never race on a shared global.
 const _prepareRequest = async (req) => {
+  await _pluginsReady
   const router = initRouter({ routes, initialUrl: req.url ?? '/' })
   const current = router.getCurrent()
   const { route, params } = router.matchRoute(current.path)

package/src/plugin/dev-server.ts

@@ -15,7 +15,7 @@ export interface ResolvedCerConfig {
   serverApiDir: string
   serverMiddlewareDir: string
   port: number
-  ssr: { dsd: boolean; streaming: boolean }
+  ssr: { dsd: boolean }
   ssg: { routes: 'auto' | string[]; concurrency: number; fallback: boolean }
   router: { base?: string; scrollToFragment?: boolean | object }
   jitCss: { content: string[]; extendedColors: boolean }