ogygia

AllMajorMinorPatch Hide pre-releases
0.14.0 minor

ogygia

Minor Changes

  • #508 eae1add Thanks @PuruVJ! - Breaking: the barrel rewrite is a plugin now, barrels() from @ogygia/barrels, listed beside ogygia() (plugins: [ogygia(), barrels(), sveltekit()]) with the same options. Use it in place of ogygia({ barrels }), which is a build error (barrels_option_removed) that names it; debarrel(), DebarrelOptions and DebarrelMatcher are gone from ogygia/vite.
  • #532 b011a71 Thanks @PuruVJ! - - @ogygia/core, ogygia: breaking (internal paths only): ogygia/internal/region-core is gone, and ogygia/internal/compiler no longer exports set_parser or takes a pathModule option; they existed only to run the compiler in a browser. Import region and isRegion from ogygia. Build output is unchanged.
  • #1665 096de6c Thanks @PuruVJ! - Breaking: shipping only the page.data your islands read is a plugin now, dataShake() from @ogygia/data-shake/vite, listed beside ogygia() (plugins: [ogygia(), dataShake(), sveltekit()]). Without it every island that reads the page gets all of page.data, and every server hole looks the page up.
  • #610 e07f6e4 Thanks @PuruVJ! - breaking: ogygia depends only on @ogygia/core and @ogygia/compiler, and no ogygia/* path forwards to a plugin package. ogygia/insights is removed: install @ogygia/insights and import from it (same names).
  • #693 b0a4f0e Thanks @PuruVJ! - region(C, props, { version }) in @ogygia/core: when two answers for the same held region reach the browser (two commands that both return it), the one with the newer data version stays on screen, whichever arrived last.
  • #528 9201d45 Thanks @PuruVJ! - - @ogygia/core, ogygia: breaking: the internal internal/compiler-browser and internal/compiler-browser-full import paths are gone. The compiler runs in Node only; use @ogygia/core/internal/compiler there. - @ogygia/cli: breaking: the ogygia mcp server no longer has the ogygia_observatory tool; the Observatory it linked to is gone. - @ogygia/content: its macros and markdown pipeline read the compiler through @ogygia/core/internal/compiler and Node's own fs, path and crypto.
  • #1707 b20ae04 Thanks @PuruVJ! - - breaking: an app's own pass over the HTML ogygia sends is the new @ogygia/rewrite package. ogygia.handle({ transform }) now throws handle_transform_moved; list rewrite() (from @ogygia/rewrite/vite, no options) beside ogygia(), and put a rewrite() handle before ogygia.handle() in sequence(). ogygia/markup is removed, and scanRegions / liftRegions / restoreRegions leave ogygia/server. - @ogygia/rewrite: rewrite({ match, render }) renders only the outermost custom elements match picks (a tag prefix, a list of tags, or a test), in one render(elements, ctx) call per chunk of the page and per region answer, so a streamed page keeps streaming and its later chunks are rendered too. - @ogygia/rewrite: each element render gets has ogygia's marks numbered from 0, so a cache can key on its bytes; equal elements in one call are rendered once. - @ogygia/rewrite: ctx carries kind, csr, url, event and signal, an AbortSignal that fires when the request is cancelled. - @ogygia/rewrite: a render's sheets go out once per key per response, into the head while it is open and inline before the first element that needs them after. - @ogygia/rewrite: a failed batch is retried one element at a time; an element that still fails, drops ogygia's marks, or returns HTML that does not close what it opens goes out as ogygia rendered it, with a warning in every build (rewrite_element_failed, rewrite_marks_lost), never thrown. - @ogygia/rewrite: an element split across streamed chunks goes out unrendered, said in dev (rewrite_element_split). - @ogygia/rewrite: several rewrites in sequence() run in order on one marking of the HTML; one listed after ogygia.handle() throws rewrite_after_ogygia, and a rewrite without the plugin throws rewrite_plugin_missing. - @ogygia/rewrite: rewrite({ page }) rewrites the whole document (held until its last chunk) or region answer, says rewrite_page_failed when it throws (thrown in dev), and has .html(str) for a plain string. - @ogygia/rewrite: .check(html, { kind, csr }) runs the whole round trip on one piece of markup for a test, listing failures and, with a DOM, every restored element that differs from Svelte's. - @ogygia/rewrite: a page where nothing was restored ships no restorer, and each streamed chunk that restored something ends with one short restore call. - @ogygia/devtools: the profiler reads a page's regions itself and no longer depends on @ogygia/rewrite.
  • #516 368b1da Thanks @PuruVJ! - - @ogygia/core, ogygia: breaking: SharedState is no longer exported from ogygia or @ogygia/core. Import it from @ogygia/federation/shared instead; it works the same. - @ogygia/federation: SharedState (state shared across separate builds on one page) is exported from @ogygia/federation/shared.

