nuclo 0.1.23

package/dist/when/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/when/index.ts"],"names":[],"mappings":"AAOA,KAAK,aAAa,GAAG,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;AAC/C,KAAK,WAAW,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,IAC/D,OAAO,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAkK1C,wBAAgB,kBAAkB,IAAI,IAAI,CAQzC;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,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/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "nuclo",
+  "private": false,
+  "version": "0.1.23",
+  "type": "module",
+  "main": "./dist/nuclo.cjs",
+  "module": "./dist/nuclo.js",
+  "browser": "./dist/nuclo.umd.js",
+  "types": "./types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/nuclo.js",
+      "require": "./dist/nuclo.cjs"
+    },
+    "./types": {
+      "types": "./types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "types"
+  ],
+  "devDependencies": {
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@types/node": "^24.7.0",
+    "@vitest/coverage-v8": "3.2.4",
+    "jsdom": "^27.0.0",
+    "rollup": "^4.52.4",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dan2dev/nuclo.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dan2dev/nuclo/issues"
+  },
+  "homepage": "https://dan2dev.github.io/nuclo/",
+  "scripts": {
+    "build": "rm -rf dist && rollup -c && tsc --emitDeclarationOnly",
+    "dev": "rm -rf dist && rollup -c -w & tsc --emitDeclarationOnly --watch",
+    "dev:all": "pnpm dev & cd examples/basic && npm run dev",
+    "build:watch": "rm -rf dist && rollup -c -w & tsc --emitDeclarationOnly --watch",
+    "build:rollup": "rollup -c",
+    "build:types": "tsc --emitDeclarationOnly",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest --watch"
+  }
+}

package/types/core/base.d.ts

@@ -0,0 +1,70 @@
+
+
+declare global {
+  export type Primitive = string | number | bigint | boolean | symbol | null | undefined;
+  export type ElementTagName = keyof HTMLElementTagNameMap;
+
+  // Core element attribute types
+  export type ExpandedElementAttributes<
+    TTagName extends ElementTagName = ElementTagName,
+  > = Omit<
+    {
+      [K in keyof HTMLElementTagNameMap[TTagName]]?:
+      | HTMLElementTagNameMap[TTagName][K]
+      | (() => HTMLElementTagNameMap[TTagName][K]);
+    },
+    "style"
+  > & {
+    style?: Partial<CSSStyleDeclaration> | (() => Partial<CSSStyleDeclaration>);
+  };
+
+  // Core element type
+  export type ExpandedElement<
+    TTagName extends ElementTagName = ElementTagName,
+  > = Partial<Omit<HTMLElementTagNameMap[TTagName], "tagName">> &
+    Pick<HTMLElementTagNameMap[TTagName], "tagName"> & {
+      rawMods?: NodeMod<TTagName> | NodeModFn<TTagName>[];
+      mods?: NodeMod<TTagName>[];
+    };
+
+  // Core modifier types
+  export type NodeMod<TTagName extends ElementTagName = ElementTagName> =
+    | Primitive
+    | (() => Primitive)
+    | ExpandedElementAttributes<TTagName>
+    | ExpandedElement<TTagName>;
+
+  export type NodeModFn<TTagName extends ElementTagName = ElementTagName> = (
+    parent: ExpandedElement<TTagName>,
+    index: number,
+  ) => NodeMod<TTagName> | void;
+
+  // 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: (NodeMod<TTagName> | NodeModFn<TTagName>)[]
+  ) => (
+    parent?: ExpandedElement<TTagName>,
+    index?: number,
+  ) => ExpandedElement<TTagName>;
+
+  // export type SelfClosingElementBuilder<
+  //   TTagName extends ElementTagName = ElementTagName,
+  // > = (
+  //   ...rawMods: NodeSelfClosingMod<TTagName>[]
+  // ) => (
+  //   parent?: ExpandedElement<TTagName>,
+  //   index?: number,
+  // ) => ExpandedElement<TTagName>;
+}
+
+export { };

