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

@jasonshimmy/vite-plugin-cer-app 0.1.6 → 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 (95) hide show

package/.github/workflows/publish.yml +56 -5
package/CHANGELOG.md +8 -0
package/README.md +2 -0
package/commits.txt +1 -1
package/dist/cli/commands/build.d.ts.map +1 -1
package/dist/cli/commands/build.js +19 -5
package/dist/cli/commands/build.js.map +1 -1
package/dist/cli/commands/dev.js +1 -1
package/dist/cli/commands/dev.js.map +1 -1
package/dist/cli/commands/preview.d.ts.map +1 -1
package/dist/cli/commands/preview.js +0 -1
package/dist/cli/commands/preview.js.map +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/build-ssg.d.ts.map +1 -1
package/dist/plugin/build-ssg.js.map +1 -1
package/dist/plugin/build-ssr.d.ts +10 -0
package/dist/plugin/build-ssr.d.ts.map +1 -1
package/dist/plugin/build-ssr.js +21 -8
package/dist/plugin/build-ssr.js.map +1 -1
package/dist/plugin/dev-server.d.ts +0 -1
package/dist/plugin/dev-server.d.ts.map +1 -1
package/dist/plugin/dev-server.js +0 -2
package/dist/plugin/dev-server.js.map +1 -1
package/dist/plugin/dts-generator.d.ts +4 -4
package/dist/plugin/dts-generator.d.ts.map +1 -1
package/dist/plugin/dts-generator.js +39 -19
package/dist/plugin/dts-generator.js.map +1 -1
package/dist/plugin/generated-dir.d.ts +28 -0
package/dist/plugin/generated-dir.d.ts.map +1 -0
package/dist/plugin/generated-dir.js +106 -0
package/dist/plugin/generated-dir.js.map +1 -0
package/dist/plugin/index.d.ts.map +1 -1
package/dist/plugin/index.js +27 -1
package/dist/plugin/index.js.map +1 -1
package/dist/plugin/path-utils.js.map +1 -1
package/dist/plugin/virtual/loading.d.ts.map +1 -1
package/dist/plugin/virtual/loading.js.map +1 -1
package/dist/runtime/app-template.d.ts +9 -0
package/dist/runtime/app-template.d.ts.map +1 -0
package/dist/runtime/app-template.js +159 -0
package/dist/runtime/app-template.js.map +1 -0
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 +4 -5
package/docs/routing.md +1 -1
package/e2e/kitchen-sink/tsconfig.json +3 -0
package/eslint.config.ts +22 -0
package/package.json +6 -1
package/src/__tests__/plugin/build-ssr.test.ts +24 -10
package/src/__tests__/plugin/cer-app-plugin.test.ts +35 -0
package/src/__tests__/plugin/dev-server.test.ts +1 -1
package/src/__tests__/plugin/dts-generator.test.ts +15 -6
package/src/__tests__/plugin/generated-dir.test.ts +137 -0
package/src/__tests__/plugin/resolve-config.test.ts +0 -5
package/src/__tests__/types/config.test.ts +1 -1
package/src/cli/commands/build.ts +19 -5
package/src/cli/commands/dev.ts +2 -2
package/src/cli/commands/preview.ts +7 -5
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/build-ssg.ts +2 -2
package/src/plugin/build-ssr.ts +22 -8
package/src/plugin/dev-server.ts +5 -4
package/src/plugin/dts-generator.ts +43 -19
package/src/plugin/generated-dir.ts +115 -0
package/src/plugin/index.ts +32 -2
package/src/plugin/path-utils.ts +1 -1
package/src/plugin/virtual/loading.ts +0 -1
package/{e2e/kitchen-sink/app/app.ts → src/runtime/app-template.ts} +24 -7
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/e2e/kitchen-sink/index.html +0 -12
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/src/plugin/generated-dir.ts ADDED Viewed