Patch Changes

  • #533 49ff074 Thanks @PuruVJ! - - @ogygia/compiler: new package, ogygia's compiler and its Vite plugin: @ogygia/compiler (the compiler), @ogygia/compiler/vite (ogygia(), definePlugin) and @ogygia/compiler/ids. It uses core only through @ogygia/core/contract; core never depends on it. - @ogygia/core: breaking: the @ogygia/core/vite, @ogygia/core/internal/compiler and @ogygia/core/internal/compiler-ids import paths are gone. Import from ogygia/vite (or @ogygia/compiler/vite), @ogygia/compiler and @ogygia/compiler/ids instead; the names are the same. - @ogygia/core: the types of the ogygia:* virtual modules and the build's switches are named in core (@ogygia/core/contract), so core's own types no longer reach into the compiler. - ogygia: ogygia/vite, ogygia/internal/compiler and ogygia/internal/compiler-ids re-export @ogygia/compiler; apps change nothing. - @ogygia/barrels, @ogygia/cli, @ogygia/content, @ogygia/devtools, @ogygia/federation, @ogygia/flags, @ogygia/postrender, @ogygia/router: they take definePlugin and the compiler from @ogygia/compiler, a new peer dependency (ogygia brings it).
  • #576 7be0138 Thanks @PuruVJ! - The head's duplicate-link pass reads each <link> attribute as HTML does, so a stylesheet or preload hint whose URL has an apostrophe is no longer dropped, and data-rel / data-href no longer count as rel / href.
  • #878 08fd293 Thanks @PuruVJ! - A hole answer's region URLs, island graph and region CSS are read as a browser reads the tags: a region or sheet inside an HTML comment is left alone, and upper-case tags, single-quoted values and a quoted > no longer hide one.
  • #577 13aa062 Thanks @PuruVJ! - A $page.data promise nested more than 65 levels deep, or inside a cyclic value, now streams into regions like any other: before, it was left in the seed, the page failed to serialize it, and a rejection went unhandled.
  • #577 13aa062 Thanks @PuruVJ! - On a router (non-navigate) request, $page.data with promises keeps its key order in the seed; before, keys came in the order their values settled.

Updated dependencies: @ogygia/[email protected], @ogygia/[email protected]

0.13.0 minor

ogygia

Patch Changes

  • #184 1767110 Thanks @PuruVJ! - Packages declare sideEffects (only their .css files run on import), so bundlers drop the modules an app never uses.

Updated dependencies: @ogygia/[email protected]

0.12.0 minor

ogygia

Updated dependencies: @ogygia/[email protected]

0.11.0 minor

ogygia

