npm - @cogenta/render - Versions diffs - 0.1.0 - Mend

@cogenta/render 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (205) hide show

package/dist/astro/integration.d.ts +57 -0
package/dist/astro/integration.d.ts.map +1 -0
package/dist/astro/integration.js +72 -0
package/dist/astro/integration.js.map +1 -0
package/dist/build/index.d.ts +7 -0
package/dist/build/index.d.ts.map +1 -0
package/dist/build/index.js +7 -0
package/dist/build/index.js.map +1 -0
package/dist/build/integration.d.ts +25 -0
package/dist/build/integration.d.ts.map +1 -0
package/dist/build/integration.js +41 -0
package/dist/build/integration.js.map +1 -0
package/dist/build/plan.d.ts +41 -0
package/dist/build/plan.d.ts.map +1 -0
package/dist/build/plan.js +48 -0
package/dist/build/plan.js.map +1 -0
package/dist/build/refusal.d.ts +14 -0
package/dist/build/refusal.d.ts.map +1 -0
package/dist/build/refusal.js +110 -0
package/dist/build/refusal.js.map +1 -0
package/dist/build/requirements.d.ts +59 -0
package/dist/build/requirements.d.ts.map +1 -0
package/dist/build/requirements.js +74 -0
package/dist/build/requirements.js.map +1 -0
package/dist/build/run-build.d.ts +43 -0
package/dist/build/run-build.d.ts.map +1 -0
package/dist/build/run-build.js +73 -0
package/dist/build/run-build.js.map +1 -0
package/dist/build/targets.d.ts +47 -0
package/dist/build/targets.d.ts.map +1 -0
package/dist/build/targets.js +69 -0
package/dist/build/targets.js.map +1 -0
package/dist/cache/index.d.ts +7 -0
package/dist/cache/index.d.ts.map +1 -0
package/dist/cache/index.js +4 -0
package/dist/cache/index.js.map +1 -0
package/dist/cache/page-cache.d.ts +64 -0
package/dist/cache/page-cache.d.ts.map +1 -0
package/dist/cache/page-cache.js +128 -0
package/dist/cache/page-cache.js.map +1 -0
package/dist/cache/recorder.d.ts +49 -0
package/dist/cache/recorder.d.ts.map +1 -0
package/dist/cache/recorder.js +77 -0
package/dist/cache/recorder.js.map +1 -0
package/dist/cache/tags.d.ts +55 -0
package/dist/cache/tags.d.ts.map +1 -0
package/dist/cache/tags.js +62 -0
package/dist/cache/tags.js.map +1 -0
package/dist/config.d.ts +48 -0
package/dist/config.d.ts.map +1 -0
package/dist/config.js +44 -0
package/dist/config.js.map +1 -0
package/dist/content/client.d.ts +35 -0
package/dist/content/client.d.ts.map +1 -0
package/dist/content/client.js +155 -0
package/dist/content/client.js.map +1 -0
package/dist/content/types.d.ts +104 -0
package/dist/content/types.d.ts.map +1 -0
package/dist/content/types.js +16 -0
package/dist/content/types.js.map +1 -0
package/dist/context/render-context.d.ts +31 -0
package/dist/context/render-context.d.ts.map +1 -0
package/dist/context/render-context.js +152 -0
package/dist/context/render-context.js.map +1 -0
package/dist/context/types.d.ts +49 -0
package/dist/context/types.d.ts.map +1 -0
package/dist/context/types.js +2 -0
package/dist/context/types.js.map +1 -0
package/dist/images/errors.d.ts +20 -0
package/dist/images/errors.d.ts.map +1 -0
package/dist/images/errors.js +58 -0
package/dist/images/errors.js.map +1 -0
package/dist/images/format.d.ts +18 -0
package/dist/images/format.d.ts.map +1 -0
package/dist/images/format.js +34 -0
package/dist/images/format.js.map +1 -0
package/dist/images/geometry.d.ts +46 -0
package/dist/images/geometry.d.ts.map +1 -0
package/dist/images/geometry.js +127 -0
package/dist/images/geometry.js.map +1 -0
package/dist/images/index.d.ts +29 -0
package/dist/images/index.d.ts.map +1 -0
package/dist/images/index.js +30 -0
package/dist/images/index.js.map +1 -0
package/dist/images/pipeline.d.ts +51 -0
package/dist/images/pipeline.d.ts.map +1 -0
package/dist/images/pipeline.js +105 -0
package/dist/images/pipeline.js.map +1 -0
package/dist/images/sharp.d.ts +57 -0
package/dist/images/sharp.d.ts.map +1 -0
package/dist/images/sharp.js +139 -0
package/dist/images/sharp.js.map +1 -0
package/dist/images/srcset.d.ts +33 -0
package/dist/images/srcset.d.ts.map +1 -0
package/dist/images/srcset.js +94 -0
package/dist/images/srcset.js.map +1 -0
package/dist/images/store.d.ts +32 -0
package/dist/images/store.d.ts.map +1 -0
package/dist/images/store.js +54 -0
package/dist/images/store.js.map +1 -0
package/dist/images/types.d.ts +128 -0
package/dist/images/types.d.ts.map +1 -0
package/dist/images/types.js +22 -0
package/dist/images/types.js.map +1 -0
package/dist/images/wasm.d.ts +43 -0
package/dist/images/wasm.d.ts.map +1 -0
package/dist/images/wasm.js +128 -0
package/dist/images/wasm.js.map +1 -0
package/dist/index.d.ts +29 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +29 -0
package/dist/index.js.map +1 -0
package/dist/pwa/build.d.ts +39 -0
package/dist/pwa/build.d.ts.map +1 -0
package/dist/pwa/build.js +38 -0
package/dist/pwa/build.js.map +1 -0
package/dist/pwa/client.d.ts +90 -0
package/dist/pwa/client.d.ts.map +1 -0
package/dist/pwa/client.js +76 -0
package/dist/pwa/client.js.map +1 -0
package/dist/pwa/index.d.ts +29 -0
package/dist/pwa/index.d.ts.map +1 -0
package/dist/pwa/index.js +22 -0
package/dist/pwa/index.js.map +1 -0
package/dist/pwa/manifest.d.ts +69 -0
package/dist/pwa/manifest.d.ts.map +1 -0
package/dist/pwa/manifest.js +108 -0
package/dist/pwa/manifest.js.map +1 -0
package/dist/pwa/offline.d.ts +44 -0
package/dist/pwa/offline.d.ts.map +1 -0
package/dist/pwa/offline.js +94 -0
package/dist/pwa/offline.js.map +1 -0
package/dist/pwa/service-worker.d.ts +71 -0
package/dist/pwa/service-worker.d.ts.map +1 -0
package/dist/pwa/service-worker.js +119 -0
package/dist/pwa/service-worker.js.map +1 -0
package/dist/pwa/strategy.d.ts +36 -0
package/dist/pwa/strategy.d.ts.map +1 -0
package/dist/pwa/strategy.js +180 -0
package/dist/pwa/strategy.js.map +1 -0
package/dist/pwa/sw-runtime.d.ts +109 -0
package/dist/pwa/sw-runtime.d.ts.map +1 -0
package/dist/pwa/sw-runtime.js +214 -0
package/dist/pwa/sw-runtime.js.map +1 -0
package/dist/pwa/types.d.ts +107 -0
package/dist/pwa/types.d.ts.map +1 -0
package/dist/pwa/types.js +18 -0
package/dist/pwa/types.js.map +1 -0
package/dist/pwa/version.d.ts +45 -0
package/dist/pwa/version.d.ts.map +1 -0
package/dist/pwa/version.js +89 -0
package/dist/pwa/version.js.map +1 -0
package/dist/skin/color.d.ts +50 -0
package/dist/skin/color.d.ts.map +1 -0
package/dist/skin/color.js +176 -0
package/dist/skin/color.js.map +1 -0
package/dist/skin/css.d.ts +19 -0
package/dist/skin/css.d.ts.map +1 -0
package/dist/skin/css.js +69 -0
package/dist/skin/css.js.map +1 -0
package/dist/skin/errors.d.ts +22 -0
package/dist/skin/errors.d.ts.map +1 -0
package/dist/skin/errors.js +59 -0
package/dist/skin/errors.js.map +1 -0
package/dist/skin/index.d.ts +15 -0
package/dist/skin/index.d.ts.map +1 -0
package/dist/skin/index.js +11 -0
package/dist/skin/index.js.map +1 -0
package/dist/skin/sheet.d.ts +42 -0
package/dist/skin/sheet.d.ts.map +1 -0
package/dist/skin/sheet.js +36 -0
package/dist/skin/sheet.js.map +1 -0
package/dist/skin/tokens.d.ts +90 -0
package/dist/skin/tokens.d.ts.map +1 -0
package/dist/skin/tokens.js +56 -0
package/dist/skin/tokens.js.map +1 -0
package/dist/skin/validate.d.ts +14 -0
package/dist/skin/validate.d.ts.map +1 -0
package/dist/skin/validate.js +272 -0
package/dist/skin/validate.js.map +1 -0
package/dist/theme/load-theme.d.ts +37 -0
package/dist/theme/load-theme.d.ts.map +1 -0
package/dist/theme/load-theme.js +102 -0
package/dist/theme/load-theme.js.map +1 -0
package/dist/theme/manifest.d.ts +48 -0
package/dist/theme/manifest.d.ts.map +1 -0
package/dist/theme/manifest.js +36 -0
package/dist/theme/manifest.js.map +1 -0
package/dist/theme/verify/forbidden.d.ts +39 -0
package/dist/theme/verify/forbidden.d.ts.map +1 -0
package/dist/theme/verify/forbidden.js +107 -0
package/dist/theme/verify/forbidden.js.map +1 -0
package/dist/theme/verify/scan-file.d.ts +15 -0
package/dist/theme/verify/scan-file.d.ts.map +1 -0
package/dist/theme/verify/scan-file.js +151 -0
package/dist/theme/verify/scan-file.js.map +1 -0
package/dist/theme/verify/scanner.d.ts +52 -0
package/dist/theme/verify/scanner.d.ts.map +1 -0
package/dist/theme/verify/scanner.js +304 -0
package/dist/theme/verify/scanner.js.map +1 -0
package/dist/theme/verify/verify-theme.d.ts +44 -0
package/dist/theme/verify/verify-theme.d.ts.map +1 -0
package/dist/theme/verify/verify-theme.js +179 -0
package/dist/theme/verify/verify-theme.js.map +1 -0
package/package.json +56 -0

