create-nuclo 0.1.1

package/templates/basic/node_modules/nuclo/dist/update/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/update/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,oBAA2B,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,uBAAuB;SAA4B,OAAO,CAAC,IAAI,CAAC;UAAQ,oBAAoB;EAAK,CAAC;AAE/G;;GAEG;AACH,eAAO,MAAM,gBAAgB,uBAA8B,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,sBAAsB;SAA+B,OAAO,CAAC,OAAO,CAAC;UAAQ,mBAAmB;EAAK,CAAC;AAUnH;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAYrF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAKzF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAEpE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAMxD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAM7D;AAOD,MAAM,WAAW,eAAe,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc;IAChF,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC;IAClB,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1D,KAAK,EAAE,OAAO,CAAC;CACf;AAyBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,SAAS,cAAc,EACnE,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,GAC7B,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAO1D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,EAAE,CAkBlD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,CAAC,cAAc,CAAC,GAAG,IAAI,CAErF"}

package/templates/basic/node_modules/nuclo/dist/update/scope.d.ts

@@ -0,0 +1,7 @@
+export interface UpdateScope {
+    roots: ReadonlyArray<Element>;
+    contains(node: Node): boolean;
+}
+export declare function getScopeRoots(ids: readonly string[]): Element[];
+export declare function scope<TTagName extends ElementTagName = ElementTagName>(...ids: string[]): NodeModFn<TTagName>;
+//# sourceMappingURL=scope.d.ts.map

package/templates/basic/node_modules/nuclo/dist/update/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/update/scope.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;CAC/B;AAoCD,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,EAAE,CAoC/D;AAED,wBAAgB,KAAK,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,EACpE,GAAG,GAAG,EAAE,MAAM,EAAE,GACf,SAAS,CAAC,QAAQ,CAAC,CAQrB"}

package/templates/basic/node_modules/nuclo/dist/update/update.d.ts

@@ -0,0 +1,4 @@
+import type { UpdateScope } from "./scope";
+export declare function update(...scopeIds: string[]): void;
+export declare function dispatchGlobalUpdateEvent(scope?: UpdateScope): void;
+//# sourceMappingURL=update.d.ts.map

package/templates/basic/node_modules/nuclo/dist/update/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/update/update.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAY3C,wBAAgB,MAAM,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CA0BlD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAqBnE"}

package/templates/basic/node_modules/nuclo/dist/when/builder.d.ts

@@ -0,0 +1,16 @@
+import type { WhenCondition, WhenContent, WhenGroup } from "./runtime";
+declare class WhenBuilderImpl<TTagName extends ElementTagName = ElementTagName> {
+    private groups;
+    private elseContent;
+    constructor(initialCondition: WhenCondition, ...content: WhenContent<TTagName>[]);
+    cloneWith(additionalGroup?: WhenGroup<TTagName>, newElseContent?: WhenContent<TTagName>[]): WhenBuilderImpl<TTagName>;
+    when(condition: WhenCondition, ...content: WhenContent<TTagName>[]): WhenBuilderImpl<TTagName>;
+    else(...content: WhenContent<TTagName>[]): WhenBuilderImpl<TTagName>;
+    render(host: ExpandedElement<TTagName>, index: number): Node | null;
+    private freshRender;
+    private hydrateRender;
+    private createRuntimeFromMarkers;
+}
+export declare function createWhenBuilderFunction<TTagName extends ElementTagName>(builder: WhenBuilderImpl<TTagName>): WhenBuilder<TTagName>;
+export { WhenBuilderImpl };
+//# sourceMappingURL=builder.d.ts.map

package/templates/basic/node_modules/nuclo/dist/when/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/when/builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAe,MAAM,WAAW,CAAC;AAyBpF,cAAM,eAAe,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc;IACpE,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,WAAW,CAA+B;gBAEtC,gBAAgB,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE;IAIhF,SAAS,CACP,eAAe,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,EACrC,cAAc,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,GACvC,eAAe,CAAC,QAAQ,CAAC;IAQ5B,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC;IAK9F,IAAI,CAAC,GAAG,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC;IAKpE,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAYnE,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,aAAa;IAgFrB,OAAO,CAAC,wBAAwB;CAwBjC;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,SAAS,cAAc,EACvE,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,GACjC,WAAW,CAAC,QAAQ,CAAC,CAavB;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/templates/basic/node_modules/nuclo/dist/when/index.d.ts