Minor Changes

  • #64 3bff299 Thanks @PuruVJ! - Breaking: features move into plugin packages, each a Vite plugin listed beside ogygia() and before sveltekit() (plugins: [ogygia(), flags(), sveltekit()]; out of order, or without ogygia(), the build says so): flags (@ogygia/flags, was ogygia/flag), frozen pages (@ogygia/freeze, was ogygia/freeze and ogygia({ freeze })), fragment federation (@ogygia/federation, was ogygia/federation; mount moved from ogygia/router) and content (@ogygia/content, was ogygia/content* and ogygia({ content }); ogygia/content/server is @ogygia/content/server, and the svelte config's ogygia.preprocess() / ogygia.extensions() are preprocess() / extensions() from @ogygia/content/vite), each with its factory from <package>/vite. The devtools dock and the profiler move to @ogygia/devtools: ogygia({ devtools, profiler }) becomes devtools({ dock, profiler }), ogygia/profiler* imports become @ogygia/devtools/profiler* (@ogygia/devtools/profiler, /profiler/client, /profiler/storage, /profiler/storage/sqlite|redis|postgres), and the event layer ogygia/devtools exported is ogygia/events (with ogygia/insights beside it). ogygia/testing is @ogygia/testing. The server router is @ogygia/router (was ogygia/router; list router() from @ogygia/router/vite so its pages' CSS links — dev warns when a page renders without it), and its typed fetch client ogygia/router/client is @ogygia/router/api (POST(schema, …) endpoints now type-check, and $infer carries their verbs). An endpoint handler's c.params is now typed strictly by its table key, at the top level, inside layout() tables and behind when(), and its return type reaches api(); GET<'/p'>(fn) is gone (a handler written outside its table checks with satisfies Handler<'/p'>). A plugin is made with definePlugin({ name, server, client, options, build }) from ogygia/vite, which returns a Vite plugin; its server and browser halves are named by location (server: import.meta.resolve('./server.ts')) instead of found by package export name. The command line lives in @ogygia/cli (npx ogygia … keeps working: ogygia's bin runs it). ogygia is now a thin package over @ogygia/core; plugins depend on @ogygia/core. ogygia()'s region options sit at its root: regions.visible, regions.presets, regions.ttl and regions.maxPageAge are visible, presets, ttl and maxPageAge. @ogygia/tsdown-plugin-svelte turns a component's relative ./x.ts imports into ./x.js in the shipped component and its types, so sources can import with real extensions. Fixed: a Kit-hydrated (csr = true) page could link the stylesheets of every region in the app, depending on how the bundler grouped the server build (newer rolldown, under vite 8.3, did).

Patch Changes

  • #77 fd47ef6 Thanks @PuruVJ! - Breaking (plugin API): a plugin's per-route setting is now a key inside Kit's own config page option — b.routeConfig(key) / ctx.routeConfig(key) replace b.routeOption(name) / ctx.routeOption(name), nothing is stripped from route files any more, and the server router's page() / layout() / routes() take config instead of freeze.
  • #80 5164260 Thanks @PuruVJ! - Server router: a page's load and actions (bare, or through load() / action()) read c.params typed by their table key, as endpoints do, and a params or search schema now types c.params / c.search with its output.
  • #74 1d97ecc Thanks @PuruVJ! - Types: import.meta.og.source is declared, instrument's attrs callback may name fewer arguments than the function takes, and loose anys in public types are now unknown (OgygiaDriver.evaluate, mount()'s page data, the router's component type); the profiler timeline's blocks are buttons.

Updated dependencies: @ogygia/[email protected]

0.10.0 minor

ogygia

Minor Changes

  • #33 6f48146 Thanks @PuruVJ! - Breaking: a render: 'deferred' hole's timing is the new fetch key (with { render: 'deferred', fetch: 'visible' }); pairing it with wake fails the build with the line to write, and wake now only means when an island's JS runs.
0.9.0 minor

ogygia

Minor Changes

  • #51 c0a7793 Thanks @PuruVJ! - Raised minimums to the versions ogygia is tested on: svelte ^5.56.8, playwright and @playwright/test ^1.62.0 (for ogygia/testing), and the magic-string dependency ^1.4.5.
  • #51 c0a7793 Thanks @PuruVJ! - SvelteKit 3 support, alongside SvelteKit 2: builds no longer fail on refreshAll (#37), islands on csr=true pages get Kit's page, the $page store no longer uses the removed $app/stores, custom-type remote arguments encode on csr=false pages, and a remote form in an island on a csr=true page no longer reloads the page.
  • #51 c0a7793 Thanks @PuruVJ! - The vite peer is ^8.2.4: Vite 8, from the first version past its published advisories. SvelteKit 2 and SvelteKit 3 both run on it.

Patch Changes

  • #51 c0a7793 Thanks @PuruVJ! - devalue is required at ^5.9.3, the first version with the fixes for its published advisories.
0.8.0 minor

ogygia

