@ogygia/core 0.12.2 → 0.13.0

package/dist/internal-instruments.js

@@ -1,5 +1,7 @@
 import { beacon_page, beacon_record_cpu, hole_request_times, is_headless } from "./runtime/beacon.js";
 import { props_sidecar_of } from "./runtime/sidecar.js";
+import { import_again } from "./runtime/import-again.js";
+import { download } from "./policies.js";
 import { PAGE_SEED_SELECTOR } from "./runtime/seeds.js";
 import { paint_blocker } from "./runtime/render-blocking.js";
 import { charge, own_cost } from "./runtime/own-cost.js";
@@ -9,4 +11,4 @@ import { tool_fetch, tool_made } from "./tool-fetches.js";
 import { PAGE_DEFER_GLOBAL, PAGE_DEFER_KEY, PAGE_DEFER_REGISTRY_KEY } from "./page-defer.js";
 import { ISLAND_GRAPH_ATTR, decode_island_graph } from "./island-graph.js";
 import { find_unscoped, unscoped_finding, unscoped_marker } from "./unscoped-css.js";
-export { ISLAND_GRAPH_ATTR, PAGE_DEFER_GLOBAL, PAGE_DEFER_KEY, PAGE_DEFER_REGISTRY_KEY, PAGE_SEED_SELECTOR, REGION_RENDER_CONCURRENCY, beacon_page, beacon_record_cpu, charge, decode_island_graph, find_unscoped, hole_request_times, is_headless, nearest_attr, own_cost, paint_blocker, props_sidecar_of, tool_fetch, tool_made, unscoped_finding, unscoped_marker };
+export { ISLAND_GRAPH_ATTR, PAGE_DEFER_GLOBAL, PAGE_DEFER_KEY, PAGE_DEFER_REGISTRY_KEY, PAGE_SEED_SELECTOR, REGION_RENDER_CONCURRENCY, beacon_page, beacon_record_cpu, charge, decode_island_graph, download, find_unscoped, hole_request_times, import_again, is_headless, nearest_attr, own_cost, paint_blocker, props_sidecar_of, tool_fetch, tool_made, unscoped_finding, unscoped_marker };

package/dist/internal-server.d.ts

@@ -1,7 +1,8 @@
 import { makeRegionEndpoint } from "./server/region-endpoint.js";
 import { render_region_html } from "./server/render-region-html.js";
-import { BatchHoleStats, HoleRequestStats, HoleStat, IslandInteractivity, IslandStat, OgygiaRequestStats, SeedKeyStat, hole_stats_of, record_request_stats, request_stats_of, set_batch_hole_listener, set_request_stats_detail, want_request_stats } from "./server/request-stats.js";
+import { BatchHoleStats, HoleRequestStats, HoleStat, IslandInteractivity, IslandStat, OgygiaRequestStats, SeedKeyStat, hold_request_stats_detail, hole_stats_of, record_request_stats, request_stats_of, set_batch_hole_listener, want_request_stats } from "./server/request-stats.js";
 import { mark_personal } from "./server/personal-response.js";
+import { cleanup_failed, current_request_scope, request_local, request_scope } from "./plugin/request-scope.js";
 import { islands_endpoint } from "./server/endpoint.js";
 import { scanRegions } from "./server/split-regions.js";
-export { type BatchHoleStats, type HoleRequestStats, type HoleStat, type IslandInteractivity, type IslandStat, type OgygiaRequestStats, type SeedKeyStat, hole_stats_of, islands_endpoint, makeRegionEndpoint, mark_personal, record_request_stats, render_region_html, request_stats_of, scanRegions, set_batch_hole_listener, set_request_stats_detail, want_request_stats };
+export { type BatchHoleStats, type HoleRequestStats, type HoleStat, type IslandInteractivity, type IslandStat, type OgygiaRequestStats, type SeedKeyStat, cleanup_failed, current_request_scope, hold_request_stats_detail, hole_stats_of, islands_endpoint, makeRegionEndpoint, mark_personal, record_request_stats, render_region_html, request_local, request_scope, request_stats_of, scanRegions, set_batch_hole_listener, want_request_stats };

package/dist/internal-server.js

