ogygia

AllMajorMinorPatch Show 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.1 patch

ogygia

Updated dependencies: @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.3 patch

ogygia

Updated dependencies: @ogygia/[email protected]

0.12.2 patch

ogygia

Updated dependencies: @ogygia/[email protected]

0.12.1 patch

ogygia

Updated dependencies: @ogygia/[email protected]

0.12.0 minor

ogygia

Updated dependencies: @ogygia/[email protected]

0.11.5 patch

ogygia

Updated dependencies: @ogygia/[email protected]

0.11.4 patch

ogygia

Updated dependencies: @ogygia/[email protected]

0.11.3 patch

ogygia

Updated dependencies: @ogygia/[email protected]

0.11.2 patch

ogygia

Updated dependencies: @ogygia/[email protected]

0.11.1 patch

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.2 patch

ogygia

Patch Changes

  • #65 83ef60a Thanks @PuruVJ! - The repository now lives at github.com/ogygiajs/ogygia; package links point there.
0.10.1 patch

ogygia

Patch Changes

  • #62 78c63bc Thanks @PuruVJ! - A regions.presets entry takes fetch (a deferred hole's timing): 0.10.0 rejected the key, so no deferred preset with a timing could be written.
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.8 patch

ogygia

Fixed

  • A hole on a page cached across a deploy keeps rendering when its component is unchanged: its URL signs the component it renders (&r=), so a new preset, wake or build-time OGYGIA_SECRET no longer turns it into unknown-id.
0.8.7 patch

ogygia

Added

  • regions.maxPageAge sets the oldest a cached copy of a page can be and still renew its holes (default 8 days, the old fixed window), for a CDN that keeps pages longer without saying so in cache-control.

Fixed

  • A refused hole request says why: its 403 carries x-ogygia-deny (foreign-key, sig, unknown-id, …) and x-ogygia-key, the answering server's key fingerprint, which every hole URL now also carries as &k=.
  • The runtime never retries a 403 from the islands endpoint: the fallback stands, and devtools and the profiler show the reason (or that a proxy, CDN or firewall in front answered).
  • The signing key is read at first use, so an OGYGIA_SECRET the host loads after the server's modules still counts; a production server signing with the build's random key logs it once.
0.8.6 patch

ogygia

Fixed

  • A hole created fresh in the browser (Kit remounting a page whose hydration failed, or an island re-creating a snippet) renders its fallback again, so an on-demand hole whose fallback is its trigger can still be woken (it came back empty in 0.8.5).
  • A hole in a live snippet that an island re-creates fetches again by its identity on any page, not only on a Kit-hydrated one.
0.8.5 patch

ogygia

Changed

  • An island inside a live snippet an island renders follows the nested rule: it renders inline and hydrates with that island.
  • An island sets data-hydrated and fires ogygia:hydrated once the live snippets it renders have hydrated too.
  • A hole nested in an island renders inline as static HTML, like a lake: its component never ships to the browser, and an island inside it wakes on its own.

Fixed

  • A hole inside a live snippet an island renders stays deferred: it ships its fallback, loads on its schedule and is never bundled into the island (it never loaded before).
  • A live snippet that renders a template-root snippet, or reads a <script module> import or value, an exported declaration or a $: declaration, no longer throws ReferenceError at render.
  • A lake inside a live snippet an island renders keeps its frozen region, so the island inside it wakes and the lake's HTML is no longer discarded beside other snippet content.
  • A live snippet an island renders reads the page's contexts on the server and in the browser, as the island does.
  • An island inside a frozen snippet wakes on its own.
  • A snippet passed to an island on a Kit-hydrated page no longer causes a hydration mismatch.
  • A hole on a Kit-hydrated page keeps its address and its landed HTML through Kit's hydration (a hole inside an island could go empty).
  • With an app transform, a router navigation no longer leaves a web component's server tree in the light DOM of a live host its own runtime already unpacked (a site nav collapsed to one unstyled item): a page the router fetches is rendered as an answer, every host restored before the swap.
  • A first-load copy of a transformed page that reaches the router (a frozen page, a prerender, a cache that ignores Vary) is loaded instead of swapped in; transformed documents vary on x-ogygia-spa.
  • A link inside a web component's shadow tree honors the data-sveltekit-reload around the component.
