@rsc-kit/core 0.20.13 → 0.21.1

package/dist/webManifest.d.ts

@@ -1,5 +1,21 @@
+/** A jump into the app from its icon - a long press on Android, a right click on desktop. */
+export interface ManifestShortcut {
+    name: string;
+    shortName?: string;
+    description?: string;
+    url: string;
+    /** Paths, like `icons`: sizes read from the filename. */
+    icons?: string[];
+}
 /** What `rscKit({ manifest })` takes. */
 export interface WebManifestOptions {
+    /**
+     * The app's identity. Without it a browser derives one from `startUrl`, and
+     * changing that later leaves everyone who installed with an orphaned app -
+     * a different app, as far as their device is concerned. `'/'` is right for
+     * almost everyone, set once and never changed.
+     */
+    id?: string;
     /** The app's name, as an install prompt shows it. */
     name: string;
     /** The short name a home screen uses when there is no room for the full one. */
@@ -19,6 +35,20 @@ export interface WebManifestOptions {
     icons?: string[];
     /** Where an installed launch lands. Defaults to `/`. */
     startUrl?: string;
+    /** The urls that are the app; a link outside it opens in the browser. Defaults to the start url's directory. */
+    scope?: string;
+    /** Lock the installed app to a way of holding the device. */
+    orientation?: 'any' | 'natural' | 'portrait' | 'landscape' | 'portrait-primary' | 'landscape-primary';
+    /** What a store or an install sheet files it under: `['productivity']`. */
+    categories?: string[];
+    /** Jumps from the app's icon. */
+    shortcuts?: ManifestShortcut[];
+    /**
+     * What Chrome's richer install sheet shows. Rarely written here: an
+     * `app/screenshot-wide-1280x720.png` or `screenshot-narrow-…` is found by
+     * name, its size and form factor read from it - see the PWA guide.
+     */
+    screenshots?: string[];
     /** Defaults to `standalone`, which is the one that looks like an app. */
     display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';
     /** The colour a browser paints its chrome. Also emitted as a meta tag. */
@@ -28,6 +58,13 @@ export interface WebManifestOptions {
     /** Anything else the spec allows, passed through untouched. */
     other?: Record<string, unknown>;
 }
+/** An icon drawn for a launcher's mask: `icon-maskable-512.png`. */
+export declare function isMaskable(file: string): boolean;
+/** A screenshot's size, from `screenshot-wide-1280x720.png`; null when the name carries none. */
+export declare function screenshotSize(file: string): {
+    width: number;
+    height: number;
+} | null;
 /** Where the manifest is written and linked from. */
 export declare const MANIFEST_PATH = "/manifest.webmanifest";
 /**

package/dist/webManifest.js

@@ -9,6 +9,15 @@
 // Everything here is the web app manifest spec rather than an invention of
 // this package, so the names are its names and anything it accepts that is not
 // spelled out below can be passed through `other`.
+/** An icon drawn for a launcher's mask: `icon-maskable-512.png`. */
+export function isMaskable(file) {
+    return /(^|[/-])maskable\b/i.test(file);
+}
+/** A screenshot's size, from `screenshot-wide-1280x720.png`; null when the name carries none. */
+export function screenshotSize(file) {
+    const match = /(\d{3,4})x(\d{3,4})\.(?:png|webp|jpe?g)$/i.exec(file);
+    return match ? { width: Number(match[1]), height: Number(match[2]) } : null;
+}
 /** Where the manifest is written and linked from. */
 export const MANIFEST_PATH = '/manifest.webmanifest';
 /**
@@ -30,28 +39,54 @@ function typeOf(file) {
             ? 'image/jpeg'
             : `image/${extension}`;
 }
+/** One icon, as the manifest spec writes it. */
+function iconEntry(file) {
+    const size = sizeOf(file);
+    return {
+        src: file.startsWith('/') ? file : `/${file}`,
+        type: typeOf(file),
+        ...(size ? { sizes: `${size}x${size}` } : {}),
+        // One purpose per icon, from the name. A maskable icon is drawn with a
+        // safe zone - the middle 80% is all a launcher promises to show - so
+        // used as "any" it looks shrunk, and an ordinary icon used as
+        // "maskable" has its corners cut off. "any maskable" on one file was
+        // both at once, and the Android splash drew the shrunk one.
+        purpose: isMaskable(file) ? 'maskable' : 'any',
+    };
+}
 /** The manifest's JSON, ready to write. */
 export function webManifest(options) {
-    const icons = (options.icons ?? []).map((file) => {
-        const size = sizeOf(file);
+    const icons = (options.icons ?? []).map(iconEntry);
+    const shortcuts = (options.shortcuts ?? []).map((shortcut) => ({
+        name: shortcut.name,
+        ...(shortcut.shortName ? { short_name: shortcut.shortName } : {}),
+        ...(shortcut.description ? { description: shortcut.description } : {}),
+        url: shortcut.url,
+        ...(shortcut.icons?.length ? { icons: shortcut.icons.map(iconEntry) } : {}),
+    }));
+    const screenshots = (options.screenshots ?? []).map((file) => {
+        const size = screenshotSize(file);
         return {
             src: file.startsWith('/') ? file : `/${file}`,
             type: typeOf(file),
-            ...(size ? { sizes: `${size}x${size}` } : {}),
-            // Maskable as well as any: without it Android crops a square icon into a
-            // circle and takes the corners off whatever is in them.
-            purpose: 'any maskable',
+            ...(size ? { sizes: `${size.width}x${size.height}`, form_factor: size.width > size.height ? 'wide' : 'narrow' } : {}),
         };
     });
     return (JSON.stringify({
+        ...(options.id ? { id: options.id } : {}),
         name: options.name,
         short_name: options.shortName ?? options.name,
         ...(options.description ? { description: options.description } : {}),
         start_url: options.startUrl ?? '/',
+        ...(options.scope ? { scope: options.scope } : {}),
         display: options.display ?? 'standalone',
+        ...(options.orientation ? { orientation: options.orientation } : {}),
+        ...(options.categories?.length ? { categories: options.categories } : {}),
         ...(options.themeColor ? { theme_color: options.themeColor } : {}),
         ...(options.backgroundColor ? { background_color: options.backgroundColor } : {}),
         ...(icons.length ? { icons } : {}),
+        ...(shortcuts.length ? { shortcuts } : {}),
+        ...(screenshots.length ? { screenshots } : {}),
         ...(options.other ?? {}),
     }, null, 2) + '\n');
 }
@@ -76,6 +111,16 @@ export function manifestWarning(options) {
     if (largest < 512) {
         return 'manifest: no 512px icon, so a splash screen will be upscaled from a smaller one.';
     }
+    // Android builds its splash from the name, the largest icon and this
+    // colour. Without it the splash is white, whatever the app looks like.
+    if (!options.backgroundColor) {
+        return 'manifest: no backgroundColor, so the Android splash screen is white. Set it to the colour the app starts on.';
+    }
+    // The one that bites later rather than now: an install keyed on startUrl
+    // is a different app the day startUrl changes.
+    if (!options.id) {
+        return "manifest: no id, so the app's identity is its startUrl - change that and everyone who installed has a different app. Set id: '/'.";
+    }
     return null;
 }
 //# sourceMappingURL=webManifest.js.map

package/dist/webManifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"webManifest.js","sourceRoot":"","sources":["../src/webManifest.ts"],"names":[],"mappings":"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","sourcesContent":["// The file that makes an app installable.\n//\n// A service worker makes an app work offline; this is what makes a browser\n// offer to put it on a home screen. They are separate decisions and separate\n// options, because an app can want either without the other — a site that\n// should survive a dead network is not necessarily one anybody wants as an\n// icon, and vice versa.\n//\n// Everything here is the web app manifest spec rather than an invention of\n// this package, so the names are its names and anything it accepts that is not\n// spelled out below can be passed through `other`.\n\n/** What `rscKit({ manifest })` takes. */\nexport interface WebManifestOptions {\n  /** The app's name, as an install prompt shows it. */\n  name: string\n  /** The short name a home screen uses when there is no room for the full one. */\n  shortName?: string\n  description?: string\n  /**\n   * The icons a browser may install.\n   *\n   * Paths relative to the client output — a file in `public/` is served at its\n   * own name, so `icon-192.png` is usually right. Sizes and types are read from\n   * the filename rather than declared twice.\n   *\n   * A browser will not offer to install an app with no icon of at least 192px,\n   * so the build says so rather than writing a manifest that quietly does\n   * nothing.\n   */\n  icons?: string[]\n  /** Where an installed launch lands. Defaults to `/`. */\n  startUrl?: string\n  /** Defaults to `standalone`, which is the one that looks like an app. */\n  display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser'\n  /** The colour a browser paints its chrome. Also emitted as a meta tag. */\n  themeColor?: string\n  /** The colour behind the app while it is starting. */\n  backgroundColor?: string\n  /** Anything else the spec allows, passed through untouched. */\n  other?: Record<string, unknown>\n}\n\n/** Where the manifest is written and linked from. */\nexport const MANIFEST_PATH = '/manifest.webmanifest'\n\n/**\n * The size a filename claims, or null.\n *\n * `icon-192.png` and `icon-192x192.png` both read as 192. Declaring it in the\n * options as well would be the same number written twice, and the one that\n * drifts is the one nobody looks at.\n */\nexport function sizeOf(file: string): number | null {\n  const match = /(\\d{2,4})(?:x\\d{2,4})?\\.(?:png|webp|jpg|jpeg|svg)$/i.exec(file)\n\n  return match ? Number(match[1]) : null\n}\n\nfunction typeOf(file: string): string {\n  const extension = file.slice(file.lastIndexOf('.') + 1).toLowerCase()\n\n  return extension === 'svg'\n    ? 'image/svg+xml'\n    : extension === 'jpg' || extension === 'jpeg'\n      ? 'image/jpeg'\n      : `image/${extension}`\n}\n\n/** The manifest's JSON, ready to write. */\nexport function webManifest(options: WebManifestOptions): string {\n  const icons = (options.icons ?? []).map((file) => {\n    const size = sizeOf(file)\n\n    return {\n      src: file.startsWith('/') ? file : `/${file}`,\n      type: typeOf(file),\n      ...(size ? { sizes: `${size}x${size}` } : {}),\n      // Maskable as well as any: without it Android crops a square icon into a\n      // circle and takes the corners off whatever is in them.\n      purpose: 'any maskable',\n    }\n  })\n\n  return (\n    JSON.stringify(\n      {\n        name: options.name,\n        short_name: options.shortName ?? options.name,\n        ...(options.description ? { description: options.description } : {}),\n        start_url: options.startUrl ?? '/',\n        display: options.display ?? 'standalone',\n        ...(options.themeColor ? { theme_color: options.themeColor } : {}),\n        ...(options.backgroundColor ? { background_color: options.backgroundColor } : {}),\n        ...(icons.length ? { icons } : {}),\n        ...(options.other ?? {}),\n      },\n      null,\n      2,\n    ) + '\\n'\n  )\n}\n\n/**\n * Whether these options produce something a browser would actually install.\n *\n * Returned as a sentence rather than thrown: a manifest with no icon is still\n * a valid manifest and still sets the theme colour, so refusing the build over\n * it would be refusing something that works. But an author who wrote\n * `manifest: {...}` meant \"installable\", and silence here is how they find out\n * months later that it never was.\n */\nexport function manifestWarning(options: WebManifestOptions): string | null {\n  const icons = options.icons ?? []\n\n  if (icons.length === 0) {\n    return 'manifest: no icons, so no browser will offer to install this. Add a 192px and a 512px png.'\n  }\n\n  const largest = icons.reduce((best, file) => Math.max(best, sizeOf(file) ?? 0), 0)\n\n  if (largest < 192) {\n    return 'manifest: no icon of 192px or more, which is the smallest a browser will install. Sizes are read from the filename, so name it like icon-192.png.'\n  }\n\n  if (largest < 512) {\n    return 'manifest: no 512px icon, so a splash screen will be upscaled from a smaller one.'\n  }\n\n  return null\n}\n\n/** The type a src/app/manifest.ts file satisfies. */\nexport type WebManifest = WebManifestOptions\n"]}
+{"version":3,"file":"webManifest.js","sourceRoot":"","sources":["../src/webManifest.ts"],"names":[],"mappings":"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","sourcesContent":["// The file that makes an app installable.\n//\n// A service worker makes an app work offline; this is what makes a browser\n// offer to put it on a home screen. They are separate decisions and separate\n// options, because an app can want either without the other — a site that\n// should survive a dead network is not necessarily one anybody wants as an\n// icon, and vice versa.\n//\n// Everything here is the web app manifest spec rather than an invention of\n// this package, so the names are its names and anything it accepts that is not\n// spelled out below can be passed through `other`.\n\n/** A jump into the app from its icon - a long press on Android, a right click on desktop. */\nexport interface ManifestShortcut {\n  name: string\n  shortName?: string\n  description?: string\n  url: string\n  /** Paths, like `icons`: sizes read from the filename. */\n  icons?: string[]\n}\n\n/** What `rscKit({ manifest })` takes. */\nexport interface WebManifestOptions {\n  /**\n   * The app's identity. Without it a browser derives one from `startUrl`, and\n   * changing that later leaves everyone who installed with an orphaned app -\n   * a different app, as far as their device is concerned. `'/'` is right for\n   * almost everyone, set once and never changed.\n   */\n  id?: string\n  /** The app's name, as an install prompt shows it. */\n  name: string\n  /** The short name a home screen uses when there is no room for the full one. */\n  shortName?: string\n  description?: string\n  /**\n   * The icons a browser may install.\n   *\n   * Paths relative to the client output — a file in `public/` is served at its\n   * own name, so `icon-192.png` is usually right. Sizes and types are read from\n   * the filename rather than declared twice.\n   *\n   * A browser will not offer to install an app with no icon of at least 192px,\n   * so the build says so rather than writing a manifest that quietly does\n   * nothing.\n   */\n  icons?: string[]\n  /** Where an installed launch lands. Defaults to `/`. */\n  startUrl?: string\n  /** The urls that are the app; a link outside it opens in the browser. Defaults to the start url's directory. */\n  scope?: string\n  /** Lock the installed app to a way of holding the device. */\n  orientation?: 'any' | 'natural' | 'portrait' | 'landscape' | 'portrait-primary' | 'landscape-primary'\n  /** What a store or an install sheet files it under: `['productivity']`. */\n  categories?: string[]\n  /** Jumps from the app's icon. */\n  shortcuts?: ManifestShortcut[]\n  /**\n   * What Chrome's richer install sheet shows. Rarely written here: an\n   * `app/screenshot-wide-1280x720.png` or `screenshot-narrow-…` is found by\n   * name, its size and form factor read from it - see the PWA guide.\n   */\n  screenshots?: string[]\n  /** Defaults to `standalone`, which is the one that looks like an app. */\n  display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser'\n  /** The colour a browser paints its chrome. Also emitted as a meta tag. */\n  themeColor?: string\n  /** The colour behind the app while it is starting. */\n  backgroundColor?: string\n  /** Anything else the spec allows, passed through untouched. */\n  other?: Record<string, unknown>\n}\n\n/** An icon drawn for a launcher's mask: `icon-maskable-512.png`. */\nexport function isMaskable(file: string): boolean {\n  return /(^|[/-])maskable\\b/i.test(file)\n}\n\n/** A screenshot's size, from `screenshot-wide-1280x720.png`; null when the name carries none. */\nexport function screenshotSize(file: string): { width: number; height: number } | null {\n  const match = /(\\d{3,4})x(\\d{3,4})\\.(?:png|webp|jpe?g)$/i.exec(file)\n\n  return match ? { width: Number(match[1]), height: Number(match[2]) } : null\n}\n\n/** Where the manifest is written and linked from. */\nexport const MANIFEST_PATH = '/manifest.webmanifest'\n\n/**\n * The size a filename claims, or null.\n *\n * `icon-192.png` and `icon-192x192.png` both read as 192. Declaring it in the\n * options as well would be the same number written twice, and the one that\n * drifts is the one nobody looks at.\n */\nexport function sizeOf(file: string): number | null {\n  const match = /(\\d{2,4})(?:x\\d{2,4})?\\.(?:png|webp|jpg|jpeg|svg)$/i.exec(file)\n\n  return match ? Number(match[1]) : null\n}\n\nfunction typeOf(file: string): string {\n  const extension = file.slice(file.lastIndexOf('.') + 1).toLowerCase()\n\n  return extension === 'svg'\n    ? 'image/svg+xml'\n    : extension === 'jpg' || extension === 'jpeg'\n      ? 'image/jpeg'\n      : `image/${extension}`\n}\n\n/** One icon, as the manifest spec writes it. */\nfunction iconEntry(file: string) {\n  const size = sizeOf(file)\n\n  return {\n    src: file.startsWith('/') ? file : `/${file}`,\n    type: typeOf(file),\n    ...(size ? { sizes: `${size}x${size}` } : {}),\n    // One purpose per icon, from the name. A maskable icon is drawn with a\n    // safe zone - the middle 80% is all a launcher promises to show - so\n    // used as \"any\" it looks shrunk, and an ordinary icon used as\n    // \"maskable\" has its corners cut off. \"any maskable\" on one file was\n    // both at once, and the Android splash drew the shrunk one.\n    purpose: isMaskable(file) ? 'maskable' : 'any',\n  }\n}\n\n/** The manifest's JSON, ready to write. */\nexport function webManifest(options: WebManifestOptions): string {\n  const icons = (options.icons ?? []).map(iconEntry)\n\n  const shortcuts = (options.shortcuts ?? []).map((shortcut) => ({\n    name: shortcut.name,\n    ...(shortcut.shortName ? { short_name: shortcut.shortName } : {}),\n    ...(shortcut.description ? { description: shortcut.description } : {}),\n    url: shortcut.url,\n    ...(shortcut.icons?.length ? { icons: shortcut.icons.map(iconEntry) } : {}),\n  }))\n\n  const screenshots = (options.screenshots ?? []).map((file) => {\n    const size = screenshotSize(file)\n\n    return {\n      src: file.startsWith('/') ? file : `/${file}`,\n      type: typeOf(file),\n      ...(size ? { sizes: `${size.width}x${size.height}`, form_factor: size.width > size.height ? 'wide' : 'narrow' } : {}),\n    }\n  })\n\n  return (\n    JSON.stringify(\n      {\n        ...(options.id ? { id: options.id } : {}),\n        name: options.name,\n        short_name: options.shortName ?? options.name,\n        ...(options.description ? { description: options.description } : {}),\n        start_url: options.startUrl ?? '/',\n        ...(options.scope ? { scope: options.scope } : {}),\n        display: options.display ?? 'standalone',\n        ...(options.orientation ? { orientation: options.orientation } : {}),\n        ...(options.categories?.length ? { categories: options.categories } : {}),\n        ...(options.themeColor ? { theme_color: options.themeColor } : {}),\n        ...(options.backgroundColor ? { background_color: options.backgroundColor } : {}),\n        ...(icons.length ? { icons } : {}),\n        ...(shortcuts.length ? { shortcuts } : {}),\n        ...(screenshots.length ? { screenshots } : {}),\n        ...(options.other ?? {}),\n      },\n      null,\n      2,\n    ) + '\\n'\n  )\n}\n\n/**\n * Whether these options produce something a browser would actually install.\n *\n * Returned as a sentence rather than thrown: a manifest with no icon is still\n * a valid manifest and still sets the theme colour, so refusing the build over\n * it would be refusing something that works. But an author who wrote\n * `manifest: {...}` meant \"installable\", and silence here is how they find out\n * months later that it never was.\n */\nexport function manifestWarning(options: WebManifestOptions): string | null {\n  const icons = options.icons ?? []\n\n  if (icons.length === 0) {\n    return 'manifest: no icons, so no browser will offer to install this. Add a 192px and a 512px png.'\n  }\n\n  const largest = icons.reduce((best, file) => Math.max(best, sizeOf(file) ?? 0), 0)\n\n  if (largest < 192) {\n    return 'manifest: no icon of 192px or more, which is the smallest a browser will install. Sizes are read from the filename, so name it like icon-192.png.'\n  }\n\n  if (largest < 512) {\n    return 'manifest: no 512px icon, so a splash screen will be upscaled from a smaller one.'\n  }\n\n  // Android builds its splash from the name, the largest icon and this\n  // colour. Without it the splash is white, whatever the app looks like.\n  if (!options.backgroundColor) {\n    return 'manifest: no backgroundColor, so the Android splash screen is white. Set it to the colour the app starts on.'\n  }\n\n  // The one that bites later rather than now: an install keyed on startUrl\n  // is a different app the day startUrl changes.\n  if (!options.id) {\n    return \"manifest: no id, so the app's identity is its startUrl - change that and everyone who installed has a different app. Set id: '/'.\"\n  }\n\n  return null\n}\n\n/** The type a src/app/manifest.ts file satisfies. */\nexport type WebManifest = WebManifestOptions\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsc-kit/core",
-  "version": "0.20.13",
+  "version": "0.21.1",
   "description": "React Server Components as a Vite plugin. Routing, streaming, server actions, typed urls and build-time prerendering — deploy to Bun, Node, Workers, Vercel or Deno.",
   "license": "MIT",
   "type": "module",
@@ -85,6 +85,10 @@
       "types": "./dist/js/Form.d.ts",
       "default": "./dist/js/Form.js"
     },
+    "./install": {
+      "types": "./dist/js/useInstall.d.ts",
+      "default": "./dist/js/useInstall.js"
+    },
     "./section": {
       "types": "./dist/js/section.d.ts",
       "default": "./dist/js/section.js"
@@ -215,10 +219,10 @@
     }
   },
   "peerDependencies": {
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
     "vite": "^8.0.0",
-    "@vitejs/plugin-rsc": "^0.5.0",
+    "@vitejs/plugin-rsc": "^0.5.34",
     "nuqs": ">=2.4.0"
   },
   "peerDependenciesMeta": {