package/types/features/list.d.ts

@@ -0,0 +1,8 @@
+declare global {
+  // Dynamic list function types
+  export type ListRenderFunction<T> = (item: T, index: number) => ExpandedElement<any> | NodeModFn<any>;
+  export type ListItemsProvider<T> = () => T[];
+  export function list<T>(itemsProvider: ListItemsProvider<T>, render: ListRenderFunction<T>): NodeModFn<any>;
+}
+
+export {};

package/types/features/on.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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 {
+  /**
+   * 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<
+    TTagName extends ElementTagName = ElementTagName,
+    K extends keyof HTMLElementEventMap = keyof HTMLElementEventMap,
+  >(
+    type: K,
+    listener: (this: HTMLElementTagNameMap[TTagName], ev: HTMLElementEventMap[K] & { currentTarget: HTMLElementTagNameMap[TTagName] }) => any,
+    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: (this: HTMLElementTagNameMap[TTagName], ev: E & { currentTarget: HTMLElementTagNameMap[TTagName] }) => any,
+    options?: boolean | AddEventListenerOptions
+  ): NodeModFn<TTagName>;
+}
+
+export {};

package/types/features/render.d.ts

@@ -0,0 +1,28 @@
+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>;
+}
+
+export {};

package/types/features/update.d.ts

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

package/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 {};

package/types/html/tags.d.ts

@@ -0,0 +1,119 @@
+declare global {
+  // HTML tags
+  export const a: ExpandedElementBuilder<"a">;
+  export const abbr: ExpandedElementBuilder<"abbr">;
+  export const address: ExpandedElementBuilder<"address">;
+  export const article: ExpandedElementBuilder<"article">;
+  export const aside: ExpandedElementBuilder<"aside">;
+  export const audio: ExpandedElementBuilder<"audio">;
+  export const b: ExpandedElementBuilder<"b">;
+  export const bdi: ExpandedElementBuilder<"bdi">;
+  export const bdo: ExpandedElementBuilder<"bdo">;
+  export const blockquote: ExpandedElementBuilder<"blockquote">;
+  export const body: ExpandedElementBuilder<"body">;
+  export const button: ExpandedElementBuilder<"button">;
+  export const canvas: ExpandedElementBuilder<"canvas">;
+  export const caption: ExpandedElementBuilder<"caption">;
+  export const cite: ExpandedElementBuilder<"cite">;
+  export const code: ExpandedElementBuilder<"code">;
+  export const colgroup: ExpandedElementBuilder<"colgroup">;
+  export const data: ExpandedElementBuilder<"data">;
+  export const datalist: ExpandedElementBuilder<"datalist">;
+  export const dd: ExpandedElementBuilder<"dd">;
+  export const del: ExpandedElementBuilder<"del">;
+  export const details: ExpandedElementBuilder<"details">;
+  export const dfn: ExpandedElementBuilder<"dfn">;
+  export const dialog: ExpandedElementBuilder<"dialog">;
+  export const div: ExpandedElementBuilder<"div">;
+  export const dl: ExpandedElementBuilder<"dl">;
+  export const dt: ExpandedElementBuilder<"dt">;
+  export const em: ExpandedElementBuilder<"em">;
+  export const fieldset: ExpandedElementBuilder<"fieldset">;
+  export const figcaption: ExpandedElementBuilder<"figcaption">;
+  export const figure: ExpandedElementBuilder<"figure">;
+  export const footer: ExpandedElementBuilder<"footer">;
+  export const form: ExpandedElementBuilder<"form">;
+  export const h1: ExpandedElementBuilder<"h1">;
+  export const h2: ExpandedElementBuilder<"h2">;
+  export const h3: ExpandedElementBuilder<"h3">;
+  export const h4: ExpandedElementBuilder<"h4">;
+  export const h5: ExpandedElementBuilder<"h5">;
+  export const h6: ExpandedElementBuilder<"h6">;
+  export const head: ExpandedElementBuilder<"head">;
+  export const header: ExpandedElementBuilder<"header">;
+  export const hgroup: ExpandedElementBuilder<"hgroup">;
+  export const html: ExpandedElementBuilder<"html">;
+  export const i: ExpandedElementBuilder<"i">;
+  export const iframe: ExpandedElementBuilder<"iframe">;
+  export const ins: ExpandedElementBuilder<"ins">;
+  export const kbd: ExpandedElementBuilder<"kbd">;
+  export const label: ExpandedElementBuilder<"label">;
+  export const legend: ExpandedElementBuilder<"legend">;
+  export const li: ExpandedElementBuilder<"li">;
+  export const main: ExpandedElementBuilder<"main">;
+  export const map: ExpandedElementBuilder<"map">;
+  export const mark: ExpandedElementBuilder<"mark">;
+  export const menu: ExpandedElementBuilder<"menu">;
+  export const meter: ExpandedElementBuilder<"meter">;
+  export const nav: ExpandedElementBuilder<"nav">;
+  export const noscript: ExpandedElementBuilder<"noscript">;
+  export const object: ExpandedElementBuilder<"object">;
+  export const ol: ExpandedElementBuilder<"ol">;
+  export const optgroup: ExpandedElementBuilder<"optgroup">;
+  export const option: ExpandedElementBuilder<"option">;
+  export const output: ExpandedElementBuilder<"output">;
+  export const p: ExpandedElementBuilder<"p">;
+  export const picture: ExpandedElementBuilder<"picture">;
+  export const pre: ExpandedElementBuilder<"pre">;
+  export const progress: ExpandedElementBuilder<"progress">;
+  export const q: ExpandedElementBuilder<"q">;
+  export const rp: ExpandedElementBuilder<"rp">;
+  export const rt: ExpandedElementBuilder<"rt">;
+  export const ruby: ExpandedElementBuilder<"ruby">;
+  export const s: ExpandedElementBuilder<"s">;
+  export const samp: ExpandedElementBuilder<"samp">;
+  export const script: ExpandedElementBuilder<"script">;
+  export const search: ExpandedElementBuilder<"search">;
+  export const section: ExpandedElementBuilder<"section">;
+  export const select: ExpandedElementBuilder<"select">;
+  export const slot: ExpandedElementBuilder<"slot">;
+  export const small: ExpandedElementBuilder<"small">;
+  export const span: ExpandedElementBuilder<"span">;
+  export const strong: ExpandedElementBuilder<"strong">;
+  export const style: ExpandedElementBuilder<"style">;
+  export const sub: ExpandedElementBuilder<"sub">;
+  export const summary: ExpandedElementBuilder<"summary">;
+  export const sup: ExpandedElementBuilder<"sup">;
+  export const table: ExpandedElementBuilder<"table">;
+  export const tbody: ExpandedElementBuilder<"tbody">;
+  export const td: ExpandedElementBuilder<"td">;
+  export const template: ExpandedElementBuilder<"template">;
+  export const textarea: ExpandedElementBuilder<"textarea">;
+  export const tfoot: ExpandedElementBuilder<"tfoot">;
+  export const th: ExpandedElementBuilder<"th">;
+  export const thead: ExpandedElementBuilder<"thead">;
+  export const time: ExpandedElementBuilder<"time">;
+  export const title: ExpandedElementBuilder<"title">;
+  export const tr: ExpandedElementBuilder<"tr">;
+  export const u: ExpandedElementBuilder<"u">;
+  export const ul: ExpandedElementBuilder<"ul">;
+  export const var_: ExpandedElementBuilder<"var">;
+  export const video: ExpandedElementBuilder<"video">;
+
+  // Self-closing HTML tags (cannot have children)
+  export const area: ExpandedElementBuilder<"area">;
+  export const base: ExpandedElementBuilder<"base">;
+  export const br: ExpandedElementBuilder<"br">;
+  export const col: ExpandedElementBuilder<"col">;
+  export const embed: ExpandedElementBuilder<"embed">;
+  export const hr: ExpandedElementBuilder<"hr">;
+  export const img: ExpandedElementBuilder<"img">;
+  export const input: ExpandedElementBuilder<"input">;
+  export const link: ExpandedElementBuilder<"link">;
+  export const meta: ExpandedElementBuilder<"meta">;
+  export const source: ExpandedElementBuilder<"source">;
+  export const track: ExpandedElementBuilder<"track">;
+  export const wbr: ExpandedElementBuilder<"wbr">;
+}
+
+export {};

package/types/index.d.ts

@@ -0,0 +1,24 @@
+// Import all organized type definitions
+import "./core/base";
+import "./svg/base";
+import "./html/tags";
+import "./svg/tags";
+import "./features/list";
+import "./features/when";
+import "./features/update";
+import "./features/on";
+import "./features/render";
+
+// Re-export on() helper for module-style consumers (import { on } from "nuclo")
+export function on<K extends keyof HTMLElementEventMap>(
+  type: K,
+  listener: (ev: HTMLElementEventMap[K]) => any,
+  options?: boolean | AddEventListenerOptions
+): NodeModFn<any>;
+export function on<K extends string, E extends Event = Event>(
+  type: K,
+  listener: (ev: E) => any,
+  options?: boolean | AddEventListenerOptions
+): NodeModFn<any>;
+
+export {};

package/types/svg/base.d.ts

@@ -0,0 +1,25 @@
+declare global {
+  // SVG element modifier types
+  export type SVGElementModifier<TTagName extends keyof SVGElementTagNameMap = keyof SVGElementTagNameMap> =
+    | Primitive
+    | (() => Primitive)
+    | Partial<SVGElementTagNameMap[TTagName]>
+    | SVGElementTagNameMap[TTagName];
+
+  export type SVGElementModifierFn<TTagName extends keyof SVGElementTagNameMap = keyof SVGElementTagNameMap> = (
+    parent: SVGElementTagNameMap[TTagName],
+    index: number,
+  ) => SVGElementModifier<TTagName> | void;
+
+  // SVG builder type
+  export type ExpandedSVGElementBuilder<
+    TTagName extends keyof SVGElementTagNameMap = keyof SVGElementTagNameMap,
+  > = (
+    ...rawMods: Array<SVGElementModifier<TTagName> | SVGElementModifierFn<TTagName>>
+  ) => (
+    parent?: SVGElementTagNameMap[TTagName],
+    index?: number,
+  ) => SVGElementTagNameMap[TTagName];
+}
+
+export {};

package/types/svg/tags.d.ts

@@ -0,0 +1,68 @@
+declare global {
+  // SVG tags
+  export const a_svg: ExpandedSVGElementBuilder<"a">;
+  export const animate: ExpandedSVGElementBuilder<"animate">;
+  export const animateMotion: ExpandedSVGElementBuilder<"animateMotion">;
+  export const animateTransform: ExpandedSVGElementBuilder<"animateTransform">;
+  export const circle: ExpandedSVGElementBuilder<"circle">;
+  export const clipPath: ExpandedSVGElementBuilder<"clipPath">;
+  export const defs: ExpandedSVGElementBuilder<"defs">;
+  export const desc: ExpandedSVGElementBuilder<"desc">;
+  export const ellipse: ExpandedSVGElementBuilder<"ellipse">;
+  export const feBlend: ExpandedSVGElementBuilder<"feBlend">;
+  export const feColorMatrix: ExpandedSVGElementBuilder<"feColorMatrix">;
+  export const feComponentTransfer: ExpandedSVGElementBuilder<"feComponentTransfer">;
+  export const feComposite: ExpandedSVGElementBuilder<"feComposite">;
+  export const feConvolveMatrix: ExpandedSVGElementBuilder<"feConvolveMatrix">;
+  export const feDiffuseLighting: ExpandedSVGElementBuilder<"feDiffuseLighting">;
+  export const feDisplacementMap: ExpandedSVGElementBuilder<"feDisplacementMap">;
+  export const feDistantLight: ExpandedSVGElementBuilder<"feDistantLight">;
+  export const feDropShadow: ExpandedSVGElementBuilder<"feDropShadow">;
+  export const feFlood: ExpandedSVGElementBuilder<"feFlood">;
+  export const feFuncA: ExpandedSVGElementBuilder<"feFuncA">;
+  export const feFuncB: ExpandedSVGElementBuilder<"feFuncB">;
+  export const feFuncG: ExpandedSVGElementBuilder<"feFuncG">;
+  export const feFuncR: ExpandedSVGElementBuilder<"feFuncR">;
+  export const feGaussianBlur: ExpandedSVGElementBuilder<"feGaussianBlur">;
+  export const feImage: ExpandedSVGElementBuilder<"feImage">;
+  export const feMerge: ExpandedSVGElementBuilder<"feMerge">;
+  export const feMergeNode: ExpandedSVGElementBuilder<"feMergeNode">;
+  export const feMorphology: ExpandedSVGElementBuilder<"feMorphology">;
+  export const feOffset: ExpandedSVGElementBuilder<"feOffset">;
+  export const fePointLight: ExpandedSVGElementBuilder<"fePointLight">;
+  export const feSpecularLighting: ExpandedSVGElementBuilder<"feSpecularLighting">;
+  export const feSpotLight: ExpandedSVGElementBuilder<"feSpotLight">;
+  export const feTile: ExpandedSVGElementBuilder<"feTile">;
+  export const feTurbulence: ExpandedSVGElementBuilder<"feTurbulence">;
+  export const filter: ExpandedSVGElementBuilder<"filter">;
+  export const foreignObject: ExpandedSVGElementBuilder<"foreignObject">;
+  export const g: ExpandedSVGElementBuilder<"g">;
+  export const image: ExpandedSVGElementBuilder<"image">;
+  export const line: ExpandedSVGElementBuilder<"line">;
+  export const linearGradient: ExpandedSVGElementBuilder<"linearGradient">;
+  export const marker: ExpandedSVGElementBuilder<"marker">;
+  export const mask: ExpandedSVGElementBuilder<"mask">;
+  export const metadata: ExpandedSVGElementBuilder<"metadata">;
+  export const mpath: ExpandedSVGElementBuilder<"mpath">;
+  export const path: ExpandedSVGElementBuilder<"path">;
+  export const pattern: ExpandedSVGElementBuilder<"pattern">;
+  export const polygon: ExpandedSVGElementBuilder<"polygon">;
+  export const polyline: ExpandedSVGElementBuilder<"polyline">;
+  export const radialGradient: ExpandedSVGElementBuilder<"radialGradient">;
+  export const rect: ExpandedSVGElementBuilder<"rect">;
+  export const script_svg: ExpandedSVGElementBuilder<"script">;
+  export const set: ExpandedSVGElementBuilder<"set">;
+  export const stop_: ExpandedSVGElementBuilder<"stop">;
+  export const style_svg: ExpandedSVGElementBuilder<"style">;
+  export const svg: ExpandedSVGElementBuilder<"svg">;
+  export const switch_svg: ExpandedSVGElementBuilder<"switch">;
+  export const symbol: ExpandedSVGElementBuilder<"symbol">;
+  export const text: ExpandedSVGElementBuilder<"text">;
+  export const textPath: ExpandedSVGElementBuilder<"textPath">;
+  export const title_svg: ExpandedSVGElementBuilder<"title">;
+  export const tspan: ExpandedSVGElementBuilder<"tspan">;
+  export const use: ExpandedSVGElementBuilder<"use">;
+  export const view: ExpandedSVGElementBuilder<"view">;
+}
+
+export {};