@jasonshimmy/vite-plugin-cer-app 0.23.1 → 0.24.0

package/dist/types/config.d.ts

@@ -1,5 +1,16 @@
 import type { RouterConfig } from '@jasonshimmy/custom-elements-runtime/router';
 import type { IncomingMessage } from 'node:http';
+/** A package-provided bundle of component resolution, global imports, and Vite plugins. */
+export interface CerAppIntegration {
+    /** Stable name used in diagnostics. */
+    name: string;
+    /** Resolve a rendered custom-element tag to its side-effect registration module. */
+    componentResolver?: (tag: string) => string | undefined;
+    /** Imports that must run once in the generated client entry (for example global CSS). */
+    globalImports?: readonly string[];
+    /** Build plugins required by the integration. */
+    plugins?: import('vite').Plugin[];
+}
 /**
  * Context passed to the `onError` hook.
  * `type` indicates which layer the error originated from so reporters can
@@ -120,17 +131,31 @@ export interface SsgConfig {
      * - `string[]` — explicit list of paths (e.g. `['/about', '/contact']`).
      */
     routes?: 'auto' | string[];
-    /** Maximum number of pages rendered in parallel. Defaults to `1`. Increase for faster SSG builds at the cost of higher memory usage. */
+    /** Maximum number of pages rendered in parallel. Defaults to `4`. Increase for faster SSG builds at the cost of higher memory usage. */
     concurrency?: number;
     /** When `true`, unenumerated routes fall back to SSR at runtime instead of returning 404. */
     fallback?: boolean;
+    /** Fail the build when any route cannot be rendered. Defaults to `true`; set to `false` only for intentionally partial output. */
+    failOnError?: boolean;
+    /**
+     * Inline root-relative CSS assets into each generated HTML document.
+     *
+     * - `false` (default) keeps stylesheet links unchanged.
+     * - `true` inlines every root-relative stylesheet.
+     * - A positive number inlines only stylesheets at or below that UTF-8 byte size.
+     *
+     * This removes a render-blocking request for small critical stylesheets at the
+     * cost of repeating their bytes in each page. Inline styles also require an
+     * appropriate Content Security Policy (`style-src`) when CSP is enabled.
+     */
+    inlineStylesheets?: boolean | number;
 }
 /** JIT (Just-In-Time) CSS configuration for shadow-DOM style injection. */
 export interface JitCssConfig {
     /** Additional glob patterns for content files scanned by the JIT CSS engine. */
     content?: string[];
-    /** Enable the extended color palette. Defaults to `false`. */
-    extendedColors?: boolean;
+    /** Enable every extended color family or list only the families to retain. Defaults to `false`. */
+    extendedColors?: boolean | string[];
     /**
      * Project-specific color families registered in the JIT CSS engine at both
      * build time and runtime. Each key is a color family name (e.g. `brand`);
@@ -223,6 +248,14 @@ export interface RuntimeConfig {
 export interface CerAppConfig {
     mode?: 'spa' | 'ssr' | 'ssg';
     srcDir?: string;
+    /**
+     * The canonical origin of the site (e.g. `'https://example.com'`).
+     * No trailing slash. When set, the SSG build automatically:
+     * - Injects `<link rel="canonical" href="${siteUrl}${path}">` into every page.
+     * - Writes a `robots.txt` to `dist/` (skipped when a `public/robots.txt` already exists).
+     * Also available at runtime via `useRuntimeConfig().public.siteUrl`.
+     */
+    siteUrl?: string;
     /** File-based content layer configuration. Reads from `content/` at the project root by default. */
     content?: import('./content.js').CerContentConfig;
     /**
@@ -243,6 +276,8 @@ export interface CerAppConfig {
     router?: Pick<RouterConfig, 'base' | 'scrollToFragment'>;
     jitCss?: JitCssConfig;
     autoImports?: AutoImportsConfig;
+    /** UI/framework integrations composed into generated entries and component code splitting. */
+    integrations?: CerAppIntegration[];
     port?: number;
     /**
      * Runtime configuration accessible via `useRuntimeConfig()`.
@@ -270,8 +305,22 @@ export interface CerAppConfig {
      * ```
      *
      * You can also run the built-in adapters independently with `cer-app adapt --platform <name>`.
-     */
+    */
     adapter?: 'vercel' | 'netlify' | 'cloudflare' | ((root: string) => Promise<void>);
+    /**
+     * Additional standalone Vite plugins to include alongside the built-in cerApp plugins.
+     * UI libraries that also resolve components or add global entry imports should
+     * use `integrations` instead.
+     *
+     * @example
+     * ```ts
+     * import inspect from 'vite-plugin-inspect'
+     * export default defineConfig({
+     *   plugins: [inspect()],
+     * })
+     * ```
+     */
+    plugins?: import('vite').Plugin[];
     /**
      * Authentication configuration.
      * Enables OAuth login flows via `useAuth()` and auto-generates

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}

package/dist/types/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AA6VA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AA+YA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/types/middleware.d.ts

@@ -6,7 +6,7 @@ import type { IncomingMessage, ServerResponse } from 'node:http';
  * - `false`  — block navigation
  * - `string` — redirect to that path
  */
-export type GuardResult = boolean | string | Promise<boolean | string>;
+export type GuardResult = boolean | string | void | Promise<boolean | string | void>;
 /**
  * Route middleware function.
  *
@@ -32,7 +32,7 @@ export type GuardResult = boolean | string | Promise<boolean | string>;
  * })
  * ```
  */
-export type MiddlewareFn = (to: RouteState, from: RouteState | null, next: () => Promise<void>) => GuardResult | void;
+export type MiddlewareFn = (to: RouteState, from: RouteState | null, next: () => Promise<void>) => GuardResult;
 /**
  * Server middleware function. Receives the raw Node.js `req`/`res` pair and a `next`
  * callback. Call `next()` to pass control to the next middleware in the chain,

package/dist/types/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/types/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAA;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAAA;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,UAAU,GAAG,IAAI,EACvB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,WAAW,GAAG,IAAI,CAAA;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,KAC1B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/types/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAA;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,UAAU,GAAG,IAAI,EACvB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,WAAW,CAAA;AAEhB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,KAC1B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jasonshimmy/vite-plugin-cer-app",
-  "version": "0.23.1",
+  "version": "0.24.0",
   "description": "Nuxt-style meta-framework for @jasonshimmy/custom-elements-runtime",
   "type": "module",
   "keywords": [
@@ -19,28 +19,30 @@
     "url": "git+https://github.com/jshimkoski/vite-plugin-cer-app.git"
   },
   "homepage": "https://github.com/jshimkoski/vite-plugin-cer-app#readme",
+  "files": [
+    "dist"
+  ],
   "sideEffects": [
-    "**/*.css",
-    "e2e/cypress/support/*.ts"
+    "**/*.css"
   ],
