@webjsdev/core 0.7.36 → 0.7.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webjsdev/core",
-  "version": "0.7.36",
+  "version": "0.7.37",
   "type": "module",
   "description": "webjs core runtime - html/css tags, WebComponent base, isomorphic renderers",
   "types": "./index.d.ts",

package/src/component.d.ts

@@ -79,6 +79,14 @@ abstract class WebComponentBase extends HTMLElement {
   static properties: Record<string, PropertyDeclaration>;
   static styles: CSSResult | CSSResult[] | null;
   static lazy?: boolean;
+  /**
+   * Force this component to ship (hydrate) even when the elision analyser would
+   * drop it as display-only. The escape hatch for interactivity the analyser
+   * cannot see statically: a dynamically-computed tag string, or a `:defined`
+   * rule in an external stylesheet outside the module graph. Leave unset for
+   * the automatic verdict.
+   */
+  static interactive?: boolean;
   /** Register this class as a custom element under `tag`. Tag must contain a hyphen. */
   static register(tag: string): void;
   static readonly observedAttributes: string[];

package/src/webjs-config.d.ts

@@ -81,7 +81,17 @@ export interface WebjsRedirectRule {
 /** The trailing-slash canonicalization policy in `webjs.trailingSlash`. */
 export type WebjsTrailingSlash = 'never' | 'always' | 'ignore';
 
-/** Dev task orchestration in `webjs.dev` (#550). Read by the CLI, not the server. */
+/** A single on-request regeneration rule in `webjs.dev.regenerate` (#967). */
+export interface WebjsRegenerateRule {
+  /** The appDir-relative served output this rule rebuilds (e.g. `"public/tailwind.css"`); a leading slash is stripped. */
+  output: string;
+  /** The shell command that rebuilds `output` (the same command prod uses in `start.before`, so dev and prod cannot diverge). */
+  command: string;
+  /** Source files/directories whose newest mtime is compared to `output`'s; a newer one (or a missing output) triggers the rebuild. */
+  inputs?: string[];
+}
+
+/** Dev task orchestration in `webjs.dev` (#550). `before`/`parallel` read by the CLI, `regenerate` by the server. */
 export interface WebjsDevTasks {
   /**
    * One-shot commands run sequentially to completion BEFORE the dev server
@@ -91,10 +101,18 @@ export interface WebjsDevTasks {
   before?: string[];
   /**
    * Long-lived commands run as child processes ALONGSIDE the dev server (the
-   * old `concurrently` watchers: the Tailwind CLI `--watch`). Spawned once in
-   * the parent and torn down on exit, so a watcher cannot leak past the server.
+   * old `concurrently` watchers). Spawned once in the parent and torn down on
+   * exit, so a watcher cannot leak past the server.
    */
   parallel?: string[];
+  /**
+   * On-request build-output regeneration (#967), DEV-ONLY. Each rule rebuilds a
+   * stale `output` before the dev server serves it, so a static build product
+   * (the scaffold's `public/tailwind.css`, #947) never goes stale without a
+   * live `--watch` process that can die mid-session. Prod builds the same output
+   * once via `start.before`. Read by the server (`readRegenerateRules`).
+   */
+  regenerate?: WebjsRegenerateRule[];
   /**
    * Extra directories the dev live-reload watcher follows IN ADDITION to the
    * appDir (#894). The dev server watches its appDir recursively, but an app