@@ -0,0 +1,44 @@
+import type { WhenCondition, WhenContent } from "./runtime";
+export { updateWhenRuntimes } from "./runtime";
+/**
+ * Creates a conditional rendering block (when/else logic).
+ *
+ * Renders different content based on boolean conditions, similar to if/else statements.
+ * Conditions can be static booleans or reactive functions that are re-evaluated on updates.
+ *
+ * @param condition - Boolean value or function returning a boolean
+ * @param content - Content to render when condition is true
+ * @returns A builder that allows chaining additional .when() or .else() branches
+ *
+ * @example
+ * ```ts
+ * const isLoggedIn = signal(false);
+ *
+ * div(
+ *   when(() => isLoggedIn.value,
+ *     span('Welcome back!')
+ *   )
+ *   .else(
+ *     button('Login', on('click', () => login()))
+ *   )
+ * )
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Multiple conditions
+ * div(
+ *   when(() => status.value === 'loading',
+ *     spinner()
+ *   )
+ *   .when(() => status.value === 'error',
+ *     errorMessage()
+ *   )
+ *   .else(
+ *     contentView()
+ *   )
+ * )
+ * ```
+ */
+export declare function when<TTagName extends ElementTagName = ElementTagName>(condition: WhenCondition, ...content: WhenContent<TTagName>[]): WhenBuilder<TTagName>;
+//# sourceMappingURL=index.d.ts.map

package/templates/basic/node_modules/nuclo/dist/when/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/when/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,IAAI,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,EACnE,SAAS,EAAE,aAAa,EACxB,GAAG,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,GAClC,WAAW,CAAC,QAAQ,CAAC,CAGvB"}

package/templates/basic/node_modules/nuclo/dist/when/runtime.d.ts

@@ -0,0 +1,59 @@
+import type { UpdateScope } from "../update/scope";
+export type WhenCondition = boolean | (() => boolean);
+export type WhenContent<TTagName extends ElementTagName = ElementTagName> = NodeMod<TTagName> | NodeModFn<TTagName>;
+export interface WhenGroup<TTagName extends ElementTagName = ElementTagName> {
+    condition: WhenCondition;
+    content: WhenContent<TTagName>[];
+}
+export interface WhenRuntime<TTagName extends ElementTagName = ElementTagName> {
+    startMarker: Comment;
+    endMarker: Comment;
+    host: ExpandedElement<TTagName>;
+    index: number;
+    groups: WhenGroup<TTagName>[];
+    elseContent: WhenContent<TTagName>[];
+    /**
+     * Tracks which branch is currently rendered:
+     *  - null:  nothing rendered yet (initial state)
+     *  - -1:    else branch is active
+     *  - >= 0:  groups[activeIndex] is active
+     */
+    activeIndex: number | null;
+    update(): void;
+}
+/**
+ * Evaluates which condition branch should be active.
+ * Returns the index of the first truthy condition, -1 for else branch, or null for no match.
+ */
+export declare function evaluateActiveCondition<TTagName extends ElementTagName>(groups: ReadonlyArray<WhenGroup<TTagName>>, elseContent: ReadonlyArray<WhenContent<TTagName>>): number | null;
+/**
+ * Main render function for when/else conditionals.
+ * Evaluates conditions, clears old content, and renders the active branch.
+ */
+export declare function renderWhenContent<TTagName extends ElementTagName>(runtime: WhenRuntime<TTagName>): void;
+/**
+ * Registers a when runtime for tracking and updates.
+ * Uses WeakRef to prevent memory leaks when elements are removed.
+ * The runtime object itself is mutable and will be updated in place.
+ */
+export declare function registerWhenRuntime<TTagName extends ElementTagName>(runtime: WhenRuntime<TTagName>): void;
+/**
+ * Updates all active when/else conditional runtimes.
+ *
+ * Re-evaluates all conditional branches and re-renders if the active branch has changed.
+ * Automatically cleans up runtimes that are garbage collected or disconnected from DOM.
+ *
+ * This function should be called after state changes that affect conditional expressions.
+ *
+ * @example
+ * ```ts
+ * isLoggedIn.value = true;
+ * updateWhenRuntimes(); // All when() conditionals re-evaluate
+ * ```
+ */
+export declare function updateWhenRuntimes(scope?: UpdateScope): void;
+/**
+ * Renders a list of content items and collects the resulting nodes.
+ */
+export declare function renderContentItems<TTagName extends ElementTagName>(items: ReadonlyArray<WhenContent<TTagName>>, host: ExpandedElement<TTagName>, index: number, endMarker: Comment): Node[];
+//# sourceMappingURL=runtime.d.ts.map

