@getforma/core 0.1.0

package/dist/runtime.d.ts

@@ -0,0 +1,86 @@
+type UnsafeEvalMode = 'mutable' | 'locked-off' | 'locked-on';
+interface RuntimeDiagnostic {
+    kind: 'handler-unsupported' | 'expression-unsupported';
+    expr: string;
+    reason: string;
+    count: number;
+    firstSeenAt: number;
+    lastSeenAt: number;
+}
+/** Yield control to keep the main thread responsive during large batches. */
+declare function yieldToMain(): Promise<void>;
+interface ContainmentHintsOptions {
+    selector?: string;
+    contain?: string;
+    contentVisibility?: string;
+    containIntrinsicSize?: string;
+    skipIfAlreadySet?: boolean;
+}
+/** Apply CSS containment hints to opt-in containers for lower layout/paint cost. */
+declare function applyContainmentHints(root?: ParentNode, options?: ContainmentHintsOptions): number;
+/**
+ * Load a pre-compiled directive map from the server.
+ * Keys are data-forma-id values, values are arrays of directive attribute names.
+ */
+declare function setDirectiveMap(map: Record<string, string[]> | null): void;
+declare function initRuntime(): void;
+/** Dispose all FormaJS scopes — clears effects, intervals, event listeners, and stops the observer. */
+declare function destroyRuntime(): void;
+/**
+ * Mount a specific element or subtree — scans for `data-forma-state`
+ * elements and initializes their reactive bindings.
+ *
+ * Use this for manual control when injecting HTML dynamically.
+ * With the MutationObserver active, this is usually not needed.
+ *
+ * @param el - The root element to scan (checks itself and all descendants).
+ */
+declare function mount(el: Element): void;
+/**
+ * Unmount a specific element or subtree — disposes all reactive bindings
+ * for `data-forma-state` elements within.
+ *
+ * @param el - The root element to clean up (checks itself and all descendants).
+ */
+declare function unmount(el: Element): void;
+/** Enable/disable debug logging. Also toggleable via window.__FORMA_DEBUG = true */
+declare function setDebug(on: boolean): void;
+/** Set unsafe-eval mode. `locked-off` is hardened and non-toggleable via setUnsafeEval. */
+declare function setUnsafeEvalMode(mode: UnsafeEvalMode): void;
+/** Enable/disable unsafe `new Function` fallback for complex expressions. */
+declare function setUnsafeEval(on: boolean): void;
+/** Get current unsafe-eval policy mode. */
+declare function getUnsafeEvalMode(): UnsafeEvalMode;
+/** Enable/disable runtime diagnostics for unsupported expressions/handlers. */
+declare function setDiagnostics(on: boolean): void;
+/** Runtime diagnostics captured while parsing/binding templates. */
+declare function getDiagnostics(): RuntimeDiagnostic[];
+/** Clear runtime diagnostics collected so far. */
+declare function clearDiagnostics(): void;
+interface ScopeDescriptor {
+    element: Element;
+    id: string;
+    values: Record<string, {
+        value: unknown;
+        type: string;
+    }>;
+    initialJSON: string;
+}
+/**
+ * DevTools: enumerate all active scopes and their current signal values.
+ * Only called when the State Inspector panel is open — zero overhead otherwise.
+ */
+declare function getScopes(): ScopeDescriptor[];
+/**
+ * DevTools: set a state value on a specific scope element.
+ * Triggers normal reactive effects (data-show, data-text, etc.).
+ */
+declare function setScopeValue(element: Element, key: string, value: unknown): void;
+/**
+ * DevTools: reset all values on a scope to their initial JSON state.
+ */
+declare function resetScope(element: Element): void;
+/** Reconcile a container's DOM against a new HTML string. */
+declare function reconcile(container: Element, html: string): void;
+
+export { applyContainmentHints, clearDiagnostics, destroyRuntime, getDiagnostics, getScopes, getUnsafeEvalMode, initRuntime, mount, reconcile, resetScope, setDebug, setDiagnostics, setDirectiveMap, setScopeValue, setUnsafeEval, setUnsafeEvalMode, unmount, yieldToMain };