package/dist/pwa/sw-runtime.js ADDED Viewed

@@ -0,0 +1,214 @@
+import { chooseStrategy } from './strategy.js';
+import { cacheNameFor, cachesToPurge } from './version.js';
+/** Messages the page may send the worker. Part of the public PWA contract. */
+export const SW_MESSAGE_PURGE = 'cogenta:purge';
+export const SW_MESSAGE_UNREGISTER = 'cogenta:unregister';
+export const SW_MESSAGE_ACTIVATED = 'cogenta:activated';
+export const SW_MESSAGE_UNREGISTERED = 'cogenta:unregistered';
+export function serviceWorkerMain(scope, config) {
+    const shellCacheName = cacheNameFor(config.cachePrefix, config.version, 'shell');
+    // Declared inside the function, like everything else here, because the
+    // function body is inlined into the generated script and module-scope
+    // constants would not travel with it. Used only when the network is down
+    // *and* the precached offline page is missing: it says what happened instead
+    // of rendering nothing, since a blank tab reads as "this site is broken",
+    // which is a different and unactionable claim from "you are offline".
+    const lastResortOfflineHtml = '<!doctype html><html lang="en"><meta charset="utf-8">' +
+        '<meta name="viewport" content="width=device-width,initial-scale=1">' +
+        '<title>Offline</title><body style="font:1rem/1.5 system-ui;margin:2rem">' +
+        '<h1>You are offline</h1><p>This page is not available without a network ' +
+        'connection. It will load again once you are back online.</p>';
+    const tellClients = async (message) => {
+        const windows = await scope.clients.matchAll({ type: 'window' });
+        for (const client of windows)
+            client.postMessage(message);
+    };
+    const purge = async (everything) => {
+        const names = await scope.caches.keys();
+        const doomed = everything
+            ? names.filter((name) => name.startsWith(`${config.cachePrefix}:`))
+            : cachesToPurge(names, config.cachePrefix, config.version);
+        await Promise.all(doomed.map((name) => scope.caches.delete(name)));
+        return doomed;
+    };
+    const describe = (request) => ({
+        method: request.method,
+        url: request.url,
+        origin: scope.location.origin,
+        destination: request.destination,
+        mode: request.mode,
+        cacheMode: request.cache,
+        hasRange: request.headers.has('range'),
+    });
+    const store = async (cache, request, response, maxEntries) => {
+        // `ok` is false for opaque cross-origin responses (status 0) and for every
+        // error status, so neither can be stored. Caching a 404 is how a site keeps
+        // showing "not found" long after the page came back.
+        if (!response.ok)
+            return;
+        await cache.put(request, response.clone());
+        if (maxEntries === null)
+            return;
+        // `keys()` is in insertion order, so the head of the list is the least
+        // recently *added*. A true LRU would need a side index in IndexedDB; the
+        // cap exists to bound disk use, not to be optimal.
+        const keys = await cache.keys();
+        const excess = keys.length - maxEntries;
+        for (let i = 0; i < excess; i++) {
+            const key = keys[i];
+            if (key !== undefined)
+                await cache.delete(key);
+        }
+    };
+    const offlineFallback = async () => {
+        const shell = await scope.caches.open(shellCacheName);
+        const page = await shell.match(config.offlineUrl);
+        if (page !== undefined)
+            return page;
+        return new scope.Response(lastResortOfflineHtml, {
+            status: 503,
+            headers: { 'content-type': 'text/html; charset=utf-8' },
+        });
+    };
+    /**
+     * Races the network against a timer rather than aborting it. The losing
+     * request is deliberately left running: it still fills the cache, so the
+     * *next* view gets fresh content even though this one was served stale.
+     */
+    const withTimeout = async (network, ms) => {
+        if (ms === null)
+            return network;
+        return Promise.race([
+            network,
+            new Promise((_resolve, reject) => {
+                scope.setTimeout(() => reject(new Error('network timeout')), ms);
+            }),
+        ]);
+    };
+    const handle = async (event, request, decision) => {
+        const cache = await scope.caches.open(cacheNameFor(config.cachePrefix, config.version, decision.bucket));
+        if (decision.strategy === 'cache-first') {
+            const hit = await cache.match(request);
+            if (hit !== undefined)
+                return hit;
+            const response = await scope.fetch(request);
+            await store(cache, request, response, decision.maxEntries);
+            return response;
+        }
+        if (decision.strategy === 'stale-while-revalidate') {
+            const hit = await cache.match(request);
+            const refresh = scope
+                .fetch(request)
+                .then(async (response) => {
+                await store(cache, request, response, decision.maxEntries);
+                return response;
+            })
+                .catch(() => undefined);
+            if (hit !== undefined) {
+                // The page is already answered; keep the worker alive until the
+                // background refresh lands, or the next view is stale again.
+                event.waitUntil(refresh);
+                return hit;
+            }
+            const fresh = await refresh;
+            if (fresh !== undefined)
+                return fresh;
+            return offlineFallback();
+        }
+        // network-first
+        try {
+            const response = await withTimeout(scope.fetch(request).then(async (fetched) => {
+                await store(cache, request, fetched, decision.maxEntries);
+                return fetched;
+            }), decision.networkTimeoutMs);
+            return response;
+        }
+        catch {
+            const hit = await cache.match(request);
+            if (hit !== undefined)
+                return hit;
+            return offlineFallback();
+        }
+    };
+    scope.addEventListener('install', (event) => {
+        event.waitUntil((async () => {
+            // Precache into this generation's own cache. A half-written precache
+            // therefore never mixes with the previous generation's entries.
+            const cache = await scope.caches.open(shellCacheName);
+            await cache.addAll(config.precache);
+            // Activate as soon as the new generation is complete. See the update
+            // strategy documented in `renderServiceWorker`.
+            await scope.skipWaiting();
+        })());
+    });
+    scope.addEventListener('activate', (event) => {
+        event.waitUntil((async () => {
+            await purge(false);
+            await scope.clients.claim();
+            // Tell the pages, do not reload them. A forced reload loses scroll
+            // position, form input and video playback; the page decides what to do
+            // with the news.
+            await tellClients({ type: 'cogenta:activated', version: config.version });
+        })());
+    });
+    scope.addEventListener('fetch', (event) => {
+        const decision = chooseStrategy(describe(event.request), config.routes);
+        // Not calling respondWith at all is not the same as fetching and returning:
+        // it hands the request back to the browser untouched, with its own HTTP
+        // cache, its own range handling and no worker in the path.
+        if (decision.strategy === 'network-only')
+            return;
+        event.respondWith(handle(event, event.request, decision));
+    });
+    scope.addEventListener('message', (event) => {
+        const data = event.data;
+        if (typeof data !== 'object' || data === null)
+            return;
+        const type = data.type;
+        // The exit path, callable from the admin. It must live in the worker
+        // itself: once a worker controls a page, only the worker can empty the
+        // caches it owns without a full "clear site data".
+        if (type === 'cogenta:unregister') {
+            event.waitUntil((async () => {
+                await purge(true);
+                await scope.registration.unregister();
+                await tellClients({ type: 'cogenta:unregistered' });
+            })());
+            return;
+        }
+        if (type === 'cogenta:purge') {
+            event.waitUntil((async () => {
+                const deleted = await purge(true);
+                await tellClients({ type: 'cogenta:purged', caches: deleted });
+            })());
+        }
+    });
+}
+/**
+ * The tombstone worker.
+ *
+ * Deployed at the *same URL* as the real worker when the PWA has to be turned
+ * off. It registers no fetch handler, empties every cache the site owns and
+ * unregisters itself. Browsers re-fetch a service worker script at least every
+ * 24 hours, so shipping this file is the only mechanism that reaches clients we
+ * can no longer run code on — which is precisely the situation the "zombie
+ * worker" incident describes.
+ */
+export function tombstoneMain(scope, cachePrefix) {
+    scope.addEventListener('install', (event) => {
+        event.waitUntil(scope.skipWaiting());
+    });
+    scope.addEventListener('activate', (event) => {
+        event.waitUntil((async () => {
+            const names = await scope.caches.keys();
+            await Promise.all(names
+                .filter((name) => name.startsWith(`${cachePrefix}:`))
+                .map((name) => scope.caches.delete(name)));
+            await scope.registration.unregister();
+            const windows = await scope.clients.matchAll({ type: 'window' });
+            for (const client of windows)
+                client.postMessage({ type: 'cogenta:unregistered' });
+        })());
+    });
+}
+//# sourceMappingURL=sw-runtime.js.map