Breaking changes

  • Flags and experiments collapse onto one primitive, flag(); experiment, layer, allowOverrides, onExposure, batchExposures, .bucket, .on and routes({ experiments }) are removed. Declare with a shape (flag('x'), flag('x', 10), flag('x', fn), flag('x', { control: 80, bold: 20 })), read by calling it (checkout(c)), branch with flag.pick(map) / flag.pick(c, map), read payloads with flag.value(c), configure once with decide({ source, overrides, exposure, batch }), and pre-decide in a route-only shell with routes({ flags: [...] }).
  • kitMount is now mount.kit.
  • ogygia/rewrite is now ogygia/markup (no alias; change the import).
  • transformHole is removed; ogygia.handle({ transform }) covers region answers and documents alike.
  • regionTtl is now regions: { ttl }.
  • regions.preload is removed; each island's whole graph preloads at its wake.

Added

  • One load scheduler for every download ogygia starts: island code and background work wait for the page's fetchpriority="high" resources (or the first input, or a 2.5 s cap), so islands no longer compete with the hero image.
  • Holes and regions a remote query / command renders see their page's page.url, route, params and server-load page.data (looked up through Kit, only when read), so a server-rendered header can refresh in place ("A lake that can refresh").
  • One DOM ownership model for every ogygia DOM writer — who writes inside an element, its attributes, its children's order and their existence — so a web component's own DOM survives repairs, hole answers and navigations.
  • SvelteKit 3 support, on the APIs late Kit 2 and Kit 3 share.
  • The SSR profiler, ogygia({ profiler }): CPU, network, heap and the browser half of a visit, with a 0–100 page score and on-demand mode (profiler: { onDemand: true }).
  • Devtools, ogygia({ devtools }): an island-graph dock with Page, Hydration, Record, Bytes and Profiler tabs, every vital explained down to the island and line responsible.
  • ogygia/testing: the devtools and the profiler as test primitives.
  • ogygia/router: Kit's routing, programmatic and fully typed; document() renders a complete page from a handle.
  • ogygia/internal/compiler: the compiler as a standalone, bundler-agnostic engine.
  • Frozen pages, ogygia({ freeze: true }): a page renders once on write and is served as stored bytes until a publish thaws it (with edge stitching for per-visitor holes).
  • Fragment federation: one federate(), a remote fragment is a region, and a publish thaws it everywhere.
  • The Ref hub: one identity layer for live classes, stores, functions, snippets and held regions that cross an island boundary.
  • Transportable values: everything devalue rejects now crosses through one serialization seam; unbridgeable values fail at discovery, not in production.
  • A navigation moves regions instead of resetting them (state-delta reconciler); opt-in server-delta navigation renders only what changed (router: { serverDelta: true }).
  • ogygia.handle({ transform }): server transforms that may reshape Svelte-owned markup, restored in the browser before hydration.
  • ogygia/markup and scanRegions(html): the region round trip for an app that runs a third-party SSR pass over the page.
  • On-demand server islands: render: 'deferred' + wake: 'interaction' fetch nothing until the visitor shows intent.
  • prefetch warms a deferred hole's HTML before it swaps.
  • keepFallback(): a server island's answer that keeps the page's fallback.
  • requestEvent(): Kit's RequestEvent inside a server island.
  • isOgygiaPage(): tells shared code which world it runs in.
  • A lake survives Kit hydration on a csr = true page.
  • ogygia({ barrels }): barrel imports become leaf imports at transform time.
  • Zero-config library islands: a dependency declares its island roots in its own package.json.
  • The app's hooks.client.ts init runs on csr = false pages.
  • Server islands ship their component tree's CSS; region CSS obeys Kit's inlineStyleThreshold.
  • Lazy islands download at background priority, so they never fight the first paint.
  • Accessible SPA navigation (focus, announcements) and a reason on every page fetch.
  • when(): flags gate routes, and pick chooses infrastructure; OpenFeature interop (ogygia/flag/openfeature).
  • The build warns when island code reads a context nothing bridges.
  • A recovered or healed island says why, and the discard warning names what Svelte threw.
  • The ogygia MCP server grows to eleven tools, and the bundled AI skill is rewritten.

