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.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.0 minor
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.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.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.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.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.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.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.