@ox-content/islands 3.1.3 → 3.1.5

package/dist/types.d.mts

@@ -0,0 +1,86 @@
+//#region src/types.d.ts
+/**
+ * Island Architecture Types
+ *
+ * Framework-agnostic type definitions for the Island system.
+ */
+/**
+ * Loading strategy for islands.
+ *
+ * - `eager`: Hydrate immediately on page load
+ * - `idle`: Hydrate when the browser is idle (requestIdleCallback)
+ * - `visible`: Hydrate when the element becomes visible (IntersectionObserver)
+ * - `media`: Hydrate when a media query matches
+ */
+type LoadStrategy = "eager" | "idle" | "visible" | "media";
+/**
+ * Island configuration extracted from data attributes.
+ */
+interface IslandConfig {
+  /** Unique island identifier */
+  id: string;
+  /** Component name to hydrate */
+  component: string;
+  /** Loading strategy */
+  load: LoadStrategy;
+  /** Media query for 'media' load strategy */
+  mediaQuery?: string;
+  /** Component props (JSON serialized in data-ox-props) */
+  props: Record<string, unknown>;
+  /** Whether the island wrapper already contains server-rendered component HTML. */
+  ssr?: boolean;
+}
+/**
+ * Hydration function signature.
+ *
+ * Called when an island should be hydrated.
+ * Returns an optional cleanup function.
+ */
+type HydrateFunction = (element: HTMLElement, props: Record<string, unknown>) => void | (() => void) | PromiseLike<void | (() => void)>;
+/**
+ * Component registry mapping component names to hydrate functions.
+ */
+type ComponentRegistry = Map<string, HydrateFunction>;
+/**
+ * Options for initializing islands.
+ */
+interface InitIslandsOptions {
+  /** Root margin for IntersectionObserver (visible strategy). Default: "200px" */
+  rootMargin?: string;
+  /** Threshold for IntersectionObserver. Default: 0 */
+  threshold?: number;
+  /** Timeout for idle callback fallback in ms. Default: 200 */
+  idleTimeout?: number;
+  /** Custom selector for finding islands. Default: "[data-ox-island]" */
+  selector?: string;
+  /** Called when an island starts hydrating */
+  onHydrateStart?: (element: HTMLElement, config: IslandConfig) => void;
+  /** Called when an island finishes hydrating */
+  onHydrateEnd?: (element: HTMLElement, config: IslandConfig) => void;
+  /** Called when hydration fails */
+  onHydrateError?: (element: HTMLElement, config: IslandConfig, error: Error) => void;
+}
+/**
+ * Island instance tracking.
+ */
+interface IslandInstance {
+  element: HTMLElement;
+  config: IslandConfig;
+  cleanup?: () => void;
+  hydrating?: boolean;
+  hydrated: boolean;
+}
+/**
+ * Island controller returned by initIslands.
+ */
+interface IslandController {
+  /** All tracked island instances */
+  instances: IslandInstance[];
+  /** Manually hydrate a specific island */
+  hydrate: (element: HTMLElement) => void;
+  /** Destroy all islands and cleanup */
+  destroy: () => void;
+}
+//#endregion
+export { IslandController as a, IslandConfig as i, HydrateFunction as n, IslandInstance as o, InitIslandsOptions as r, LoadStrategy as s, ComponentRegistry as t };
+//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;;;;;KAcY;;;;UAKK;;EAEf;;EAEA;;EAEA,MAAM;;EAEN;;EAEA,OAAO;;EAEP;;;;;;;;KASU,mBACV,SAAS,aACT,OAAO,kDACkB;;;;KAKf,oBAAoB,YAAY;;;;UAK3B;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA,kBAAkB,SAAS,aAAa,QAAQ;;EAEhD,gBAAgB,SAAS,aAAa,QAAQ;;EAE9C,kBAAkB,SAAS,aAAa,QAAQ,cAAc,OAAO;;;;;UAMtD;EACf,SAAS;EACT,QAAQ;EACR;EACA;EACA;;;;;UAMe;;EAEf,WAAW;;EAEX,UAAU,SAAS;;EAEnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ox-content/islands",
-  "version": "3.1.3",
+  "version": "3.1.5",
   "description": "Framework-agnostic Island Architecture for ox-content",
   "keywords": [
     "framework-agnostic",
@@ -24,12 +24,34 @@
   "types": "./dist/index.d.mts",
   "exports": {
     ".": {
-      "import": "./dist/index.mjs",
-      "types": "./dist/index.d.mts"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./runtime": {
-      "import": "./dist/runtime.mjs",
-      "types": "./dist/runtime.d.mts"
+      "import": {
+        "types": "./dist/runtime.d.mts",
+        "default": "./dist/runtime.mjs"
+      },
+      "require": {
+        "types": "./dist/runtime.d.cts",
+        "default": "./dist/runtime.cjs"
+      }
+    },
+    "./html-host": {
+      "import": {
+        "types": "./dist/html-host.d.mts",
+        "default": "./dist/html-host.mjs"
+      },
+      "require": {
+        "types": "./dist/html-host.d.cts",
+        "default": "./dist/html-host.cjs"
+      }
     }
   },
   "publishConfig": {
@@ -42,7 +64,7 @@
     "vite-plus": "0.3.0"
   },
   "scripts": {
-    "build": "vp pack",
+    "build": "vp pack && node ../../tools/scripts/stabilize-public-declaration-exports.mjs @ox-content/islands",
     "dev": "vp pack --watch",
     "typecheck": "tsgo --noEmit"
   }

package/dist/runtime2.d.mts

@@ -1,2 +0,0 @@
-import { n as initIslands, r as isIslandsSupported, t as createDeferredInit } from "./runtime.mjs";
-export { createDeferredInit, initIslands, isIslandsSupported };