Changed

  • A <Region of={promise}> waits where the render can: awaited in the server render under Svelte's async mode, streamed as a late region on the server router, or resolved after hydration otherwise.
  • Islands inside a region's HTML always wake on the runtime, csr = true pages included.
  • The page seed ships only when an island reads it, and only the page.data keys the page's islands read.
  • The remote seed ships only for remotes an island on the page can call.
  • Island props reference the page seed instead of copying it, and ride at the end of the body with the module-preload hints.
  • Island hints are fetchpriority="low"; island wakes start after the page has painted.
  • The boot never loads Svelte and is four files fetched in one round trip; the runtime goes right before the page's own JavaScript.
  • Duplicate stylesheet links are dropped.
  • HTML is byte-identical across renders (window-aligned capability expiry, per-request slot ids).
  • The server request path is one request store, one document pass and one walk, and stops allocating per item.
  • A slow or hung page can no longer wedge the profiler or the site, and recordings coordinate across processes.
  • The Vite plugin is a compiler, and region rendering is region-granular.
  • rolldown is no longer a dependency: the compiler parses and bundles through the app's Vite, keeping its 16 MB native binary out of production installs.

Fixed

  • Island entries on pages below the root no longer 404 in builds (Kit's asset() form comes from the build's Kit version).
  • A region moved by another script keeps its in-flight fetch and its woken island.
  • Restored shadow roots keep their sheets across a router navigation.
  • A preloaded load hole stays out of the batch instead of downloading twice.
  • Region URLs are pinned to their page, there is one region per hole across path depths, and a navigated island arrives whole in one swap.
  • A registry's plain imports keep their CSS on csr = false pages; an island inside an island links its own CSS; held regions keep inline sheets.
  • A kept island adopts its server DOM instead of discarding it on every load.
  • An island with children has the same fingerprint and bytes on every render.
  • An island edited while it slept hydrates from its own server markup instead of re-rendering.
  • A hole answer that is not the region's (a redirect, a whole document) is refused.
  • A deferred hole survives Kit rebuilding a client-on document, and outlives a CDN-cached document.
  • A hole's answer morphs over its fallback on every schedule, keeping a web component's attributes and state, unfocused edited fields, and focus visible to assistive tech.
  • Region and hole HTML is parsed aware of declarative shadow DOM.
  • A lake with no island host survives Kit giving up on the document, and a lake's island with props hydrates on a csr = true page.
  • An error page under a csr = false page renders as the Kit-hydrated document it is.
  • A csr = true route that imports a block registry no longer links every block's CSS and chunk, and a csr = false page links only the island CSS it renders.
  • Island entries and the runtime are content-hashed, so a deploy never runs the last build's island code.
  • The runtime's hash module is no longer named fingerprint.js, which ad blockers blocked.
  • A visible island's code waits for the viewport, and a scroll-woken island no longer waits on the scheduler.
  • An island of ours on a Kit document waits until Kit has applied its page; requestEvent() answers under Kit's own render too.
  • goto() from an island on a Kit-booted page navigates through Kit, and a script module reached through an app alias gets the island's page.
  • The router keeps a destination page's inline <style> sheets, follows data-sveltekit-reload's grammar, navigates links inside web components in place, corrects the address bar after a server redirect, and keeps the live <body> on a fallback swap.
  • An unkeyed wrapper around an island survives a sibling inserted above it, and lakes restore by DOM position.
  • A layout's csr world derives from the pages it serves, and a csr = true page under a csr = false layout keeps the layout's chrome.
  • kit.files.routes, kit.outDir, appDir and paths.base are honoured everywhere, and route walkers follow symlinks.
  • Island chunks are emitted only for islands the server bundle can reach.
  • Region fingerprints no longer cost 20 ms per island; the profiler is free when it is not profiling.
  • $app/stores $page works inside every ogygia render root, and a server island's page.url is the referring page.
  • On a csr = true page a server island keeps its server-minted endpoint through Kit's hydration, and server-island HTML is absolutized for nested paths.
  • wake: 'interaction' replays the waking click on the next frame, into the deepest target.
  • A wake: 'none' lake in a +layout.svelte ships its scoped CSS, a lake's or island's scoped CSS keeps its Svelte hash, and the fouc-css fallback ships valid CSS.
  • An island inside a server island's ogygiaFallback stays a region, and keepFallback() from an inline-rendered server island fails with the reason.
  • A relative with { wake } import inside a {#snippet}, a forwarded snippet opening with {@const}, and a raw <style lang="scss"> no longer break or silently skip a component.
  • A portable snippet carries its host's style scope, a branded snippet runs in place, and store auto-subscriptions in crossing snippets hoist as snapshots.
  • An island's <svelte:head> survives a head other scripts edited, and an island's page seed follows dynamic imports.
  • The compiler registers only wired transportable classes, and a byte-order-marked source is edited at the right offsets.
  • Freeze: a root prefix clears shared stores, and tag sets keep their longest lifetime.
  • Dev: CSS authored in holes, regions, islands and frozen snippets applies on first load.
  • Dev: every island is a crawl root for Vite's dep scanner, so nothing is discovered late on a cold server.
  • Dev: an installed ogygia runs as one copy in the browser.
  • Dev: a dep re-optimization no longer strands the islands on an open tab.
  • Dev: server islands keep working after an HMR edit of their host file.
  • Dev: toggling a route's csr export refreshes the server's route set.
  • Dev: the nested-island warning no longer crashes SSR.
  • Devtools: the dock is styled in a build and under a CSP that refuses inline styles; a wait for a failing first-screen island is not blamed on ogygia.
  • Profiler: a page that leaks never takes the server down.
  • Profiler: page profiling survives serverless timeouts, and network capture is reliable.
  • Profiler: its renders ask as a page navigation, so streamed pages profile as visitors get them.
  • Profiler: login survives a large cookie jar, and the dev server runs one live profiler per process.
  • Profiler: beacon visits over 64 KB are sent, one beacon per Kit page.
  • Profiler: JSON and .cpuprofile links download, a .ogp moved between machines imports, and the UI ships TS-free templates.

Internal

  • Full TypeScript strict at the library level, with svelte-check in the library check and zero explicit any.
  • oxfmt is the workspace formatter.
  • The per-host csr context cascade is one per-document signal (documentIsCsrTrue()).
  • The on-demand-hole browser tests no longer depend on where the runner's pointer rests, and the weekly upstream watcher gained a baseline leg.
0.7.0 minor

ogygia

Breaking changes

  • Unified cross-island context: <Context of={ctx} value={v}> and ctx.get() are replaced by Svelte's own setContext / getContext, bridged across islands.

Added

  • $page.data (with form, error, status) works inside islands on csr = false pages, streamed load promises included.
  • Drop-in setContext: adopt cross-island context with an import swap.
  • A .ts registry with { wake } binding is mountable.
  • import.meta.og.asRegion(Comp, options): the barrel escape hatch for regions.

Fixed

  • A csr = false subtree under a csr = true ancestor layout islands correctly, also next to a commented-out csr export.
  • ogygia's own injected imports resolve to ogygia's own files, and its components compile under SSR when the app externalizes it.
  • A plain function passed as an island prop errors as a function, not as a snippet.
  • The runtime chunk URL busts on the feature set, not only on source.
  • region() recognizes a wake: attach binding, and keep splits the region dedupe key.
  • Two lakes of the same component restore to the right boxes.
  • A held-region import that is only text (a comment, a template literal) is left alone.

Internal

  • One shared region-option parser, one emitter per region kind, and side-channel emits centralized.
0.6.0 minor

ogygia

Breaking changes

  • Transportable codecs are declared with the wire macro (static [ogygia.wire] = …).
  • The Vite peer is ^7 || ^8 (5 and 6 dropped).
  • Island facades are emitted as og-region.<hash>.js.
  • continuity.speculate is removed; SPA mode never emits speculation rules.

Added

  • The config surface: one grammar per ogygia() subsystem.
  • The site layer, site() in ogygia/content, with shells and bricks (Frame, DocsShell).
  • The import.meta.og.* compile-macro family.
  • Region snippets, region.snippet(): a snippet that crosses the island boundary.
  • Awaitable regions: await region(Component, props) bakes the SSR HTML into the ticket.
  • preference() / preference.switch(): site-wide, no-flash visitor preferences.
  • A Markdown authoring dialect with VitePress-compatible containers.
  • MPA-mode native speculation rules with router: false.
  • Dev guards: mutating a captured host snapshot inside an island warns.
  • ogygia/profiler: a drop-in SSR profiler.

Changed

  • Schema layers merge instead of chaining.
  • Preloading is render-gated end to end.
  • svelte/server and the codec graph no longer reach the client.
  • Router prefetch also warms the incoming page's island modules.

Fixed

  • A directly used <Region> on a csr = true page renders inline in the Kit tree.
  • An island reading $app/stores / $app/state no longer bundles Kit's real client store.
  • Dev soft-CSS HMR is scoped to the page's own sub-app.
  • csr = false apps no longer need a token csr = true route.
  • folder() collections no longer come up empty on the dev server.
  • Childless islands no longer serialize a phantom children slot.
  • Nested islands no longer compile in O(2^depth).
  • import.meta.og.code() in a .svelte host is no longer discarded.
  • An interrupted navigation no longer logs an unhandled "Transition was skipped" rejection.
  • ogygia/content/slot resolves.
  • Shell reactivity and accessibility fixes (version switcher, element overrides, tab groups).

Security

  • A dev-server path traversal in the FOUC CSS virtual is closed.
  • The region batch endpoint rejects oversized bodies (413) before reading them.
  • A full audit of the signed-capability pipeline.
0.5.0 minor

ogygia

Breaking changes

  • The SPA router is global; the <Router/> component is removed.
  • Content render() and renderHtml() are replaced by the entry's body (a region) with get() + <Region>.
  • OgygiaBoundary is now Boundary.
  • ogygiaHandle is now handle, exported from ogygia/server (ogygia/hooks stays as an alias).
  • The default island endpoint is /🏝️.
  • Presets speak the render / wake grammar.
  • @ogygia/content is merged into ogygia.

Added

  • Live regions: LiveView over query.live.
  • Streaming server islands (opt-in, ogygia({ stream: true })).
  • Regions: region(Component, props), a server-chosen renderable placed like data, with dual-face regions and ogygia.transport.
  • content is part of ogygia (ogygia/content).
  • One config surface in ogygia({ … }), and a namespace API (import * as ogygia from 'ogygia').
  • npx ogygia init wires a SvelteKit project in one step.
  • Async regions: <Region of={promise}> owns the full wait.
  • blocks.resolve(tree, registry) resolves a data tree to regions.
  • Per-hole browser cache, maxAge.
  • ogygia.script(): an inline <script> from one plain object.
  • The Fallback<P> type for a deferred island's fallback slot.
  • ogygia/internal/compiler: the pure transform engine.
  • Zero-file all-csr = false apps.

Changed

  • Deferred holes are dynamic by default (Cache-Control: no-store).
  • ogygia.preprocess() is synchronous.
  • Content sources are trimmed; the mdsvex source is markdown().
  • The island endpoint is matched independently of paths.base.

Fixed

  • Router back/forward swaps the page, and prefetched pages are used on click.
  • The $app/state page snapshot reaches islands, and updates after SPA navigation in dev.
  • Lakes survive client hydration.
  • Content-page islands build, and a standalone client build keeps SSR island registrations.
  • Deferred regions hydrate on csr = true pages.
  • Phantom modulepreload chunks are dropped.
  • Island hydration adopts SSR roots in place (no "hero bounce" reflow).
  • No FOUC on the first navigation after a deploy.
  • Held-region CSS styles the page, in dev and on serverless adapters.
  • A live command refresh with only refresh keys works.
  • The morph keeps form state with a keyed diff.
0.4.0 minor

ogygia

Breaking changes

  • Portable island bindings: a marked import rewrites the binding itself to an island wrapper, so <A />, dynamic components and {#each} lists of components work; host children on island call sites are a build error (except ogygiaFallback).

Changed

  • Dedupe is identity-based: the same component and options make one wrapper and one client entry, however many call sites.
  • csr = false client hosts no longer pull island wrappers into Kit's client graph.
  • The plugin uses build.rolldownOptions on Vite 8.
  • Props are real Svelte props into the wrapper, and ogygiaFallback is a normal snippet prop.
  • Lakes are portable wrappers too.

Removed

  • The static-tag-only requirement, and the tag-hoist virtual modules.
0.3.0 minor

ogygia

Changed

  • A hydrate island's entry is an importable module URL in production, and the runtime no longer embeds an app-wide regions map.
  • Each hydrate island is emitted at a deterministic ogygia-island.<id>.js, and SSR renders the same virtual island module the client hydrates.

Fixed

  • Dev: asset() no longer rewrites Vite /@id/… URLs, and props stay the region's immediate sibling.
  • SSR and the client share one virtual tree, ending hydration mismatches on captured props.
0.0.0 minor

ogygia