coralite 0.40.2 → 0.41.0

package/dist/lib/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../lib/renderer.js"],"names":[],"mappings":"AA0CA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AACH,+IAVG;IAAuC,GAAG,EAAlC,gBAAgB;IACY,aAAa,EAAzC,aAAa;IACQ,MAAM;IACJ,QAAQ;IACD,WAAW,EAAzC,eAAe;IACM,KAAK;IACR,OAAO,EAAzB,GAAG;IACoB,oBAAoB;CACnD,OAyjDF;sCA7kDS,mBAAmB;mCAKK,qBAAqB;qCAL7C,mBAAmB"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../lib/renderer.js"],"names":[],"mappings":"AA0CA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AACH,+IAVG;IAAuC,GAAG,EAAlC,gBAAgB;IACY,aAAa,EAAzC,aAAa;IACQ,MAAM;IACJ,QAAQ;IACD,WAAW,EAAzC,eAAe;IACM,KAAK;IACR,OAAO,EAAzB,GAAG;IACoB,oBAAoB;CACnD,OAmkDF;sCAvlDS,mBAAmB;mCAKK,qBAAqB;qCAL7C,mBAAmB"}

package/dist/lib/utils/client/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../lib/utils/client/runtime.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;GAUG;AACH,gHAPG;IAAwB,IAAI,EAApB,MAAM;IACU,eAAe,EAA/B,MAAM;IACU,aAAa;IACV,eAAe,GAAlC,MAAM,EAAE;IACS,aAAa,GAA9B,MAAM;CACd,GAAU,MAAM,CAoHlB"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../lib/utils/client/runtime.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;GAUG;AACH,gHAPG;IAAwB,IAAI,EAApB,MAAM;IACU,eAAe,EAA/B,MAAM;IACU,aAAa;IACV,eAAe,GAAlC,MAAM,EAAE;IACS,aAAa,GAA9B,MAAM;CACd,GAAU,MAAM,CA4IlB"}

package/dist/lib/utils/server/render.d.ts

@@ -52,8 +52,9 @@ export function injectStyles(root: any, head: any, styles: any): void;
  * @param {CoraliteComponentRoot} root - The root of the AST.
  * @param {CoraliteElement | null} head - The head element.
  * @param {boolean} hasScripts - Whether the page has scripts to wait for.
+ * @param {'production' | 'development' | 'testing'} [mode] - Current build mode.
  */