package/dist/pwa/sw-runtime.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"sw-runtime.js","sourceRoot":"","sources":["../../src/pwa/sw-runtime.ts"],"names":[],"mappings":"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"}

package/dist/pwa/types.d.ts ADDED Viewed

@@ -0,0 +1,107 @@
+/**
+ * The vocabulary of the PWA layer.
+ *
+ * Everything here is *data*, and that is the whole design. A route rule is a
+ * JSON-serialisable record, not a closure, because the same rule table has to
+ * be readable by three different readers: the unit tests in Node, the generated
+ * service worker running in a browser, and a human trying to work out why a
+ * page served stale content. A table of closures would only be readable by the
+ * first two, and only the first one would be testable.
+ */
+/** How a response is obtained, and whether the cache may answer instead. */
+export type CacheStrategy =
+/** Ask the network; fall back to the cache only when the network fails. */
+'network-first'
+/** Answer from the cache; only go to the network on a miss. */
+ | 'cache-first'
+/** Answer from the cache and refresh it in the background. */
+ | 'stale-while-revalidate'
+/** Never touch the cache. The service worker does not even intercept. */
+ | 'network-only';
+/**
+ * Caches are split by bucket so that one kind of resource can be evicted or
+ * capped without touching another: images must be capped (they are unbounded),
+ * documents must not (they are the only thing that works offline).
+ */
+export type CacheBucket = 'shell' | 'documents' | 'assets' | 'images' | 'data';
+export declare const CACHE_BUCKETS: readonly CacheBucket[];
+/**
+ * One routing rule. Fields that may be absent are typed `| null` rather than
+ * optional: this record is serialised into the generated service worker, and
+ * `undefined` does not survive `JSON.stringify`. A missing field would then
+ * mean something different on each side of the wire.
+ */
+export interface RouteRule {
+    /** Stable identifier, reported in the decision so a miss can be traced. */
+    readonly id: string;
+    /**
+     * `Request.destination` values this rule answers for. Empty means "any
+     * destination". `''` is the destination of a plain `fetch()`.
+     */
+    readonly destinations: readonly string[];
+    /** Regular expression source, matched against `pathname + search`. */
+    readonly pattern: string | null;
+    /** Whether the rule also applies to cross-origin requests. */
+    readonly crossOrigin: boolean;
+    readonly strategy: CacheStrategy;
+    readonly bucket: CacheBucket;
+    /** Cap on stored entries for this bucket. `null` means uncapped. */
+    readonly maxEntries: number | null;
+    /** How long the network gets before the cache answers. `null` means no cap. */
+    readonly networkTimeoutMs: number | null;
+}
+/**
+ * A request reduced to the fields a routing decision actually needs.
+ *
+ * This is not `Request`. The render package compiles against ES2023 without the
+ * DOM library, and more importantly a decision function that takes a real
+ * `Request` can only be tested inside a browser. Reducing the request to seven
+ * scalars is what moves the routing decision into a unit test.
+ */
+export interface RequestDescriptor {
+    readonly method: string;
+    readonly url: string;
+    /** Origin of the service worker itself, used to detect cross-origin traffic. */
+    readonly origin: string;
+    /** `Request.destination`: `'document'`, `'script'`, `'image'`, `''`… */
+    readonly destination: string;
+    /** `Request.mode`: `'navigate'` marks a page load. */
+    readonly mode: string;
+    /** `Request.cache`: `'no-store'` and `'reload'` are the user overruling us. */
+    readonly cacheMode: string;
+    /** A ranged request asks for part of a body; a cache entry is a whole body. */
+    readonly hasRange: boolean;
+}
+export interface StrategyDecision {
+    readonly strategy: CacheStrategy;
+    readonly bucket: CacheBucket;
+    readonly maxEntries: number | null;
+    readonly networkTimeoutMs: number | null;
+    /** Rule that matched, or a `bypass:*` marker when nothing did. */
+    readonly ruleId: string;
+    /** Why this decision was reached. Present so a log line is diagnosable. */
+    readonly reason: string;
+}
+export interface PwaConfig {
+    /**
+     * Namespace for every cache this site owns. Other applications may share the
+     * origin; purging must never touch their caches.
+     */
+    readonly cachePrefix: string;
+    /**
+     * Cache generation. Changing it makes the previous generation garbage, which
+     * is what the activation purge collects. Derive it with `computeCacheVersion`
+     * rather than bumping it by hand.
+     */
+    readonly version: string;
+    /** URL of the offline page. Precached, and served when a navigation fails. */
+    readonly offlineUrl: string;
+    /**
+     * Everything precached at install. Keep it to the offline page and the shell:
+     * a large precache turns every deploy into a full re-download, which is the
+     * main reason PWAs feel heavier than the site they wrap.
+     */
+    readonly precache: readonly string[];
+    readonly routes: readonly RouteRule[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pwa/types.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pwa/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,aAAa;AACvB,2EAA2E;AACzE,eAAe;AACjB,+DAA+D;GAC7D,aAAa;AACf,8DAA8D;GAC5D,wBAAwB;AAC1B,yEAAyE;GACvE,cAAc,CAAA;AAElB;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;AAE9E,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAM/C,CAAA;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CACzC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IACxC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAA;CACtC"}

package/dist/pwa/types.js ADDED Viewed

@@ -0,0 +1,18 @@
+/**
+ * The vocabulary of the PWA layer.
+ *
+ * Everything here is *data*, and that is the whole design. A route rule is a
+ * JSON-serialisable record, not a closure, because the same rule table has to
+ * be readable by three different readers: the unit tests in Node, the generated
+ * service worker running in a browser, and a human trying to work out why a
+ * page served stale content. A table of closures would only be readable by the
+ * first two, and only the first one would be testable.
+ */
+export const CACHE_BUCKETS = [
+    'shell',
+    'documents',
+    'assets',
+    'images',
+    'data',
+];
+//# sourceMappingURL=types.js.map

package/dist/pwa/types.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pwa/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,OAAO;IACP,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,MAAM;CACP,CAAA"}

package/dist/pwa/version.d.ts ADDED Viewed

@@ -0,0 +1,45 @@
+import type { CacheBucket, PwaConfig } from './types.js';
+export declare const DEFAULT_CACHE_PREFIX = "cogenta:pwa";
+/**
+ * Derives the cache generation from everything that changes how a response is
+ * produced or stored: the offline page, the precache list and the whole route
+ * table. Editing a rule therefore invalidates the caches that rule filled,
+ * which is the case people forget when they version by build number alone.
+ *
+ * `buildId` is whatever the deployment already has — a commit sha, a build
+ * timestamp. Passing it is what makes a content change bump the generation.
+ */
+export declare function computeCacheVersion(input: Pick<PwaConfig, 'offlineUrl' | 'precache' | 'routes'> & {
+    readonly buildId?: string;
+}): string;
+/**
+ * Builds a cache name.
+ *
+ * Inlined verbatim into the generated service worker (see `runtime-source.ts`),
+ * so it must stay free of any reference to module scope.
+ */
+export declare function cacheNameFor(prefix: string, version: string, bucket: string): string;
+/**
+ * Selects the caches to delete at activation: ours, and not of this generation.
+ *
+ * Two properties matter and both are tested. Caches belonging to another
+ * application on the same origin are never returned — a purge that deletes a
+ * neighbour's cache is a far worse incident than the one it fixes. And a cache
+ * of the current generation is never returned, including when the bucket is one
+ * this build no longer uses, because the fetch handler may be filling it right
+ * now.
+ *
+ * Inlined verbatim into the generated service worker: no module-scope
+ * references allowed.
+ */
+export declare function cachesToPurge(existing: readonly string[], prefix: string, version: string): string[];
+/** Parsed form of a cache name we own. `null` for anything that is not ours. */
+export interface ParsedCacheName {
+    readonly prefix: string;
+    readonly version: string;
+    readonly bucket: string;
+}
+export declare function parseCacheName(name: string, prefix: string): ParsedCacheName | null;
+/** Typed convenience over `cacheNameFor` for call sites that know the bucket. */
+export declare function bucketCacheName(config: PwaConfig, bucket: CacheBucket): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/pwa/version.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/pwa/version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAmBxD,eAAO,MAAM,oBAAoB,gBAAgB,CAAA;AAiBjD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3F,MAAM,CAQR;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CAIV;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAMnF;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAE9E"}

package/dist/pwa/version.js ADDED Viewed

@@ -0,0 +1,89 @@
+/**
+ * Cache naming and generational purge.
+ *
+ * A cache name carries its generation: `cogenta:pwa:3f2a91cc:images`. That one
+ * decision is what makes the purge trivial and total — "delete every cache of
+ * mine whose generation is not the current one" needs no bookkeeping, no
+ * manifest of what was stored, and no per-entry expiry. Caches from a deploy
+ * three versions ago cannot survive, because their name says so.
+ *
+ * The alternative — one cache reused across deploys, entries expired by age —
+ * is the design that produces the incident this module exists to prevent: the
+ * cache still holds last month's HTML and nothing in the system knows it.
+ */
+/** Separator between the prefix, the version and the bucket. */
+const SEPARATOR = ':';
+export const DEFAULT_CACHE_PREFIX = 'cogenta:pwa';
+/**
+ * FNV-1a, 32 bits. Not `node:crypto`: this helper is also used from the edge
+ * build target, where the Node crypto module may be absent. The hash is a cache
+ * generation marker, never a security boundary — a collision costs a stale
+ * asset, not an exploit.
+ */
+function hash(input) {
+    let value = 0x811c9dc5;
+    for (let i = 0; i < input.length; i++) {
+        value ^= input.charCodeAt(i);
+        value = Math.imul(value, 0x01000193) >>> 0;
+    }
+    return value.toString(16).padStart(8, '0');
+}
+/**
+ * Derives the cache generation from everything that changes how a response is
+ * produced or stored: the offline page, the precache list and the whole route
+ * table. Editing a rule therefore invalidates the caches that rule filled,
+ * which is the case people forget when they version by build number alone.
+ *
+ * `buildId` is whatever the deployment already has — a commit sha, a build
+ * timestamp. Passing it is what makes a content change bump the generation.
+ */
+export function computeCacheVersion(input) {
+    const material = JSON.stringify([
+        input.buildId ?? '',
+        input.offlineUrl,
+        [...input.precache].sort(),
+        input.routes,
+    ]);
+    return hash(material);
+}
+/**
+ * Builds a cache name.
+ *
+ * Inlined verbatim into the generated service worker (see `runtime-source.ts`),
+ * so it must stay free of any reference to module scope.
+ */
+export function cacheNameFor(prefix, version, bucket) {
+    return `${prefix}:${version}:${bucket}`;
+}
+/**
+ * Selects the caches to delete at activation: ours, and not of this generation.
+ *
+ * Two properties matter and both are tested. Caches belonging to another
+ * application on the same origin are never returned — a purge that deletes a
+ * neighbour's cache is a far worse incident than the one it fixes. And a cache
+ * of the current generation is never returned, including when the bucket is one
+ * this build no longer uses, because the fetch handler may be filling it right
+ * now.
+ *
+ * Inlined verbatim into the generated service worker: no module-scope
+ * references allowed.
+ */
+export function cachesToPurge(existing, prefix, version) {
+    const mine = `${prefix}:`;
+    const current = `${prefix}:${version}:`;
+    return existing.filter((name) => name.startsWith(mine) && !name.startsWith(current));
+}
+export function parseCacheName(name, prefix) {
+    if (!name.startsWith(`${prefix}${SEPARATOR}`))
+        return null;
+    const rest = name.slice(prefix.length + SEPARATOR.length);
+    const cut = rest.indexOf(SEPARATOR);
+    if (cut <= 0 || cut === rest.length - 1)
+        return null;
+    return { prefix, version: rest.slice(0, cut), bucket: rest.slice(cut + 1) };
+}
+/** Typed convenience over `cacheNameFor` for call sites that know the bucket. */
+export function bucketCacheName(config, bucket) {
+    return cacheNameFor(config.cachePrefix, config.version, bucket);
+}
+//# sourceMappingURL=version.js.map

package/dist/pwa/version.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/pwa/version.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,gEAAgE;AAChE,MAAM,SAAS,GAAG,GAAG,CAAA;AAErB,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAA;AAEjD;;;;;GAKG;AACH,SAAS,IAAI,CAAC,KAAa;IACzB,IAAI,KAAK,GAAG,UAAU,CAAA;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC5B,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA4F;IAE5F,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,KAAK,CAAC,OAAO,IAAI,EAAE;QACnB,KAAK,CAAC,UAAU;QAChB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;QAC1B,KAAK,CAAC,MAAM;KACb,CAAC,CAAA;IACF,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAA;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAAe,EAAE,MAAc;IAC1E,OAAO,GAAG,MAAM,IAAI,OAAO,IAAI,MAAM,EAAE,CAAA;AACzC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA2B,EAC3B,MAAc,EACd,OAAe;IAEf,MAAM,IAAI,GAAG,GAAG,MAAM,GAAG,CAAA;IACzB,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,OAAO,GAAG,CAAA;IACvC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;AACtF,CAAC;AASD,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAc;IACzD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;QAAE,OAAO,IAAI,CAAA;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACnC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACpD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAA;AAC7E,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,MAAmB;IACpE,OAAO,YAAY,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AACjE,CAAC"}

package/dist/skin/color.d.ts ADDED Viewed

@@ -0,0 +1,50 @@
+/**
+ * Colour parsing and WCAG contrast, written by hand.
+ *
+ * Why no dependency: a colour library is a supply-chain surface, and the whole
+ * point of the skin validator is that a skin generated by a model in L9 is safe
+ * *by construction*. The rules it enforces must be auditable in one file, not
+ * inherited from a package that may change its rounding next minor version.
+ */
+export interface Rgb {
+    readonly r: number;
+    readonly g: number;
+    readonly b: number;
+}
+export interface Rgba extends Rgb {
+    /** 0 = fully transparent, 1 = fully opaque. */
+    readonly a: number;
+}
+/** WCAG 2.2 AA thresholds. Large text is >=18.66px bold or >=24px regular. */
+export declare const AA_NORMAL_TEXT = 4.5;
+export declare const AA_LARGE_TEXT = 3;
+export type TextSize = 'normal' | 'large';
+export declare function aaThreshold(size: TextSize): number;
+/**
+ * Parses a CSS colour. The accepted set is deliberately closed to hex, `rgb()`
+ * and `hsl()`: named colours, `color()` and `oklch()` would each need their own
+ * conversion path before a contrast ratio could be computed, and a colour whose
+ * luminance cannot be computed cannot be validated — so it must not be accepted.
+ *
+ * Returns `null` rather than throwing: the caller owns the error, because only
+ * the caller knows which token the value came from.
+ */
+export declare function parseColor(value: string): Rgba | null;
+/** WCAG 2.2 relative luminance. */
+export declare function relativeLuminance(color: Rgb): number;
+/** WCAG 2.2 contrast ratio, between 1 and 21. */
+export declare function contrastRatio(a: Rgb, b: Rgb): number;
+/**
+ * Composites a translucent foreground over an opaque background. A contrast
+ * ratio computed on the raw foreground of a translucent colour is wrong — and
+ * wrong in the optimistic direction — so it is composited first.
+ */
+export declare function compositeOver(foreground: Rgba, background: Rgb): Rgb;
+/**
+ * No epsilon on purpose. A pair at 4.4999:1 is below AA; rounding it up to
+ * "4.50" is exactly the kind of leniency that makes the guarantee a lie.
+ */
+export declare function meetsContrastAa(ratio: number, size: TextSize): boolean;
+/** Two decimals, the precision every WCAG reporting tool uses. */
+export declare function formatRatio(ratio: number): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/skin/color.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/skin/color.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,IAAK,SAAQ,GAAG;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,8EAA8E;AAC9E,eAAO,MAAM,cAAc,MAAM,CAAA;AACjC,eAAO,MAAM,aAAa,IAAI,CAAA;AAE9B,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEzC,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAElD;AAKD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAmBrD;AAwGD,mCAAmC;AACnC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAMpD;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAMpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,GAAG,GAAG,CAOpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEtE;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}