package/templates/basic/node_modules/nuclo/dist/when/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/when/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,IACtE,OAAO,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,WAAW,SAAS,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc;IACzE,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc;IAC3E,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;IACrC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,IAAI,IAAI,CAAC;CAChB;AAmBD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,SAAS,cAAc,EACrE,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAC1C,WAAW,EAAE,aAAa,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,GAChD,MAAM,GAAG,IAAI,CAOf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS,cAAc,EAC/D,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,GAC7B,IAAI,CAoBN;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,cAAc,EACjE,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,GAC7B,IAAI,CAKN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CA0C5D;AA8BD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,SAAS,cAAc,EAChE,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,EAC3C,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,GACjB,IAAI,EAAE,CASR"}

package/templates/basic/node_modules/nuclo/package.json

@@ -0,0 +1,88 @@
+{
+	"name": "nuclo",
+	"private": false,
+	"version": "0.2.13",
+	"description": "Lightweight reactive DOM library with global tag builders, SSR, hydration, and atomic CSS — no virtual DOM, no compiler.",
+	"license": "MIT",
+	"author": "Danilo Celestino de Castro (https://github.com/dan2dev)",
+	"keywords": [
+		"dom",
+		"reactive",
+		"ui",
+		"ssr",
+		"hydration",
+		"atomic-css",
+		"no-vdom",
+		"typescript"
+	],
+	"type": "module",
+	"main": "./dist/nuclo.cjs",
+	"module": "./dist/nuclo.mjs",
+	"browser": "./dist/nuclo.umd.js",
+	"unpkg": "./dist/nuclo.umd.js",
+	"jsdelivr": "./dist/nuclo.umd.js",
+	"types": "./types/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./types/index.d.ts",
+			"import": "./dist/nuclo.mjs",
+			"require": "./dist/nuclo.cjs"
+		},
+		"./ssr": {
+			"types": "./types/ssr.d.ts",
+			"import": "./dist/ssr/nuclo.ssr.mjs",
+			"require": "./dist/ssr/nuclo.ssr.cjs"
+		},
+		"./polyfill": {
+			"types": "./types/polyfill.d.ts",
+			"import": "./dist/polyfill/nuclo.polyfill.mjs",
+			"require": "./dist/polyfill/nuclo.polyfill.cjs"
+		},
+		"./types": {
+			"types": "./types/index.d.ts"
+		}
+	},
+	"files": [
+		"dist",
+		"types"
+	],
+	"scripts": {
+		"build": "tsdown && tsc --emitDeclarationOnly",
+		"dev": "tsdown --watch",
+		"dev:all": "bun dev & cd examples/basic && bun run dev",
+		"build:watch": "tsdown --watch",
+		"build:types": "tsc --emitDeclarationOnly",
+		"clean": "rm -rf dist *.tsbuildinfo",
+		"typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
+		"test": "npm run typecheck && vitest run --coverage",
+		"test:watch": "vitest --watch --coverage",
+		"bench": "bun bench/ssr.bench.ts && bun bench/hydrate.bench.ts",
+		"bench:jfb": "bun bench/js-framework.bench.ts",
+		"lint": "eslint . --ext .ts,.js,.json,.jsonc,.json5,.md,.css",
+		"lint:fix": "eslint . --ext .ts,.js,.json,.jsonc,.json5,.md,.css --fix"
+	},
+	"devDependencies": {
+		"@eslint/css": "^1.4.0",
+		"@eslint/js": "^10.0.1",
+		"@eslint/json": "^2.0.1",
+		"@eslint/markdown": "^8.0.3",
+		"@types/node": "^25.9.4",
+		"@vitest/coverage-v8": "4.1.7",
+		"eslint": "^10.6.0",
+		"globals": "^17.7.0",
+		"jiti": "^2.7.0",
+		"jsdom": "^29.1.1",
+		"tsdown": "^0.22.3",
+		"typescript": "^6.0.3",
+		"typescript-eslint": "^8.63.0",
+		"vitest": "^4.1.10"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/dan2dev/nuclo.git"
+	},
+	"bugs": {
+		"url": "https://github.com/dan2dev/nuclo/issues"
+	},
+	"homepage": "https://nuclo.dev/"
+}