-export function injectReadinessScript(root: CoraliteComponentRoot, head: CoraliteElement | null, hasScripts: boolean): void;
+export function injectReadinessScript(root: CoraliteComponentRoot, head: CoraliteElement | null, hasScripts: boolean, mode?: "production" | "development" | "testing"): void;
 /**
  * Injects an import map into the document head (or root if head is missing).
  *

package/dist/lib/utils/server/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../lib/utils/server/render.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH;;GAEG;AAEH;;;;;GAKG;AACH,sCAHW,qBAAqB,GACnB;IAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,eAAe,GAAG,qBAAqB,CAAA;CAAE,CA6B3F;AAED;;;;;;GAMG;AACH,2CAJW,qBAAqB,QACrB,eAAe,GAAG,IAAI,UACtB,MAAM,EAAE,QAwClB;AAED;;;;;;GAMG;AACH;;;;;;;GAOG;AACH,+CALW,qBAAqB,QACrB,eAAe,GAAG,IAAI,cACtB,MAAM,EAAE,QACR,MAAM,QAyChB;AAED;;GAEG;AACH,sEA6BC;AAED;;;;;;GAMG;AACH,4CAJW,qBAAqB,QACrB,eAAe,GAAG,IAAI,cACtB,OAAO,QA4BjB;AAED;;;;;;GAMG;AACH,sCAJW,qBAAqB,QACrB,eAAe,GAAG,IAAI,wBA6BhC;AAED;;;;;GAKG;AACH,yCAHW,eAAe,EAAE,kBACjB,OAAO,QA6BjB;AAED;;;;;;GAMG;AACH,kDAJW,kBAAkB,SAClB,MAAM,GAAG,MAAM,EAAE,GACf,sBAAsB,EAAE,CA+BpC;2CAhUS,yBAAyB;qCAAzB,yBAAyB;oCAIA,qBAAqB;4CAJ9C,yBAAyB"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../lib/utils/server/render.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH;;GAEG;AAEH;;;;;GAKG;AACH,sCAHW,qBAAqB,GACnB;IAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,eAAe,GAAG,qBAAqB,CAAA;CAAE,CA6B3F;AAED;;;;;;GAMG;AACH,2CAJW,qBAAqB,QACrB,eAAe,GAAG,IAAI,UACtB,MAAM,EAAE,QAwClB;AAED;;;;;;GAMG;AACH;;;;;;;GAOG;AACH,+CALW,qBAAqB,QACrB,eAAe,GAAG,IAAI,cACtB,MAAM,EAAE,QACR,MAAM,QAyChB;AAED;;GAEG;AACH,sEA6BC;AAED;;;;;;;GAOG;AACH,4CALW,qBAAqB,QACrB,eAAe,GAAG,IAAI,cACtB,OAAO,SACP,YAAY,GAAG,aAAa,GAAG,SAAS,QAgClD;AAED;;;;;;GAMG;AACH,sCAJW,qBAAqB,QACrB,eAAe,GAAG,IAAI,wBA6BhC;AAED;;;;;GAKG;AACH,yCAHW,eAAe,EAAE,kBACjB,OAAO,QA6BjB;AAED;;;;;;GAMG;AACH,kDAJW,kBAAkB,SAClB,MAAM,GAAG,MAAM,EAAE,GACf,sBAAsB,EAAE,CA+BpC;2CArUS,yBAAyB;qCAAzB,yBAAyB;oCAIA,qBAAqB;4CAJ9C,yBAAyB"}

package/dist/plugins/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../plugins/testing.js"],"names":[],"mappings":"AA4BA,wEA8CE"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../plugins/testing.js"],"names":[],"mappings":"AAwEA,wEA8DE"}

package/dist/types/core.d.ts

@@ -176,9 +176,13 @@ export type CoraliteConfig = {
      */
     externalStyles?: string[];
     /**
-     * - Build mode: "development" or "production"
+     * - Build mode: "production", "development", or "testing"
      */
-    mode?: string;
+    mode?: "production" | "development" | "testing";
+    /**
+     * - Configuration for testing mode.
+     */
+    testing?: CoraliteTestingConfig;
     /**
      * - The root directory of the project.
      */
@@ -331,7 +335,21 @@ export type CoraliteSession = {
     /**
      * - Current build mode.
      */
-    mode?: "production" | "development";
+    mode?: "production" | "development" | "testing";
+};
+export type CoraliteTestingConfig = {
+    /**
+     * - Mock definitions for components.
+     */
+    mocks?: {
+        [x: string]: CoraliteTestingMock;
+    };
+};
+export type CoraliteTestingMock = {
+    /**
+     * - Mock implementation of the component's server() block.
+     */
+    server?: Function;
 };
 /**
  * Configuration options for creating a component element.

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

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

package/dist/types/plugin.d.ts

@@ -122,6 +122,10 @@ export type CoralitePluginBeforeComponentRenderContext = {
      * - The current page context
      */
     page: CoralitePage;
+    /**
+     * - The component template AST
+     */
+    template?: CoraliteAnyNode;
     /**
      * - The parent AST tag itself
      */
@@ -591,9 +595,9 @@ import type { CoraliteRef } from './component.js';
 import type { CoraliteTextNodeToken } from './component.js';
 import type { CoraliteAttributeToken } from './component.js';
 import type { CoralitePage } from './core.js';
+import type { CoraliteAnyNode } from './dom.js';
 import type { CoraliteSession } from './core.js';
 import type { CoraliteInstance } from './core.js';
-import type { CoraliteAnyNode } from './dom.js';
 import type { CoraliteModuleDefinitions } from './module.js';
 import type { CoraliteModule } from './module.js';
 import type { CoraliteComponentRoot } from './dom.js';

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

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

package/llms.txt

