npm - @jasonshimmy/vite-plugin-cer-app - Versions diffs - 0.2.0 → 0.3.0 - Mend

@jasonshimmy/vite-plugin-cer-app 0.2.0 → 0.3.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.

Files changed (56) hide show

package/CHANGELOG.md +4 -0
package/README.md +2 -0
package/commits.txt +1 -1
package/dist/cli/create/index.js +7 -3
package/dist/cli/create/index.js.map +1 -1
package/dist/cli/create/templates/spa/.gitignore.tpl +25 -0
package/dist/cli/create/templates/spa/index.html.tpl +1 -1
package/dist/cli/create/templates/ssg/.gitignore.tpl +25 -0
package/dist/cli/create/templates/ssg/index.html.tpl +1 -1
package/dist/cli/create/templates/ssr/.gitignore.tpl +25 -0
package/dist/cli/create/templates/ssr/cer.config.ts.tpl +0 -1
package/dist/cli/create/templates/ssr/index.html.tpl +1 -1
package/dist/plugin/dev-server.d.ts +0 -1
package/dist/plugin/dev-server.d.ts.map +1 -1
package/dist/plugin/generated-dir.d.ts +5 -11
package/dist/plugin/generated-dir.d.ts.map +1 -1
package/dist/plugin/generated-dir.js +43 -31
package/dist/plugin/generated-dir.js.map +1 -1
package/dist/plugin/index.d.ts.map +1 -1
package/dist/plugin/index.js +0 -1
package/dist/plugin/index.js.map +1 -1
package/dist/runtime/app-template.d.ts +5 -4
package/dist/runtime/app-template.d.ts.map +1 -1
package/dist/runtime/app-template.js +6 -5
package/dist/runtime/app-template.js.map +1 -1
package/dist/types/config.d.ts +0 -1
package/dist/types/config.d.ts.map +1 -1
package/dist/types/config.js.map +1 -1
package/docs/cli.md +1 -1
package/docs/configuration.md +2 -11
package/docs/getting-started.md +2 -100
package/docs/rendering-modes.md +2 -3
package/package.json +1 -1
package/src/__tests__/plugin/dev-server.test.ts +1 -1
package/src/__tests__/plugin/generated-dir.test.ts +8 -39
package/src/__tests__/plugin/resolve-config.test.ts +0 -5
package/src/__tests__/types/config.test.ts +1 -1
package/src/cli/create/index.ts +12 -8
package/src/cli/create/templates/spa/.gitignore.tpl +25 -0
package/src/cli/create/templates/spa/index.html.tpl +1 -1
package/src/cli/create/templates/ssg/.gitignore.tpl +25 -0
package/src/cli/create/templates/ssg/index.html.tpl +1 -1
package/src/cli/create/templates/ssr/.gitignore.tpl +25 -0
package/src/cli/create/templates/ssr/cer.config.ts.tpl +0 -1
package/src/cli/create/templates/ssr/index.html.tpl +1 -1
package/src/plugin/dev-server.ts +1 -1
package/src/plugin/generated-dir.ts +44 -31
package/src/plugin/index.ts +0 -1
package/src/runtime/app-template.ts +6 -5
package/src/types/config.ts +0 -1
package/dist/cli/create/templates/spa/app/app.ts.tpl +0 -93
package/dist/cli/create/templates/ssg/app/app.ts.tpl +0 -97
package/dist/cli/create/templates/ssr/app/app.ts.tpl +0 -97
package/src/cli/create/templates/spa/app/app.ts.tpl +0 -93
package/src/cli/create/templates/ssg/app/app.ts.tpl +0 -97
package/src/cli/create/templates/ssr/app/app.ts.tpl +0 -97

package/docs/configuration.md CHANGED Viewed