@@ -0,0 +1,115 @@
+import { writeFileSync, existsSync, mkdirSync, readFileSync, appendFileSync } from 'node:fs'
+import { join } from 'pathe'
+import type { ResolvedCerConfig } from './dev-server.js'
+import { APP_ENTRY_TEMPLATE } from '../runtime/app-template.js'
+/** The name of the generated directory relative to the project root. */
+export const GENERATED_DIR_NAME = '.cer'
+/**
+ * Returns the absolute path to the .cer/ generated directory.
+ */
+export function getGeneratedDir(root: string): string {
+  return join(root, GENERATED_DIR_NAME)
+}
+/**
+ * Returns the HTML entry path to use for builds.
+ * Prefers the consumer's root-level `index.html` when it exists;
+ * falls back to `.cer/index.html`.
+ */
+export function resolveHtmlEntry(config: ResolvedCerConfig): string {
+  const userHtml = join(config.root, 'index.html')
+  if (existsSync(userHtml)) return userHtml
+  return join(getGeneratedDir(config.root), 'index.html')
+}
+/**
+ * Generates the content for the default `.cer/index.html`.
+ * Always points to the generated `/.cer/app.ts` entry.
+ */
+export function generateDefaultHtml(): string {
+  return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>CER App</title>
+  </head>
+  <body>
+    <cer-layout-view></cer-layout-view>
+    <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/`, `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 cerEntry = `${GENERATED_DIR_NAME}/`
+  if (existsSync(gitignorePath)) {
+    const content = readFileSync(gitignorePath, 'utf-8')
+    if (!content.includes(cerEntry) && !content.includes(`${GENERATED_DIR_NAME}\n`)) {
+      appendFileSync(gitignorePath, `\n# CER App generated directory\n${cerEntry}\n`)
+    }
+  } else {
+    writeFileSync(gitignorePath, GITIGNORE_DEFAULTS)
+  }
+}
+/**
+ * Writes all generated files to `.cer/`:
+ * - `.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`.
+ */
+export function writeGeneratedDir(config: ResolvedCerConfig): void {
+  const dir = getGeneratedDir(config.root)
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true })
+  }
+  // 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(), 'utf-8')
+  ensureGitignore(config.root)
+}

package/src/plugin/index.ts CHANGED Viewed

@@ -1,11 +1,13 @@
 import { resolve, join } from 'pathe'
-import type { Plugin, ViteDevServer, ModuleNode } from 'vite'
+import { existsSync, readFileSync } from 'node:fs'
+import type { Plugin, ViteDevServer } from 'vite'
 import type { CerAppConfig } from '../types/config.js'
 import type { ResolvedCerConfig } from './dev-server.js'
 import { cerPlugin } from '@jasonshimmy/custom-elements-runtime/vite-plugin'
 import { autoImportTransform } from './transforms/auto-import.js'
 import { scanComposableExports, writeAutoImportDts, writeTsconfigPaths } from './dts-generator.js'
 import { configureCerDevServer } from './dev-server.js'
+import { writeGeneratedDir, getGeneratedDir } from './generated-dir.js'
 import { generateRoutesCode } from './virtual/routes.js'
 import { generateLayoutsCode } from './virtual/layouts.js'
 import { generateComponentsCode } from './virtual/components.js'
@@ -60,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',
@@ -256,11 +257,38 @@ export function cerApp(userConfig: CerAppConfig = {}): Plugin[] {
         // config might not be set yet; resolve with cwd
         config = resolveConfig(userConfig, process.cwd())
       }
+      // Write .cer/ generated files (app.ts fallback, index.html, .gitignore)
+      writeGeneratedDir(config)
       // Scan composables and write .d.ts + tsconfig paths on dev server start
       composableExports = await scanComposableExports(config.composablesDir)
       await writeAutoImportDts(config.root, config.composablesDir, composableExports)
       writeTsconfigPaths(config.root, config.srcDir)
