@moku-labs/web 1.16.1 → 2.0.0

package/README.md

@@ -171,7 +171,7 @@ There are two entry points, and the difference is a hard guarantee, not a tree-s
 | Entry | Format | For | Includes |
 |---|---|---|---|
 | **`@moku-labs/web`** | dual ESM + CJS | Node SSG builds | the full surface — add `content` / `build` / `deploy` / `cli` and wire `dotenv()` / `processEnv()` |
-| **`@moku-labs/web/browser`** | ESM-only | client bundles | the same `createApp` over the same isomorphic defaults, plus `dataPlugin`, the route DSL, `createComponent`, `browserEnv`, and the SEO head primitives — **with all node-only code excluded** (`build` / `deploy` / `cli` and the `dotenv` / `processEnv` / `fileSystemContent` providers), and `browserEnv()` pre-wired as the default `env` provider |
+| **`@moku-labs/web/browser`** | ESM-only | client bundles | the same `createApp` over the same isomorphic defaults, plus `dataPlugin`, the route DSL, `createIsland`, `browserEnv`, and the SEO head primitives — **with all node-only code excluded** (`build` / `deploy` / `cli` and the `dotenv` / `processEnv` / `fileSystemContent` providers), and `browserEnv()` pre-wired as the default `env` provider |
 
 Importing `@moku-labs/web/browser` can **never** drag node/native code into a client bundle, regardless of bundler or tree-shaking — its static import graph references zero node-only modules. This is stronger and more reliable than importing the main entry and relying on `"sideEffects": false`, where building entries together can merge node code into a shared chunk. (The browser entry keeps the `contentPlugin` *shell* so build-only loaders can `ctx.require(contentPlugin)`; the node Markdown source lives in `fileSystemContent`, which the entry does **not** export.) CI proves it:
 

package/dist/browser.d.mts

