@jasonshimmy/custom-elements-runtime 1.2.1 → 1.2.3

package/dist/router.d.ts

@@ -1,13 +1,7 @@
-/**
- * Lightweight, scalable router for Custom Elements Runtime
- * - Functional API, zero dependencies, SSR/static site compatible
- * - Integrates with createStore and lib/index.ts
- */
-import { type Store } from './store';
-export interface RouteComponent {
+import { type Store } from "./store";
+export type RouteComponent = {
     new (...args: any[]): any;
-    (...args: any[]): any;
-}
+} | ((...args: any[]) => any);
 export interface RouteState {
     path: string;
     params: Record<string, string>;
@@ -50,8 +44,8 @@ export interface RouterLinkProps {
     ariaCurrentValue: string;
     disabled: boolean;
     external: boolean;
-    class?: string;
-    style: string;
+    linkClass?: string;
+    linkStyle?: string;
 }
 export interface RouterLinkComputed {
     current: RouteState;
@@ -68,11 +62,6 @@ export interface RouterConfig {
     base?: string;
     initialUrl?: string;
 }
-export interface RouteState {
-    path: string;
-    params: Record<string, string>;
-    query: Record<string, string>;
-}
 export declare const parseQuery: (search: string) => Record<string, string>;
 export declare const matchRoute: (routes: Route[], path: string) => {
     route: Route | null;
@@ -89,7 +78,7 @@ export declare function useRouter(config: RouterConfig): {
     push: (path: string) => Promise<void>;
     replace: (path: string) => Promise<void>;
     back: () => void;
-    subscribe: (listener: (state: RouteState) => void) => void;
+    subscribe: (listener: (state: RouteState) => void) => () => void;
     matchRoute: (path: string) => {
         route: Route | null;
         params: Record<string, string>;
@@ -112,7 +101,7 @@ export declare function initRouter(config: RouterConfig): {
     push: (path: string) => Promise<void>;
     replace: (path: string) => Promise<void>;
     back: () => void;
-    subscribe: (listener: (state: RouteState) => void) => void;
+    subscribe: (listener: (state: RouteState) => void) => () => void;
     matchRoute: (path: string) => {
         route: Route | null;
         params: Record<string, string>;

package/dist/runtime/helpers.d.ts

@@ -76,3 +76,18 @@ export declare function getNestedValue(obj: any, path: string): any;
  * Set nested property value in object using dot notation
  */
 export declare function setNestedValue(obj: any, path: string, value: any): void;
+/**
+ * Safely unwrap reactive-like wrappers to their inner primitive when safe.
+ * Returns the original value when it's not safe to coerce to a primitive.
+ */
+export declare function unwrapIfPrimitive(v: any): any;
+/**
+ * Return a serialized string for an attribute value when safe to write to DOM.
+ * Returns `null` when the value should not be written as an attribute.
+ */
+export declare function safeSerializeAttr(val: any): string | null;
+/**
+ * Determine if an attribute name is class-like and should be preserved on hosts.
+ * Class-like: exactly 'class', camelCase ending with 'Class', or kebab-case ending with '-class'.
+ */
+export declare function isClassLikeAttr(name: string): boolean;

package/dist/runtime/node-metadata.d.ts

@@ -8,15 +8,6 @@
  * @internal
  */
 export declare function getNodeKey(node: Node | null | undefined): string | undefined;
-/**
- * Store a node key on a Node.
- *
- * This sets a WeakMap entry and also writes defensive DOM fallbacks for
- * compatibility with older consumers/tests. Errors are swallowed to avoid
- * disrupting host environments that forbid property writes.
- *
- * @internal
- */
 export declare function setNodeKey(node: Node, key: string): void;
 /**
  * Retrieve transition-group metadata attached to an element.

package/dist/store.d.ts

@@ -1,6 +1,10 @@
 type Listener<T> = (state: T) => void;
 export interface Store<T extends object> {
-    subscribe(listener: Listener<T>): void;
+    /**
+     * Subscribe to store updates.
+     * Returns an unsubscribe function to remove the listener.
+     */
+    subscribe(listener: Listener<T>): () => void;
     getState(): T;
     setState(partial: Partial<T> | ((prev: T) => Partial<T>)): void;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jasonshimmy/custom-elements-runtime",
   "description": "A powerful, modern, and lightweight runtime for creating reactive web components with TypeScript",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "type": "module",
   "keywords": [
     "web-components",
@@ -30,6 +30,7 @@
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.8.0",
+    "@types/jsdom": "^27.0.0",
     "@vitest/coverage-v8": "^3.2.4",
     "cypress": "^15.0.0",
     "jsdom": "^26.1.0",