package/templates/basic/node_modules/nuclo/types/core/base.d.ts

@@ -0,0 +1,113 @@
+
+
+declare global {
+  export type Primitive = string | number | bigint | boolean | symbol | null | undefined;
+  export type ElementTagName = keyof HTMLElementTagNameMap;
+  export type SVGTagName = keyof SVGElementTagNameMap;
+  export type ValueFactory<TValue> = () => TValue;
+  export type ValueOrFactory<TValue> = TValue | ValueFactory<TValue>;
+  // `never[]` (not `unknown[]`) so factories with typed parameters still match:
+  // `(...args: unknown[])` rejects e.g. `(x: number) => string` under strict
+  // contravariance and would resolve to never.
+  export type InferFactoryResult<TFactory> = TFactory extends (...args: never[]) => infer TResult
+    ? TResult
+    : never;
+
+  // CSS style object: only the string-valued (settable) CSSStyleDeclaration
+  // properties, as string | number. Filters out methods (setProperty, item…),
+  // readonly non-string members (length, parentRule) and the numeric index.
+  export type CSSStyleObject = {
+    [K in keyof CSSStyleDeclaration as K extends string
+      ? CSSStyleDeclaration[K] extends string
+        ? K
+        : never
+      : never]?: string | number;
+  };
+
+  // Core element attribute types
+  export type ExpandedElementAttributes<
+    TTagName extends ElementTagName = ElementTagName,
+  > = {
+    [K in keyof HTMLElementTagNameMap[TTagName]]?:
+      K extends "style"
+        ? ValueOrFactory<CSSStyleObject>
+        : ValueOrFactory<HTMLElementTagNameMap[TTagName][K]>;
+  } & {
+    // Allow custom attributes (data-*, aria-*, etc.)
+    [key: string]: ValueOrFactory<unknown>;
+  };
+
+  export type DetachedExpandedElementFactory<
+    TTagName extends ElementTagName = ElementTagName,
+  > = NodeModFn<TTagName> & ((
+    parent?: ExpandedElement<TTagName>,
+    index?: number,
+  ) => ExpandedElement<TTagName>);
+
+  // Core element type
+  export type ExpandedElement<
+    TTagName extends ElementTagName = ElementTagName,
+  > = Partial<Omit<HTMLElementTagNameMap[TTagName], "tagName">> &
+    Pick<HTMLElementTagNameMap[TTagName], "tagName"> & {
+      rawMods?: ReadonlyArray<NodeModLike<ElementTagName>>;
+      mods?: ReadonlyArray<NodeMod<ElementTagName>>;
+    };
+
+  // Core modifier types
+  export type NodeRenderable<TTagName extends ElementTagName = ElementTagName> =
+    | Primitive
+    | ExpandedElementAttributes<TTagName>
+    | ExpandedElement<TTagName>
+    | Node;
+
+  export type NodeMod<TTagName extends ElementTagName = ElementTagName> =
+    | NodeRenderable<TTagName>
+    | ValueFactory<Primitive>
+    | ((parent: ExpandedElement<TTagName>, index: number) => Node);  // Allow Node builders
+
+  export type NodeModFn<TTagName extends ElementTagName = ElementTagName> = (
+    parent: ExpandedElement<TTagName>,
+    index: number,
+  ) => NodeMod<TTagName> | void;
+
+  export type NodeModLike<TTagName extends ElementTagName = ElementTagName> =
+    | NodeMod<TTagName>
+    | NodeModFn<TTagName>;
+
+  export type InferExpandedElement<TValue> =
+    TValue extends ExpandedElement<infer TTagName>
+      ? ExpandedElement<TTagName>
+      : TValue extends DetachedExpandedElementFactory<infer TTagName>
+        ? ExpandedElement<TTagName>
+        : TValue extends ExpandedElementBuilder<infer TTagName>
+          ? ExpandedElement<TTagName>
+          : TValue extends NodeModFn<infer TTagName>
+            ? ExpandedElement<TTagName>
+            : Extract<TValue, Element>;
+
+  // Core modifier types (selfClosing)
+  // export type NodeSelfClosingMod<
+  //   TTagName extends ElementTagName = ElementTagName,
+  // > = ExpandedElementAttributes<TTagName>    | Primitive
+  // | (() => Primitive);
+
+
+
+  // Core builder types
+  export type ExpandedElementBuilder<
+    TTagName extends ElementTagName = ElementTagName,
+  > = (
+    ...rawMods: readonly NodeModLike<TTagName>[]
+  ) => DetachedExpandedElementFactory<TTagName>;
+
+  // export type SelfClosingElementBuilder<
+  //   TTagName extends ElementTagName = ElementTagName,
+  // > = (
+  //   ...rawMods: NodeSelfClosingMod<TTagName>[]
+  // ) => (
+  //   parent?: ExpandedElement<TTagName>,
+  //   index?: number,
+  // ) => ExpandedElement<TTagName>;
+}
+
+export { };