-  "main": "dist/index.cjs",
+  "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     },
     "./composables": {
+      "types": "./dist/runtime/composables/index.d.ts",
       "import": "./dist/runtime/composables/index.js",
-      "require": "./dist/runtime/composables/index.cjs",
-      "types": "./dist/runtime/composables/index.d.ts"
+      "default": "./dist/runtime/composables/index.js"
     },
     "./types": {
+      "types": "./dist/types/index.d.ts",
       "import": "./dist/types/index.js",
-      "require": "./dist/types/index.cjs",
-      "types": "./dist/types/index.d.ts"
+      "default": "./dist/types/index.js"
     },
     "./isr": {
       "import": "./dist/runtime/isr-handler.js",
@@ -57,7 +59,8 @@
   },
   "scripts": {
     "validate": "npm run lint && npm test && npm run build && npm run e2e",
-    "build": "tsc -p tsconfig.build.json && cp -r src/cli/create/templates dist/cli/create/templates",
+    "prebuild": "node scripts/clean-dist.mjs",
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-templates.mjs",
     "dev": "tsc -p tsconfig.build.json --watch",
     "lint": "eslint",
     "test": "vitest run",
@@ -73,10 +76,10 @@
     "e2e:serve:ssr": "node dist/cli/index.js preview --root e2e/kitchen-sink --port 4175 --ssr",
     "e2e:serve:ssg": "node dist/cli/index.js preview --root e2e/kitchen-sink --port 4176",
     "e2e:serve:dev": "node dist/cli/index.js dev --root e2e/kitchen-sink --port 4177 --mode ssr",
-    "e2e:run:spa": "cypress run --config baseUrl=http://localhost:4174 --env mode=spa",
-    "e2e:run:ssr": "cypress run --config baseUrl=http://localhost:4175 --env mode=ssr",
-    "e2e:run:ssg": "cypress run --config baseUrl=http://localhost:4176 --env mode=ssg",
-    "e2e:run:dev": "cypress run --config baseUrl=http://localhost:4177 --env mode=dev",
+    "e2e:run:spa": "cypress run --config baseUrl=http://localhost:4174 --expose mode=spa",
+    "e2e:run:ssr": "cypress run --config baseUrl=http://localhost:4175 --expose mode=ssr",
+    "e2e:run:ssg": "cypress run --config baseUrl=http://localhost:4176 --expose mode=ssg",
+    "e2e:run:dev": "cypress run --config baseUrl=http://localhost:4177 --expose mode=dev",
     "e2e:spa": "npm run e2e:build:spa && start-server-and-test e2e:serve:spa http://localhost:4174 e2e:run:spa",
     "e2e:ssr": "npm run e2e:build:ssr && start-server-and-test e2e:serve:ssr http://localhost:4175 e2e:run:ssr",
     "e2e:ssg": "npm run e2e:build:ssg && start-server-and-test e2e:serve:ssg http://localhost:4176 e2e:run:ssg",
@@ -85,20 +88,20 @@
     "cypress:open": "cypress open"
   },
   "peerDependencies": {
-    "@jasonshimmy/custom-elements-runtime": ">=3.4.0",
+    "@jasonshimmy/custom-elements-runtime": ">=3.9.0",
     "vite": ">=5.0.0"
   },
   "dependencies": {
     "commander": "^14.0.3",
     "fast-glob": "^3.3.3",
-    "gray-matter": "^4.0.3",
     "magic-string": "^0.30.21",
     "marked": "^18.0.0",
     "minisearch": "^7.2.0",
-    "pathe": "^2.0.3"
+    "pathe": "^2.0.3",
+    "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "@jasonshimmy/custom-elements-runtime": "^3.7.5",
+    "@jasonshimmy/custom-elements-runtime": "^3.9.0",
     "@types/node": "^25.6.0",
     "@vitest/coverage-v8": "^4.1.2",
     "cypress": "^15.13.1",

package/.github/copilot-instructions.md

@@ -1,169 +0,0 @@
----
-applyTo: '**'
----
-
-You are an expert in TypeScript, JavaScript, HTML, CSS. Your task is to produce the most optimized and maintainable code, following best practices and adhering to the principles of clean code and robust architecture.
-
-## Objective
-
-- Create a Web Component Runtime solution that is not only functional but also adheres to the best practices in performance, security, and maintainability.
-- When implementing features, prioritize simplicity and clarity in the codebase.
-- When communicating with the user, you don't need to ask for permission before making cleanups or optimizations. Instead, focus on delivering a solution that is efficient and easy to understand.
-
-## Commands to Know
-
-- `npm run build`: Builds the project for production.
-- `npm run dev`: Starts the development server with hot-reloading.
-- `npm test`: Runs the test suite using Vitest.
-- `npm test:watch`: Runs the test suite using Vitest in development watch mode.
-- `npm run test:coverage`: Generates a code coverage report.
-
-## Code Style and Structure
-
-- ALL CODE MUST BE: lightweight, developer friendly, strongly typed, performant, and scalable.
-- Write concise, technical TypeScript code with accurate examples.
-- Use functional and declarative programming patterns; avoid classes.
-- Prefer iteration and modularization over code duplication.
-- Use descriptive variable names with auxiliary verbs (e.g., isLoading, hasError).
-- Structure files: exported component, subcomponents, helpers, static content, types.
-- Use lowercase with dashes for directory names (e.g., `components/auth-wizard`).
-- Use kebab-case for file names (e.g., `auth-wizard.ts`).
-- Avoid using "this" keyword in functional components.
-- Prefer pure functions and avoid side effects.
-- Use immutable data structures where possible.
-- Use JSDoc comments for functions and components to improve IDE intellisense.
-
-## Markdown Documentation
-
-All documentation written in the docs directory should be:
-
-- In Markdown format
-- Structured with clear headings and subheadings
-- Include code examples where applicable
-- Use consistent terminology and phrasing
-- Be 100% accurate with the actual code implementation
-- Be easy to read and understand
-- Be concise and to the point
-- Use emojis for titles
-
-## Naming Conventions
-
-- Use lowercase with dashes for directories (e.g., components/auth-wizard).
-- Favor named exports for components.
-
-## TypeScript Usage
-
-- Use strict TypeScript for all code; prefer interfaces over types.
-- Avoid enums; use maps instead.
-- Use functional components with TypeScript interfaces.
-- Never use "any" type; always prefer strongly typed definitions.
-
-## Syntax and Formatting
-
-- Use the "function" keyword for pure functions.
-- Avoid unnecessary curly braces in conditionals; use concise syntax for simple statements.
-
-## UI and Styling
-
-- Generate Custom Elements using our lib/index.ts for components and styling.
-- Implement responsive design; use a mobile-first approach.
-
-## Performance Optimization
-
-- Use TypeScript and JavaScript best practices to ensure high performance.
-- Always favor tree-shaking and code splitting.
-- Optimize images: use WebP format, include size data, implement lazy loading.
-
-## Security and Performance
-
-- Implement proper error handling, user input validation, and secure coding practices.
-- Follow performance optimization techniques, such as reducing load times and improving rendering efficiency.
-
-## Testing and Documentation
-
-- Write unit tests for components using Vitest.
-- Provide clear and concise comments for complex logic.
-- Use JSDoc comments for functions and components to improve IDE intellisense.
-
-## Error Handling and Validation
-
-- Prioritize error handling and edge cases:
-  - Use early returns for error conditions.
-  - Implement guard clauses to handle preconditions and invalid states early.
-  - Use custom error types for consistent error handling.
-
-## Key Conventions - NON-NEGOTIABLE
-
-- NEVER GUESS OR ASSUME! Always make informed decisions based on available data in a project.
-- Always use strongly typed TypeScript.
-- Keep code lightweight and modular.
-- Do not use external dependencies.
-- Keep code performant.
-- Keep code secure.
-- Keep code developer friendly and easy to use.
-- Keep code easy to read and understand.
-- Keep code maintainable and scalable.
-- Always write tests for your code.
-- Always follow best practices in coding, security, and performance.
-- Always validate assumptions with actual data.
-- ALWAYS add new unit and e2e/integration tests for any new functionality.
-- ALWAYS document new functionality in the project's documentation files.
-- ALWAYS have the user validate all changes with `npm run validate` and report results back to you.
-- NEVER run Cypress tests yourself. ONLY the user runs Cypress. Always ask the user to run Cypress and report the results.
-- A change can only be considered complete when it meets all the above criteria and has been thoroughly tested and reviewed. THIS IS NON-NEGOTIABLE.
-
-## Feature completion checklist (apply to every new feature or fix)
-
-Before declaring any change complete, ALL of the following must be satisfied:
-
-### Documentation
-- [ ] All new features are documented in the relevant `docs/*.md` file with options, API reference, and examples.
-- [ ] If a composable was added, it has a full entry in `docs/composables.md`.
-- [ ] If the feature affects auto-imports, `docs/configuration.md` is updated.
-- [ ] If the feature affects routing, `docs/routing.md` is updated.
-- [ ] If the feature affects middleware, `docs/middleware.md` is updated.
-- [ ] Documentation is 100% accurate with the actual implementation.
-
-### Unit tests
-- [ ] Vitest unit tests in `src/__tests__/` cover typical usage, edge cases, and error paths.
-- [ ] Existing test coverage has not been reduced.
-
-### E2e tests
-- [ ] Cypress specs in `e2e/cypress/e2e/` cover the feature across all applicable build modes (SPA, SSR, SSG, dev).
-- [ ] Required kitchen-sink fixtures are added to `e2e/kitchen-sink/`.
-- [ ] Cypress is NOT run by the AI — the user runs `npm run e2e` and reports results.
-
-### Auto-imports
-- [ ] New framework composables are added to `FRAMEWORK_IMPORTS` and `FRAMEWORK_IDENTIFIERS` in `src/plugin/transforms/auto-import.ts`.
-- [ ] Auto-import behavior is tested in `src/__tests__/plugin/transforms/auto-import.test.ts`.
-
-### TypeScript
-- [ ] All new code uses strict TypeScript — no `any`, no implicit `any`.
-- [ ] New public types are exported from `src/types/`.
-- [ ] `npm run build` completes without TypeScript errors.
-
-### Validation
-- [ ] `npm run lint && npm test && npm run build` passes clean before asking the user to run Cypress.
-- [ ] User runs `npm run validate` to confirm the full pipeline passes.
-
-## Methodology
-
-1. **System 2 Thinking**: Approach the problem with analytical rigor. Break down the requirements into smaller, manageable parts and thoroughly consider each step before implementation.
-2. **Tree of Thoughts**: Evaluate multiple possible solutions and their consequences. Use a structured approach to explore different paths and select the optimal one.
-3. **Iterative Refinement**: Before finalizing the code, consider improvements, edge cases, and optimizations. Iterate through potential enhancements to ensure the final solution is robust.
-
-## Process:
-
-1. **Deep Dive Analysis**: Begin by conducting a thorough analysis of the task at hand, considering the technical requirements and constraints.
-2. **Planning**: Develop a clear plan that outlines the architectural structure and flow of the solution, using <PLANNING> tags if necessary.
-3. **Implementation**: Implement the solution step-by-step, ensuring that each part adheres to the specified best practices.
-4. **Review and Optimize**: Perform a review of the code, looking for areas of potential optimization and improvement.
-5. **Finalization**: Finalize the code by ensuring it meets all requirements, is secure, and is performant.
-
-### Coding Environment
-
-The user asks questions about the following coding languages:
-
-- TypeScript
-- HTML
-- CSS