+      // Serve a generated index.html for HTML requests when the consumer has
+      // not provided one. This runs BEFORE configureCerDevServer so that the
+      // Vite HTML pipeline (HMR injection, module preprocessing) is applied.
+      const userHtml = resolve(config.root, 'index.html')
+      if (!existsSync(userHtml)) {
+        const cerHtmlPath = join(getGeneratedDir(config.root), 'index.html')
+        server.middlewares.use(async (req, res, next) => {
+          const url = (req as { url?: string }).url ?? '/'
+          const isHtmlRequest =
+            url === '/' ||
+            url === '/index.html' ||
+            (!url.includes('.') && !url.startsWith('/api/'))
+          if (isHtmlRequest && existsSync(cerHtmlPath)) {
+            const rawHtml = readFileSync(cerHtmlPath, 'utf-8')
+            const transformed = await server.transformIndexHtml(url, rawHtml)
+            res.setHeader('Content-Type', 'text/html; charset=utf-8')
+            res.end(transformed)
+            return
+          }
+          next()
+        })
+      }
       // Watch app/ and server/ directories for file changes
       const watchDirs = [
         config.pagesDir,
@@ -302,6 +330,8 @@ export function cerApp(userConfig: CerAppConfig = {}): Plugin[] {
       if (!config) {
         config = resolveConfig(userConfig, process.cwd())
       }
+      // Write .cer/ generated files before the build begins
+      writeGeneratedDir(config)
       // Scan composables and generate type declarations + tsconfig paths
       composableExports = await scanComposableExports(config.composablesDir)
       await writeAutoImportDts(config.root, config.composablesDir, composableExports)

package/src/plugin/path-utils.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import { basename, dirname, join, relative } from 'pathe'
+import { basename, relative } from 'pathe'
 export interface RouteEntry {
   filePath: string

package/src/plugin/virtual/loading.ts CHANGED Viewed

@@ -1,6 +1,5 @@
 import { existsSync } from 'node:fs'
 import { join } from 'pathe'
-import { scanDirectory } from '../scanner.js'
 /**
  * Generates the virtual:cer-loading module code.

package/{e2e/kitchen-sink/app/app.ts → src/runtime/app-template.ts} RENAMED Viewed

@@ -1,3 +1,13 @@
+/**
+ * Template string for `.cer/app.ts` — the framework client entry point.
+ *
+ * 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 — do not edit.
+// Regenerated automatically on every dev server start and build.
 import '@jasonshimmy/custom-elements-runtime/css'
 import 'virtual:cer-jit-css'
 import 'virtual:cer-components'
@@ -27,10 +37,11 @@ const router = initRouter({ routes })
 const isNavigating = ref(false)
 const currentError = ref(null)
-;(globalThis as any).resetError = () => {
+const resetError = (): void => {
   currentError.value = null
-  router.replace(router.getCurrent().path)
+  void router.replace(router.getCurrent().path)
 }
+;(globalThis as Record<string, unknown>).resetError = resetError
 const _push = router.push.bind(router)
 const _replace = router.replace.bind(router)
@@ -68,8 +79,8 @@ router.replace = async (path) => {
 // synchronously, calling the render function immediately.
 const _pluginProvides = new Map<string, unknown>()
 // Expose plugin provides globally so page components can read them synchronously
-// regardless of render order (inject/provide has timing issues in SSG mode).
-;(globalThis as any).__cerPluginProvides = _pluginProvides
+// regardless of render order.
+;(globalThis as Record<string, unknown>).__cerPluginProvides = _pluginProvides
 // ─── <cer-layout-view> ───────────────────────────────────────────────────────
@@ -100,7 +111,8 @@ component('cer-layout-view', () => {
   }
   const matched = router.matchRoute(current.value.path)
-  const layoutName = (matched?.route as any)?.meta?.layout ?? 'default'
+  const routeMeta = matched?.route?.meta as { layout?: string } | undefined
+  const layoutName = routeMeta?.layout ?? 'default'
   const layoutTag = (layouts as Record<string, string>)[layoutName]
   const routerView = { tag: 'router-view', props: {}, children: [] }
@@ -110,7 +122,11 @@ component('cer-layout-view', () => {
 for (const plugin of plugins) {
   if (plugin && typeof plugin.setup === 'function') {
-    await plugin.setup({ router, provide: (key: string, value: unknown) => { _pluginProvides.set(key, value) }, config: {} })
+    await plugin.setup({
+      router,
+      provide: (key: string, value: unknown) => { _pluginProvides.set(key, value) },
+      config: {},
+    })
   }
 }
@@ -135,7 +151,8 @@ if (typeof window !== 'undefined') {
   await _replace(window.location.pathname + window.location.search + window.location.hash)
   // Clear SSR loader data after initial navigation so subsequent client-side
   // navigations don't accidentally reuse stale server data.
-  delete (globalThis as any).__CER_DATA__
+  delete (globalThis as Record<string, unknown>).__CER_DATA__
 }
 export { router }
+`

package/src/types/config.ts CHANGED Viewed

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

package/dist/cli/create/templates/spa/app/app.ts.tpl DELETED Viewed

@@ -1,93 +0,0 @@
-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 }
-}
-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: typeof current.value) => { 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
-})
-for (const plugin of plugins) {
-  if (plugin && typeof plugin.setup === 'function') {
-    await plugin.setup({ router, provide: (key: string, value: unknown) => { _pluginProvides.set(key, value) }, config: {} })
-  }
-}
-// Pre-load the current page's route chunk AFTER plugins run so that
-// cer-layout-view's first render (which calls provide()) completes before
-// page components are defined. This ensures inject() in child components
-// can find values stored by provide().
-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') {
-  // Use the original (unwrapped) replace so isNavigating stays false on first paint.
-  await _replace(window.location.pathname + window.location.search + window.location.hash)
-}
-export { router }

package/dist/cli/create/templates/ssg/app/app.ts.tpl DELETED Viewed

@@ -1,97 +0,0 @@
-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 }
-}
-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: typeof current.value) => { 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
-})
-for (const plugin of plugins) {
-  if (plugin && typeof plugin.setup === 'function') {
-    await plugin.setup({ router, provide: (key: string, value: unknown) => { _pluginProvides.set(key, value) }, config: {} })
-  }
-}
-// Pre-load the current page's route chunk AFTER plugins run so that
-// cer-layout-view's first render (which calls provide()) completes before
-// page components are defined. This ensures inject() in child components
-// can find values stored by provide().
-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') {
-  // Use the original (unwrapped) replace so isNavigating stays false on first
-  // paint — the loading component must not flash over pre-rendered SSG content.
-  await _replace(window.location.pathname + window.location.search + window.location.hash)
-  // Clear SSR hydration data after initial navigation so subsequent navigations
-  // don't accidentally reuse it.
-  delete (globalThis as any).__CER_DATA__
-}
-export { router }

package/dist/cli/create/templates/ssr/app/app.ts.tpl DELETED Viewed

@@ -1,97 +0,0 @@
-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 }
-}
-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: typeof current.value) => { 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
-})
-for (const plugin of plugins) {
-  if (plugin && typeof plugin.setup === 'function') {
-    await plugin.setup({ router, provide: (key: string, value: unknown) => { _pluginProvides.set(key, value) }, config: {} })
-  }
-}
-// Pre-load the current page's route chunk AFTER plugins run so that
-// cer-layout-view's first render (which calls provide()) completes before
-// page components are defined. This ensures inject() in child components
-// can find values stored by provide().
-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') {
-  // Use the original (unwrapped) replace so isNavigating stays false on first
-  // paint — the loading component must not flash over pre-rendered SSR content.
-  await _replace(window.location.pathname + window.location.search + window.location.hash)
-  // Clear SSR hydration data after initial navigation so subsequent navigations
-  // don't accidentally reuse it.
-  delete (globalThis as any).__CER_DATA__
-}
-export { router }

package/e2e/kitchen-sink/index.html DELETED Viewed

@@ -1,12 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Kitchen Sink</title>
-  </head>
-  <body>
-    <cer-layout-view></cer-layout-view>
-    <script type="module" src="/app/app.ts"></script>
-  </body>
-</html>

package/src/cli/create/templates/spa/app/app.ts.tpl DELETED Viewed

@@ -1,93 +0,0 @@
-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 }
-}
-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: typeof current.value) => { 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
-})
-for (const plugin of plugins) {
-  if (plugin && typeof plugin.setup === 'function') {
-    await plugin.setup({ router, provide: (key: string, value: unknown) => { _pluginProvides.set(key, value) }, config: {} })
-  }
-}
-// Pre-load the current page's route chunk AFTER plugins run so that
-// cer-layout-view's first render (which calls provide()) completes before
-// page components are defined. This ensures inject() in child components
-// can find values stored by provide().
-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') {
-  // Use the original (unwrapped) replace so isNavigating stays false on first paint.
-  await _replace(window.location.pathname + window.location.search + window.location.hash)
-}
-export { router }