package/templates/basic/node_modules/nuclo/types/features/list.d.ts

@@ -0,0 +1,38 @@
+declare global {
+  export type ListItemsInput<T> = readonly T[] | Iterable<T>;
+
+  // Dynamic list function types - supports both HTML and SVG builders/elements
+  export type ListRenderResult<TTagName extends ElementTagName = ElementTagName> =
+    | ExpandedElement<TTagName>
+    | DetachedExpandedElementFactory<TTagName>
+    | NodeModFn<TTagName>
+    | DetachedSVGElementFactory
+    | SVGElementModifierFn
+    | Node
+    | null
+    | undefined;
+
+  export type ListRenderFunction<T, TTagName extends ElementTagName = ElementTagName> = (
+    item: T,
+    index: number
+  ) => ListRenderResult<TTagName>;
+
+  export type ListItemsProvider<T> = () => ListItemsInput<T>;
+
+  /**
+   * A list modifier uses a generic call signature so it can be attached to any
+   * parent element, regardless of the tag of the items it renders.
+   * (TTagName represents the child element tag, not the parent.)
+   */
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  export type ListModifier<TTagName extends ElementTagName = ElementTagName> =
+    (<TParent extends ElementTagName>(parent: ExpandedElement<TParent>, index: number) => Comment) &
+    ((parent: Node & ParentNode, index: number) => Comment);
+
+  export function list<T, TTagName extends ElementTagName = ElementTagName>(
+    itemsProvider: ListItemsProvider<T>,
+    render: ListRenderFunction<T, TTagName>
+  ): ListModifier<TTagName>;
+}
+
+export {};

