@swiftbrowser/web 0.1.0

package/node/dist/node/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Programmatic API of `@swiftbrowser/web`: run the dev server or build the
+ * static site for any set of apps (see ./apps.ts for what an app is).
+ *
+ *     import { createDevServer, buildSite } from '@swiftbrowser/web';
+ *
+ * Both use this package's `Web/` directory as the Vite root (found relative
+ * to this module, so it works from `node_modules`) and build the Vite config
+ * from the options; `vite.config.ts` is not read.
+ */
+import { type ViteDevServer } from 'vite';
+import { type SiteOptions } from './config.js';
+export type { AppSpec } from './apps.js';
+export { APP_NAME, validateAppSpecs } from './apps.js';
+export type { LandingApp, SiteOptions } from './config.js';
+export { createViteConfig, landingApps, webRoot } from './config.js';
+export interface DevServerOptions extends SiteOptions {
+    /** Defaults to 5173. */
+    port?: number;
+    /** As Vite's `server.host`: `true` listens on all addresses. */
+    host?: string | boolean;
+    /** Fail instead of trying the next port when `port` is taken (default true). */
+    strictPort?: boolean;
+    /** Open the landing page in a browser once listening. */
+    open?: boolean;
+}
+export interface BuildSiteOptions extends SiteOptions {
+    /** Output directory (absolute, or relative to the current working directory). */
+    outDir: string;
+    /** Empty `outDir` first (default true). */
+    emptyOutDir?: boolean;
+    /** Vite's log level for the build (`info` prints every emitted file). */
+    logLevel?: 'info' | 'warn' | 'error' | 'silent';
+}
+/**
+ * A configured, started Vite dev server (`listen` has been called) with the
+ * registry plugins for `options.apps`. Call `server.printUrls()` to show the
+ * addresses and `server.close()` to stop it.
+ */
+export declare function createDevServer(options: DevServerOptions): Promise<ViteDevServer>;
+/**
+ * `vite build` of the landing + app pages into `outDir`, with every app's
+ * wasm module, catalog JSON + images and web manifest (+ icon) written into
+ * it, so the directory is a complete static site.
+ */
+export declare function buildSite(options: BuildSiteOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/node/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAA2C,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AACnF,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEjE,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAWvF;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CASxE"}

package/node/dist/node/index.js

@@ -0,0 +1,52 @@
+/**
+ * Programmatic API of `@swiftbrowser/web`: run the dev server or build the
+ * static site for any set of apps (see ./apps.ts for what an app is).
+ *
+ *     import { createDevServer, buildSite } from '@swiftbrowser/web';
+ *
+ * Both use this package's `Web/` directory as the Vite root (found relative
+ * to this module, so it works from `node_modules`) and build the Vite config
+ * from the options; `vite.config.ts` is not read.
+ */
+import path from 'node:path';
+import { build, createServer } from 'vite';
+import { createViteConfig } from './config.js';
+export { APP_NAME, validateAppSpecs } from './apps.js';
+export { createViteConfig, landingApps, webRoot } from './config.js';
+/**
+ * A configured, started Vite dev server (`listen` has been called) with the
+ * registry plugins for `options.apps`. Call `server.printUrls()` to show the
+ * addresses and `server.close()` to stop it.
+ */
+export async function createDevServer(options) {
+    const { port, host, strictPort, open, ...site } = options;
+    const config = createViteConfig(site);
+    const server = { ...config.server };
+    if (port !== undefined)
+        server.port = port;
+    if (host !== undefined)
+        server.host = host;
+    if (strictPort !== undefined)
+        server.strictPort = strictPort;
+    if (open !== undefined)
+        server.open = open;
+    const devServer = await createServer({ ...config, configFile: false, server });
+    await devServer.listen();
+    return devServer;
+}
+/**
+ * `vite build` of the landing + app pages into `outDir`, with every app's
+ * wasm module, catalog JSON + images and web manifest (+ icon) written into
+ * it, so the directory is a complete static site.
+ */
+export async function buildSite(options) {
+    const { outDir, emptyOutDir, logLevel, ...site } = options;
+    const config = createViteConfig(site);
+    await build({
+        ...config,
+        configFile: false,
+        ...(logLevel ? { logLevel } : {}),
+        build: { ...config.build, outDir: path.resolve(outDir), emptyOutDir: emptyOutDir ?? true },
+    });
+}
+//# sourceMappingURL=index.js.map

package/node/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,YAAY,EAA0C,MAAM,MAAM,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAoB,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAsBrE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAyB;IAC7D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC1D,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAkB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;IACnD,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAC3C,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAC3C,IAAI,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IAC7D,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/E,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;IACzB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAyB;IACvD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,CAAC;QACV,GAAG,MAAM;QACT,UAAU,EAAE,KAAK;QACjB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE;KAC3F,CAAC,CAAC;AACL,CAAC"}

package/node/dist/plugins/app-manifests.d.ts

@@ -0,0 +1,61 @@
+/**
+ * One web app manifest per registered app, served at
+ * `/manifests/<name>.webmanifest` (dev server and `vite build`), plus the
+ * app's own icon at `/manifests/<name>-icon.png` when its spec has one.
+ *
+ * "Add to Home Screen" in Safari takes the start URL from the page's manifest,
+ * not from the page's own URL. With the single `/manifest.webmanifest`
+ * (`start_url: /app/`) every home-screen icon therefore launched the default
+ * app, whichever one was open when it was added. `app/index.html` points
+ * `<link rel="manifest">` at the manifest of the app named by `?app=`, so each
+ * icon reopens its own app and is labelled with the app's display name.
+ *
+ * Safari takes the home-screen image from `<link rel="apple-touch-icon">`
+ * rather than from the manifest, so for apps with an icon the plugin also
+ * injects `window.__SB_APP_ICONS__` (name -> icon URL) into the app page; the
+ * inline script in app/index.html repoints that link.
+ */
+import type { Plugin } from 'vite';
+import { type AppSpec } from '../node/apps.js';
+export declare const MANIFEST_DIR = "manifests";
+/** The fields of an {@link AppSpec} a manifest is made from. */
+export type ManifestSpec = Pick<AppSpec, 'name' | 'displayName' | 'description' | 'icon'>;
+export interface AppManifest {
+    id: string;
+    name: string;
+    short_name: string;
+    description: string;
+    start_url: string;
+    scope: string;
+    display: 'standalone';
+    orientation: 'portrait';
+    background_color: string;
+    icons: {
+        src: string;
+        sizes: string;
+        type: string;
+    }[];
+}
+/** URL path of an app's manifest, as the app page links it. */
+export declare function manifestPath(app: string): string;
+/** URL path of an app's own icon (only served for specs with `icon`). */
+export declare function manifestIconPath(app: string): string;
+/** The app page URL that runs `app` (matches `appPath` in src/landing.ts). */
+export declare function appStartUrl(app: string): string;
+/** Default description, for a spec without one. */
+export declare function defaultDescription(spec: ManifestSpec): string;
+/**
+ * The manifest for one app. No `theme_color`: the status bar is translucent
+ * and the page draws its own background under it, and the light/dark
+ * `theme-color` metas in app/index.html cover the browser UI.
+ */
+export declare function appManifest(spec: ManifestSpec | string): AppManifest;
+export declare function appManifestJson(spec: ManifestSpec | string): string;
+/** The app named by a manifest request URL, or null for any other URL. */
+export declare function manifestRequestApp(url: string): string | null;
+/** The app named by an icon request URL (`/manifests/<name>-icon.png`), or null. */
+export declare function iconRequestApp(url: string): string | null;
+/** `name -> icon URL` for the specs that bring their own icon (what the app page reads). */
+export declare function appIconUrls(specs: readonly ManifestSpec[]): Record<string, string>;
+export declare function appManifests(specs: readonly ManifestSpec[]): Plugin;
+//# sourceMappingURL=app-manifests.d.ts.map

package/node/dist/plugins/app-manifests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-manifests.d.ts","sourceRoot":"","sources":["../../../plugins/app-manifests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAGxE,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,gEAAgE;AAChE,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,CAAC,CAAC;AAE1F,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,UAAU,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE7D;AAYD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,WAAW,CAsBpE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,CAEnE;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzD;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIlF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAoEnE"}

package/node/dist/plugins/app-manifests.js

@@ -0,0 +1,168 @@
+/**
+ * One web app manifest per registered app, served at
+ * `/manifests/<name>.webmanifest` (dev server and `vite build`), plus the
+ * app's own icon at `/manifests/<name>-icon.png` when its spec has one.
+ *
+ * "Add to Home Screen" in Safari takes the start URL from the page's manifest,
+ * not from the page's own URL. With the single `/manifest.webmanifest`
+ * (`start_url: /app/`) every home-screen icon therefore launched the default
+ * app, whichever one was open when it was added. `app/index.html` points
+ * `<link rel="manifest">` at the manifest of the app named by `?app=`, so each
+ * icon reopens its own app and is labelled with the app's display name.
+ *
+ * Safari takes the home-screen image from `<link rel="apple-touch-icon">`
+ * rather than from the manifest, so for apps with an icon the plugin also
+ * injects `window.__SB_APP_ICONS__` (name -> icon URL) into the app page; the
+ * inline script in app/index.html repoints that link.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { APP_NAME, displayNameOf } from '../node/apps.js';
+import { readImageSize } from './asset-catalogs.js';
+export const MANIFEST_DIR = 'manifests';
+/** URL path of an app's manifest, as the app page links it. */
+export function manifestPath(app) {
+    return `/${MANIFEST_DIR}/${app}.webmanifest`;
+}
+/** URL path of an app's own icon (only served for specs with `icon`). */
+export function manifestIconPath(app) {
+    return `/${MANIFEST_DIR}/${app}-icon.png`;
+}
+/** The app page URL that runs `app` (matches `appPath` in src/landing.ts). */
+export function appStartUrl(app) {
+    return `/app/?app=${encodeURIComponent(app)}`;
+}
+/** Default description, for a spec without one. */
+export function defaultDescription(spec) {
+    return `The ${displayNameOf(spec)} app, compiled to WebAssembly and rendered in the browser.`;
+}
+/** `WxH` of a PNG on disk, or `any` when it cannot be read. */
+function iconSizes(file) {
+    try {
+        const size = readImageSize(readFileSync(file), 'png');
+        return size ? `${size.width}x${size.height}` : 'any';
+    }
+    catch {
+        return 'any';
+    }
+}
+/**
+ * The manifest for one app. No `theme_color`: the status bar is translucent
+ * and the page draws its own background under it, and the light/dark
+ * `theme-color` metas in app/index.html cover the browser UI.
+ */
+export function appManifest(spec) {
+    const app = typeof spec === 'string' ? { name: spec } : spec;
+    if (!APP_NAME.test(app.name))
+        throw new Error(`Invalid app name: ${JSON.stringify(app.name)}`);
+    const start = appStartUrl(app.name);
+    const displayName = displayNameOf(app);
+    return {
+        id: start,
+        name: displayName,
+        short_name: displayName,
+        description: app.description ?? defaultDescription(app),
+        start_url: start,
+        scope: '/app/',
+        display: 'standalone',
+        orientation: 'portrait',
+        background_color: '#000000',
+        icons: app.icon
+            ? [{ src: manifestIconPath(app.name), sizes: iconSizes(app.icon), type: 'image/png' }]
+            : [
+                { src: '/icon.svg', sizes: 'any', type: 'image/svg+xml' },
+                { src: '/apple-touch-icon.png', sizes: '180x180', type: 'image/png' },
+            ],
+    };
+}
+export function appManifestJson(spec) {
+    return JSON.stringify(appManifest(spec), null, 2) + '\n';
+}
+/** The app named by a manifest request URL, or null for any other URL. */
+export function manifestRequestApp(url) {
+    const match = new RegExp(`^/${MANIFEST_DIR}/([A-Za-z0-9_-]+)\\.webmanifest(?:\\?|$)`).exec(url);
+    return match?.[1] ?? null;
+}
+/** The app named by an icon request URL (`/manifests/<name>-icon.png`), or null. */
+export function iconRequestApp(url) {
+    const match = new RegExp(`^/${MANIFEST_DIR}/([A-Za-z0-9_-]+)-icon\\.png(?:\\?|$)`).exec(url);
+    return match?.[1] ?? null;
+}
+/** `name -> icon URL` for the specs that bring their own icon (what the app page reads). */
+export function appIconUrls(specs) {
+    const icons = {};
+    for (const spec of specs)
+        if (spec.icon)
+            icons[spec.name] = manifestIconPath(spec.name);
+    return icons;
+}
+export function appManifests(specs) {
+    const byName = new Map(specs.map((spec) => [spec.name, spec]));
+    const icons = appIconUrls(specs);
+    const isAppPage = (pathname) => /(^|\/)app\/(index\.html)?$/.test(pathname.split('?')[0] ?? '');
+    return {
+        name: 'swiftbrowser:app-manifests',
+        configureServer(server) {
+            server.middlewares.use((req, res, next) => {
+                const url = req.url ?? '';
+                const app = manifestRequestApp(url);
+                if (app !== null) {
+                    const spec = byName.get(app);
+                    if (!spec) {
+                        res.statusCode = 404;
+                        res.end();
+                        return;
+                    }
+                    res.setHeader('Content-Type', 'application/manifest+json');
+                    res.setHeader('Cache-Control', 'no-cache');
+                    res.end(appManifestJson(spec));
+                    return;
+                }
+                const iconApp = iconRequestApp(url);
+                if (iconApp === null)
+                    return next();
+                const icon = byName.get(iconApp)?.icon;
+                if (!icon || !existsSync(icon)) {
+                    res.statusCode = 404;
+                    res.end();
+                    return;
+                }
+                res.setHeader('Content-Type', 'image/png');
+                res.setHeader('Cache-Control', 'no-cache');
+                res.end(readFileSync(icon));
+            });
+        },
+        transformIndexHtml(_html, ctx) {
+            // Only the app page needs the icon map, and only when some app has one.
+            if (Object.keys(icons).length === 0 || !isAppPage(ctx.path))
+                return;
+            return [
+                {
+                    tag: 'script',
+                    injectTo: 'head-prepend',
+                    children: `window.__SB_APP_ICONS__ = ${JSON.stringify(icons)};`,
+                },
+            ];
+        },
+        generateBundle() {
+            for (const spec of specs) {
+                this.emitFile({
+                    type: 'asset',
+                    fileName: `${MANIFEST_DIR}/${spec.name}.webmanifest`,
+                    source: appManifestJson(spec),
+                });
+                if (spec.icon) {
+                    if (!existsSync(spec.icon)) {
+                        this.warn(`${spec.name}: icon ${spec.icon} does not exist, skipped`);
+                        continue;
+                    }
+                    this.emitFile({
+                        type: 'asset',
+                        fileName: `${MANIFEST_DIR}/${spec.name}-icon.png`,
+                        source: readFileSync(spec.icon),
+                    });
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=app-manifests.js.map

package/node/dist/plugins/app-manifests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-manifests.js","sourceRoot":"","sources":["../../../plugins/app-manifests.ts"],"names":[],"mappings":"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"}

package/node/dist/plugins/asset-catalogs.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Serves every registered app's Xcode asset catalogs (the `*.xcassets`
+ * directories of its `AppSpec`) as one JSON manifest at `/catalog/<App>.json`
+ * plus the image files at `/catalog/<App>/<name>.<ext>` (dev server and
+ * `vite build`).
+ *
+ * The Swift side refers to catalog images and colors by name only
+ * (`Image("dough/plain-full")`, `Color("dough/plain-bg")`). The page fetches
+ * the manifest before loading the app (src/main.ts) so the layout engine
+ * knows every image's intrinsic size and the renderer can resolve the URL and
+ * the light/dark color values. See `AssetCatalog` in src/assets.ts.
+ *
+ * Catalog rules implemented here:
+ * - a folder whose `Contents.json` has `properties.provides-namespace: true`
+ *   prefixes everything inside with `<folder>/` (nested folders chain);
+ * - `<name>.imageset`: the `2x` entry is preferred (then `1x`, `3x`, then the
+ *   first entry with a file); points = pixels ÷ scale;
+ * - `<name>.symbolset`: an SVG drawn as a template (`kind: "symbol"`);
+ * - `<name>.colorset`: the entry without appearances is `light`, the one with
+ *   `luminosity: dark` is `dark`; idiom and contrast variants are ignored.
+ */
+import type { Plugin } from 'vite';
+import { type AppSpec } from '../node/apps.js';
+import { type AssetCatalog, type AssetColor } from '../src/assets.js';
+export { CATALOG_DIR, catalogPath, assetFilePath } from '../src/assets.js';
+export type { AssetCatalog } from '../src/assets.js';
+/** One file the manifest refers to. */
+export interface CatalogFile {
+    /** Published path without a leading slash (`catalog/App/dough__plain-full.png`). */
+    fileName: string;
+    /** Absolute path of the source file on disk. */
+    source: string;
+    contentType: string;
+}
+export interface BuiltCatalog {
+    manifest: AssetCatalog;
+    /** Keyed by `fileName`. */
+    files: Map<string, CatalogFile>;
+    /** Entries that were skipped and why (the plugin logs them). */
+    warnings: string[];
+}
+interface ImageSetContents {
+    images?: {
+        filename?: string;
+        idiom?: string;
+        scale?: string;
+    }[];
+}
+interface ColorSetContents {
+    colors?: {
+        idiom?: string;
+        appearances?: {
+            appearance?: string;
+            value?: string;
+        }[];
+        color?: {
+            'color-space'?: string;
+            components?: {
+                red?: string;
+                green?: string;
+                blue?: string;
+                alpha?: string;
+            };
+        };
+    }[];
+}
+/**
+ * One colorset component as a 0...1 value. Xcode writes hex (`"0xC2"`),
+ * floats (`"0.439"`, `"1.000"`) or 0...255 integers (`"255"`). A bare `"0"`
+ * or `"1"` has no decimal point but is taken as 0 / 1 (full), as Xcode never
+ * writes 1/255 that way.
+ */
+export declare function parseComponent(value: string | undefined, fallback?: number): number;
+/** CSS `rgba(r, g, b, a)` for colorset components (r/g/b 0...255, a 0...1). */
+export declare function componentsToCSS(components: {
+    red?: string;
+    green?: string;
+    blue?: string;
+    alpha?: string;
+}): string;
+/** The `light` / `dark` CSS colors of a colorset, or null when it has no usable entry. */
+export declare function parseColorSet(contents: ColorSetContents): AssetColor | null;
+export interface PixelSize {
+    width: number;
+    height: number;
+}
+/**
+ * Pixel size of a PNG (IHDR), JPEG (the first SOF segment), WebP (VP8,
+ * VP8L or VP8X chunk) or SVG (`width`/`height` attributes, else `viewBox`);
+ * null for anything else.
+ */
+export declare function readImageSize(data: Buffer, ext: string): PixelSize | null;
+/** The image entry to publish for an imageset, with its numeric scale. */
+export declare function pickImage(contents: ImageSetContents): {
+    filename: string;
+    scale: number;
+} | null;
+/** Every `*.xcassets` directory under `dir` (recursive, skipping hidden directories). */
+export declare function findAssetCatalogs(dir: string): string[];
+/**
+ * Build the manifest of `app` from the given `.xcassets` directories (later
+ * catalogs do not override earlier names: the first definition wins, with a
+ * warning for the duplicate).
+ */
+export declare function buildCatalog(app: string, catalogDirs: readonly string[]): BuiltCatalog;
+/** The manifest of the app at `<examplesDir>/<App>` (all catalogs under it). */
+export declare function buildAppCatalog(examplesDir: string, app: string): BuiltCatalog;
+export declare function catalogJson(catalog: AssetCatalog): string;
+/** The app named by a manifest request URL (`/catalog/<App>.json`), or null. */
+export declare function catalogRequestApp(url: string): string | null;
+/** The app and published file name of an asset file request, or null. */
+export declare function catalogRequestFile(url: string): {
+    app: string;
+    fileName: string;
+} | null;
+/** The fields of an {@link AppSpec} the catalog plugin reads. */
+export type CatalogSpec = Pick<AppSpec, 'name' | 'catalogs'>;
+export declare function assetCatalogs(specs: readonly CatalogSpec[]): Plugin;
+//# sourceMappingURL=asset-catalogs.d.ts.map

package/node/dist/plugins/asset-catalogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-catalogs.d.ts","sourceRoot":"","sources":["../../../plugins/asset-catalogs.ts"],"names":[],"mappings":"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"}