@getforma/core 1.0.3 → 1.0.5

package/dist/index.d.cts

@@ -653,6 +653,30 @@ declare function createErrorBoundary(tryFn: () => Node, catchFn: (error: Error,
  */
 declare function createSuspense(fallback: () => Node, children: () => Node): DocumentFragment;
 
+/**
+ * Forma DOM - Template
+ *
+ * Runtime helper for compiled template output. Memoizes template parsing
+ * so that each unique HTML string is parsed once and then cloned per use.
+ *
+ * The returned node should be cloned via `.cloneNode(true)` before use
+ * in component instances.
+ */
+/**
+ * Create a reusable template node from an HTML string.
+ *
+ * The returned node is a cached prototype. Callers must call
+ * `.cloneNode(true)` to get a unique DOM tree for each component instance.
+ */
+declare function template(html: string): Node;
+/**
+ * Create a reusable template DocumentFragment from an HTML string.
+ *
+ * Used when the template has multiple root nodes. The returned fragment
+ * is a cached prototype; callers must call `.cloneNode(true)`.
+ */
+declare function templateMany(html: string): DocumentFragment;
+
 /**
  * Hydrate an SSR island in-place. Runs the component in hydration mode so
  * h() returns descriptors, then walks the descriptor tree against the SSR DOM
@@ -991,4 +1015,4 @@ declare function onResize(el: HTMLElement, handler: (entry: ResizeObserverEntry)
 declare function onIntersect(el: HTMLElement, handler: (entry: IntersectionObserverEntry) => void, options?: IntersectionObserverInit): () => void;
 declare function onMutation(el: HTMLElement, handler: (mutations: MutationRecord[]) => void, options?: MutationObserverInit): () => void;
 
-export { $, $$, type CleanupFn, type ComponentDef, type Context, type CreateListOptions, type Dispatch, type ErrorHandler, type EventBus, Fragment, type HistoryControls, type IslandHydrateFn, type KeyOptions, type ListTransitionHooks, type PersistOptions, type ReconcileResult, type Ref, type SetupFn, SignalGetter, type StoreSetter, type SwitchCase, activateIslands, addClass, batch, children, cleanup, closest, createBus, createComputed, createContext, createEffect, createErrorBoundary, createHistory, createList, createMemo, createPortal, createReducer, createRef, createRoot, createShow, createStore, createSuspense, createSwitch, createText, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, fragment, h, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, removeClass, setAttr, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, untrack };
+export { $, $$, type CleanupFn, type ComponentDef, type Context, type CreateListOptions, type Dispatch, type ErrorHandler, type EventBus, Fragment, type HistoryControls, type IslandHydrateFn, type KeyOptions, type ListTransitionHooks, type PersistOptions, type ReconcileResult, type Ref, type SetupFn, SignalGetter, type StoreSetter, type SwitchCase, activateIslands, addClass, batch, children, cleanup, closest, createBus, createComputed, createContext, createEffect, createErrorBoundary, createHistory, createList, createMemo, createPortal, createReducer, createRef, createRoot, createShow, createStore, createSuspense, createSwitch, createText, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, fragment, h, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, removeClass, setAttr, setHTMLUnsafe, setStyle, setText, siblings, template, templateMany, toggleClass, trackDisposer, unprovide, untrack };

package/dist/index.d.ts

@@ -653,6 +653,30 @@ declare function createErrorBoundary(tryFn: () => Node, catchFn: (error: Error,
  */
 declare function createSuspense(fallback: () => Node, children: () => Node): DocumentFragment;
 
+/**
+ * Forma DOM - Template
+ *
+ * Runtime helper for compiled template output. Memoizes template parsing
+ * so that each unique HTML string is parsed once and then cloned per use.
+ *
+ * The returned node should be cloned via `.cloneNode(true)` before use
+ * in component instances.
+ */
+/**
+ * Create a reusable template node from an HTML string.
+ *
+ * The returned node is a cached prototype. Callers must call
+ * `.cloneNode(true)` to get a unique DOM tree for each component instance.
+ */
+declare function template(html: string): Node;
+/**
+ * Create a reusable template DocumentFragment from an HTML string.
+ *
+ * Used when the template has multiple root nodes. The returned fragment
+ * is a cached prototype; callers must call `.cloneNode(true)`.
+ */
+declare function templateMany(html: string): DocumentFragment;
+
 /**
  * Hydrate an SSR island in-place. Runs the component in hydration mode so
  * h() returns descriptors, then walks the descriptor tree against the SSR DOM
@@ -991,4 +1015,4 @@ declare function onResize(el: HTMLElement, handler: (entry: ResizeObserverEntry)
 declare function onIntersect(el: HTMLElement, handler: (entry: IntersectionObserverEntry) => void, options?: IntersectionObserverInit): () => void;
 declare function onMutation(el: HTMLElement, handler: (mutations: MutationRecord[]) => void, options?: MutationObserverInit): () => void;
 
-export { $, $$, type CleanupFn, type ComponentDef, type Context, type CreateListOptions, type Dispatch, type ErrorHandler, type EventBus, Fragment, type HistoryControls, type IslandHydrateFn, type KeyOptions, type ListTransitionHooks, type PersistOptions, type ReconcileResult, type Ref, type SetupFn, SignalGetter, type StoreSetter, type SwitchCase, activateIslands, addClass, batch, children, cleanup, closest, createBus, createComputed, createContext, createEffect, createErrorBoundary, createHistory, createList, createMemo, createPortal, createReducer, createRef, createRoot, createShow, createStore, createSuspense, createSwitch, createText, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, fragment, h, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, removeClass, setAttr, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, untrack };
+export { $, $$, type CleanupFn, type ComponentDef, type Context, type CreateListOptions, type Dispatch, type ErrorHandler, type EventBus, Fragment, type HistoryControls, type IslandHydrateFn, type KeyOptions, type ListTransitionHooks, type PersistOptions, type ReconcileResult, type Ref, type SetupFn, SignalGetter, type StoreSetter, type SwitchCase, activateIslands, addClass, batch, children, cleanup, closest, createBus, createComputed, createContext, createEffect, createErrorBoundary, createHistory, createList, createMemo, createPortal, createReducer, createRef, createRoot, createShow, createStore, createSuspense, createSwitch, createText, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, fragment, h, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, removeClass, setAttr, setHTMLUnsafe, setStyle, setText, siblings, template, templateMany, toggleClass, trackDisposer, unprovide, untrack };

package/dist/index.js

@@ -53,7 +53,7 @@ function createSwitch(value, cases, fallback) {
   const fragment2 = document.createDocumentFragment();
   fragment2.appendChild(startMarker);
   fragment2.appendChild(endMarker);
-  const cache = /* @__PURE__ */ new Map();
+  const cache2 = /* @__PURE__ */ new Map();
   let currentNode = null;
   let currentMatch = UNSET;
   const switchDispose = internalEffect(() => {
@@ -88,7 +88,7 @@ function createSwitch(value, cases, fallback) {
     }
     const matchedCase = cases.find((c) => c.match === val);
     if (matchedCase) {
-      let entry = cache.get(val);
+      let entry = cache2.get(val);
       if (!entry) {
         let branchDispose;
         const node = createRoot((dispose) => {
@@ -96,7 +96,7 @@ function createSwitch(value, cases, fallback) {
           return untrack(() => matchedCase.render());
         });
         entry = { node, dispose: branchDispose };
-        cache.set(val, entry);
+        cache2.set(val, entry);
         if (DEBUG) console.log("[forma:switch] rendered new branch for", String(val), "\u2192", node.nodeName, "type", node.nodeType);
       } else {
         if (DEBUG) console.log("[forma:switch] reusing cached branch for", String(val), "\u2192", entry.node.nodeName, "type", entry.node.nodeType, "childNodes", entry.node.childNodes?.length);
@@ -113,10 +113,10 @@ function createSwitch(value, cases, fallback) {
   });
   fragment2.__switchDispose = () => {
     switchDispose();
-    for (const entry of cache.values()) {
+    for (const entry of cache2.values()) {
       entry.dispose();
     }
-    cache.clear();
+    cache2.clear();
   };
   return fragment2;
 }
@@ -220,6 +220,29 @@ function createSuspense(fallback, children2) {
   return fragment2;
 }
 
+// src/dom/template.ts
+var cache = /* @__PURE__ */ new Map();
+function template(html) {
+  let node = cache.get(html);
+  if (!node) {
+    const tpl = document.createElement("template");
+    tpl.innerHTML = html;
+    node = tpl.content.firstChild;
+    cache.set(html, node);
+  }
+  return node;
+}
+function templateMany(html) {
+  let node = cache.get(html);
+  if (!node) {
+    const tpl = document.createElement("template");
+    tpl.innerHTML = html;
+    node = tpl.content;
+    cache.set(html, node);
+  }
+  return node.cloneNode(true);
+}
+
 // src/dom/activate.ts
 var FORBIDDEN_PROP_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
 function sanitizeProps(obj) {
@@ -992,6 +1015,6 @@ function onMutation(el, handler, options) {
   };
 }
 
-export { $, $$, activateIslands, addClass, children, closest, createBus, createContext, createErrorBoundary, createHistory, createPortal, createStore, createSuspense, createSwitch, createText, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, inject, mount, nextSibling, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, removeClass, setAttr, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide };
+export { $, $$, activateIslands, addClass, children, closest, createBus, createContext, createErrorBoundary, createHistory, createPortal, createStore, createSuspense, createSwitch, createText, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, inject, mount, nextSibling, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, removeClass, setAttr, setHTMLUnsafe, setStyle, setText, siblings, template, templateMany, toggleClass, trackDisposer, unprovide };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map