@@ -871,7 +871,7 @@ type Api$1 = {
   composeTitle(head: HeadConfig | undefined): string;
 };
 declare namespace types_d_exports$4 {
-  export { AnyVNode, COMPONENT_HOOK_NAMES, ComponentContext, ComponentDef, ComponentEventHandler, ComponentEvents, ComponentHooks, ComponentInstance, ComponentRender, ComponentRouteSlice, ComponentSpec, ComponentSpecExtras, ComponentStateFactory, ExtractApi, PageData, RenderResult, ResolvedSpaConfig, SpaApi, SpaConfig, SpaContext, SpaDataReader, SpaEmitFunction, SpaEvents, SpaKernel, SpaKernelDeps, SpaRequire, SpaState };
+  export { AnyVNode, ExtractApi, ISLAND_HOOK_NAMES, IslandContext, IslandDef, IslandEventHandler, IslandEvents, IslandHooks, IslandInstance, IslandRender, IslandRouteSlice, IslandSpec, IslandSpecExtras, IslandStateFactory, PageData, RenderResult, ResolvedSpaConfig, SpaApi, SpaConfig, SpaContext, SpaDataReader, SpaEmitFunction, SpaEvents, SpaKernel, SpaKernelDeps, SpaRequire, SpaState };
 }
 /** Payload map for the events `spa` emits, used to type the kernel's `emit` closure. */
 type SpaEvents = {
@@ -881,12 +881,12 @@ type SpaEvents = {
   }; /** The swap completed and the new URL is active. */
   "spa:navigated": {
     url: string;
-  }; /** A component instance attached to an element. */
-  "spa:component-mount": {
+  }; /** A island instance attached to an element. */
+  "spa:island-mount": {
     name: string;
     el: Element;
-  }; /** A component instance detached from an element. */
-  "spa:component-unmount": {
+  }; /** A island instance detached from an element. */
+  "spa:island-unmount": {
     name: string;
     el: Element;
   };
@@ -955,10 +955,10 @@ type SpaConfig = {
    */
   progressBar?: boolean;
   /**
-   * Components to auto-register at init (in addition to runtime `register`).
+   * Islands to auto-register at init (in addition to runtime `register`).
    * Defaults to an empty array.
    */
-  components?: ComponentDef[];
+  islands?: IslandDef[];
 };
 /** Resolved SPA config after defaults are applied. */
 interface ResolvedSpaConfig {
@@ -968,11 +968,11 @@ interface ResolvedSpaConfig {
   viewTransitions: boolean;
   /** Whether the progress bar is enabled. */
   progressBar: boolean;
-  /** Pre-registered components. */
-  components: ComponentDef[];
+  /** Pre-registered islands. */
+  islands: IslandDef[];
 }
 /**
- * What a component's `render` may return:
+ * What a island's `render` may return:
  * - a Preact `VNode` — committed into the host through the lazy Preact gate (`commitVNode`);
  * - a `Node` — replaces the host's children;
  * - a `string` — set as the host's `innerHTML`;
@@ -984,30 +984,33 @@ type RenderResult = AnyVNode | Node | string | void;
  * `VNode<SomeProps>`; the props generic is invariant under `exactOptionalPropertyTypes`,
  * so the only supertype that accepts every concrete `VNode<P>` is `VNode<any>`.
  */
+/**
+ *
+ */
 type AnyVNode = import("preact").VNode<any>;
 /**
- * Factory that builds a component's typed per-instance state (mirrors a plugin's
+ * Factory that builds a island's typed per-instance state (mirrors a plugin's
  * `createState`). Called ONCE at mount; the returned object is stored on the
- * {@link ComponentInstance} and exposed read-only as `ctx.state`.
+ * {@link IslandInstance} and exposed read-only as `ctx.state`.
  *
- * @param ctx - The component context for this instance (state is not yet set).
+ * @param ctx - The island context for this instance (state is not yet set).
  * @returns The initial per-instance state.
  * @example
  * state: (ctx): BoardState => ({ boardId: ctx.params.id ?? "", cards: [] })
  */
-type ComponentStateFactory<S extends object> = (ctx: ComponentContext<S>) => S;
+type IslandStateFactory<S extends object> = (ctx: IslandContext<S>) => S;
 /**
  * Pure render of `(state, ctx)` → {@link RenderResult}. Called after mount-state-init
  * and again (microtask-batched) after every `ctx.set`. Must be free of side effects
  * beyond producing its result.
  *
  * @param state - The current per-instance state (read-only).
- * @param ctx - The component context for this instance.
+ * @param ctx - The island context for this instance.
  * @returns The render result to commit into the host.
  * @example
  * render: (state) => h(BoardView, { snapshot: state.snapshot })
  */
-type ComponentRender<S extends object> = (state: Readonly<S>, ctx: ComponentContext<S>) => RenderResult;
+type IslandRender<S extends object> = (state: Readonly<S>, ctx: IslandContext<S>) => RenderResult;
 /**
  * A delegated DOM event handler. `target` is the element matched by the key's selector
  * (already resolved via `closest` — no `instanceof`/`closest` ceremony in the body).
@@ -1015,14 +1018,14 @@ type ComponentRender<S extends object> = (state: Readonly<S>, ctx: ComponentCont
  * Typed `void` for ergonomics (the void-return rule accepts async handlers returning
  * `Promise<void>` too); the kernel ignores any returned value.
  *
- * @param ctx - The component context (carries the live per-instance `state`).
+ * @param ctx - The island context (carries the live per-instance `state`).
  * @param event - The raw DOM event.
  * @param target - The element matched by the selector (the host when no selector).
  * @returns void (a returned promise is ignored by the kernel).
  * @example
  * (ctx, event, button) => { event.preventDefault(); ctx.set({ open: true }); }
  */
-type ComponentEventHandler<S extends object> = (ctx: ComponentContext<S>, event: Event, target: Element) => void;
+type IslandEventHandler<S extends object> = (ctx: IslandContext<S>, event: Event, target: Element) => void;
 /**
  * Declarative delegated event map. Each key is `"<type> <selector>"` (the selector is
  * optional → a host-level listener). ONE real listener per event TYPE is attached to
@@ -1035,9 +1038,9 @@ type ComponentEventHandler<S extends object> = (ctx: ComponentContext<S>, event:
  *   "submit [data-add]": (ctx, e) => { e.preventDefault(); add(ctx); }
  * }
  */
-type ComponentEvents<S extends object> = Record<string, ComponentEventHandler<S>>;
+type IslandEvents<S extends object> = Record<string, IslandEventHandler<S>>;
 /**
- * Context handed to every component lifecycle hook, render, and event handler — the
+ * Context handed to every island lifecycle hook, render, and event handler — the
  * bound element + page data, plus the matched route's `params`/`meta`/`locale` and a
  * link builder, so an island can read its route context (e.g. a `card` route's
  * `ctx.meta.focus` + `ctx.params.id`) directly, without the page bridging it through
@@ -1045,11 +1048,11 @@ type ComponentEvents<S extends object> = Record<string, ComponentEventHandler<S>
  *
  * Generic over the per-instance state `S` (default `undefined` so every existing
  * hooks-only island still type-checks). The additive members (`state`/`set`/`flush`/
- * `cleanup`/`component`) are ALWAYS-PRESENT functions — never optional keys — so they
+ * `cleanup`/`island`) are ALWAYS-PRESENT functions — never optional keys — so they
  * never trip `exactOptionalPropertyTypes`.
  */
-interface ComponentContext<S = undefined> {
-  /** The element the component instance is bound to. */
+interface IslandContext<S = undefined> {
+  /** The element the island instance is bound to. */
   el: Element;
   /** Page data extracted from the `script#__DATA__` payload. */
   data: PageData;
@@ -1098,128 +1101,128 @@ interface ComponentContext<S = undefined> {
    * Resolve another island's registered `api` by name. Returns `undefined` when no
    * provider is registered (optional-dependency semantics, mirroring `ctx.has`).
    *
-   * @param name - The provider island's component name.
+   * @param name - The provider island's island name.
    * @returns The provider's api, or `undefined`.
    * @example
-   * ctx.component<LightboxApi>("lightbox")?.open(slides, index);
+   * ctx.island<LightboxApi>("lightbox")?.open(slides, index);
    */
-  component<T = unknown>(name: string): T | undefined;
+  island<T = unknown>(name: string): T | undefined;
 }
-/** Lifecycle hooks a component may implement. Generic over the per-instance state `S`. */
-interface ComponentHooks<S = undefined> {
+/** Lifecycle hooks a island may implement. Generic over the per-instance state `S`. */
+interface IslandHooks<S = undefined> {
   /**
    * Called once when the instance is created (before DOM attach).
    *
-   * @param ctx - The component context for this instance.
+   * @param ctx - The island context for this instance.
    * @returns void
    * @example
    * onCreate({ el }) { el.dataset.ready = "1"; }
    */
-  onCreate?(ctx: ComponentContext<S>): void;
+  onCreate?(ctx: IslandContext<S>): void;
   /**
    * Called after the instance is attached to its element.
    *
-   * @param ctx - The component context for this instance.
+   * @param ctx - The island context for this instance.
    * @returns void
    * @example
    * onMount({ el }) { el.textContent = "0"; }
    * @example
    * async onMount(ctx) { ctx.set({ items: await load() }); } // async is allowed; the harness awaits it via settle()
    */
-  onMount?(ctx: ComponentContext<S>): void;
+  onMount?(ctx: IslandContext<S>): void;
   /**
    * Called when a navigation begins while this instance is mounted.
    *
-   * @param ctx - The component context for this instance.
+   * @param ctx - The island context for this instance.
    * @returns void
    * @example
    * onNavStart({ el }) { el.dataset.loading = ""; }
    */
-  onNavStart?(ctx: ComponentContext<S>): void;
+  onNavStart?(ctx: IslandContext<S>): void;
   /**
    * Called when a navigation completes while this instance is mounted.
    *
-   * @param ctx - The component context for this instance.
+   * @param ctx - The island context for this instance.
    * @returns void
    * @example
    * onNavEnd({ el }) { delete el.dataset.loading; }
    */
-  onNavEnd?(ctx: ComponentContext<S>): void;
+  onNavEnd?(ctx: IslandContext<S>): void;
   /**
    * Called before the instance is detached from its element.
    *
-   * @param ctx - The component context for this instance.
+   * @param ctx - The island context for this instance.
    * @returns void
    * @example
    * onUnMount({ el }) { el.replaceChildren(); }
    */
-  onUnMount?(ctx: ComponentContext<S>): void;
+  onUnMount?(ctx: IslandContext<S>): void;
   /**
    * Called once when the instance is destroyed (after detach).
    *
-   * @param ctx - The component context for this instance.
+   * @param ctx - The island context for this instance.
    * @returns void
    * @example
    * onDestroy({ el }) { delete el.dataset.ready; }
    */
-  onDestroy?(ctx: ComponentContext<S>): void;
+  onDestroy?(ctx: IslandContext<S>): void;
 }
 /** Allowed hook names — single source of truth for fail-fast validation. */
-declare const COMPONENT_HOOK_NAMES: readonly ["onCreate", "onMount", "onNavStart", "onNavEnd", "onUnMount", "onDestroy"];
+declare const ISLAND_HOOK_NAMES: readonly ["onCreate", "onMount", "onNavStart", "onNavEnd", "onUnMount", "onDestroy"];
 /**
- * The plugin-mirror authoring form for {@link createComponent}: typed per-instance
+ * The plugin-mirror authoring form for {@link createIsland}: typed per-instance
  * `state`, `render`, declarative `events`, and a cross-island `api` on top of the
  * lifecycle hooks. All keys optional + additive; the presence of any spec-only key
- * (`state`/`render`/`events`/`api`) selects the spec overload of `createComponent`.
+ * (`state`/`render`/`events`/`api`) selects the spec overload of `createIsland`.
  *
  * @example
- * createComponent<{ boards: Board[] }>("board-list", {
+ * createIsland<{ boards: Board[] }>("board-list", {
  *   state: () => ({ boards: [] }),
- *   async onMount(ctx) { ctx.set({ boards: await ctx.component<Api>("api")!.list() }); },
+ *   async onMount(ctx) { ctx.set({ boards: await ctx.island<Api>("api")!.list() }); },
  *   render: (s) => h(BoardList, { boards: s.boards }),
  *   events: { "submit [data-create]": (ctx, e) => { e.preventDefault(); create(ctx); } }
  * });
  */
-interface ComponentSpec<S extends object = object, A = unknown> extends ComponentHooks<S> {
+interface IslandSpec<S extends object = object, A = unknown> extends IslandHooks<S> {
   /** Build typed per-instance state at mount (stored on the instance, not a module WeakMap). */
-  state?: ComponentStateFactory<S>;
+  state?: IslandStateFactory<S>;
   /** Pure render re-invoked (microtask-batched) on every `ctx.set`. */
-  render?: ComponentRender<S>;
+  render?: IslandRender<S>;
   /** Declarative delegated DOM events with auto-teardown. */
-  events?: ComponentEvents<S>;
-  /** Public api factory — registered under the component name; reached via `app.spa.component(name)`. */
-  api?: (ctx: ComponentContext<S>) => A;
+  events?: IslandEvents<S>;
+  /** Public api factory — registered under the island name; reached via `app.spa.island(name)`. */
+  api?: (ctx: IslandContext<S>) => A;
 }
 /**
- * The spec extras carried on a {@link ComponentDef}, type-erased to `object` state
- * (authors keep full `S` inference at the `createComponent` call site; the registry
+ * The spec extras carried on a {@link IslandDef}, type-erased to `object` state
+ * (authors keep full `S` inference at the `createIsland` call site; the registry
  * stores the runtime-only erased form). Absent for legacy `(name, hooks)` defs.
  */
-interface ComponentSpecExtras {
+interface IslandSpecExtras {
   /** Per-instance state factory. */
-  state?: ComponentStateFactory<object>;
+  state?: IslandStateFactory<object>;
   /** Render called on mount + after every `ctx.set`. */
-  render?: ComponentRender<object>;
+  render?: IslandRender<object>;
   /** Declarative delegated events. */
-  events?: ComponentEvents<object>;
-  /** Public api factory registered under the component name. */
-  api?: (ctx: ComponentContext<object>) => unknown;
+  events?: IslandEvents<object>;
+  /** Public api factory registered under the island name. */
+  api?: (ctx: IslandContext<object>) => unknown;
 }
-/** A registered component definition (an opaque token; author inference lives on `createComponent`). */
-interface ComponentDef {
-  /** Unique component name (matched against `data-component`). */
+/** A registered island definition (an opaque token; author inference lives on `createIsland`). */
+interface IslandDef {
+  /** Unique island name (matched against `data-island`). */
   name: string;
   /** Lifecycle hooks (the subset shared with the legacy form). */
-  hooks: ComponentHooks<object>;
+  hooks: IslandHooks<object>;
   /** Plugin-mirror extras (state/render/events/api). Absent for legacy `(name, hooks)` defs. */
-  spec?: ComponentSpecExtras;
+  spec?: IslandSpecExtras;
 }
 /** The matched-route slice carried on a live instance (params/meta/locale + link builder). */
-type ComponentRouteSlice = Pick<ComponentContext, "params" | "meta" | "locale" | "url">;
-/** A live, mounted component instance. */
-interface ComponentInstance {
+type IslandRouteSlice = Pick<IslandContext, "params" | "meta" | "locale" | "url">;
+/** A live, mounted island instance. */
+interface IslandInstance {
   /** The definition this instance was created from. */
-  def: ComponentDef;
+  def: IslandDef;
   /** The element this instance is bound to. */
   el: Element;
   /**
@@ -1229,13 +1232,13 @@ interface ComponentInstance {
    */
   persistent: boolean;
   /** The single per-instance context reused by every hook, event handler, and render. */
-  ctx: ComponentContext<object>;
+  ctx: IslandContext<object>;
   /** Live per-instance state (the object returned by `spec.state`), or undefined for hooks-only islands. */
   state: object | undefined;
   /** This instance's public api (the object returned by `spec.api`), or undefined when none declared. */
   api: unknown;
   /** Current matched-route slice (updated on navigation; read by `ctx.params/meta/locale/url`). */
-  route: ComponentRouteSlice;
+  route: IslandRouteSlice;
   /** Current page data payload (updated on navigation; read by `ctx.data`). */
   data: PageData;
   /** Disposers from `ctx.cleanup` + the declarative `events` listeners — run LIFO on destroy. */
@@ -1275,7 +1278,7 @@ interface SpaKernelDeps {
 /** The single shared SPA kernel — pure factory over state/config/emit/deps. */
 interface SpaKernel {
   /**
-   * Validate config, register config.components, seed currentUrl.
+   * Validate config, register config.islands, seed currentUrl.
    *
    * @returns void
    * @example
@@ -1291,14 +1294,14 @@ interface SpaKernel {
    */
   boot(): void;
   /**
-   * Register a component definition (last-registered-wins).
+   * Register a island definition (last-registered-wins).
    *
-   * @param component - The component definition to register.
+   * @param island - The island definition to register.
    * @returns void
    * @example
    * kernel.register(counter);
    */
-  register(component: ComponentDef): void;
+  register(island: IslandDef): void;
   /**
    * Process a navigation to `path`: fetch then swap then head-sync then emit.
    *
@@ -1309,7 +1312,7 @@ interface SpaKernel {
    */
   processNav(path: string): void;
   /**
-   * Query the swap region and mount components for matching elements.
+   * Query the swap region and mount islands for matching elements.
    *
    * @returns void
    * @example
@@ -1327,12 +1330,12 @@ interface SpaKernel {
 }
 /** Internal mutable state for the spa plugin (all kernel data lives here). */
 interface SpaState {
-  /** Components registered by name (last-registered-wins). */
-  registeredComponents: Map<string, ComponentDef>;
-  /** Live component instances keyed by their bound element. */
-  instances: Map<Element, ComponentInstance>;
-  /** Registered island apis by component name (the cross-island `ctx.component`/`app.spa.component` seam). */
-  componentApis: Map<string, unknown>;
+  /** Islands registered by name (last-registered-wins). */
+  registeredIslands: Map<string, IslandDef>;
+  /** Live island instances keyed by their bound element. */
+  instances: Map<Element, IslandInstance>;
+  /** Registered island apis by island name (the cross-island `ctx.island`/`app.spa.island` seam). */
+  islandApis: Map<string, unknown>;
   /** The current resolved URL (pathname + search). */
   currentUrl: string;
   /** Teardown handle for the attached router listeners (null when detached). */
@@ -1345,14 +1348,14 @@ interface SpaState {
 /** Public API of the spa plugin (registration / control surface). */
 type SpaApi = {
   /**
-   * Register a component definition for client mounting.
+   * Register a island definition for client mounting.
    *
-   * @param component - The component definition created via `createComponent`.
+   * @param island - The island definition created via `createIsland`.
    * @returns void
    * @example
    * app.spa.register(counter);
    */
-  register(component: ComponentDef): void;
+  register(island: IslandDef): void;
   /**
    * Programmatically navigate to a path (client runtime; no-op without a DOM).
    *
@@ -1374,12 +1377,12 @@ type SpaApi = {
    * Resolve a registered island's api by name (the cross-island seam). Returns
    * `undefined` when no provider with that name is currently registered.
    *
-   * @param name - The provider island's component name.
+   * @param name - The provider island's island name.
    * @returns The provider's api, or `undefined`.
    * @example
-   * app.spa.component<LightboxApi>("lightbox")?.open(slides, 0);
+   * app.spa.island<LightboxApi>("lightbox")?.open(slides, 0);
    */
-  component<T = unknown>(name: string): T | undefined;
+  island<T = unknown>(name: string): T | undefined;
 };
 //#endregion
 //#region src/plugins/site/index.d.ts
@@ -1597,43 +1600,43 @@ declare const headPlugin: import("@moku-labs/core").PluginInstance<"head", Confi
   buildArticleHead: typeof buildArticleHead;
 };
 //#endregion
-//#region src/plugins/spa/components.d.ts
+//#region src/plugins/spa/islands.d.ts
 /**
- * Create a validated component definition. Accepts either the legacy hooks-only form
- * (`createComponent("counter", { onMount() {} })`) or the plugin-mirror spec form
- * (`createComponent("board", { state, render, events, api, ...hooks })`). Spec-only
+ * Create a validated island definition. Accepts either the legacy hooks-only form
+ * (`createIsland("counter", { onMount() {} })`) or the plugin-mirror spec form
+ * (`createIsland("board", { state, render, events, api, ...hooks })`). Spec-only
  * keys (`state`/`render`/`events`/`api`) are partitioned out before hook-name
  * validation, so a real typo (e.g. `onMout`) still throws immediately while the spec
  * keys are accepted.
  *
- * @param name - Unique component name.
+ * @param name - Unique island name.
  * @param spec - Lifecycle hooks, or the `{ state, render, events, api, ...hooks }` spec.
- * @returns A `ComponentDef` ready to `register`.
+ * @returns A `IslandDef` ready to `register`.
  * @throws {Error} If `name` is empty, a hook key is unknown, or an extra/hook value has the wrong shape.
  * @example
- * const counter = createComponent("counter", { onMount({ el }) { el.textContent = "0"; } });
+ * const counter = createIsland("counter", { onMount({ el }) { el.textContent = "0"; } });
  * @example
- * const list = createComponent<{ items: string[] }>("list", {
+ * const list = createIsland<{ items: string[] }>("list", {
  *   state: () => ({ items: [] }),
  *   render: (s) => h(List, { items: s.items })
  * });
  */
-declare function createComponent<S extends object = object, A = unknown>(name: string, spec: ComponentSpec<S, A>): ComponentDef;
+declare function createIsland<S extends object = object, A = unknown>(name: string, spec: IslandSpec<S, A>): IslandDef;
 //#endregion
 //#region src/plugins/spa/lazy-embed.d.ts
 /**
  * Lazy-embed island: facade button click → real `<iframe loading="lazy">`.
  * The companion of the content pipeline's `::embed` directive.
  */
-declare const lazyEmbed: ComponentDef;
+declare const lazyEmbed: IslandDef;
 //#endregion
 //#region src/plugins/spa/index.d.ts
 /**
  * SPA plugin — progressive client-side navigation layered over the static site:
  * swaps a page region on navigation, with an optional progress bar and View
- * Transitions. Register interactive islands with {@link createComponent}. Depends
- * on router and head; emits `spa:navigate`, `spa:navigated`, `spa:component-mount`,
- * and `spa:component-unmount`.
+ * Transitions. Register interactive islands with {@link createIsland}. Depends
+ * on router and head; emits `spa:navigate`, `spa:navigated`, `spa:island-mount`,
+ * and `spa:island-unmount`.
  *
  * @example Enable view transitions and a custom swap region
  * ```ts
@@ -1656,11 +1659,11 @@ declare const spaPlugin: import("@moku-labs/core").PluginInstance<"spa", SpaConf
   "spa:navigated": {
     url: string;
   };
-  "spa:component-mount": {
+  "spa:island-mount": {
     name: string;
     el: Element;
   };
-  "spa:component-unmount": {
+  "spa:island-unmount": {
     name: string;
     el: Element;
   };
@@ -2036,7 +2039,7 @@ type GalleryProps = {
 /**
  * A consumer-supplied gallery component: a Preact function component over
  * {@link GalleryProps}, rendered (at build time, to static markup) as the inner
- * content — inside the framework-owned `<div data-component="gallery">` that carries
+ * content — inside the framework-owned `<div data-island="gallery">` that carries
  * the island hook. Defaults to the built-in `GalleryTrack`.
  */
 type GalleryComponent = FunctionComponent<GalleryProps>;
@@ -2359,11 +2362,11 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
   "spa:navigated": {
     url: string;
   };
-  "spa:component-mount": {
+  "spa:island-mount": {
     name: string;
     el: Element;
   };
-  "spa:component-unmount": {
+  "spa:island-unmount": {
     name: string;
     el: Element;
   };
@@ -2388,11 +2391,11 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
   "spa:navigated": {
     url: string;
   };
-  "spa:component-mount": {
+  "spa:island-mount": {
     name: string;
     el: Element;
   };
-  "spa:component-unmount": {
+  "spa:island-unmount": {
     name: string;
     el: Element;
   };
@@ -2414,4 +2417,4 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
  */
 declare const createPlugin: import("@moku-labs/core").BoundCreatePluginFunction<Config$5, Events, import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common").LogConfig, import("@moku-labs/common").LogState, import("@moku-labs/common").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common").EnvConfig, import("@moku-labs/common").EnvState, import("@moku-labs/common").EnvApi>]>>;
 //#endregion
-export { types_d_exports as Content, types_d_exports$1 as Data, type Env, types_d_exports$2 as Head, type Log, types_d_exports$3 as Router, types_d_exports$4 as Spa, browserEnv, buildArticleHead, canonical, contentPlugin, createApp, createComponent, createPlugin, createUrls, dataPlugin, defineRoutes, envPlugin, feedLink, headPlugin, hreflang, i18nPlugin, jsonLd, lazyEmbed, logPlugin, meta, og, route, routerPlugin, sitePlugin, spaPlugin, twitter };
+export { types_d_exports as Content, types_d_exports$1 as Data, type Env, types_d_exports$2 as Head, type Log, types_d_exports$3 as Router, types_d_exports$4 as Spa, browserEnv, buildArticleHead, canonical, contentPlugin, createApp, createIsland, createPlugin, createUrls, dataPlugin, defineRoutes, envPlugin, feedLink, headPlugin, hreflang, i18nPlugin, jsonLd, lazyEmbed, logPlugin, meta, og, route, routerPlugin, sitePlugin, spaPlugin, twitter };