@nisli/core 0.46.0 → 0.47.4

package/README.md

@@ -16,7 +16,7 @@ import { signal, component, html } from '@nisli/core';
 const Counter = component('x-counter', () => {
   const count = signal(0);
   return html`
-    <button @click=${() => count.set(count() + 1)}>
+    <button @click=${() => count.value++}>
       Count: ${count}
     </button>
   `;
@@ -34,6 +34,7 @@ const Counter = component('x-counter', () => {
 - **Lifecycle** — `onMount`, `onCleanup`, `useHostEvent`
 - **Refs** — Direct element access via `ref()`
 - **Control Flow** — `when()` for toggles, `each()` for keyed list rendering
+- **Static Rendering** — DOM-free HTML string rendering via `@nisli/core/static`
 
 ## API
 
@@ -45,7 +46,7 @@ effect(() => { ... })   // Side effect that tracks dependencies
 
 // Components
 component('tag-name', (props, host) => html`...`)
-component<Props>('tag-name', { props: [...] }, (props, host) => html`...`)
+component<Props>('tag-name', (props, host) => html`...`)
 
 // Templates — signals are implicit, no .value needed
 html`<div>${count}</div>`
@@ -69,11 +70,11 @@ const { data, loading, error } = query(
 // Lifecycle
 onMount(() => { ... })
 onCleanup(() => { ... })
-useHostEvent('click', handler)
+useHostEvent(host, 'click', handler)
 
 // Refs
 const el = ref<HTMLDivElement>()
-html`<div ${el}>...</div>`
+html`<div ref="${el}">...</div>`
 
 // Events
 class Nav extends Emitter<{ select: { id: string } }> {}
@@ -81,6 +82,21 @@ inject(Nav).emit('select', { id })
 inject(Nav).on('select', ({ id }) => { ... })
 ```
 
+## Static Rendering
+
+Use the static entry point when you want HTML strings for build-time pages,
+feeds, emails, or other DOM-free output.
+
+```typescript
+import { staticHtml, raw, renderToString } from '@nisli/core/static';
+
+const page = staticHtml`<article>${raw(markdownHtml)}</article>`;
+const output = renderToString(page);
+```
+
+`staticHtml` is intentionally separate from browser `html`. Browser `html`
+returns mountable DOM bindings; `staticHtml` returns escaped static HTML strings.
+
 ## Size
 
 ~2,600 lines of TypeScript. Zero dependencies.

package/dist/ref.d.ts

@@ -10,11 +10,11 @@
  *
  * onMount(() => inputRef.current?.focus());
  *
- * return html`<input ${inputRef} @keydown.enter=${onSubmit} />`;
+ * return html`<input ref="${inputRef}" @keydown.enter=${onSubmit} />`;
  * ```
  *
- * The template engine detects `Ref` objects in expression positions
- * (not inside attribute values) and assigns the nearest parent element.
+ * The template engine detects `Ref` objects in `ref="${...}"`
+ * attribute bindings and assigns the referenced element.
  */
 export declare const REF_BRAND: unique symbol;
 export interface Ref<T extends Element = Element> {

package/dist/ref.js

@@ -10,11 +10,11 @@
  *
  * onMount(() => inputRef.current?.focus());
  *
- * return html`<input ${inputRef} @keydown.enter=${onSubmit} />`;
+ * return html`<input ref="${inputRef}" @keydown.enter=${onSubmit} />`;
  * ```
  *
- * The template engine detects `Ref` objects in expression positions
- * (not inside attribute values) and assigns the nearest parent element.
+ * The template engine detects `Ref` objects in `ref="${...}"`
+ * attribute bindings and assigns the referenced element.
  */
 // ── Brand for ref detection in templates ─────────────────────────────
 export const REF_BRAND = Symbol.for('backlog.ref');

package/dist/static/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Static rendering public API.
+ */
+export { staticHtml, raw, renderToString, type StaticResult, type RawHtml, } from './render.js';

package/dist/static/index.js

@@ -0,0 +1,5 @@
+/**
+ * Static rendering public API.
+ */
+export { staticHtml, raw, renderToString, } from './render.js';
+//# sourceMappingURL=index.js.map

package/dist/static/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/static/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,EACV,GAAG,EACH,cAAc,GAGf,MAAM,aAAa,CAAC"}

package/dist/static/render.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Static HTML renderer for Nisli-style templates.
+ *
+ * This module is intentionally DOM-free. It renders tagged templates to HTML
+ * strings for build-time/static use cases, not live browser bindings.
+ */
+export interface StaticResult {
+    toString(): string;
+    __staticResult: true;
+}
+export interface RawHtml {
+    value: string;
+    __raw: true;
+}
+export declare function staticHtml(strings: TemplateStringsArray, ...values: unknown[]): StaticResult;
+export declare function raw(value: string): RawHtml;
+export declare function renderToString(value: unknown): string;

package/dist/static/render.js

@@ -0,0 +1,66 @@
+/**
+ * Static HTML renderer for Nisli-style templates.
+ *
+ * This module is intentionally DOM-free. It renders tagged templates to HTML
+ * strings for build-time/static use cases, not live browser bindings.
+ */
+const ESCAPE_MAP = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+function escapeHtml(value) {
+    return value.replace(/[&<>"']/g, ch => ESCAPE_MAP[ch] ?? ch);
+}
+function isStaticResult(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '__staticResult' in value &&
+        value.__staticResult === true &&
+        typeof value.toString === 'function');
+}
+function isRawHtml(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '__raw' in value &&
+        value.__raw === true &&
+        typeof value.value === 'string');
+}
+export function staticHtml(strings, ...values) {
+    const result = [];
+    for (let i = 0; i < strings.length; i++) {
+        result.push(strings[i] ?? '');
+        if (i < values.length) {
+            result.push(renderToString(values[i]));
+        }
+    }
+    const output = result.join('');
+    return {
+        __staticResult: true,
+        toString: () => output,
+    };
+}
+export function raw(value) {
+    return {
+        __raw: true,
+        value,
+    };
+}
+export function renderToString(value) {
+    if (value == null || value === false || value === true) {
+        return '';
+    }
+    if (isStaticResult(value)) {
+        return value.toString();
+    }
+    if (isRawHtml(value)) {
+        return value.value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(renderToString).join('');
+    }
+    return escapeHtml(String(value));
+}
+//# sourceMappingURL=render.js.map

package/dist/static/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/static/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,UAAU,GAA2B;IACzC,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,gBAAgB,IAAI,KAAK;QACxB,KAAsB,CAAC,cAAc,KAAK,IAAI;QAC/C,OAAQ,KAAsB,CAAC,QAAQ,KAAK,UAAU,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QACf,KAAiB,CAAC,KAAK,KAAK,IAAI;QACjC,OAAQ,KAAiB,CAAC,KAAK,KAAK,QAAQ,CAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA6B,EAAE,GAAG,MAAiB;IAC5E,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAE9B,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE/B,OAAO;QACL,cAAc,EAAE,IAAa;QAC7B,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,OAAO;QACL,KAAK,EAAE,IAAa;QACpB,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACvD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@nisli/core",
-  "version": "0.46.0",
+  "version": "0.47.4",
   "description": "A reactive web component framework. Signals, templates, dependency injection — no build step, no virtual DOM, no dependencies.",
   "type": "module",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/gkoreli/backlog-mcp",
-    "directory": "packages/framework"
+    "url": "https://github.com/gkoreli/nisli.git",
+    "directory": "packages/core"
   },
   "keywords": [
     "web-components",
@@ -21,6 +21,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./static": {
+      "types": "./dist/static/index.d.ts",
+      "default": "./dist/static/index.js"
     }
   },
   "files": [