@@ -1,7 +1,8 @@
 import { makeRegionEndpoint } from "./server/region-endpoint.js";
 import { render_region_html } from "./server/render-region-html.js";
-import { hole_stats_of, record_request_stats, request_stats_of, set_batch_hole_listener, set_request_stats_detail, want_request_stats } from "./server/request-stats.js";
+import { hold_request_stats_detail, hole_stats_of, record_request_stats, request_stats_of, set_batch_hole_listener, want_request_stats } from "./server/request-stats.js";
 import { mark_personal } from "./server/personal-response.js";
+import { cleanup_failed, current_request_scope, request_local, request_scope } from "./plugin/request-scope.js";
 import { islands_endpoint } from "./server/endpoint.js";
 import { scanRegions } from "./server/split-regions.js";
-export { hole_stats_of, islands_endpoint, makeRegionEndpoint, mark_personal, record_request_stats, render_region_html, request_stats_of, scanRegions, set_batch_hole_listener, set_request_stats_detail, want_request_stats };
+export { cleanup_failed, current_request_scope, hold_request_stats_detail, hole_stats_of, islands_endpoint, makeRegionEndpoint, mark_personal, record_request_stats, render_region_html, request_local, request_scope, request_stats_of, scanRegions, set_batch_hole_listener, want_request_stats };

package/dist/internal.d.ts

@@ -10,5 +10,4 @@ import { __tag_context } from "./context-bridge.js";
 import { og_portable } from "./region-snippet.js";
 import { og_html_region, prebaked_region } from "./region.js";
 import Region from "./Region.svelte";
-import NestedProvider from "./NestedProvider.svelte";
-export { NestedProvider, Region, __og_$, __og_boundary, __og_source, __og_store, __register_fn, __register_store_factory, __register_transportable, __tag_context, configure_boundary, documentIsCsrTrue, isNested, mark_store, og_entry_hydrate, og_entry_unmount, og_html_region, og_portable, prebaked_region, setNested };
+export { Region, __og_$, __og_boundary, __og_source, __og_store, __register_fn, __register_store_factory, __register_transportable, __tag_context, configure_boundary, documentIsCsrTrue, isNested, mark_store, og_entry_hydrate, og_entry_unmount, og_html_region, og_portable, prebaked_region, setNested };

package/dist/internal.js

@@ -10,5 +10,4 @@ import { __tag_context } from "./context-bridge.js";
 import { og_portable } from "./region-snippet.js";
 import { og_html_region, prebaked_region } from "./region.js";
 import Region from "./Region.svelte";
-import NestedProvider from "./NestedProvider.svelte";
-export { NestedProvider, Region, __og_$, __og_boundary, __og_source, __og_store, __register_fn, __register_store_factory, __register_transportable, __tag_context, configure_boundary, documentIsCsrTrue, isNested, mark_store, og_entry_hydrate, og_entry_unmount, og_html_region, og_portable, prebaked_region, setNested };
+export { Region, __og_$, __og_boundary, __og_source, __og_store, __register_fn, __register_store_factory, __register_transportable, __tag_context, configure_boundary, documentIsCsrTrue, isNested, mark_store, og_entry_hydrate, og_entry_unmount, og_html_region, og_portable, prebaked_region, setNested };

package/dist/keep-fallback.d.ts

@@ -1,6 +1,4 @@
 import { KEEP_FALLBACK_HTML } from "./keep-fallback-marker.js";
-/** The message a misplaced `keepFallback()` fails with (a real error, not the signal). */
-export declare const KEEP_FALLBACK_INLINE_MESSAGE: string;
 export declare class KeepFallbackSignal extends Error {
   constructor();
 }

package/dist/keep-fallback.js

@@ -1,4 +1,5 @@
 import { isHoleInline } from "./context.js";
+import { OgygiaError, line } from "./messages/island.js";
 import { KEEP_FALLBACK_HTML } from "./keep-fallback-marker.js";
 // src/keep-fallback.ts
 /**
@@ -12,11 +13,9 @@ import { KEEP_FALLBACK_HTML } from "./keep-fallback-marker.js";
 * only: it throws a branded signal the handle recognises; in the browser a hole never renders.
 */
 const KEEP = Symbol.for("ogygia.keep-fallback");