0.8.4 patch

ogygia

Fixed

  • ogygia always uses the app's SvelteKit: a second copy resolved from ogygia's own location (a linked ogygia whose peer resolved another Kit) left the devtools' server events, the freeze verdict and the page seed without their request.
  • A hole's answer morphed into a custom element with a shadow root keeps the answer's order: a reordered or newly shown child no longer stays in or lands at the wrong place.
  • A baked held region on a Kit-hydrated page no longer throws a hydration mismatch that emptied it: the region element is adopted as it stands, like a lake's.
  • Islands inside a baked held region on a Kit-hydrated page wake on the runtime instead of being left to Kit, which never hydrates them.
  • Custom elements inside a baked held region keep what the server's transform wrote (a closed dropdown no longer loses hidden and shifts the page).
0.8.3 patch

ogygia

Added

  • ogygia/testing: record(actions, { blockNavigation: true }) holds back any document load the actions cause, keeps the page and lists each in navigations with what started it, seen as it began (the link, form or input being handled; approx where the browser cannot say).
  • ogygia/testing: compare() and toMarkdown() also report hydration per island instance, session counts (errors, shifts, slow interactions, blocked navigations, CLS) and vitals past a noise threshold (compare(base, head, { noise })), and take several runs a side ({ test, runs }): load signals by median, session signals only when every head run has them and no base run does.
  • ogygia/testing: each hydration() island has a key per instance (Name#n in page order, or the islandKey attribute on it or its nearest ancestor, across shadow roots) and its wake times (t0, done); session findings carry names; a session's counts.cls is a number, and toMeetBudget({ cls }) reads it.
  • ogygia/testing: playwrightDriver(page, { onNavigationHeld }) and turnOnDevtools(page, baseURL), the fixture's own pieces, for a test that holds its pages itself.
  • ogygia/testing: every report names the page's testing engine (engine.version, engine.lean); against a site on an older ogygia, record() fills in navigations from the loads it held, and one warning per site is logged for the whole run.
  • ogygia/testing: a changed island says whether only attributes differ (attributesOnly, with each in attributes) and whether input landed on it while it hydrated (inputDuringHydration); ignoreAttributes leaves chosen attribute changes out, and toHydrateCleanly({ allowAttributeChanges, allowInput }) lets them through.
  • ogygia/testing: page().self says what measuring cost the page (script_ms, the testing engine's bytes), and lean testing (lean: true, the og_testing=lean cookie) runs the testing API and nothing else of devtools, so the page loads what a visitor's does.
  • ogygia/testing: page().route (the SvelteKit route id), cpuFunctions for more than 15 of page().cpu.fns, and a session's failed requests and slowest interaction per element (by_element).
  • Profiler: record(…, { server: true }) works across the instances of a serverless deployment: the window's signed id rides each of the session's requests, every instance writes them to the profiler store, and stop on any instance gathers them (window.instances); a window that fails leaves the session whole with server: { error }.
  • Profiler: the JSON report names its engine.version; ?fields= (profile(path, { fields })) answers only the sections asked for; ?weigh=full weighs every file with no time budget, and each file it could not weigh says why (assets.missed_why).
  • A page with devtools switched on is sent Document-Policy: js-profiling, so the browser's CPU sampler can run on it.

Changed

  • OgygiaDriver.evaluate is loosely typed, so a driver's page.evaluate fits without a cast.
  • A pkg.pr.new preview is versioned <next patch>-next.<commit>, never the release it was built after.

Fixed

  • record() whose page left for another document now says so, with the actions' own error as cause, instead of "serve with devtools".
  • withOgygia turns devtools on for the first page a test opens when there is no baseURL; before, it was silently left off.
  • A page with devtools switched on is sent private, no-store with Vary: Cookie and is never frozen, so a shared cache cannot hand its events to other visitors; a profiler beacon page too.
  • A hole's Server-Timing reaches a browser that switched devtools on (it checked an old cookie value).
  • A profiler window whose stop never came frees its instance at its 60 s cap; before, that instance refused every later window.
  • A file the profiler failed to weigh by a timeout is weighed again on the next profile; before, it stayed a miss for the life of the instance.
  • Devtools' Page and Timeline tabs, and page(), stay on the page after a router navigation that never swapped it (handed to the browser and held back, or overtaken); before, they reported no islands.
  • On Windows, ogygia knows its own files again: builds no longer register its devtools and profiler components as app modules or warn that its own marks are ignored.
  • The dev dependency scan no longer fails when the profiler is on, so dependencies pre-bundle again; devalue is now named through ogygia, so pnpm apps stop warning that it can't be resolved.
  • A click on a load, idle, visible or media island before it is live is no longer lost: the island wakes at once and the click is replayed when it is live, as on an interaction island; hydratedBy() then says 'interaction'.
  • A Ctrl/Cmd/Shift- or middle-click on a link in an island that is not live yet opens the link as the browser would; before, it was canceled and replayed, and the replay could not open it.
0.8.2 patch

ogygia

Changed

  • In a build with devtools, the launcher stays hidden until a browser turns devtools on (?og-devtools=on, or ogygia.devtools.on() in the console); ?og-devtools=off, ogygia.devtools.off() or hide in the dock turn it off. The dev server is unchanged.

Fixed

  • A hole's CSS now carries components taken through a package (its exports, a TypeScript entry included) or a barrel — only the names imported — and an island inside a hole brings its own CSS, so what it renders after a click is styled.
0.8.1 patch

ogygia

Fixed

  • handle({ endpoint }) now moves every hole and live-region URL a page mints, not only the handler; before, every hole asked the old /__ogygia__ path and stayed empty.
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.6 patch

ogygia

Fixed

  • A {#snippet} forwarded into an island no longer emits duplicate imports.
0.6.5 patch

ogygia

Removed

  • The profiler dashboard's live-server recording mode.

Fixed

  • ogygia/profiler is in the published export map.
0.6.4 patch

ogygia

Added

  • Profiler: ×N call counts and a per-call column, waiting by function, per-caller network attribution, and a serverless dump / upload.

Fixed

  • Profiler: native runtime frames are named instead of rendering as "—".
0.6.3 patch

ogygia

Fixed

  • A DocsShell sidebar no longer drowns its own page cross-fade.
0.6.2 patch

ogygia

Fixed

  • A content body's scoped <style> no longer vanishes on a csr = false page.
  • A static server island no longer 404s a bare region id on navigation.
  • A page transition between different shells no longer stutters.
0.6.1 patch

ogygia

Fixed

  • Placed client-island CSS no longer vanishes in a production build.
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.1 patch

ogygia

Fixed

  • Published exports resolve to dist, not src.
  • The browser runtime no longer disappears to tree-shaking.
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.3 patch

ogygia

Fixed

  • invalidateAll is a soft seed refresh, not a body swap and view transition.
  • csr = false FOUC CSS no longer double-owns island component JS, and client stubs keep the entry import that carries island CSS.
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.5 patch

ogygia

Fixed

  • Nested server and deferred-client islands keep their authored attributes.
0.3.4 patch

ogygia

Added

  • Deferred client islands: with { defer, hydrate } fetch signed HTML on one schedule and hydrate it on another (matching schedules coalesce).

Changed

  • defer + hydrate is no longer a build error; hydrate: 'none' + defer warns in dev and is treated as defer-only.
0.3.3 patch

ogygia

Changed

  • hydrate: 'load' also modulepreloads the island's dependency chunks.
0.3.2 patch

ogygia

Changed

  • One runtime bootstrap per page, and load preload hints hoisted to the head.

Fixed

  • Relative island entries on nested routes resolve against the document, not the runtime module.
0.3.1 patch

ogygia

Fixed

  • The client build no longer emits thin island entry facades.
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