ogygia
0.14.0 minor
ogygia
Minor Changes
- #508
eae1addThanks @PuruVJ! - Breaking: the barrel rewrite is a plugin now,barrels()from@ogygia/barrels, listed besideogygia()(plugins: [ogygia(), barrels(), sveltekit()]) with the same options. Use it in place ofogygia({ barrels }), which is a build error (barrels_option_removed) that names it;debarrel(),DebarrelOptionsandDebarrelMatcherare gone fromogygia/vite. - #532
b011a71Thanks @PuruVJ! - -@ogygia/core,ogygia: breaking (internal paths only):ogygia/internal/region-coreis gone, andogygia/internal/compilerno longer exportsset_parseror takes apathModuleoption; they existed only to run the compiler in a browser. ImportregionandisRegionfromogygia. Build output is unchanged. - #1665
096de6cThanks @PuruVJ! - Breaking: shipping only thepage.datayour islands read is a plugin now,dataShake()from@ogygia/data-shake/vite, listed besideogygia()(plugins: [ogygia(), dataShake(), sveltekit()]). Without it every island that reads the page gets all ofpage.data, and every server hole looks the page up. - #610
e07f6e4Thanks @PuruVJ! - breaking:ogygiadepends only on@ogygia/coreand@ogygia/compiler, and noogygia/*path forwards to a plugin package.ogygia/insightsis removed: install@ogygia/insightsand import from it (same names). - #693
b0a4f0eThanks @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
9201d45Thanks @PuruVJ! - -@ogygia/core,ogygia: breaking: the internalinternal/compiler-browserandinternal/compiler-browser-fullimport paths are gone. The compiler runs in Node only; use@ogygia/core/internal/compilerthere. -@ogygia/cli: breaking: theogygia mcpserver no longer has theogygia_observatorytool; the Observatory it linked to is gone. -@ogygia/content: its macros and markdown pipeline read the compiler through@ogygia/core/internal/compilerand Node's ownfs,pathandcrypto. - #1707
b20ae04Thanks @PuruVJ! - - breaking: an app's own pass over the HTML ogygia sends is the new@ogygia/rewritepackage.ogygia.handle({ transform })now throwshandle_transform_moved; listrewrite()(from@ogygia/rewrite/vite, no options) besideogygia(), and put arewrite()handle beforeogygia.handle()insequence().ogygia/markupis removed, andscanRegions/liftRegions/restoreRegionsleaveogygia/server. -@ogygia/rewrite:rewrite({ match, render })renders only the outermost custom elementsmatchpicks (a tag prefix, a list of tags, or a test), in onerender(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 elementrendergets 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:ctxcarrieskind,csr,url,eventandsignal, an AbortSignal that fires when the request is cancelled. -@ogygia/rewrite: a render'ssheetsgo 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 insequence()run in order on one marking of the HTML; one listed afterogygia.handle()throwsrewrite_after_ogygia, and a rewrite without the plugin throwsrewrite_plugin_missing. -@ogygia/rewrite:rewrite({ page })rewrites the whole document (held until its last chunk) or region answer, saysrewrite_page_failedwhen 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
368b1daThanks @PuruVJ! - -@ogygia/core,ogygia: breaking:SharedStateis no longer exported fromogygiaor@ogygia/core. Import it from@ogygia/federation/sharedinstead; it works the same. -@ogygia/federation:SharedState(state shared across separate builds on one page) is exported from@ogygia/federation/shared.
Patch Changes
- #533
49ff074Thanks @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/compilerand@ogygia/core/internal/compiler-idsimport paths are gone. Import fromogygia/vite(or@ogygia/compiler/vite),@ogygia/compilerand@ogygia/compiler/idsinstead; the names are the same. -@ogygia/core: the types of theogygia:*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/compilerandogygia/internal/compiler-idsre-export@ogygia/compiler; apps change nothing. -@ogygia/barrels,@ogygia/cli,@ogygia/content,@ogygia/devtools,@ogygia/federation,@ogygia/flags,@ogygia/postrender,@ogygia/router: they takedefinePluginand the compiler from@ogygia/compiler, a new peer dependency (ogygiabrings it). - #576
7be0138Thanks @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, anddata-rel/data-hrefno longer count asrel/href. - #878
08fd293Thanks @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
13aa062Thanks @PuruVJ! - A$page.datapromise 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
13aa062Thanks @PuruVJ! - On a router (non-navigate) request,$page.datawith 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
1767110Thanks @PuruVJ! - Packages declaresideEffects(only their.cssfiles 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
3bff299Thanks @PuruVJ! - Breaking: features move into plugin packages, each a Vite plugin listed besideogygia()and beforesveltekit()(plugins: [ogygia(), flags(), sveltekit()]; out of order, or withoutogygia(), the build says so): flags (@ogygia/flags, wasogygia/flag), frozen pages (@ogygia/freeze, wasogygia/freezeandogygia({ freeze })), fragment federation (@ogygia/federation, wasogygia/federation;mountmoved fromogygia/router) and content (@ogygia/content, wasogygia/content*andogygia({ content });ogygia/content/serveris@ogygia/content/server, and the svelte config'sogygia.preprocess()/ogygia.extensions()arepreprocess()/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 })becomesdevtools({ dock, profiler }),ogygia/profiler*imports become@ogygia/devtools/profiler*(@ogygia/devtools/profiler,/profiler/client,/profiler/storage,/profiler/storage/sqlite|redis|postgres), and the event layerogygia/devtoolsexported isogygia/events(withogygia/insightsbeside it).ogygia/testingis@ogygia/testing. The server router is@ogygia/router(wasogygia/router; listrouter()from@ogygia/router/viteso its pages' CSS links — dev warns when a page renders without it), and its typed fetch clientogygia/router/clientis@ogygia/router/api(POST(schema, …)endpoints now type-check, and$infercarries their verbs). An endpoint handler'sc.paramsis now typed strictly by its table key, at the top level, insidelayout()tables and behindwhen(), and its return type reachesapi();GET<'/p'>(fn)is gone (a handler written outside its table checks withsatisfies Handler<'/p'>). A plugin is made withdefinePlugin({ name, server, client, options, build })fromogygia/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).ogygiais 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.ttlandregions.maxPageAgearevisible,presets,ttlandmaxPageAge.@ogygia/tsdown-plugin-svelteturns a component's relative./x.tsimports into./x.jsin 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
fd47ef6Thanks @PuruVJ! - Breaking (plugin API): a plugin's per-route setting is now a key inside Kit's ownconfigpage option —b.routeConfig(key)/ctx.routeConfig(key)replaceb.routeOption(name)/ctx.routeOption(name), nothing is stripped from route files any more, and the server router'spage()/layout()/routes()takeconfiginstead offreeze. - #80
5164260Thanks @PuruVJ! - Server router: a page'sloadandactions(bare, or throughload()/action()) readc.paramstyped by their table key, as endpoints do, and aparamsorsearchschema now typesc.params/c.searchwith its output. - #74
1d97eccThanks @PuruVJ! - Types:import.meta.og.sourceis declared,instrument's attrs callback may name fewer arguments than the function takes, and looseanys in public types are nowunknown(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
0.10.1 patch
ogygia
Patch Changes
0.10.0 minor
ogygia
Minor Changes
0.9.0 minor
ogygia
Minor Changes
- #51
c0a7793Thanks @PuruVJ! - Raised minimums to the versions ogygia is tested on:svelte^5.56.8,playwrightand@playwright/test^1.62.0 (forogygia/testing), and themagic-stringdependency ^1.4.5. - #51
c0a7793Thanks @PuruVJ! - SvelteKit 3 support, alongside SvelteKit 2: builds no longer fail onrefreshAll(#37), islands on csr=true pages get Kit's page, the$pagestore 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
c0a7793Thanks @PuruVJ! - Thevitepeer 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
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,wakeor build-timeOGYGIA_SECRETno longer turns it intounknown-id.
0.8.7 patch
ogygia
Added
regions.maxPageAgesets 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 incache-control.
Fixed
- A refused hole request says why: its 403 carries
x-ogygia-deny(foreign-key,sig,unknown-id, …) andx-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_SECRETthe 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-hydratedand firesogygia:hydratedonce 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 throwsReferenceErrorat 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 onx-ogygia-spa. - A link inside a web component's shadow tree honors the
data-sveltekit-reloadaround 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
hiddenand 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 innavigationswith what started it, seen as it began (the link, form or input being handled;approxwhere the browser cannot say).ogygia/testing:compare()andtoMarkdown()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: eachhydration()island has akeyper instance (Name#nin page order, or theislandKeyattribute on it or its nearest ancestor, across shadow roots) and its wake times (t0,done); session findings carrynames; a session'scounts.clsis a number, andtoMeetBudget({ cls })reads it.ogygia/testing:playwrightDriver(page, { onNavigationHeld })andturnOnDevtools(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 innavigationsfrom the loads it held, and one warning per site is logged for the whole run.ogygia/testing: achangedisland says whether only attributes differ (attributesOnly, with each inattributes) and whether input landed on it while it hydrated (inputDuringHydration);ignoreAttributesleaves chosen attribute changes out, andtoHydrateCleanly({ allowAttributeChanges, allowInput })lets them through.ogygia/testing:page().selfsays what measuring cost the page (script_ms, the testing engine'sbytes), and lean testing (lean: true, theog_testing=leancookie) 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),cpuFunctionsfor more than 15 ofpage().cpu.fns, and a session'sfailedrequests 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 withserver: { error }. - Profiler: the JSON report names its
engine.version;?fields=(profile(path, { fields })) answers only the sections asked for;?weigh=fullweighs 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.evaluateis loosely typed, so a driver'spage.evaluatefits 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 ascause, instead of "serve with devtools".withOgygiaturns devtools on for the first page a test opens when there is nobaseURL; before, it was silently left off.- A page with devtools switched on is sent
private, no-storewithVary: Cookieand is never frozen, so a shared cache cannot hand its events to other visitors; a profiler beacon page too. - A hole's
Server-Timingreaches 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;
devalueis now named through ogygia, so pnpm apps stop warning that it can't be resolved. - A click on a
load,idle,visibleor 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 aninteractionisland;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, orogygia.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,.onandroutes({ 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 withflag.pick(map)/flag.pick(c, map), read payloads withflag.value(c), configure once withdecide({ source, overrides, exposure, batch }), and pre-decide in a route-only shell withroutes({ flags: [...] }). kitMountis nowmount.kit.ogygia/rewriteis nowogygia/markup(no alias; change the import).transformHoleis removed;ogygia.handle({ transform })covers region answers and documents alike.regionTtlis nowregions: { ttl }.regions.preloadis 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/commandrenders see their page'spage.url, route, params and server-loadpage.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/markupandscanRegions(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. prefetchwarms a deferred hole's HTML before it swaps.keepFallback(): a server island's answer that keeps the page's fallback.requestEvent(): Kit'sRequestEventinside a server island.isOgygiaPage(): tells shared code which world it runs in.- A lake survives Kit hydration on a
csr = truepage. 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.tsinitruns oncsr = falsepages. - 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, andpickchooses 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 = truepages included. - The page seed ships only when an island reads it, and only the
page.datakeys 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.
rolldownis 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
loadhole 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 = falsepages; 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 = truepage. - An error page under a
csr = falsepage renders as the Kit-hydrated document it is. - A
csr = trueroute that imports a block registry no longer links every block's CSS and chunk, and acsr = falsepage 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
visibleisland'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, followsdata-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 = truepage under acsr = falselayout keeps the layout's chrome. kit.files.routes,kit.outDir,appDirandpaths.baseare 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$pageworks inside every ogygia render root, and a server island'spage.urlis the referring page.- On a
csr = truepage 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.svelteships 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
ogygiaFallbackstays a region, andkeepFallback()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
csrexport 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
.cpuprofilelinks download, a.ogpmoved between machines imports, and the UI ships TS-free templates.
Internal
- Full TypeScript
strictat the library level, withsvelte-checkin the library check and zero explicitany. - 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}>andctx.get()are replaced by Svelte's ownsetContext/getContext, bridged across islands.
Added
$page.data(withform,error,status) works inside islands oncsr = falsepages, streamed load promises included.- Drop-in
setContext: adopt cross-island context with an import swap. - A
.tsregistrywith { wake }binding is mountable. import.meta.og.asRegion(Comp, options): the barrel escape hatch for regions.
Fixed
- A
csr = falsesubtree under acsr = trueancestor layout islands correctly, also next to a commented-outcsrexport. - 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 awake:attach binding, andkeepsplits 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/profileris in the published export map.
0.6.4 patch
ogygia
Added
- Profiler:
×Ncall 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
DocsShellsidebar no longer drowns its own page cross-fade.
0.6.2 patch
ogygia
Fixed
- A content body's scoped
<style>no longer vanishes on acsr = falsepage. - 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
wiremacro (static [ogygia.wire] = …). - The Vite peer is
^7 || ^8(5 and 6 dropped). - Island facades are emitted as
og-region.<hash>.js. continuity.speculateis removed; SPA mode never emits speculation rules.
Added
- The config surface: one grammar per
ogygia()subsystem. - The site layer,
site()inogygia/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/serverand the codec graph no longer reach the client.- Router prefetch also warms the incoming page's island modules.
Fixed
- A directly used
<Region>on acsr = truepage renders inline in the Kit tree. - An island reading
$app/stores/$app/stateno longer bundles Kit's real client store. - Dev soft-CSS HMR is scoped to the page's own sub-app.
csr = falseapps no longer need a tokencsr = trueroute.folder()collections no longer come up empty on the dev server.- Childless islands no longer serialize a phantom
childrenslot. - Nested islands no longer compile in O(2^depth).
import.meta.og.code()in a.sveltehost is no longer discarded.- An interrupted navigation no longer logs an unhandled "Transition was skipped" rejection.
ogygia/content/slotresolves.- 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
exportsresolve todist, notsrc. - 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()andrenderHtml()are replaced by the entry'sbody(a region) withget()+<Region>. OgygiaBoundaryis nowBoundary.ogygiaHandleis nowhandle, exported fromogygia/server(ogygia/hooksstays as an alias).- The default island endpoint is
/🏝️. - Presets speak the
render/wakegrammar. @ogygia/contentis 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 andogygia.transport. contentis part of ogygia (ogygia/content).- One config surface in
ogygia({ … }), and a namespace API (import * as ogygia from 'ogygia'). npx ogygia initwires 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 = falseapps.
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/statepage 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 = truepages. - 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
invalidateAllis a soft seed refresh, not a body swap and view transition.csr = falseFOUC 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 (exceptogygiaFallback).
Changed
- Dedupe is identity-based: the same component and options make one wrapper and one client entry, however many call sites.
csr = falseclient hosts no longer pull island wrappers into Kit's client graph.- The plugin uses
build.rolldownOptionson Vite 8. - Props are real Svelte props into the wrapper, and
ogygiaFallbackis 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+hydrateis no longer a build error;hydrate: 'none'+deferwarns 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
loadpreload 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
entryis 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.