-/** The message a misplaced `keepFallback()` fails with (a real error, not the signal). */
-const KEEP_FALLBACK_INLINE_MESSAGE = "[ogygia] keepFallback() ran inside the PAGE render: this server island is nested inside a `wake` island, where `render: \"deferred\"` is ignored and its component renders inline — nothing catches the signal there and its fallback never shows. Move the island out of the enclosing island (into the page, a layout, or a lake), or drop keepFallback() from a component that can render inline.";
 var KeepFallbackSignal = class extends Error {
 	constructor() {
-		super("[ogygia] keepFallback(): the page fallback stands");
+		super(line("keep_fallback_signal"));
 		this.name = "KeepFallback";
 		Object.defineProperty(this, KEEP, { value: true });
 	}
@@ -29,11 +28,11 @@ function keepFallback() {
 	try {
 		inline = isHoleInline();
 	} catch {}
-	if (inline) throw new Error(KEEP_FALLBACK_INLINE_MESSAGE);
+	if (inline) throw new OgygiaError("keep_fallback_inline");
 	throw new KeepFallbackSignal();
 }
 /** Did a hole render end with {@link keepFallback}? (the handle's catch reads this) */
 function is_keep_fallback(e) {
 	return !!e && typeof e === "object" && e[KEEP] === true;
 }
-export { KEEP_FALLBACK_HTML, KEEP_FALLBACK_INLINE_MESSAGE, KeepFallbackSignal, is_keep_fallback, keepFallback };
+export { KEEP_FALLBACK_HTML, KeepFallbackSignal, is_keep_fallback, keepFallback };

package/dist/live-transport.js

@@ -3,6 +3,7 @@ import { register_snippet_kind } from "./region-snippet.js";
 import { register_derived_kind, register_store_kind } from "./store-transport.js";
 import { register_fn_kind } from "./fn-transport.js";
 import { REF_WIRE_KEY, mint, register_kind, resolve } from "./ref.js";
+import { OgygiaError } from "./messages/island.js";
 // src/live-transport.ts
 /**
 * Transportable objects — `static [import.meta.og.wire]` codecs, as the hub's WIRE kind.
@@ -78,7 +79,7 @@ function codec_of(cls) {
 }
 function class_for(tag) {
 	const cls = tag === void 0 ? void 0 : wire_registry().classes.get(tag);
-	if (cls === void 0) throw new Error(`[ogygia] cannot revive transportable "${tag}": its class is not loaded on this side. The island must import the class as a VALUE (not \`import type\`) so its codec travels with the island's bundle.`);
+	if (cls === void 0) throw new OgygiaError("transportable_class_missing", { tag: String(tag) });
 	return cls;
 }
 /** The hub kind: `[og.wire]` class instances. Identity/reunify/Keep live in the hub. */
@@ -92,7 +93,7 @@ function register_wire_kind() {
 		encode(value) {
 			const cls = value.constructor;
 			const tag = wire_registry().tags.get(cls);
-			if (tag === void 0) throw new Error(`[ogygia] class "${cls.name ?? "?"}" has a [import.meta.og.wire] codec but was never registered. Transportable classes must be declared in a module the ogygia vite plugin transforms (an \`export class\` in your app source, not node_modules or a dynamic eval).`);
+			if (tag === void 0) throw new OgygiaError("transportable_unregistered", { name: cls.name ?? "?" });
 			return {
 				t: tag,
 				d: codec_of(cls).encode(value)

package/dist/messages/build.d.ts

@@ -0,0 +1,585 @@
+import { MessagesOf } from "./define.js";
+/** Retired `ogygia({ … })` keys, each with its new spelling: the config check throws
+ *  `option_retired` for any of them (a legacy key that silently did nothing would un-tune real
+ *  apps). */
+export declare const RETIRED_OPTIONS: Record<string, string>;
+/** The errors: `throw new OgygiaError(code, args)`. */
+export declare const BUILD_ERRORS: {
+  macro_store_misuse: {
+    text: (a: {
+      file: string;
+      line: number;
+      problem: string;
+    }) => string;
+    details: () => string;
+  };
+  macro_dollar_misuse: {
+    text: (a: {
+      file: string;
+      line: number;
+      problem: string;
+    }) => string;
+    details: () => string;
+  };
+  macro_wire_misuse: {
+    text: (a: {
+      file: string;
+      line: number;
+      problem: string;
+    }) => string;
+    details: () => string;
+  };
+  macro_source_misuse: {
+    text: (a: {
+      file: string;
+      line: number;
+      problem: string;
+    }) => string;
+    details: () => string;
+  };
+  macro_bake_arity: {
+    text: (a: {
+      file: string;
+      line: number;
+    }) => string;
+    details: () => string;
+  };
+  macro_bake_not_function: {
+    text: (a: {
+      file: string;
+      line: number;
+    }) => string;
+    details: () => string;
+  };
+  macro_bake_eval_failed: {
+    text: (a: {
+      file: string;
+      reason: string;
+    }) => string;
+    details: () => string;
+  };
+  macro_bake_not_serializable: {
+    text: (a: {
+      file: string;
+      line: number;
+      reason: string;
+    }) => string;
+    details: () => string;
+  };
+  kit_config_not_literal: {
+    text: (a: {
+      file: string;
+      key: string;
+    }) => string;
+    details: () => string;
+  };
+  island_import_unresolved: {
+    text: (a: {
+      specifier: string;
+      host: string;
+    }) => string;
+    details: () => string;
+  };
+  call_arg_not_literal: {
+    text: (a: {
+      call: string;
+      got: string;
+    }) => string;
+    details: () => string;
+  };
+  call_arg_interpolated: {
+    text: (a: {
+      call: string;
+    }) => string;
+    details: () => string;
+  };
+  call_arg_in_expression: {
+    text: (a: {
+      call: string;
+      near: string;
+    }) => string;
+    details: () => string;
+  };
+  import_key_invalid: {
+    text: (a: {
+      role: string;
+      got: string;
+    }) => string;
+    details: () => string;
+  };
+  import_keys_not_distinct: {
+    text: () => string;
+    details: () => string;
+  };
+  region_value_not_raw: {
+    text: (a: {
+      host: string;
+      key: string;
+    }) => string;
+    details: () => string;
+  };
+  wake_strategy_unknown: {
+    text: (a: {
+      host: string;
+      key: string;
+      value: string;
+    }) => string;
+    details: () => string;
+  };
+  generated_module_relative_import: {
+    text: (a: {
+      host: string;
+      specifier: string;
+    }) => string;
+    details: () => string;
+  };
+  region_import_invalid: {
+    text: (a: {
+      host: string;
+      names: string;
+      problem: string;
+    }) => string;
+    details: () => string;
+  };
+  as_region_invalid: {
+    text: (a: {
+      host: string;
+      name: string;
+      problem: string;
+    }) => string;
+    details: () => string;
+  };
+  region_children_not_portable: {
+    text: (a: {
+      host: string;
+      tag: string;
+      server: boolean;
+    }) => string;
+    details: () => string;
+  };
+  region_dotted_tag: {
+    text: (a: {
+      host: string;
+      tag: string;
+      import: string;
+    }) => string;
+    details: () => string;
+  };
+  dynamic_region_import: {
+    text: (a: {
+      host: string;
+      keys: string;
+      wake_key: string;
+      render_key: string;
+      preset_key: string;
+    }) => string;
+    details: () => string;
+  };
+  region_import_no_specifier: {
+    text: (a: {
+      host: string;
+      name: string;
+      held: boolean;
+    }) => string;
+    details: () => string;
+  };
+  snippet_reads_dollar_props: {
+    text: (a: {
+      host: string;
+      snippet: string;
+      name: string;
+    }) => string;
+    details: () => string;
+  };
+  held_fetch_without_render: {
+    text: (a: {
+      host: string;
+      fetch_key: string;
+      render_key: string;
+      wake_key: string;
+      value: string;
+    }) => string;
+    details: () => string;
+  };
+  held_render_live: {
+    text: (a: {
+      host: string;
+      render_key: string;
+    }) => string;
+    details: () => string;
+  };
+  held_render_unknown: {
+    text: (a: {
+      host: string;
+      render_key: string;
+      value: string;
+    }) => string;
+    details: () => string;
+  };
+  held_hole_timed_twice: {
+    text: (a: {
+      host: string;
+      render_key: string;
+      fetch_key: string;
+      wake_key: string;
+      fetch: string;
+      wake: string;
+    }) => string;
+    details: () => string;
+  };
+  held_fetch_not_timing: {
+    text: (a: {
+      host: string;
+      fetch_key: string;
+      value: string;
+    }) => string;
+    details: () => string;
+  };
+  held_marker_mixed: {
+    text: (a: {
+      host: string;
+      name: string;
+      region_key: string;
+      wake_key: string;
+      render_key: string;
+      fetch_key: string;
+    }) => string;
+    details: () => string;
+  };
+  option_retired: {
+    text: (a: {
+      option: string;
+    }) => string;
+    details: () => string;
+  };
+  preset_empty: {
+    text: (a: {
+      name: string;
+    }) => string;
+    details: () => string;
+  };
+  preset_key_unknown: {
+    text: (a: {
+      name: string;
+      key: string;
+      allowed: string;
+    }) => string;
+    details: () => string;
+  };
+  max_page_age_invalid: {
+    text: (a: {
+      value: string;
+    }) => string;
+    details: () => string;
+  };
+  secret_too_short: {
+    text: (a: {
+      min_bytes: number;
+    }) => string;
+    details: () => string;
+  };
+  kit_remote_src_missing: {
+    text: () => string;
+    details: () => string;
+  };
+  package_files_not_array: {
+    text: (a: {
+      package: string;
+      got: string;
+    }) => string;
+    details: () => string;
+  };
+  package_files_escapes: {
+    text: (a: {
+      package: string;
+      entry: string;
+    }) => string;
+    details: () => string;
+  };
+  plugin_without_ogygia: {
+    text: (a: {
+      plugin: string;
+    }) => string;
+    details: () => string;
+  };
+  plugin_factory_not_called: {
+    text: () => string;
+    details: () => string;
+  };
+  plugin_after_sveltekit: {
+    text: (a: {
+      plugin: string;
+    }) => string;
+    details: () => string;
+  };
+  plugin_name_missing: {
+    text: () => string;
+    details: () => string;
+  };
+  plugin_listed_twice: {
+    text: (a: {
+      plugin: string;
+    }) => string;
+    details: () => string;
+  };
+  plugin_realm_not_location: {
+    text: (a: {
+      plugin: string;
+      realm: string;
+    }) => string;
+    details: () => string;
+  };
+  plugin_options_not_json: {
+    text: (a: {
+      plugin: string;
+    }) => string;
+    details: () => string;
+  };
+  plugin_realm_not_file: {
+    text: (a: {
+      plugin: string;
+      realm: string;
+      location: string;
+    }) => string;
+    details: () => string;
+  };
+  plugin_package_unresolved: {
+    text: (a: {
+      plugin: string;
+      root: string;
+    }) => string;
+    details: () => string;
+  };
+  route_config_key_invalid: {
+    text: (a: {
+      plugin: string;
+      key: string;
+    }) => string;
+    details: () => string;
+  };
+  route_config_key_claimed: {
+    text: (a: {
+      key: string;
+      owner: string;
+      plugin: string;
+    }) => string;
+    details: () => string;
+  };
+  plugin_macro_name_invalid: {
+    text: (a: {
+      plugin: string;
+      name: string;
+    }) => string;
+    details: () => string;
+  };
+  plugin_macro_claimed: {
+    text: (a: {
+      name: string;
+      owner: string;
+      plugin: string;
+    }) => string;
+    details: () => string;
+  };
+  page_modules_not_absolute: {
+    text: (a: {
+      plugin: string;
+      file: string;
+    }) => string;
+    details: () => string;
+  };
+  request_event_server_only: {
+    text: () => string;
+    details: () => string;
+  };
+};
+/** The warnings: `warn(code, args, ...rest)`; and, at its end, the build's reports, which print
+ *  their `line(code, args)` at info level. */
+export declare const BUILD_WARNINGS: {
+  macro_store_returns_non_store: {
+    text: (a: {
+      file: string;
+      line: number;
+    }) => string;
+    details: () => string;
+  };
+  scoped_css_failed: {
+    text: (a: {
+      file: string;
+      reason: string;
+    }) => string;
+    details: () => string;
+  };
+  package_marks_undeclared: {
+    text: (a: {
+      file: string;
+    }) => string;
+    details: () => string;
+  };
+  island_context_unprovided: {
+    text: (a: {
+      file: string;
+      key: string;
+    }) => string;
+    details: () => string;
+  };
+  content_leaked_to_client: {
+    text: (a: {
+      count: number;
+      chunk: string;
+      modules: string;
+    }) => string;
+    details: () => string;
+  };
+  region_host_skipped: {
+    text: (a: {
+      file: string;
+      reason: string;
+      at: string;
+    }) => string;
+    details: () => string;
+  };
+  hole_wake_deprecated: {
+    text: (a: {
+      host: string;
+      said?: string;
+      render_key: string;
+      wake_key: string;
+      fetch_key: string;
+      value: string;
+    }) => string;
+    details: () => string;
+  };
+  snippet_store_snapshot: {
+    text: (a: {
+      host: string;
+      snippet: string;
+      store: string;
+      at: string;
+    }) => string;
+    details: () => string;
+  };
+  snippet_store_unverified: {
+    text: (a: {
+      host: string;
+      snippet: string;
+      store: string;
+      at: string;
+    }) => string;
+    details: () => string;
+  };
+  snippet_captures_store: {
+    text: (a: {
+      host: string;
+      snippet: string;
+      store: string;
+    }) => string;
+    details: () => string;
+  };
+  barrels_component_skipped: {
+    text: (a: {
+      file: string;
+      reason: string;
+      at: string;
+    }) => string;
+    details: () => string;
+  };
+  sass_missing: {
+    text: () => string;
+    details: () => string;
+  };
+  scss_compile_failed: {
+    text: (a: {
+      file: string;
+      reason: string;
+    }) => string;
+    details: () => string;
+  };
+  ts_strip_failed: {
+    text: (a: {
+      file: string;
+      reason: string;
+    }) => string;
+    details: () => string;
+  };
+  optimize_deps_includes_ogygia: {
+    text: (a: {
+      specifiers: string;
+      count: number;
+    }) => string;
+    details: () => string;
+  };
+  island_handoff_write_failed: {
+    text: () => string;
+    details: () => string;
+  };
+  package_files_missing: {
+    text: (a: {
+      package: string;
+      entry: string;
+    }) => string;
+    details: () => string;
+  };
+  kit_config_unreadable: {
+    text: (a: {
+      file: string;
+      routes: string;
+      out: string;
+      reason: string;
+    }) => string;
+    details: () => string;
+  };
+  island_chunks_not_emitted: {
+    text: (a: {
+      count: number;
+    }) => string;
+    details: () => string;
+  };
+  flags_manifest_written: {
+    text: (a: {
+      count: number;
+    }) => string;
+    details: () => string;
+  };
+  page_seed_report: {
+    text: (a: {
+      islands: number;
+      pinned: number;
+      keys: number;
+      unpinned: number;
+    }) => string;
+    details: () => string;
+  };
+  barrels_report: {
+    text: (a: {
+      importers: string;
+      files: string;
+      imports: string;
+      names: string;
+      barrels: string;
+      seconds: string;
+    }) => string;
+    details: () => string;
+  };
+  barrels_report_none: {
+    text: (a: {
+      files: string;
+      seconds: string;
+    }) => string;
+    details: () => string;
+  };
+  barrels_rewrite: {
+    text: (a: {
+      file: string;
+      names: string;
+      barrel: string;
+      leaves: string;
+    }) => string;
+    details: () => string;
+  };
+};
+type Build = MessagesOf<typeof BUILD_ERRORS, typeof BUILD_WARNINGS>;
+export declare const OgygiaError: Build["OgygiaError"];
+export declare const warn: Build["warn"];
+/** A code's line as a string, for a logger that takes one (Rollup's `this.warn`). */
+export declare const line: Build["line"];
+export {};