@@ -80,9 +80,67 @@ A component definition consists of four primary blocks:
 
 #### 1. `attributes` (Sync)
 
-* **Purpose**: Coerces HTML attributes into JavaScript primitives.
-* **Rule**: Strictly limited to primitives (`String`, `Number`, `Boolean`). `Object` and `Array` types are strictly blocked to avoid JSON-in-HTML parsing errors.
-* **Reactivity**: Changes to HTML attributes (via `setAttribute`) automatically trigger updates to the unified `state`.
+* **Purpose**: Declares and coerces HTML attributes into typed JavaScript primitives on the component's reactive `state`.
+* **Rules & Constraints**:
+  - **Allowed Types**: Strictly limited to `String`, `Number`, and `Boolean`.
+  - **Blocked Types**: `Object` and `Array` constructors are strictly blocked. Attempting to use them throws a `CoraliteError` to prevent unsafe or complex JSON-in-HTML parsing. Use `server()` or global contexts for complex data.
+  - **Declaration Syntax**:
+    - *Shorthand*: `attributeName: TypeConstructor` (e.g., `isChecked: Boolean`).
+    - *Verbose (with default)*: `attributeName: { type: TypeConstructor, default: DefaultValue }`.
+  - **Attribute Naming**: Attributes are declared in camelCase (e.g., `isChecked`). The framework automatically maps them to/from their kebab-case HTML equivalents (e.g., `is-checked`).
+
+* **Attribute Coercion Engine**:
+  Below are the exact coercion logic patterns utilized at compile-time (server-side) and run-time (client-side) to normalize raw HTML string attributes into JS values:
+
+  - **`Boolean` Coercion Pattern**:
+    - **How it Works**:
+      - **Client-Side Coercion**:
+        ```javascript
+        if (value === '') return true;
+        return value !== 'false' && value !== null;
+        ```
+      - **Server-Side Coercion**:
+        ```javascript
+        state[key] = value !== 'false' && value !== null && value !== '';
+        ```
+    - **Limitations & Hydration Mismatch Warning**:
+      - *The Empty Attribute SSR Mismatch*: An empty HTML attribute (e.g. `<my-component is-checked></my-component>` or just `<my-component is-checked>`) is parsed as `""` (empty string) in HTML. On the client, this empty string evaluates to `true` (standard browser behavior for attributes like `disabled` or `checked`). However, on the server, it evaluates to `false` (due to the `value !== ''` check).
+      - *Solution*: To ensure consistent behavior between Server-Side Rendering (SSR) and Client-Side Hydration, developers should explicitly pass the string value `"true"` (e.g., `<my-component is-checked="true">`) instead of using shorthand empty attributes, or rely on a declared `default` value in the attribute schema.
+  
+  - **`Number` Coercion Pattern**:
+    - **Logic**: Evaluates `Number(value)`.
+    - **Result**: Valid numeric strings become numbers. Non-numeric strings resolve to `NaN`.
+  
+  - **`String` Coercion Pattern**:
+    - **Logic**: Evaluates `String(value)`.
+    - **Result**: Converts any non-null input value to a string.
+
+  - **Coercion Matrix for LLMs**:
+    Refer to this matrix to determine the final coerced type and value:
+    | Input HTML Attribute Value | Declared `Boolean` | Declared `Number` | Declared `String` |
+    | :--- | :--- | :--- | :--- |
+    | **`"true"`** | `true` | `NaN` | `"true"` |
+    | **`"false"`** | `false` | `NaN` | `"false"` |
+    | **`"42"`** | `true` | `42` | `"42"` |
+    | **`"0"`** | `true` | `0` | `"0"` |
+    | **`""` (empty attribute)** | `true` (client) / `false` (server) | `0` | `""` |
+    | **`null` / Absent** | `false` (or `default` value) | `null` (or `default` value) | `null` (or `default` value) |
+    | **`"hello"`** | `true` | `NaN` | `"hello"` |
+
+* **Reactivity & Synchronization**:
+  - Changing an attribute in the DOM (e.g., `element.setAttribute('is-checked', 'true')`) automatically triggers the `attributeChangedCallback`, recoerces the value, and updates the unified `state.isChecked`.
+  - Mutating the property directly in `state` (inside the `client` block) updates the internal reactivity tree, but does *not* automatically reflect back to the physical DOM attribute unless manually synchronized (avoiding costly DOM reflection loops).
+
+* **Native HTML Boolean Attributes Toggling (`BOOLEAN_ATTRIBUTES`)**:
+  - **Overview**: When reactive tokens are bound to attributes inside component templates (e.g., `<button disabled="{{ isDisabled }}">`), Coralite applies specialized toggling logic if the target attribute name is in the reserved native HTML boolean attributes list.
+  - **The Reserved List**: Includes standard HTML boolean attributes: `allowfullscreen`, `async`, `autofocus`, `autoplay`, `checked`, `controls`, `default`, `defer`, `disabled`, `formnovalidate`, `hidden`, `inert`, `ismap`, `itemscope`, `loop`, `multiple`, `muted`, `nomodule`, `novalidate`, `open`, `playsinline`, `readonly`, `required`, `reversed`, `selected`, and `truespeed`.
+  - **How it Works**:
+    - If the bound value resolves to any falsy value (specifically `""`, `"false"`, `"null"`, `"0"`, or `"undefined"`), the attribute is **completely removed** from the target element (via `element.removeAttribute(name)`). This matches native HTML behavior, where the mere presence of a boolean attribute (even if written as `disabled="false"`) evaluates to true in the browser.
+    - If the bound value is truthy, the attribute is set as an empty string presence attribute (via `element.setAttribute(name, '')`).
+  - **Limitations**:
+    - This automatic add/remove toggling logic *only* applies to attributes on the reserved native HTML list.
+    - Custom boolean attributes (e.g., `<div is-active="{{ isActive }}">`) or other attributes not on the reserved list are not removed; instead, their values are written directly as string attributes (e.g., `is-active="false"`).
+
 
 #### 2. `server({ state, page, root, module, id, session, app, noHydration, ...plugins })` (Async/Server)
 