@@ -13,7 +13,6 @@ export default defineConfig({
   ssr: {
     dsd: true,
-    streaming: false,
   },
   ssg: {
@@ -87,8 +86,7 @@ Controls SSR rendering behavior.
 ```ts
 ssr: {
-  dsd: true,       // Emit Declarative Shadow DOM
-  streaming: false // Reserved for future use
+  dsd: true, // Emit Declarative Shadow DOM
 }
 ```
@@ -99,13 +97,6 @@ ssr: {
 When `true`, renders components with [Declarative Shadow DOM](https://developer.chrome.com/docs/css-ui/declarative-shadow-dom) markup. This eliminates Flash of Unstyled Content (FOUC) because styles are embedded directly in the HTML.
-### `ssr.streaming`
-**Type:** `boolean`
-**Default:** `false`
-Reserved for future use. Currently, the SSR renderer always collects the full HTML string before sending the response.
 ---
 ## `ssg` options
@@ -247,7 +238,7 @@ export default defineConfig({
   plugins: [
     cerApp({
       mode: 'ssr',
-      ssr: { dsd: true, streaming: true },
+      ssr: { dsd: true },
     }),
   ],
 })

package/docs/getting-started.md CHANGED Viewed

@@ -128,110 +128,12 @@ component('layout-default', () => {
   </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>
 ```
-### 7. Create `app/app.ts` (auto-generated if absent)
-The framework generates this file when you scaffold a new project. It bootstraps the router, registers all auto-discovered components, runs plugins, and mounts the app:
-```ts
-// app/app.ts
-import '@jasonshimmy/custom-elements-runtime/css'
-import 'virtual:cer-jit-css'
-import 'virtual:cer-components'
-import routes from 'virtual:cer-routes'
-import layouts from 'virtual:cer-layouts'
-import plugins from 'virtual:cer-plugins'
-import { hasLoading, loadingTag } from 'virtual:cer-loading'
-import { hasError, errorTag } from 'virtual:cer-error'
-import {
-  component, ref, provide,
-  useOnConnected, useOnDisconnected,
-  registerBuiltinComponents,
-} from '@jasonshimmy/custom-elements-runtime'
-import { initRouter } from '@jasonshimmy/custom-elements-runtime/router'
-import { enableJITCSS } from '@jasonshimmy/custom-elements-runtime/jit-css'
-registerBuiltinComponents()
-enableJITCSS()
-const router = initRouter({ routes })
-const isNavigating = ref(false)
-const currentError = ref(null)
-;(globalThis as any).resetError = () => {
-  currentError.value = null
-  router.replace(router.getCurrent().path)
-}
-const _push = router.push.bind(router)
-const _replace = router.replace.bind(router)
-router.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 }
-}
-router.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 }
-}
-// _pluginProvides is populated by plugin setup and forwarded into the component
-// context tree via provide() inside cer-layout-view so inject() works in all modes.
-// Also exposed on globalThis for the SSG timing edge case — see docs/plugins.md.
-const _pluginProvides = new Map<string, unknown>()
-;(globalThis as any).__cerPluginProvides = _pluginProvides
-component('cer-layout-view', () => {
-  for (const [key, value] of _pluginProvides) { provide(key, value) }
-  const current = ref(router.getCurrent())
-  let unsub: (() => void) | undefined
-  useOnConnected(() => { unsub = router.subscribe((s) => { current.value = s }) })
-  useOnDisconnected(() => { unsub?.(); unsub = undefined })
-  if (currentError.value !== null) {
-    if (hasError && errorTag) return { tag: errorTag, props: { attrs: { error: String(currentError.value) } }, children: [] }
-    return { tag: 'div', props: { attrs: { style: 'padding:2rem;font-family:monospace' } }, children: String(currentError.value) }
-  }
-  if (isNavigating.value && hasLoading && loadingTag) return { tag: loadingTag, props: {}, children: [] }
-  const matched = router.matchRoute(current.value.path)
-  const layoutName = (matched?.route as any)?.meta?.layout ?? 'default'
-  const layoutTag = (layouts as Record<string, string>)[layoutName]
-  const routerView = { tag: 'router-view', props: {}, children: [] }
-  return layoutTag ? { tag: layoutTag, props: {}, children: [routerView] } : routerView
-})
-// Plugins run AFTER cer-layout-view is defined so provide() calls from plugins
-// are forwarded into the component tree on the very first render.
-for (const plugin of plugins ?? []) {
-  if (plugin && typeof plugin.setup === 'function') {
-    await plugin.setup({ router, provide: (key, value) => { _pluginProvides.set(key, value) }, config: {} })
-  }
-}
-// Pre-load the current page's route chunk AFTER plugins run.
-// This ensures cer-layout-view's first render (and its provide() calls) completes
-// before page component modules are imported and their renders are scheduled.
-if (typeof window !== 'undefined') {
-  const _initMatch = router.matchRoute(window.location.pathname)
-  if (_initMatch?.route?.load) {
-    try { await _initMatch.route.load() } catch { /* non-fatal */ }
-  }
-}
-if (typeof window !== 'undefined') {
-  await _replace(window.location.pathname + window.location.search + window.location.hash)
-  delete (globalThis as any).__CER_DATA__
-}
-export { router }
-```
-> **Note:** Do not move the plugin loop before `component('cer-layout-view', …)`. The layout component must be defined first so that when plugins call `app.provide()`, the values are available to the component tree from the very first render. See [Plugins](plugins.md) for details.
+> **Note:** The framework bootstrap lives in `.cer/app.ts` and is regenerated automatically on every dev server start and build. You never edit or own this file — updates to the plugin propagate to it immediately, just like Nuxt's `.nuxt/` directory.
 ---

package/docs/rendering-modes.md CHANGED Viewed

@@ -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/package.json CHANGED Viewed

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

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

@@ -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/generated-dir.test.ts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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__/types/config.test.ts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 ADDED Viewed

@@ -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 CHANGED Viewed

@@ -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 ADDED Viewed

@@ -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 CHANGED Viewed

@@ -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 ADDED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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/dev-server.ts CHANGED Viewed

@@ -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 }

package/src/plugin/generated-dir.ts CHANGED Viewed

@@ -13,16 +13,6 @@ export function getGeneratedDir(root: string): string {
   return join(root, GENERATED_DIR_NAME)
 }
-/**
- * Returns the app entry file path to use for builds and the dev server.
- * Prefers the consumer's `app/app.ts` when it exists; falls back to `.cer/app.ts`.
- */
-export function resolveAppEntry(config: ResolvedCerConfig): string {
-  const userEntry = join(config.srcDir, 'app.ts')
-  if (existsSync(userEntry)) return userEntry
-  return join(getGeneratedDir(config.root), 'app.ts')
-}
 /**
  * Returns the HTML entry path to use for builds.
  * Prefers the consumer's root-level `index.html` when it exists;
@@ -35,13 +25,10 @@ export function resolveHtmlEntry(config: ResolvedCerConfig): string {
 }
 /**
- * Generates the content for a default `index.html`.
- * The script src points to the consumer's `app/app.ts` if it exists,
- * otherwise to the generated `.cer/app.ts`.
+ * Generates the content for the default `.cer/index.html`.
+ * Always points to the generated `/.cer/app.ts` entry.
  */
-export function generateDefaultHtml(config: ResolvedCerConfig): string {
-  const userEntry = join(config.srcDir, 'app.ts')
-  const scriptSrc = existsSync(userEntry) ? '/app/app.ts' : '/.cer/app.ts'
+export function generateDefaultHtml(): string {
   return `<!DOCTYPE html>
 <html lang="en">
   <head>
@@ -51,34 +38,61 @@ export function generateDefaultHtml(config: ResolvedCerConfig): string {
   </head>
   <body>
     <cer-layout-view></cer-layout-view>
-    <script type="module" src="${scriptSrc}"></script>
+    <script type="module" src="/.cer/app.ts"></script>
   </body>
 </html>
 `
 }
+const GITIGNORE_DEFAULTS = `# 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
+`
 /**
- * Ensures `.cer/` is listed in the project's `.gitignore`.
- * Creates `.gitignore` if it does not exist.
+ * Ensures `.cer/`, `node_modules/`, `dist/`, and other common entries are
+ * listed in the project's `.gitignore`. Creates `.gitignore` if it does not exist.
  */
 function ensureGitignore(root: string): void {
   const gitignorePath = join(root, '.gitignore')
-  const entry = `${GENERATED_DIR_NAME}/`
+  const cerEntry = `${GENERATED_DIR_NAME}/`
   if (existsSync(gitignorePath)) {
     const content = readFileSync(gitignorePath, 'utf-8')
-    if (!content.includes(entry) && !content.includes(`${GENERATED_DIR_NAME}\n`)) {
-      appendFileSync(gitignorePath, `\n# CER App generated directory\n${entry}\n`)
+    if (!content.includes(cerEntry) && !content.includes(`${GENERATED_DIR_NAME}\n`)) {
+      appendFileSync(gitignorePath, `\n# CER App generated directory\n${cerEntry}\n`)
     }
   } else {
-    writeFileSync(gitignorePath, `# CER App generated directory\n${entry}\n`)
+    writeFileSync(gitignorePath, GITIGNORE_DEFAULTS)
   }
 }
 /**
  * Writes all generated files to `.cer/`:
- * - `.cer/app.ts`       — default entry (only when `app/app.ts` does not exist)
- * - `.cer/index.html`   — default HTML shell
+ * - `.cer/app.ts`        — framework entry (always regenerated)
+ * - `.cer/index.html`    — default HTML shell (always regenerated)
  * - `.cer/tsconfig.json` — written by dts-generator via writeTsconfigPaths
  *
  * Also ensures `.cer/` is listed in `.gitignore`.
@@ -89,14 +103,13 @@ export function writeGeneratedDir(config: ResolvedCerConfig): void {
     mkdirSync(dir, { recursive: true })
   }
-  // Write default app.ts only when the consumer has not provided one.
-  const userEntry = join(config.srcDir, 'app.ts')
-  if (!existsSync(userEntry)) {
-    writeFileSync(join(dir, 'app.ts'), APP_ENTRY_TEMPLATE, 'utf-8')
-  }
+  // Always write the generated app.ts — this is the framework entry point and
+  // is never user-owned. Regenerating it on every dev/build ensures consumers
+  // automatically get the latest bootstrap code on plugin update (Nuxt-style).
+  writeFileSync(join(dir, 'app.ts'), APP_ENTRY_TEMPLATE, 'utf-8')
   // Always write the default index.html so builds and the dev server can use it.
-  writeFileSync(join(dir, 'index.html'), generateDefaultHtml(config), 'utf-8')
+  writeFileSync(join(dir, 'index.html'), generateDefaultHtml(), 'utf-8')
   ensureGitignore(config.root)
 }

package/src/plugin/index.ts CHANGED Viewed

@@ -62,7 +62,6 @@ export function resolveConfig(userConfig: CerAppConfig, root: string = process.c
     port: userConfig.port ?? 3000,
     ssr: {
       dsd: userConfig.ssr?.dsd ?? true,
-      streaming: userConfig.ssr?.streaming ?? false,
     },
     ssg: {
       routes: userConfig.ssg?.routes ?? 'auto',

package/src/runtime/app-template.ts CHANGED Viewed

@@ -1,11 +1,12 @@
 /**
- * Template string for the default `.cer/app.ts` client entry point.
+ * Template string for `.cer/app.ts` — the framework client entry point.
  *
- * Written to `.cer/app.ts` when the consumer does not provide `app/app.ts`.
- * Consumers can override by creating their own `app/app.ts`.
+ * Always written to `.cer/app.ts` on every dev/build so consumers
+ * automatically receive the latest bootstrap code on plugin update.
+ * This file is gitignored and should never be edited directly.
  */
-export const APP_ENTRY_TEMPLATE = `// AUTO-GENERATED by @jasonshimmy/vite-plugin-cer-app
-// This is the default client entry point. Create app/app.ts to override it.
+export const APP_ENTRY_TEMPLATE = `// AUTO-GENERATED by @jasonshimmy/vite-plugin-cer-app — do not edit.
+// Regenerated automatically on every dev server start and build.
 import '@jasonshimmy/custom-elements-runtime/css'
 import 'virtual:cer-jit-css'

package/src/types/config.ts CHANGED Viewed

@@ -13,7 +13,6 @@ export interface JitCssConfig {
 export interface SsrConfig {
   dsd?: boolean
-  streaming?: boolean
 }
 export interface AutoImportsConfig {