package/templates/basic/node_modules/nuclo/types/features/on.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Typed event listener helper types for the `on()` modifier function.
+ *
+ * Usage example:
+ *   button(
+ *     "Click me",
+ *     on("click", (e) => {
+ *       // e is a MouseEvent (e.g., e.clientX is available)
+ *       // example: console.log(e.clientX);
+ *     })
+ *   );
+ *
+ * Overloads:
+ * 1. DOM standard events (strongly typed via HTMLElementEventMap)
+ * 2. Custom / arbitrary event names with user-specified event type
+ */
+
+declare global {
+  export type TypedEventListener<
+    TElement extends EventTarget,
+    TEvent extends Event = Event,
+  > = (this: TElement, ev: TEvent & { currentTarget: TElement }) => unknown;
+
+  /**
+   * Add a strongly typed DOM event listener as a View Craft modifier.
+   *
+   * The returned modifier attaches the listener when the element is created.
+   *
+   * @param type Standard DOM event name (e.g. "click", "input", "change").
+   * @param listener Event listener with fully typed event object.
+   * @param options Native addEventListener options.
+   */
+  function on<
+    K extends keyof HTMLElementEventMap,
+    TTagName extends ElementTagName = ElementTagName,
+  >(
+    type: K,
+    listener: TypedEventListener<HTMLElementTagNameMap[TTagName], HTMLElementEventMap[K]>,
+    options?: boolean | AddEventListenerOptions
+  ): NodeModFn<TTagName>;
+
+  /**
+   * Add a custom / arbitrary event listener (e.g. "my-event").
+   *
+   * Provide a custom Event subtype via the generic parameter E when needed:
+   *   on<"my-event", CustomEvent<MyDetail>>("my-event", (e) => { ... })
+   */
+  function on<
+    K extends string,
+    E extends Event = Event,
+    TTagName extends ElementTagName = ElementTagName
+  >(
+    type: K,
+    listener: TypedEventListener<HTMLElementTagNameMap[TTagName], E>,
+    options?: boolean | AddEventListenerOptions
+  ): NodeModFn<TTagName>;
+}
+
+export {};

package/templates/basic/node_modules/nuclo/types/features/render.d.ts

@@ -0,0 +1,49 @@
+declare global {
+  /**
+   * Renders a NodeModFn to a parent element by calling it and appending the result.
+   *
+   * @param nodeModFn The NodeModFn to render (created by tag builders like div(), h1(), etc.)
+   * @param parent The parent element to render into (defaults to document.body)
+   * @param index The index to pass to the NodeModFn (defaults to 0)
+   * @returns The rendered element
+   *
+   * @example
+   * ```ts
+   * const app = div(
+   *   h1('Hello World'),
+   *   button('Click me')
+   * );
+   *
+   * render(app); // Renders to document.body
+   * render(app, container); // Renders to specific container
+   * ```
+   */
+  function render<TTagName extends ElementTagName = ElementTagName>(
+    nodeModFn: NodeModFn<TTagName>,
+    parent?: Element,
+    index?: number
+  ): ExpandedElement<TTagName>;
+
+  /**
+   * Hydrates an existing server-rendered DOM tree by walking it in parallel with
+   * the component tree, reusing existing nodes and re-attaching reactivity.
+   *
+   * @param nodeModFn The NodeModFn to hydrate (same component used for SSR)
+   * @param parent The parent element containing the SSR HTML (defaults to document.body)
+   * @returns The hydrated root element
+   *
+   * @example
+   * ```ts
+   * // Server: const html = renderToString(div(h1("Hello")));
+   * // Client:
+   * const app = document.getElementById("app")!;
+   * hydrate(div(h1("Hello")), app);
+   * ```
+   */
+  function hydrate<TTagName extends ElementTagName = ElementTagName>(
+    nodeModFn: NodeModFn<TTagName>,
+    parent?: Element,
+  ): ExpandedElement<TTagName>;
+}
+
+export {};

package/templates/basic/node_modules/nuclo/types/features/scope.d.ts

@@ -0,0 +1,6 @@
+declare global {
+  // Scope modifier for scoped updates
+  export function scope<TTagName extends ElementTagName = ElementTagName>(...ids: string[]): NodeModFn<TTagName>;
+}
+
+export {};

package/templates/basic/node_modules/nuclo/types/features/style.d.ts