@@ -279,7 +337,8 @@ These strings must be non-empty.
 *   `baseURL` (string): Base URL for asset paths (defaults to `/`).
 *   `assets` (array): Static assets to copy during the build.
 *   `externalStyles` (array of strings): Global stylesheets to inject into every page.
-*   `mode` (string): Build mode, either `'production'` or `'development'`.
+*   `mode` (string): Build mode: `'production'`, `'development'`, or `'testing'`.
+*   `testing` (object): Optional configuration for `'testing'` mode (e.g., `{ mocks: { 'comp-id': { server: ... } } }`).
 *   `projectRoot` (string): The root directory of the project.
 *   `ignoreByAttribute` (array): Attributes to ignore during parse.
 *   `skipRenderByAttribute` (array): Attributes to skip rendering.
@@ -332,12 +391,22 @@ export default defineConfig({
 
 * **Metadata Plugin**: Extracts SEO data during the build phase.
 * **Static Asset Plugin**: Copies static assets to the build output folder.
-* **Testing Plugin**: Automates E2E testing preparation by duplicating all `ref` attributes to `data-testid` deterministically on both server and client.
+* **Testing Plugin**: Automatically activated in `testing` mode. It provides deterministic `data-testid` injection, disables animations, and enables deep framework telemetry.
 
 ## 10. E2E Testing
 
-* **Readiness**: Await `window.__coralite__.lifecycle.hydrated` after navigation. Use `window.__coralite__.lifecycle.rendered` for visual-only readiness, or `window.__coralite__.lifecycle.waitFor(el)` for dynamic elements.
-* **Selectors**: Rely on `data-testid` generated by the **Testing Plugin** (e.g., `[data-testid="my-component-0__submit-btn"]`) for robust selectors.
+For a robust E2E environment, users are encouraged to use `mode: 'testing'` exclusively.
+
+* **Static Build Target**: `testing` mode acts as a static build target, identical to `production` mode. It compiles optimized static assets and strips development-only metadata, but leaves test-related tooling intact.
+* **Incremental Build Cache Invalidation**: The build compiler computes a hash of the `testing.mocks` configuration. If your mock definitions change, it invalidates the incremental build cache (ISR) and triggers a rebuild for all affected pages.
+* **Targeting Selectors**: Target elements using the auto-injected `data-testid` attributes. To target specific components or elements without hardcoding the dynamic instance index, use CSS suffix selectors (e.g. `[data-testid$="__btn"]`).
+* **Readiness**: Await `window.__coralite__.lifecycle.hydrated` after navigation.
+* **Deterministic Selectors**: In `testing` mode, Coralite automatically injects `data-testid` onto all interactive elements (`button`, `a`, `input`, etc.) and custom elements using the pattern `[instanceId]__[tagName]-[index]`. Template `ref` attributes are also mapped to `data-testid`.
+* **Velocity Engine**: Animations, transitions, and smooth scrolling are globally disabled in `testing` mode to eliminate race conditions and speed up tests.
+* **Glass Box Assertions**: The reactive state of every hydrated component is exposed via `window.__coralite__.components['instance-id'].state`.
+* **Event Telemetry**: All `CustomEvent` dispatches are logged to `window.__coralite__.events`.
+* **Fail-Fast Hydration**: Any hydration mismatch or client-side error immediately triggers a fatal red overlay, failing the test instantly.
+* **Server Mocking**: Override component `server()` blocks via the `testing.mocks` configuration in `coralite.config.js`.
 
 ## 11. Form Integration and Interaction Patterns
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coralite",
-  "version": "0.40.2",
+  "version": "0.41.0",
   "description": "HTML modules static site generator",
   "type": "module",
   "keywords": [
@@ -95,18 +95,20 @@
     "test:unit": "node --experimental-vm-modules --experimental-import-meta-resolve --test \"./tests/unit/**/*.spec.js\"",
     "test:unit:watch": "node --experimental-vm-modules --experimental-import-meta-resolve --test --watch \"./tests/unit/**/*.spec.js\"",
     "test:unit:coverage": "node --experimental-vm-modules --experimental-import-meta-resolve --experimental-test-coverage --test \"./tests/unit/**/*.spec.js\"",
-    "test:e2e": "pnpm build && pnpm clean:e2e && pnpm build:html:dev && pnpm build:html:prod && playwright test",
+    "test:e2e": "pnpm build && pnpm clean:e2e && pnpm build:html:dev && pnpm build:html:prod && pnpm build:html:testing && playwright test",
     "test:e2e:report": "playwright show-report",
     "test:e2e:ui": "playwright test --ui",
-    "clean:e2e": "premove .coralite-dev && premove .coralite-prod",
+    "clean:e2e": "premove .coralite-dev && premove .coralite-prod && premove .coralite-testing",
     "server": "pnpm run server:dev",
     "server:dev": "node ./tests/scripts/serve.js --dir .coralite-dev --port 3000",
     "server:prod": "node ./tests/scripts/serve.js --dir .coralite-prod --port 3001",
+    "server:testing": "node ./tests/scripts/serve.js --dir .coralite-testing --port 3002",
     "build": "premove dist && pnpm build:lib && pnpm build:types",
     "build:lib": "esbuild ./lib/index.js ./lib/coralite-element.js ./lib/plugin.js ./lib/utils/core.js ./lib/utils/index.js ./lib/utils/client/inject.js --bundle --target=esnext --format=esm --outdir=dist/lib --platform=node --sourcemap --packages=external --alias:#lib=./lib/index.js --alias:#plugins=./plugins/index.js --outbase=./lib",
     "build:types": "tsc",
     "build:html:dev": "node --experimental-vm-modules ./tests/scripts/build-html.js --mode development --outDir .coralite-dev",
     "build:html:prod": "node --experimental-vm-modules ./tests/scripts/build-html.js --mode production --outDir .coralite-prod",
+    "build:html:testing": "node --experimental-vm-modules ./tests/scripts/build-testing.js",
     "bench": "node --experimental-vm-modules ./tests/scripts/run-benchmarks.js"
   }
 }