@@ -0,0 +1,77 @@
+// Styling global type definitions.
+//
+// nuclo styling is atomic, theme-aware, typed CSS-in-TS:
+//
+//   const { css, cx } = createCss({
+//     colors: { primary: "#6366f1" },
+//     screens: { md: "(min-width: 768px)" },
+//   });
+//   const button = css({ px: 24, bg: "primary", hover: { bg: "#4f46e5" }, md: { px: 32 } });
+//   div(button, "Save");
+//
+// The themeless defaults (css, cx, keyframes, globalStyle) are registered as
+// globals by the runtime bootstrap; themed instances come from createCss().
+//
+// The type definitions live in types/style.d.ts (NOT src/) so they resolve in
+// the published package, which ships only dist/ and types/.
+
+import type {
+	ClassInput as NucloClassInput,
+	CssInstance as NucloCssInstance,
+	CSSProperties as NucloCSSProperties,
+	FlatStyle as NucloFlatStyle,
+	KeyframeFrames as NucloKeyframeFrames,
+	KeyframeStop as NucloKeyframeStop,
+	Size as NucloSize,
+	Style as NucloStyle,
+	StyleResult as NucloStyleResult,
+	ThemeConfig as NucloThemeConfig,
+	VariantDefinitions as NucloVariantDefinitions,
+	VariantProps as NucloVariantProps,
+	VariantsConfig as NucloVariantsConfig,
+	VariantsFn as NucloVariantsFn,
+} from "../style";
+
+declare global {
+	export type Size = NucloSize;
+	export type CSSProperties = NucloCSSProperties;
+	export type ThemeConfig = NucloThemeConfig;
+	export type FlatStyle<T extends ThemeConfig = ThemeConfig> = NucloFlatStyle<T>;
+	export type Style<T extends ThemeConfig = ThemeConfig> = NucloStyle<T>;
+	export type StyleResult = NucloStyleResult;
+	export type ClassInput = NucloClassInput;
+	export type KeyframeStop = NucloKeyframeStop;
+	export type KeyframeFrames<T extends ThemeConfig = ThemeConfig> = NucloKeyframeFrames<T>;
+	export type VariantDefinitions<T extends ThemeConfig = ThemeConfig> = NucloVariantDefinitions<T>;
+	export type VariantProps<V extends VariantDefinitions> = NucloVariantProps<V>;
+	export type VariantsConfig<T extends ThemeConfig, V extends VariantDefinitions<T>> = NucloVariantsConfig<T, V>;
+	export type VariantsFn<V extends VariantDefinitions> = NucloVariantsFn<V>;
+
+	/**
+	 * A themed styling instance: css/cx/variants/keyframes/globalStyle bound to
+	 * a theme. Returned by createCss().
+	 */
+	export type CssInstance<T extends ThemeConfig = ThemeConfig> = NucloCssInstance<T>;
+
+	/**
+	 * Create a themed styling instance. Theme tokens (colors, fonts, shadows,
+	 * radii) become autocompleted values; `screens` become responsive variant
+	 * keys usable inside style objects.
+	 */
+	function createCss<const T extends ThemeConfig>(theme?: T): CssInstance<T>;
+
+	/** Themeless css() — full property/variant typing, no tokens or screens. */
+	function css(style: Style<object>): StyleResult;
+	/** Compose class lists with last-wins conflict resolution. */
+	function cx(...inputs: ClassInput[]): StyleResult;
+	/** Themeless variants() recipe helper. */
+	function variants<const V extends VariantDefinitions<object>>(
+		config: VariantsConfig<object, V>,
+	): VariantsFn<V>;
+	/** Themeless keyframes() helper. */
+	function keyframes(frames: KeyframeFrames<object>): string;
+	/** Themeless globalStyle() helper. */
+	function globalStyle(selector: string, style: FlatStyle<object>): void;
+}
+
+export {};

package/templates/basic/node_modules/nuclo/types/features/update.d.ts

@@ -0,0 +1,6 @@
+declare global {
+  // Update controller function
+  export function update(...scopeIds: string[]): void;
+}
+
+export {};

package/templates/basic/node_modules/nuclo/types/features/when.d.ts

@@ -0,0 +1,18 @@
+declare global {
+  // When/conditional rendering types
+  export type WhenCondition = boolean | (() => boolean);
+  export type WhenContent<TTagName extends ElementTagName = ElementTagName> = 
+    NodeMod<TTagName> | NodeModFn<TTagName>;
+  
+  export interface WhenBuilder<TTagName extends ElementTagName = ElementTagName> extends NodeModFn<TTagName> {
+    when(condition: WhenCondition, ...content: WhenContent<TTagName>[]): WhenBuilder<TTagName>;
+    else(...content: WhenContent<TTagName>[]): WhenBuilder<TTagName>;
+  }
+  
+  export function when<TTagName extends ElementTagName = ElementTagName>(
+    condition: WhenCondition, 
+    ...content: WhenContent<TTagName>[]
+  ): WhenBuilder<TTagName>;
+}
+
+export {};