diff --git a/CHANGELOG.md b/CHANGELOG.md
index b6e33437..bb14c639 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,6 +16,8 @@ Notable user-visible changes are recorded here. ScriptWidget follows semantic ve
- Fix native Promise callback ownership so completed and abandoned executions release their JavaScript VM and snapshot.
- Serialize native runtime subscription, result delivery and cancellation to prevent intermittent empty results and reference-lifetime crashes.
- Fix bundled templates whose text was cut off or pushed out of the widget, most visibly with the wider font of Android, Windows and Linux: Month Calendar (long month names, six-week months), the Daily Command Center, Family Command Board, Travel Day and Wellness dashboards, World Clock Faces and Year in Dots at the extra-large size, and fifteen smaller templates.
+- Give 21 bundled templates that had one layout a small-widget layout showing their essential content (clocks, battery, focus, reading, sleep, system and the five dashboards), give the Daily Command Center, Family Command Board, Monthly Budget, Travel Day and Wellness dashboards a medium layout, and fix the overlapping rows of the large Monthly Budget Planner and the cut-off header of the medium Personal Dashboard.
+- Fix Text Year Days Left, which counted to 31 January of the next year and so showed 31 days too many.
- Continue expanded personal-data APIs, authenticated services/music and visual editing on the same release branch; M3–M5 remain in progress.
## Unreleased
diff --git a/Editor/editorfe/scripts/generate-api-docs.mjs b/Editor/editorfe/scripts/generate-api-docs.mjs
index 5441b399..ea61cc4f 100644
--- a/Editor/editorfe/scripts/generate-api-docs.mjs
+++ b/Editor/editorfe/scripts/generate-api-docs.mjs
@@ -1,6 +1,7 @@
-import { writeFile } from "node:fs/promises";
+import { readFile, writeFile } from "node:fs/promises";
import { scriptWidgetAPI as api } from "../src/scriptWidgetAPI.js";
import { dataAPICatalog } from "../src/dataAPICatalog.js";
+import { platformCell, platformColumns, platformRow, platformSentence, platformSupport } from "../src/platformSupport.js";
const outputURL = new URL("../../../docs/scriptwidget-runtime-api.md", import.meta.url);
@@ -32,17 +33,96 @@ lines.push("", "## Environment values", "", ...api.environmentValues.map((name)
await writeFile(outputURL, `${lines.join("\n")}\n`);
+// Which systems each API runs on, from platformSupport.js.
+
+// Its Apple columns must say what the catalog says.
+for (const group of [...new Set(dataAPICatalog.map((item) => item.group))]) {
+ const row = platformRow(`$${group}`);
+ if (!row) throw new Error(`platformSupport.js has no row for $${group}`);
+ for (const item of dataAPICatalog.filter((entry) => entry.group === group)) {
+ for (const id of ["ios", "macos"]) {
+ if (item.platforms.includes(id) !== (row[id] !== false)) {
+ throw new Error(`${item.id}: platformSupport.js and dataAPICatalog.js disagree about ${id}`);
+ }
+ }
+ }
+}
+
+const code = (names) => names.map((name) => `\`${name}\``).join(", ");
+
+const platformTable = [
+ `| API | ${platformColumns.map((column) => column.title).join(" | ")} |`,
+ `| --- | ${platformColumns.map(() => "---").join(" | ")} |`,
+ ...platformSupport.map((row) => `| ${row.label ?? code(row.apis)} | ${platformColumns.map((column) => platformCell(row[column.id])).join(" | ")} |`),
+];
+
+function sentence(row) {
+ const { yes, no } = platformSentence(row);
+ return `${yes}.${no ? ` **Not on:** ${no}.` : ""}`;
+}
+
+// The note at the top of a page about one API or a few.
+function runsOn(apis) {
+ const rows = [...new Set(apis.map((name) => {
+ const row = platformRow(name);
+ if (!row) throw new Error(`platformSupport.js has no row for ${name}`);
+ return row;
+ }))];
+ const link = "Details and limits: [Platform support](platform-support.md).";
+ if (rows.length === 1) return [`> **Runs on:** ${sentence(rows[0])} ${link}`];
+ return [
+ "> **Runs on**",
+ ">",
+ ...rows.map((row) => `> - ${code(row.apis.filter((name) => apis.includes(name)))}: ${sentence(row)}`),
+ ">",
+ `> ${link}`,
+ ];
+}
+
+// Replaces what is between the two markers of a hand-written page.
+async function writeBetweenMarkers(file, content) {
+ const url = new URL(`../../../docs/${file}`, import.meta.url);
+ const text = await readFile(url, "utf8");
+ const start = "", end = "";
+ const from = text.indexOf(start), to = text.indexOf(end);
+ if (from < 0 || to < from) throw new Error(`docs/${file} has no platforms markers`);
+ await writeFile(url, `${text.slice(0, from + start.length)}\n${content.join("\n")}\n${text.slice(to)}`);
+}
+
+await writeBetweenMarkers("platform-support.md", platformTable);
+await writeBetweenMarkers("runtime-api.md", platformTable);
+for (const [file, apis] of Object.entries({
+ "calendar-api.md": ["$calendar"],
+ "file-api.md": ["$file"],
+ "health-api.md": ["$health"],
+ "http-response-api.md": ["$http"],
+ "icloud-json-api.md": ["$icloud"],
+ "location-api.md": ["$location"],
+ "music-api.md": ["$music"],
+ "photos-api.md": ["$photos"],
+ "reminders-api.md": ["$reminders"],
+ "services-api.md": ["$services"],
+ "storage-api.md": ["$storage"],
+ "system-services-api.md": ["$weather", "$alarms", "$documents", "$contacts", "$maps", "$home", "$notifications"],
+})) {
+ await writeBetweenMarkers(file, runsOn(apis));
+}
+
const dataLines = [
"# Data API capability catalog", "",
- "> Generated from `Editor/editorfe/src/dataAPICatalog.js`. Native JSExport protocols remain authoritative. This catalog is descriptive and grants no permissions.", "",
+ "> Generated from `Editor/editorfe/src/dataAPICatalog.js` and `Editor/editorfe/src/platformSupport.js`. Native JSExport protocols remain authoritative. This catalog is descriptive and grants no permissions.", "",
"This covers device, system, health, location, calendar, reminders, photos and connected-service data methods. Files, network, storage, rendering and runtime configuration retain their own contracts. Platforms list intended real-data support, not mocked browser execution; hardware and OS authorization still determine availability.", "",
"Existing data-method return formats are unchanged. Present manifests now undergo package and minimum-version validation before execution. In particular, HealthKit does not expose individual read-denial status, and location cache presence is not proof that permission is still granted. Default mock values are illustrative, never measurements from the current device.", "",
+ "## Which systems each API runs on", "",
+ "\"Native platforms\" in the method table below means the Apple systems. Android, Windows and Linux run the same scripts on another engine; what they support is per API, not per method, and [Platform support](platform-support.md) explains each limit. An API a system lacks answers `false` from `isAvailable()` and rejects with `[unsupported_platform]`.", "",
+ ...platformTable, "",
+ "## Methods", "",
"| API | Minimum native API | Native platforms | Execution | Authorization | Operation |", "| --- | --- | --- | --- | --- | --- |",
...dataAPICatalog.map((item) => `| \`${item.id}(${item.arguments.join(", ")})\` | ${item.minimumRuntimeVersion} | ${item.platforms.join(", ")} | ${item.asynchronous ? "Promise" : "Synchronous"} | ${item.authorization} | ${item.operation} |`), "",
];
for (const group of [...new Set(dataAPICatalog.map((item) => item.group))]) {
const entries = dataAPICatalog.filter((item) => item.group === group);
- dataLines.push(`## ${group}`, "", entries[0].notes, "");
+ dataLines.push(`## ${group}`, "", entries[0].notes, "", `**Runs on:** ${sentence(platformRow(`$${group}`))}`, "");
for (const entry of entries) {
dataLines.push(`### \`${entry.id}\``, "", "Default editable preview sample:", "", "```json", JSON.stringify(entry.value, null, 2), "```", "");
}
diff --git a/Editor/editorfe/src/platformSupport.js b/Editor/editorfe/src/platformSupport.js
new file mode 100644
index 00000000..af59ecb9
--- /dev/null
+++ b/Editor/editorfe/src/platformSupport.js
@@ -0,0 +1,60 @@
+// Which systems each global API runs on. One row per API (or group of APIs
+// with the same answer). `true` is "Yes", `false` is "No", a string is "Yes"
+// with that limit, written as the cell's text.
+//
+// This file is the source of the tables that `npm run docs` writes into
+// docs/platform-support.md, docs/runtime-api.md, docs/data-api-catalog.md and
+// the per-API pages. The authorities for each column are named in
+// docs/platform-support.md; change this file when one of them changes.
+//
+// The iPhone/iPad and Mac columns of the data APIs must agree with the
+// `platforms` of dataAPICatalog.js; the generator refuses to run otherwise.
+
+export const platformColumns = [
+ { id: "ios", title: "iPhone and iPad" },
+ { id: "macos", title: "Mac" },
+ { id: "android", title: "Android" },
+ { id: "windows", title: "Windows" },
+ { id: "linux", title: "Linux" },
+];
+
+const everywhere = { ios: true, macos: true, android: true, windows: true, linux: true };
+const appleOnly = { android: false, windows: false, linux: false };
+
+export const platformSupport = [
+ { apis: ["$device", "$system", "$storage", "$file", "fetch", "$http", "$xml"], ...everywhere },
+ { apis: ["$dataSource"], label: "`$dataSource` (Data Source Plugins)", ...everywhere },
+ { apis: ["$weather"], ...everywhere },
+ { apis: ["$calendar"], ios: true, macos: true, android: "Yes, for calendars selected in the app", windows: false, linux: false },
+ { apis: ["$photos"], ios: true, macos: true, android: "Individual photos picked in the app, no albums", windows: false, linux: false },
+ { apis: ["$contacts", "$documents"], ios: true, macos: true, android: "Yes, for items picked in the app", windows: false, linux: false },
+ { apis: ["$maps"], ios: true, macos: true, android: "Geocoding and place search; no `snapshot`", windows: false, linux: false },
+ { apis: ["$notifications"], ios: true, macos: true, android: "Yes, delivery is inexact", windows: false, linux: false },
+ { apis: ["$services"], label: "`$services` (GitHub)", ios: true, macos: true, android: "With a fine-grained token, no OAuth sign-in", windows: false, linux: false },
+ { apis: ["$icloud"], ios: true, macos: true, android: "A sync folder the user picks; cannot exchange data with an iPhone", windows: false, linux: false },
+ { apis: ["$location"], ios: true, macos: false, android: "Yes; widgets see the position saved while the app was open", windows: false, linux: false },
+ { apis: ["$health"], ios: true, macos: false, android: "Health Connect; no ring goals or stand time", windows: false, linux: false },
+ { apis: ["$music"], ios: true, macos: false, android: "The active media session of any app", windows: false, linux: false },
+ { apis: ["$alarms"], ios: true, macos: false, android: "Yes, inexact, no system alarm UI", windows: false, linux: false },
+ { apis: ["$reminders"], ios: true, macos: true, ...appleOnly },
+ { apis: ["$home"], ios: true, macos: false, ...appleOnly },
+];
+
+export function platformRow(api) {
+ return platformSupport.find((row) => row.apis.includes(api));
+}
+
+export function platformCell(value) {
+ return value === true ? "Yes" : value === false ? "No" : value;
+}
+
+// "iPhone and iPad, Mac, Android (…)" and "Windows, Linux" for one row.
+export function platformSentence(row) {
+ const yes = [], no = [];
+ for (const column of platformColumns) {
+ const value = row[column.id];
+ if (value === false) no.push(column.title);
+ else yes.push(value === true ? column.title : `${column.title} (${value.replace(/^Yes[,;] /, "")})`);
+ }
+ return { yes: yes.join(", "), no: no.join(", ") };
+}
diff --git a/Editor/editorfe/test/platformSupport.test.js b/Editor/editorfe/test/platformSupport.test.js
new file mode 100644
index 00000000..c964a25e
--- /dev/null
+++ b/Editor/editorfe/test/platformSupport.test.js
@@ -0,0 +1,35 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { dataAPICatalog } from "../src/dataAPICatalog.js";
+import { platformColumns, platformRow, platformSentence, platformSupport } from "../src/platformSupport.js";
+
+test("every API is in one row and every row answers for every system", () => {
+ const names = platformSupport.flatMap((row) => row.apis);
+ assert.equal(new Set(names).size, names.length);
+ for (const row of platformSupport) {
+ for (const column of platformColumns) {
+ const value = row[column.id];
+ assert.ok(typeof value === "boolean" || (typeof value === "string" && value.length > 0), `${row.apis[0]} ${column.id}`);
+ }
+ }
+});
+
+test("the Apple columns agree with the data API catalog", () => {
+ for (const item of dataAPICatalog) {
+ const row = platformRow(`$${item.group}`);
+ assert.ok(row, item.group);
+ assert.equal(row.ios !== false, item.platforms.includes("ios"), item.id);
+ assert.equal(row.macos !== false, item.platforms.includes("macos"), item.id);
+ }
+});
+
+test("a row reads as a sentence", () => {
+ assert.deepEqual(platformSentence(platformRow("$health")), {
+ yes: "iPhone and iPad, Android (Health Connect; no ring goals or stand time)",
+ no: "Mac, Windows, Linux",
+ });
+ assert.deepEqual(platformSentence(platformRow("$storage")), {
+ yes: "iPhone and iPad, Mac, Android, Windows, Linux",
+ no: "",
+ });
+});
diff --git a/README_AR.md b/README_AR.md
index 99837129..9720006a 100644
--- a/README_AR.md
+++ b/README_AR.md
@@ -20,6 +20,25 @@ ScriptWidget منصة مفتوحة المصدر بترخيص Apache 2.0 لإنش
تطبيق Android (الإصدار 1.0.0، يتطلب Android 15 أو أحدث) متاح كملف [APK على GitHub Releases](https://github.com/everettjf/scriptwidget/releases/tag/android-v1.0.0). على Google Play هو في اختبار مغلق: للانضمام، انضم إلى [مجموعة Atomsprout Testers](https://groups.google.com/g/atomsprout). راجع [ScriptWidget لنظام Android](docs/android/README.md).
+نسختا Windows وLinux تجريبيتان: [Windows 0.1.0](https://github.com/everettjf/scriptwidget/releases/tag/windows-v0.1.0) يتطلب Windows 11، راجع [ScriptWidget لنظام Windows](docs/windows/README.md)؛ ونسخة Linux تعمل حاليًا على [Omarchy](https://omarchy.org) 4.5، والأرشيفات متاحة على [GitHub Releases](https://github.com/everettjf/scriptwidget/releases)، راجع [ScriptWidget لنظام Linux](docs/linux/README.md). تشغّل النسختان حزم الأدوات المصغّرة نفسها، لكن لا تتوفر فيهما واجهات بيانات الجهاز مثل الصحة والتقويم والموقع والموسيقى.
+
+### لقطات شاشة من كل منصة
+
+جميعها لقطات شاشة حقيقية. نسختا Windows وLinux تجريبيتان.
+
+| iPhone | iPad | Mac |
+| --- | --- | --- |
+|  |  |  |
+
+| Android | Windows | Linux (Omarchy) |
+| --- | --- | --- |
+|  |  |  |
+|  |  |  |
+
+| Web Studio |
+| --- |
+|  |
+
## لماذا ScriptWidget؟
- يعمل السكربت نفسه على iOS وiPadOS وmacOS، وكذلك على Android (قيد الاختبار)، مع تخطيطات متكيفة عبر `$getenv("widget-size")`.
diff --git a/README_DE.md b/README_DE.md
index 0dfffcf6..71b7dca1 100644
--- a/README_DE.md
+++ b/README_DE.md
@@ -18,6 +18,25 @@ ScriptWidget ist eine Open-Source-Plattform unter der Apache 2.0-Lizenz zum Erst
Die Android-App (Version 1.0.0, ab Android 15) gibt es als [APK in den GitHub Releases](https://github.com/everettjf/scriptwidget/releases/tag/android-v1.0.0). Bei Google Play läuft ein geschlossener Test: Wer teilnehmen möchte, tritt der [Gruppe Atomsprout Testers](https://groups.google.com/g/atomsprout) bei. Siehe [ScriptWidget für Android](docs/android/README.md).
+Die Versionen für Windows und Linux sind Vorschauversionen: [Windows 0.1.0](https://github.com/everettjf/scriptwidget/releases/tag/windows-v0.1.0) benötigt Windows 11, siehe [ScriptWidget für Windows](docs/windows/README.md); die Linux-Version läuft derzeit unter [Omarchy](https://omarchy.org) 4.5, die Archive liegen in den [GitHub Releases](https://github.com/everettjf/scriptwidget/releases), siehe [ScriptWidget für Linux](docs/linux/README.md). Beide führen dieselben Widget-Pakete aus, haben aber keine APIs für Gerätedaten wie Gesundheit, Kalender, Standort und Musik.
+
+### Screenshots aller Plattformen
+
+Alles echte Screenshots. Windows und Linux sind Vorschauversionen.
+
+| iPhone | iPad | Mac |
+| --- | --- | --- |
+|  |  |  |
+
+| Android | Windows | Linux (Omarchy) |
+| --- | --- | --- |
+|  |  |  |
+|  |  |  |
+
+| Web Studio |
+| --- |
+|  |
+
## Warum ScriptWidget?
- Ein Skript läuft auf iOS, iPadOS und macOS sowie auf Android (im Test); Layouts lassen sich mit `$getenv("widget-size")` anpassen.
diff --git a/README_ES.md b/README_ES.md
index 935a5fe9..e4fa3635 100644
--- a/README_ES.md
+++ b/README_ES.md
@@ -18,6 +18,25 @@ ScriptWidget es una plataforma de código abierto con licencia Apache 2.0 para c
La app para Android (versión 1.0.0, Android 15 o posterior) está disponible como [APK en GitHub Releases](https://github.com/everettjf/scriptwidget/releases/tag/android-v1.0.0). En Google Play está en prueba cerrada: para participar, únete al [grupo Atomsprout Testers](https://groups.google.com/g/atomsprout). Consulta [ScriptWidget para Android](docs/android/README.md).
+Las versiones para Windows y Linux son versiones preliminares: [Windows 0.1.0](https://github.com/everettjf/scriptwidget/releases/tag/windows-v0.1.0) requiere Windows 11, consulta [ScriptWidget para Windows](docs/windows/README.md); la versión para Linux funciona por ahora en [Omarchy](https://omarchy.org) 4.5, los archivos están en [GitHub Releases](https://github.com/everettjf/scriptwidget/releases), consulta [ScriptWidget para Linux](docs/linux/README.md). Ambas ejecutan los mismos paquetes de widgets, pero no tienen las API de datos del dispositivo como salud, calendario, ubicación y música.
+
+### Capturas de cada plataforma
+
+Todas son capturas reales. Windows y Linux son versiones preliminares.
+
+| iPhone | iPad | Mac |
+| --- | --- | --- |
+|  |  |  |
+
+| Android | Windows | Linux (Omarchy) |
+| --- | --- | --- |
+|  |  |  |
+|  |  |  |
+
+| Web Studio |
+| --- |
+|  |
+
## Por qué elegir ScriptWidget
- Un mismo script funciona en iOS, iPadOS y macOS, y también en Android (en pruebas), con diseños adaptables mediante `$getenv("widget-size")`.
diff --git a/README_FR.md b/README_FR.md
index df27c6f0..32a11b4c 100644
--- a/README_FR.md
+++ b/README_FR.md
@@ -18,6 +18,25 @@ ScriptWidget est une plateforme open source sous licence Apache 2.0 pour créer
L’application Android (version 1.0.0, Android 15 ou ultérieur) est disponible en [APK sur GitHub Releases](https://github.com/everettjf/scriptwidget/releases/tag/android-v1.0.0). Sur Google Play, elle est en test fermé : pour participer, rejoignez le [groupe Atomsprout Testers](https://groups.google.com/g/atomsprout). Voir [ScriptWidget pour Android](docs/android/README.md).
+Les versions Windows et Linux sont des préversions : [Windows 0.1.0](https://github.com/everettjf/scriptwidget/releases/tag/windows-v0.1.0) nécessite Windows 11, voir [ScriptWidget pour Windows](docs/windows/README.md) ; la version Linux fonctionne pour l’instant sous [Omarchy](https://omarchy.org) 4.5, les archives se trouvent dans les [GitHub Releases](https://github.com/everettjf/scriptwidget/releases), voir [ScriptWidget pour Linux](docs/linux/README.md). Les deux exécutent les mêmes paquets de widgets, mais n’ont pas les API de données de l’appareil comme la santé, le calendrier, la localisation et la musique.
+
+### Captures d’écran de chaque plateforme
+
+Ce sont toutes de vraies captures d’écran. Windows et Linux sont des préversions.
+
+| iPhone | iPad | Mac |
+| --- | --- | --- |
+|  |  |  |
+
+| Android | Windows | Linux (Omarchy) |
+| --- | --- | --- |
+|  |  |  |
+|  |  |  |
+
+| Web Studio |
+| --- |
+|  |
+
## Pourquoi choisir ScriptWidget
- Un même script fonctionne sur iOS, iPadOS et macOS, ainsi que sur Android (en test), avec des mises en page adaptées via `$getenv("widget-size")`.
diff --git a/README_JA.md b/README_JA.md
index be86ca15..e24f4395 100644
--- a/README_JA.md
+++ b/README_JA.md
@@ -18,6 +18,25 @@ ScriptWidget は、Apache 2.0 ライセンスのオープンソース・ウィ
Android アプリ(バージョン 1.0.0、Android 15 以降)は [GitHub Releases の APK](https://github.com/everettjf/scriptwidget/releases/tag/android-v1.0.0) で入手できます。Google Play ではクローズドテスト中です。参加するには [Atomsprout Testers グループ](https://groups.google.com/g/atomsprout) に参加してください。詳しくは [Android 版 ScriptWidget](docs/android/README.md) をご覧ください。
+Windows 版と Linux 版はプレビュー版です。[Windows 0.1.0](https://github.com/everettjf/scriptwidget/releases/tag/windows-v0.1.0) には Windows 11 が必要です([Windows 版 ScriptWidget](docs/windows/README.md) を参照)。Linux 版は現在 [Omarchy](https://omarchy.org) 4.5 に対応しており、アーカイブは [GitHub Releases](https://github.com/everettjf/scriptwidget/releases) にあります([Linux 版 ScriptWidget](docs/linux/README.md) を参照)。どちらも同じウィジェットパッケージを実行しますが、ヘルスケア、カレンダー、位置情報、ミュージックなどのデバイスデータ API はありません。
+
+### 各プラットフォームのスクリーンショット
+
+すべて実際のスクリーンショットです。Windows 版と Linux 版はプレビュー版です。
+
+| iPhone | iPad | Mac |
+| --- | --- | --- |
+|  |  |  |
+
+| Android | Windows | Linux (Omarchy) |
+| --- | --- | --- |
+|  |  |  |
+|  |  |  |
+
+| Web Studio |
+| --- |
+|  |
+
## ScriptWidget の特長
- 1 つのスクリプトが iOS、iPadOS、macOS で動作し(Android 版はテスト中)、`$getenv("widget-size")` でサイズ別に調整できます。
diff --git a/README_KO.md b/README_KO.md
index ceb66078..8765dd1c 100644
--- a/README_KO.md
+++ b/README_KO.md
@@ -18,6 +18,25 @@ ScriptWidget은 Apache 2.0 라이선스로 공개된 위젯 제작 플랫폼입
Android 앱(버전 1.0.0, Android 15 이상)은 [GitHub Releases의 APK](https://github.com/everettjf/scriptwidget/releases/tag/android-v1.0.0)로 받을 수 있습니다. Google Play에서는 비공개 테스트 중입니다. 참여하려면 [Atomsprout Testers 그룹](https://groups.google.com/g/atomsprout)에 가입하세요. [Android용 ScriptWidget](docs/android/README.md)을 참고하세요.
+Windows와 Linux 버전은 미리보기 버전입니다. [Windows 0.1.0](https://github.com/everettjf/scriptwidget/releases/tag/windows-v0.1.0)은 Windows 11이 필요하며 [Windows용 ScriptWidget](docs/windows/README.md)을 참고하세요. Linux 버전은 현재 [Omarchy](https://omarchy.org) 4.5를 지원하고 아카이브는 [GitHub Releases](https://github.com/everettjf/scriptwidget/releases)에 있으며 [Linux용 ScriptWidget](docs/linux/README.md)을 참고하세요. 둘 다 같은 위젯 패키지를 실행하지만 건강, 캘린더, 위치, 음악 같은 기기 데이터 API는 없습니다.
+
+### 플랫폼별 스크린샷
+
+모두 실제 스크린샷입니다. Windows와 Linux는 미리보기 버전입니다.
+
+| iPhone | iPad | Mac |
+| --- | --- | --- |
+|  |  |  |
+
+| Android | Windows | Linux (Omarchy) |
+| --- | --- | --- |
+|  |  |  |
+|  |  |  |
+
+| Web Studio |
+| --- |
+|  |
+
## ScriptWidget을 선택하는 이유
- 하나의 스크립트가 iOS, iPadOS, macOS와 Android(테스트 중)에서 작동하며 `$getenv("widget-size")`로 크기별 레이아웃을 조정할 수 있습니다.
diff --git a/README_PT_BR.md b/README_PT_BR.md
index c16e4f97..72326aee 100644
--- a/README_PT_BR.md
+++ b/README_PT_BR.md
@@ -18,6 +18,25 @@ ScriptWidget é uma plataforma de código aberto sob a licença Apache 2.0 para
O app para Android (versão 1.0.0, Android 15 ou posterior) está disponível como [APK no GitHub Releases](https://github.com/everettjf/scriptwidget/releases/tag/android-v1.0.0). No Google Play ele está em teste fechado: para participar, entre no [grupo Atomsprout Testers](https://groups.google.com/g/atomsprout). Consulte [ScriptWidget para Android](docs/android/README.md).
+As versões para Windows e Linux são prévias: o [Windows 0.1.0](https://github.com/everettjf/scriptwidget/releases/tag/windows-v0.1.0) requer o Windows 11, consulte [ScriptWidget para Windows](docs/windows/README.md); a versão para Linux funciona por enquanto no [Omarchy](https://omarchy.org) 4.5, os arquivos estão no [GitHub Releases](https://github.com/everettjf/scriptwidget/releases), consulte [ScriptWidget para Linux](docs/linux/README.md). As duas executam os mesmos pacotes de widgets, mas não têm as APIs de dados do dispositivo, como saúde, calendário, localização e música.
+
+### Capturas de tela de cada plataforma
+
+Todas são capturas de tela reais. Windows e Linux são prévias.
+
+| iPhone | iPad | Mac |
+| --- | --- | --- |
+|  |  |  |
+
+| Android | Windows | Linux (Omarchy) |
+| --- | --- | --- |
+|  |  |  |
+|  |  |  |
+
+| Web Studio |
+| --- |
+|  |
+
## Por que escolher o ScriptWidget
- Um único script funciona no iOS, iPadOS e macOS, e também no Android (em testes), com layouts adaptáveis usando `$getenv("widget-size")`.
diff --git a/README_RU.md b/README_RU.md
index ce89a030..4c3546ab 100644
--- a/README_RU.md
+++ b/README_RU.md
@@ -18,6 +18,25 @@ ScriptWidget — это открытая платформа для создан
Приложение для Android (версия 1.0.0, Android 15 и новее) доступно как [APK в GitHub Releases](https://github.com/everettjf/scriptwidget/releases/tag/android-v1.0.0). В Google Play идёт закрытое тестирование: чтобы участвовать, вступите в [группу Atomsprout Testers](https://groups.google.com/g/atomsprout). См. [ScriptWidget для Android](docs/android/README.md).
+Версии для Windows и Linux — предварительные: [Windows 0.1.0](https://github.com/everettjf/scriptwidget/releases/tag/windows-v0.1.0) требует Windows 11, см. [ScriptWidget для Windows](docs/windows/README.md); версия для Linux пока работает в [Omarchy](https://omarchy.org) 4.5, архивы лежат в [GitHub Releases](https://github.com/everettjf/scriptwidget/releases), см. [ScriptWidget для Linux](docs/linux/README.md). Обе запускают те же пакеты виджетов, но в них нет API данных устройства: здоровья, календаря, геопозиции, музыки и других.
+
+### Снимки экрана на каждой платформе
+
+Все снимки настоящие. Версии для Windows и Linux — предварительные.
+
+| iPhone | iPad | Mac |
+| --- | --- | --- |
+|  |  |  |
+
+| Android | Windows | Linux (Omarchy) |
+| --- | --- | --- |
+|  |  |  |
+|  |  |  |
+
+| Web Studio |
+| --- |
+|  |
+
## Почему ScriptWidget
- Один скрипт работает в iOS, iPadOS, macOS и в Android (тестируется), а макеты адаптируются через `$getenv("widget-size")`.
diff --git a/Resource/WidgetDemoScreenshots/Activity Rings.png b/Resource/WidgetDemoScreenshots/Activity Rings.png
new file mode 100644
index 00000000..e41b3168
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Activity Rings.png differ
diff --git a/Resource/WidgetDemoScreenshots/Air Quality Now.png b/Resource/WidgetDemoScreenshots/Air Quality Now.png
index feebf2a2..b04c89f9 100644
Binary files a/Resource/WidgetDemoScreenshots/Air Quality Now.png and b/Resource/WidgetDemoScreenshots/Air Quality Now.png differ
diff --git a/Resource/WidgetDemoScreenshots/An Empty Widget.png b/Resource/WidgetDemoScreenshots/An Empty Widget.png
index 3f746650..b72e1402 100644
Binary files a/Resource/WidgetDemoScreenshots/An Empty Widget.png and b/Resource/WidgetDemoScreenshots/An Empty Widget.png differ
diff --git a/Resource/WidgetDemoScreenshots/Animation Aquarium.png b/Resource/WidgetDemoScreenshots/Animation Aquarium.png
index 56ee4022..56236163 100644
Binary files a/Resource/WidgetDemoScreenshots/Animation Aquarium.png and b/Resource/WidgetDemoScreenshots/Animation Aquarium.png differ
diff --git a/Resource/WidgetDemoScreenshots/Animation Clock.png b/Resource/WidgetDemoScreenshots/Animation Clock.png
index 6eabe92d..15b25f62 100644
Binary files a/Resource/WidgetDemoScreenshots/Animation Clock.png and b/Resource/WidgetDemoScreenshots/Animation Clock.png differ
diff --git a/Resource/WidgetDemoScreenshots/Animation Golden Bloom.png b/Resource/WidgetDemoScreenshots/Animation Golden Bloom.png
index 712b4f09..07698af6 100644
Binary files a/Resource/WidgetDemoScreenshots/Animation Golden Bloom.png and b/Resource/WidgetDemoScreenshots/Animation Golden Bloom.png differ
diff --git a/Resource/WidgetDemoScreenshots/Animation Lissajous.png b/Resource/WidgetDemoScreenshots/Animation Lissajous.png
index d5b71e20..e8a73539 100644
Binary files a/Resource/WidgetDemoScreenshots/Animation Lissajous.png and b/Resource/WidgetDemoScreenshots/Animation Lissajous.png differ
diff --git a/Resource/WidgetDemoScreenshots/Animation Orbital Resonance.png b/Resource/WidgetDemoScreenshots/Animation Orbital Resonance.png
index 84744747..9a611a5b 100644
Binary files a/Resource/WidgetDemoScreenshots/Animation Orbital Resonance.png and b/Resource/WidgetDemoScreenshots/Animation Orbital Resonance.png differ
diff --git a/Resource/WidgetDemoScreenshots/Animation Phase Wave.png b/Resource/WidgetDemoScreenshots/Animation Phase Wave.png
index c55a1f46..048946ff 100644
Binary files a/Resource/WidgetDemoScreenshots/Animation Phase Wave.png and b/Resource/WidgetDemoScreenshots/Animation Phase Wave.png differ
diff --git a/Resource/WidgetDemoScreenshots/Animation Spirograph.png b/Resource/WidgetDemoScreenshots/Animation Spirograph.png
index 778f2520..177a62e5 100644
Binary files a/Resource/WidgetDemoScreenshots/Animation Spirograph.png and b/Resource/WidgetDemoScreenshots/Animation Spirograph.png differ
diff --git a/Resource/WidgetDemoScreenshots/Birthday Countdown.png b/Resource/WidgetDemoScreenshots/Birthday Countdown.png
index 3ce22cd7..292c13c1 100644
Binary files a/Resource/WidgetDemoScreenshots/Birthday Countdown.png and b/Resource/WidgetDemoScreenshots/Birthday Countdown.png differ
diff --git a/Resource/WidgetDemoScreenshots/Calendar Agenda.png b/Resource/WidgetDemoScreenshots/Calendar Agenda.png
new file mode 100644
index 00000000..a5e5fb47
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Calendar Agenda.png differ
diff --git a/Resource/WidgetDemoScreenshots/Check Is Friday Today.png b/Resource/WidgetDemoScreenshots/Check Is Friday Today.png
index be5b1e74..08c55d5e 100644
Binary files a/Resource/WidgetDemoScreenshots/Check Is Friday Today.png and b/Resource/WidgetDemoScreenshots/Check Is Friday Today.png differ
diff --git a/Resource/WidgetDemoScreenshots/Check Is Working Day Today.png b/Resource/WidgetDemoScreenshots/Check Is Working Day Today.png
index 6de468de..7202cd31 100644
Binary files a/Resource/WidgetDemoScreenshots/Check Is Working Day Today.png and b/Resource/WidgetDemoScreenshots/Check Is Working Day Today.png differ
diff --git a/Resource/WidgetDemoScreenshots/Condition Content.png b/Resource/WidgetDemoScreenshots/Condition Content.png
index 1aeb71fe..40c36e56 100644
Binary files a/Resource/WidgetDemoScreenshots/Condition Content.png and b/Resource/WidgetDemoScreenshots/Condition Content.png differ
diff --git a/Resource/WidgetDemoScreenshots/Control Switch.png b/Resource/WidgetDemoScreenshots/Control Switch.png
new file mode 100644
index 00000000..3bc4c763
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Control Switch.png differ
diff --git a/Resource/WidgetDemoScreenshots/Countdown.png b/Resource/WidgetDemoScreenshots/Countdown.png
index f7190c36..7398fc6e 100644
Binary files a/Resource/WidgetDemoScreenshots/Countdown.png and b/Resource/WidgetDemoScreenshots/Countdown.png differ
diff --git a/Resource/WidgetDemoScreenshots/Crypto Price Ticker.png b/Resource/WidgetDemoScreenshots/Crypto Price Ticker.png
index 5561bb7f..07eec396 100644
Binary files a/Resource/WidgetDemoScreenshots/Crypto Price Ticker.png and b/Resource/WidgetDemoScreenshots/Crypto Price Ticker.png differ
diff --git a/Resource/WidgetDemoScreenshots/Currency Pulse.png b/Resource/WidgetDemoScreenshots/Currency Pulse.png
index 0f7faab7..e95d3e2a 100644
Binary files a/Resource/WidgetDemoScreenshots/Currency Pulse.png and b/Resource/WidgetDemoScreenshots/Currency Pulse.png differ
diff --git a/Resource/WidgetDemoScreenshots/Daily Affirmation.png b/Resource/WidgetDemoScreenshots/Daily Affirmation.png
index ec56ebeb..42119ab1 100644
Binary files a/Resource/WidgetDemoScreenshots/Daily Affirmation.png and b/Resource/WidgetDemoScreenshots/Daily Affirmation.png differ
diff --git a/Resource/WidgetDemoScreenshots/Daily Agenda.png b/Resource/WidgetDemoScreenshots/Daily Agenda.png
index 89f91b2f..029f94f6 100644
Binary files a/Resource/WidgetDemoScreenshots/Daily Agenda.png and b/Resource/WidgetDemoScreenshots/Daily Agenda.png differ
diff --git a/Resource/WidgetDemoScreenshots/Daily Command Center.png b/Resource/WidgetDemoScreenshots/Daily Command Center.png
index 17edcc4f..3d756554 100644
Binary files a/Resource/WidgetDemoScreenshots/Daily Command Center.png and b/Resource/WidgetDemoScreenshots/Daily Command Center.png differ
diff --git a/Resource/WidgetDemoScreenshots/Daily Quote.png b/Resource/WidgetDemoScreenshots/Daily Quote.png
index a082f1f9..6ef475ff 100644
Binary files a/Resource/WidgetDemoScreenshots/Daily Quote.png and b/Resource/WidgetDemoScreenshots/Daily Quote.png differ
diff --git a/Resource/WidgetDemoScreenshots/Datetime Current.png b/Resource/WidgetDemoScreenshots/Datetime Current.png
index 7d2ba341..8d607cf5 100644
Binary files a/Resource/WidgetDemoScreenshots/Datetime Current.png and b/Resource/WidgetDemoScreenshots/Datetime Current.png differ
diff --git a/Resource/WidgetDemoScreenshots/Datetime Timezone.png b/Resource/WidgetDemoScreenshots/Datetime Timezone.png
index ba91a9e0..9539da04 100644
Binary files a/Resource/WidgetDemoScreenshots/Datetime Timezone.png and b/Resource/WidgetDemoScreenshots/Datetime Timezone.png differ
diff --git a/Resource/WidgetDemoScreenshots/Day Rhythm.png b/Resource/WidgetDemoScreenshots/Day Rhythm.png
new file mode 100644
index 00000000..d5b64fc9
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Day Rhythm.png differ
diff --git a/Resource/WidgetDemoScreenshots/Family Command Board.png b/Resource/WidgetDemoScreenshots/Family Command Board.png
index fb5e8e60..2ace0afc 100644
Binary files a/Resource/WidgetDemoScreenshots/Family Command Board.png and b/Resource/WidgetDemoScreenshots/Family Command Board.png differ
diff --git a/Resource/WidgetDemoScreenshots/Focus Countdown.png b/Resource/WidgetDemoScreenshots/Focus Countdown.png
index 358acf80..7b982f2c 100644
Binary files a/Resource/WidgetDemoScreenshots/Focus Countdown.png and b/Resource/WidgetDemoScreenshots/Focus Countdown.png differ
diff --git a/Resource/WidgetDemoScreenshots/GitHub Profile.png b/Resource/WidgetDemoScreenshots/GitHub Profile.png
new file mode 100644
index 00000000..da6e92ea
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/GitHub Profile.png differ
diff --git a/Resource/WidgetDemoScreenshots/GitHub Repo Stats.png b/Resource/WidgetDemoScreenshots/GitHub Repo Stats.png
index dfc4b8a7..e43692d2 100644
Binary files a/Resource/WidgetDemoScreenshots/GitHub Repo Stats.png and b/Resource/WidgetDemoScreenshots/GitHub Repo Stats.png differ
diff --git a/Resource/WidgetDemoScreenshots/Habit Heatmap.png b/Resource/WidgetDemoScreenshots/Habit Heatmap.png
new file mode 100644
index 00000000..629f8f41
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Habit Heatmap.png differ
diff --git a/Resource/WidgetDemoScreenshots/Habit Streak Tracker.png b/Resource/WidgetDemoScreenshots/Habit Streak Tracker.png
index 36d99499..f190eee7 100644
Binary files a/Resource/WidgetDemoScreenshots/Habit Streak Tracker.png and b/Resource/WidgetDemoScreenshots/Habit Streak Tracker.png differ
diff --git a/Resource/WidgetDemoScreenshots/Health Overview.png b/Resource/WidgetDemoScreenshots/Health Overview.png
new file mode 100644
index 00000000..aa6bfe12
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Health Overview.png differ
diff --git a/Resource/WidgetDemoScreenshots/Health Steps Ring.png b/Resource/WidgetDemoScreenshots/Health Steps Ring.png
index d591bde5..d6eec1cf 100644
Binary files a/Resource/WidgetDemoScreenshots/Health Steps Ring.png and b/Resource/WidgetDemoScreenshots/Health Steps Ring.png differ
diff --git a/Resource/WidgetDemoScreenshots/Hydration Goal iCloud.png b/Resource/WidgetDemoScreenshots/Hydration Goal iCloud.png
new file mode 100644
index 00000000..2b451953
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Hydration Goal iCloud.png differ
diff --git a/Resource/WidgetDemoScreenshots/Hydration Goal.png b/Resource/WidgetDemoScreenshots/Hydration Goal.png
index 2991b9da..9c339cb5 100644
Binary files a/Resource/WidgetDemoScreenshots/Hydration Goal.png and b/Resource/WidgetDemoScreenshots/Hydration Goal.png differ
diff --git a/Resource/WidgetDemoScreenshots/Image Basic Usage.png b/Resource/WidgetDemoScreenshots/Image Basic Usage.png
index 7b96963a..7402a8d1 100644
Binary files a/Resource/WidgetDemoScreenshots/Image Basic Usage.png and b/Resource/WidgetDemoScreenshots/Image Basic Usage.png differ
diff --git a/Resource/WidgetDemoScreenshots/Image No Margin.png b/Resource/WidgetDemoScreenshots/Image No Margin.png
index ed620a7c..9f5b1f33 100644
Binary files a/Resource/WidgetDemoScreenshots/Image No Margin.png and b/Resource/WidgetDemoScreenshots/Image No Margin.png differ
diff --git a/Resource/WidgetDemoScreenshots/Image.png b/Resource/WidgetDemoScreenshots/Image.png
index 0bb73bf3..4c69772e 100644
Binary files a/Resource/WidgetDemoScreenshots/Image.png and b/Resource/WidgetDemoScreenshots/Image.png differ
diff --git a/Resource/WidgetDemoScreenshots/Layout Starter.png b/Resource/WidgetDemoScreenshots/Layout Starter.png
new file mode 100644
index 00000000..9706b2cf
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Layout Starter.png differ
diff --git a/Resource/WidgetDemoScreenshots/Live Activity Demo.png b/Resource/WidgetDemoScreenshots/Live Activity Demo.png
index 8b4680a0..e837e22b 100644
Binary files a/Resource/WidgetDemoScreenshots/Live Activity Demo.png and b/Resource/WidgetDemoScreenshots/Live Activity Demo.png differ
diff --git a/Resource/WidgetDemoScreenshots/Local Weather (Location).png b/Resource/WidgetDemoScreenshots/Local Weather (Location).png
index 95e20579..cf1490e4 100644
Binary files a/Resource/WidgetDemoScreenshots/Local Weather (Location).png and b/Resource/WidgetDemoScreenshots/Local Weather (Location).png differ
diff --git a/Resource/WidgetDemoScreenshots/Location Snapshot.png b/Resource/WidgetDemoScreenshots/Location Snapshot.png
index 7b023fa1..dc9a02b5 100644
Binary files a/Resource/WidgetDemoScreenshots/Location Snapshot.png and b/Resource/WidgetDemoScreenshots/Location Snapshot.png differ
diff --git a/Resource/WidgetDemoScreenshots/Lunar Date.png b/Resource/WidgetDemoScreenshots/Lunar Date.png
index f7240255..af4106de 100644
Binary files a/Resource/WidgetDemoScreenshots/Lunar Date.png and b/Resource/WidgetDemoScreenshots/Lunar Date.png differ
diff --git a/Resource/WidgetDemoScreenshots/Material Study.png b/Resource/WidgetDemoScreenshots/Material Study.png
new file mode 100644
index 00000000..bef33535
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Material Study.png differ
diff --git a/Resource/WidgetDemoScreenshots/Meal Planner.png b/Resource/WidgetDemoScreenshots/Meal Planner.png
index 0ecb1ee8..588ac760 100644
Binary files a/Resource/WidgetDemoScreenshots/Meal Planner.png and b/Resource/WidgetDemoScreenshots/Meal Planner.png differ
diff --git a/Resource/WidgetDemoScreenshots/Meeting Countdown.png b/Resource/WidgetDemoScreenshots/Meeting Countdown.png
index 9b227cd9..5d0b5f82 100644
Binary files a/Resource/WidgetDemoScreenshots/Meeting Countdown.png and b/Resource/WidgetDemoScreenshots/Meeting Countdown.png differ
diff --git a/Resource/WidgetDemoScreenshots/Month Calendar.png b/Resource/WidgetDemoScreenshots/Month Calendar.png
new file mode 100644
index 00000000..342c76fb
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Month Calendar.png differ
diff --git a/Resource/WidgetDemoScreenshots/Monthly Budget Planner.png b/Resource/WidgetDemoScreenshots/Monthly Budget Planner.png
index 5a91af00..42fd78ac 100644
Binary files a/Resource/WidgetDemoScreenshots/Monthly Budget Planner.png and b/Resource/WidgetDemoScreenshots/Monthly Budget Planner.png differ
diff --git a/Resource/WidgetDemoScreenshots/Mood Check-in.png b/Resource/WidgetDemoScreenshots/Mood Check-in.png
index 11095b36..3a8c6738 100644
Binary files a/Resource/WidgetDemoScreenshots/Mood Check-in.png and b/Resource/WidgetDemoScreenshots/Mood Check-in.png differ
diff --git a/Resource/WidgetDemoScreenshots/Music Playback.png b/Resource/WidgetDemoScreenshots/Music Playback.png
new file mode 100644
index 00000000..a09e743f
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Music Playback.png differ
diff --git a/Resource/WidgetDemoScreenshots/New Episode Tracker.png b/Resource/WidgetDemoScreenshots/New Episode Tracker.png
index 6472377c..d007b3ab 100644
Binary files a/Resource/WidgetDemoScreenshots/New Episode Tracker.png and b/Resource/WidgetDemoScreenshots/New Episode Tracker.png differ
diff --git a/Resource/WidgetDemoScreenshots/Now Playing.png b/Resource/WidgetDemoScreenshots/Now Playing.png
new file mode 100644
index 00000000..4422ef3e
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Now Playing.png differ
diff --git a/Resource/WidgetDemoScreenshots/Nyan Cat.png b/Resource/WidgetDemoScreenshots/Nyan Cat.png
index 1c71c30e..8b5f1114 100644
Binary files a/Resource/WidgetDemoScreenshots/Nyan Cat.png and b/Resource/WidgetDemoScreenshots/Nyan Cat.png differ
diff --git a/Resource/WidgetDemoScreenshots/Open Link.png b/Resource/WidgetDemoScreenshots/Open Link.png
index dedc5511..62aff229 100644
Binary files a/Resource/WidgetDemoScreenshots/Open Link.png and b/Resource/WidgetDemoScreenshots/Open Link.png differ
diff --git a/Resource/WidgetDemoScreenshots/Packing Checklist.png b/Resource/WidgetDemoScreenshots/Packing Checklist.png
index 47a3e4a8..8f8b9e27 100644
Binary files a/Resource/WidgetDemoScreenshots/Packing Checklist.png and b/Resource/WidgetDemoScreenshots/Packing Checklist.png differ
diff --git a/Resource/WidgetDemoScreenshots/Personal Dashboard.png b/Resource/WidgetDemoScreenshots/Personal Dashboard.png
index 16b7436c..14cd12bd 100644
Binary files a/Resource/WidgetDemoScreenshots/Personal Dashboard.png and b/Resource/WidgetDemoScreenshots/Personal Dashboard.png differ
diff --git a/Resource/WidgetDemoScreenshots/Photo Album Rotator.png b/Resource/WidgetDemoScreenshots/Photo Album Rotator.png
new file mode 100644
index 00000000..3087598e
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Photo Album Rotator.png differ
diff --git a/Resource/WidgetDemoScreenshots/Photo Card.png b/Resource/WidgetDemoScreenshots/Photo Card.png
new file mode 100644
index 00000000..a3963ed8
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Photo Card.png differ
diff --git a/Resource/WidgetDemoScreenshots/Plant Care.png b/Resource/WidgetDemoScreenshots/Plant Care.png
index 10d8590d..31e26d2b 100644
Binary files a/Resource/WidgetDemoScreenshots/Plant Care.png and b/Resource/WidgetDemoScreenshots/Plant Care.png differ
diff --git a/Resource/WidgetDemoScreenshots/Pocket Pet.png b/Resource/WidgetDemoScreenshots/Pocket Pet.png
new file mode 100644
index 00000000..e36c0761
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Pocket Pet.png differ
diff --git a/Resource/WidgetDemoScreenshots/Pomodoro Focus.png b/Resource/WidgetDemoScreenshots/Pomodoro Focus.png
index 160aef96..dad6cf65 100644
Binary files a/Resource/WidgetDemoScreenshots/Pomodoro Focus.png and b/Resource/WidgetDemoScreenshots/Pomodoro Focus.png differ
diff --git a/Resource/WidgetDemoScreenshots/Portfolio Pulse.png b/Resource/WidgetDemoScreenshots/Portfolio Pulse.png
new file mode 100644
index 00000000..57f0098a
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Portfolio Pulse.png differ
diff --git a/Resource/WidgetDemoScreenshots/Quick Launcher.png b/Resource/WidgetDemoScreenshots/Quick Launcher.png
index 0e2fa6cf..b12d339b 100644
Binary files a/Resource/WidgetDemoScreenshots/Quick Launcher.png and b/Resource/WidgetDemoScreenshots/Quick Launcher.png differ
diff --git a/Resource/WidgetDemoScreenshots/Reading Goal.png b/Resource/WidgetDemoScreenshots/Reading Goal.png
index 6d6167a7..206118a9 100644
Binary files a/Resource/WidgetDemoScreenshots/Reading Goal.png and b/Resource/WidgetDemoScreenshots/Reading Goal.png differ
diff --git a/Resource/WidgetDemoScreenshots/Reminders Agenda.png b/Resource/WidgetDemoScreenshots/Reminders Agenda.png
new file mode 100644
index 00000000..d299d6ca
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Reminders Agenda.png differ
diff --git a/Resource/WidgetDemoScreenshots/Savings Goal.png b/Resource/WidgetDemoScreenshots/Savings Goal.png
index a87f6bcf..f54294c7 100644
Binary files a/Resource/WidgetDemoScreenshots/Savings Goal.png and b/Resource/WidgetDemoScreenshots/Savings Goal.png differ
diff --git a/Resource/WidgetDemoScreenshots/Shape.png b/Resource/WidgetDemoScreenshots/Shape.png
index a491966b..f6aa215b 100644
Binary files a/Resource/WidgetDemoScreenshots/Shape.png and b/Resource/WidgetDemoScreenshots/Shape.png differ
diff --git a/Resource/WidgetDemoScreenshots/Sleep Schedule.png b/Resource/WidgetDemoScreenshots/Sleep Schedule.png
index 10045f3f..46ae95b2 100644
Binary files a/Resource/WidgetDemoScreenshots/Sleep Schedule.png and b/Resource/WidgetDemoScreenshots/Sleep Schedule.png differ
diff --git a/Resource/WidgetDemoScreenshots/Storage Ring.png b/Resource/WidgetDemoScreenshots/Storage Ring.png
index cd774d56..2a30c6fa 100644
Binary files a/Resource/WidgetDemoScreenshots/Storage Ring.png and b/Resource/WidgetDemoScreenshots/Storage Ring.png differ
diff --git a/Resource/WidgetDemoScreenshots/Study Tracker.png b/Resource/WidgetDemoScreenshots/Study Tracker.png
index ae1087d8..ff3ce44a 100644
Binary files a/Resource/WidgetDemoScreenshots/Study Tracker.png and b/Resource/WidgetDemoScreenshots/Study Tracker.png differ
diff --git a/Resource/WidgetDemoScreenshots/Sunrise & Sunset.png b/Resource/WidgetDemoScreenshots/Sunrise & Sunset.png
index 10e3460b..bad2dcc1 100644
Binary files a/Resource/WidgetDemoScreenshots/Sunrise & Sunset.png and b/Resource/WidgetDemoScreenshots/Sunrise & Sunset.png differ
diff --git a/Resource/WidgetDemoScreenshots/System Insights.png b/Resource/WidgetDemoScreenshots/System Insights.png
index be0e98c6..847abcf4 100644
Binary files a/Resource/WidgetDemoScreenshots/System Insights.png and b/Resource/WidgetDemoScreenshots/System Insights.png differ
diff --git a/Resource/WidgetDemoScreenshots/Text Days To End Of Month.png b/Resource/WidgetDemoScreenshots/Text Days To End Of Month.png
index 9dbde244..f42b73b7 100644
Binary files a/Resource/WidgetDemoScreenshots/Text Days To End Of Month.png and b/Resource/WidgetDemoScreenshots/Text Days To End Of Month.png differ
diff --git a/Resource/WidgetDemoScreenshots/Text Days to End Of Year.png b/Resource/WidgetDemoScreenshots/Text Days to End Of Year.png
index 33fddc75..c4c13cc3 100644
Binary files a/Resource/WidgetDemoScreenshots/Text Days to End Of Year.png and b/Resource/WidgetDemoScreenshots/Text Days to End Of Year.png differ
diff --git a/Resource/WidgetDemoScreenshots/Text Today Week.png b/Resource/WidgetDemoScreenshots/Text Today Week.png
index ee9792cc..7fd3e190 100644
Binary files a/Resource/WidgetDemoScreenshots/Text Today Week.png and b/Resource/WidgetDemoScreenshots/Text Today Week.png differ
diff --git a/Resource/WidgetDemoScreenshots/Text Year Days Left.png b/Resource/WidgetDemoScreenshots/Text Year Days Left.png
index 55470a6b..d4b72820 100644
Binary files a/Resource/WidgetDemoScreenshots/Text Year Days Left.png and b/Resource/WidgetDemoScreenshots/Text Year Days Left.png differ
diff --git a/Resource/WidgetDemoScreenshots/Travel Day Dashboard.png b/Resource/WidgetDemoScreenshots/Travel Day Dashboard.png
index 6f6dc904..87bbc72e 100644
Binary files a/Resource/WidgetDemoScreenshots/Travel Day Dashboard.png and b/Resource/WidgetDemoScreenshots/Travel Day Dashboard.png differ
diff --git a/Resource/WidgetDemoScreenshots/Wallpaper Match.png b/Resource/WidgetDemoScreenshots/Wallpaper Match.png
new file mode 100644
index 00000000..10a5f4c4
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Wallpaper Match.png differ
diff --git a/Resource/WidgetDemoScreenshots/Weather Display.png b/Resource/WidgetDemoScreenshots/Weather Display.png
index cd18e3b0..e03fd438 100644
Binary files a/Resource/WidgetDemoScreenshots/Weather Display.png and b/Resource/WidgetDemoScreenshots/Weather Display.png differ
diff --git a/Resource/WidgetDemoScreenshots/Weather Glance.png b/Resource/WidgetDemoScreenshots/Weather Glance.png
new file mode 100644
index 00000000..079d2f20
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Weather Glance.png differ
diff --git a/Resource/WidgetDemoScreenshots/Weather Now (MET Norway).png b/Resource/WidgetDemoScreenshots/Weather Now (MET Norway).png
new file mode 100644
index 00000000..ed45486d
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Weather Now (MET Norway).png differ
diff --git a/Resource/WidgetDemoScreenshots/Weather Now (Open-Meteo).png b/Resource/WidgetDemoScreenshots/Weather Now (Open-Meteo).png
deleted file mode 100644
index a3d8fb35..00000000
Binary files a/Resource/WidgetDemoScreenshots/Weather Now (Open-Meteo).png and /dev/null differ
diff --git a/Resource/WidgetDemoScreenshots/Weather.png b/Resource/WidgetDemoScreenshots/Weather.png
index d17f4bb0..c4843979 100644
Binary files a/Resource/WidgetDemoScreenshots/Weather.png and b/Resource/WidgetDemoScreenshots/Weather.png differ
diff --git a/Resource/WidgetDemoScreenshots/Weekly Planner.png b/Resource/WidgetDemoScreenshots/Weekly Planner.png
index 505aaed1..886da7dc 100644
Binary files a/Resource/WidgetDemoScreenshots/Weekly Planner.png and b/Resource/WidgetDemoScreenshots/Weekly Planner.png differ
diff --git a/Resource/WidgetDemoScreenshots/Wellness Dashboard.png b/Resource/WidgetDemoScreenshots/Wellness Dashboard.png
index 40c0175c..0d5c6e25 100644
Binary files a/Resource/WidgetDemoScreenshots/Wellness Dashboard.png and b/Resource/WidgetDemoScreenshots/Wellness Dashboard.png differ
diff --git a/Resource/WidgetDemoScreenshots/World Clock Faces.png b/Resource/WidgetDemoScreenshots/World Clock Faces.png
new file mode 100644
index 00000000..1601ba7f
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/World Clock Faces.png differ
diff --git a/Resource/WidgetDemoScreenshots/Year in Dots.png b/Resource/WidgetDemoScreenshots/Year in Dots.png
new file mode 100644
index 00000000..5ff87251
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/Year in Dots.png differ
diff --git a/Resource/WidgetDemoScreenshots/_contact-sheet-1.jpg b/Resource/WidgetDemoScreenshots/_contact-sheet-1.jpg
index bf3b275f..61297828 100644
Binary files a/Resource/WidgetDemoScreenshots/_contact-sheet-1.jpg and b/Resource/WidgetDemoScreenshots/_contact-sheet-1.jpg differ
diff --git a/Resource/WidgetDemoScreenshots/_contact-sheet-2.jpg b/Resource/WidgetDemoScreenshots/_contact-sheet-2.jpg
index da429485..21a9829f 100644
Binary files a/Resource/WidgetDemoScreenshots/_contact-sheet-2.jpg and b/Resource/WidgetDemoScreenshots/_contact-sheet-2.jpg differ
diff --git a/Resource/WidgetDemoScreenshots/_contact-sheet-3.jpg b/Resource/WidgetDemoScreenshots/_contact-sheet-3.jpg
index 43c50123..728d89a6 100644
Binary files a/Resource/WidgetDemoScreenshots/_contact-sheet-3.jpg and b/Resource/WidgetDemoScreenshots/_contact-sheet-3.jpg differ
diff --git a/Resource/WidgetDemoScreenshots/_contact-sheet-4.jpg b/Resource/WidgetDemoScreenshots/_contact-sheet-4.jpg
index 9adacf19..557a3136 100644
Binary files a/Resource/WidgetDemoScreenshots/_contact-sheet-4.jpg and b/Resource/WidgetDemoScreenshots/_contact-sheet-4.jpg differ
diff --git a/Resource/WidgetDemoScreenshots/_contact-sheet-5.jpg b/Resource/WidgetDemoScreenshots/_contact-sheet-5.jpg
new file mode 100644
index 00000000..a3bc965c
Binary files /dev/null and b/Resource/WidgetDemoScreenshots/_contact-sheet-5.jpg differ
diff --git a/Resource/WidgetDemoScreenshots/render-report.txt b/Resource/WidgetDemoScreenshots/render-report.txt
index d86bac9d..f64606cf 100644
--- a/Resource/WidgetDemoScreenshots/render-report.txt
+++ b/Resource/WidgetDemoScreenshots/render-report.txt
@@ -1 +1,7 @@
-OK
+Rendered 2026-11-18 by the Mac app (--render-template-previews), unsigned debug build, macOS 27.2.
+Kept from the earlier set, because this Mac has no battery or the request timed out:
+- Battery & Brightness
+- Device Battery Percent
+- Gauge Battery
+- Stock Snapshot
+- System Status Panel
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Animation Clock/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Animation Clock/main.jsx
index e517ca94..f2a85b0f 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Animation Clock/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Animation Clock/main.jsx
@@ -6,15 +6,31 @@
//
-$render(
-
-
-
-
-
-
-
-
- ANALOG CLOCK
-
-);
+if ($getenv("widget-size") === "small") {
+ // Small: the clock face with the time under it.
+ $render(
+
+
+
+
+
+
+
+
+
+
+ );
+} else {
+ $render(
+
+
+
+
+
+
+
+
+ ANALOG CLOCK
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Battery & Brightness/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Battery & Brightness/main.jsx
index 6d989d29..b258e4ec 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Battery & Brightness/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Battery & Brightness/main.jsx
@@ -9,20 +9,32 @@ const battery = $device.battery();
const brightness = $system.brightness();
const percent = (battery.level * 100).toFixed(0);
-$render(
-
-
- BATTERY
+if ($getenv("widget-size") === "small") {
+ // Small: the battery level, with the brightness as one line under it.
+ $render(
+
+ BATTERY{percent}%
+ {brightness >= 0 ? Math.round(brightness * 100) + "% display" : "Display —"}
-
-
-
-
- DISPLAY
- {brightness >= 0 ? Math.round(brightness * 100) + "%" : "—"}
- Brightness
-
-
-);
+ );
+} else {
+ $render(
+
+
+ BATTERY
+ {percent}%
+
+
+
+
+
+
+ DISPLAY
+ {brightness >= 0 ? Math.round(brightness * 100) + "%" : "—"}
+ Brightness
+
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Daily Command Center/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Daily Command Center/main.jsx
index dfbad11d..76bdefc1 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Daily Command Center/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Daily Command Center/main.jsx
@@ -1,4 +1,4 @@
-// Large widget. widget-param: Focus task|09:00 Stand-up,11:30 Deep work,15:00 Review|Email Alex,Book dentist,Walk 20 min
+// Designed for the large widget; the small and medium sizes show the essentials. widget-param: Focus task|09:00 Stand-up,11:30 Deep work,15:00 Review|Email Alex,Book dentist,Walk 20 min
const parts = ($getenv("widget-param") || "Ship the weekly update|09:00 Stand-up,11:30 Deep work,15:00 Review|Reply to Sam,Book dentist,Walk 20 min").split("|");
const focus = (parts[0] || "Choose one meaningful outcome").trim();
const schedule = (parts[1] || "").split(",").filter(Boolean).slice(0, 3);
@@ -13,26 +13,54 @@ const Row = ({ text, index }) => (
);
-$render(
-
-
- Today
-
-
-
- PRIMARY OUTCOME
- {focus}
+const size = $getenv("widget-size");
+if (size === "small") {
+ // Small: the primary outcome, the day's progress and the next entry of the schedule.
+ $render(
+
+ PRIMARY OUTCOME
+ {focus}
+ {schedule.length ? {schedule[0].trim()} : null}
-
-
+ );
+} else if (size === "medium") {
+ // Medium: the primary outcome beside the schedule.
+ $render(
+
+
+ PRIMARY OUTCOME
+ {focus}
+
+
+ SCHEDULE
{schedule.map((item, i) => )}
-
- QUICK TASKS
- {tasks.map((item, i) => )}
-
-
-);
+ );
+} else {
+ $render(
+
+
+ Today
+
+
+
+ PRIMARY OUTCOME
+ {focus}
+
+
+
+
+ SCHEDULE
+ {schedule.map((item, i) => )}
+
+
+ QUICK TASKS
+ {tasks.map((item, i) => )}
+
+
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Datetime Current/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Datetime Current/main.jsx
index 310596be..e49372f3 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Datetime Current/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Datetime Current/main.jsx
@@ -7,9 +7,22 @@
// Description: Display Clock Time
//
-$render(
-
- CURRENT TIME
-
-
-);
+if ($getenv("widget-size") === "small") {
+ // Small: the time, with a short date that fits the narrow widget.
+ $render(
+
+ CURRENT TIME
+
+
+ {new Date().toLocaleDateString("en-US", { weekday: "short", month: "short", day: "numeric" })}
+
+
+ );
+} else {
+ $render(
+
+ CURRENT TIME
+
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Datetime Timezone/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Datetime Timezone/main.jsx
index ab6f21d3..e1b2795f 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Datetime Timezone/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Datetime Timezone/main.jsx
@@ -10,9 +10,22 @@ const widget_param = $getenv("widget-param");
const time = zone => new Date().toLocaleTimeString([], { timeZone: zone, hour: "2-digit", minute: "2-digit" });
-$render(
-
- World Clock
- BEIJING{time("Asia/Shanghai")}SAN JOSE{time("America/Los_Angeles")}NEW YORK{time("America/New_York")}
-
-);
+if (widget_size === "small") {
+ // Small: one city on each line.
+ const City = ({ name, zone }) => {name}{time(zone)};
+ $render(
+
+ World Clock
+
+
+
+
+ );
+} else {
+ $render(
+
+ World Clock
+ BEIJING{time("Asia/Shanghai")}SAN JOSE{time("America/Los_Angeles")}NEW YORK{time("America/New_York")}
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Device Battery Percent/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Device Battery Percent/main.jsx
index 158cde7c..a2c48572 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Device Battery Percent/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Device Battery Percent/main.jsx
@@ -9,9 +9,19 @@
var percent = $device.battery().level * 100;
percent = percent.toFixed(0);
-$render(
-
- DEVICE BATTERY{percent}%Power at a glance
-
-
-);
+if ($getenv("widget-size") === "small") {
+ // Small: the percentage inside the ring.
+ $render(
+
+ DEVICE BATTERY
+ {percent}%
+
+ );
+} else {
+ $render(
+
+ DEVICE BATTERY{percent}%Power at a glance
+
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Family Command Board/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Family Command Board/main.jsx
index 6546d3a0..cf720c3d 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Family Command Board/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Family Command Board/main.jsx
@@ -1,4 +1,4 @@
-// Large widget. widget-param: Family name|events comma-separated|chores comma-separated|dinner
+// Designed for the large widget; the small and medium sizes show the essentials. widget-param: Family name|events comma-separated|chores comma-separated|dinner
const parts = ($getenv("widget-param") || "The Parkers|08:15 School drop-off,17:30 Soccer practice,19:00 Call Grandma|Mia · Feed Mochi,Noah · Recycling,All · Tidy kitchen|Taco bowls · 18:30").split("|");
const family = (parts[0] || "Our Family").trim();
const events = (parts[1] || "").split(",").filter(Boolean).slice(0, 3);
@@ -15,19 +15,49 @@ const Event = ({ text, index }) => {
);
};
-$render(
-
- {family}Home at a glance
-
-
- TODAY{new Date().toLocaleDateString("en-US", { month: "short", day: "numeric" })}
+const size = $getenv("widget-size");
+const today = new Date().toLocaleDateString("en-US", { month: "short", day: "numeric" });
+if (size === "small") {
+ // Small: the next event and dinner.
+ $render(
+
+ TODAY{today}
+ {events.length ? : null}
+ DINNER PLAN{dinner}
+
+ );
+} else if (size === "medium") {
+ // Medium: today's events beside the first chore and dinner.
+ $render(
+
+
+ TODAY{today}
{events.map((item, i) => )}
-
- CHORES
- {chores.map(item => {item.trim()})}
+
+
+ CHORES
+ {chores.length ? {chores[0].trim()} : null}
+
+ DINNER PLAN{dinner}
- DINNER PLAN{dinner}
-
-);
+ );
+} else {
+ $render(
+
+ {family}Home at a glance
+
+
+ TODAY{new Date().toLocaleDateString("en-US", { month: "short", day: "numeric" })}
+ {events.map((item, i) => )}
+
+
+ CHORES
+ {chores.map(item => {item.trim()})}
+
+
+ DINNER PLAN{dinner}
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/README.md b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/README.md
index f698e93f..98f9905a 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/README.md
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/README.md
@@ -10,6 +10,6 @@ Alternatively, provide `endsAt` as a timezone-qualified ISO date for a native ti
Supported optional fields: `title`, `detail`, integer `progress` and `total`, and `endsAt`. The package requires no network, location or storage permission. Activity attributes and state together must fit the system's 4 KiB budget.
-Ordinary Home Screen preview is supported at medium size. Web preview is a layout preview; actual ActivityKit and Dynamic Island presentation require a supported iPhone. System scheduling controls display and timer/stale transitions. Remote updates and interactive Island buttons are not included.
+Ordinary Home Screen preview is supported at small and medium size; the small widget shows the state and the title. Web preview is a layout preview; actual ActivityKit and Dynamic Island presentation require a supported iPhone. System scheduling controls display and timer/stale transitions. Remote updates and interactive Island buttons are not included.
See [local Live Activities](../../../../../../../docs/live-activities.md) for lifecycle, installation binding, data constraints and verification limits.
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/main.jsx
index 0e3f6c06..efd63647 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/main.jsx
@@ -14,7 +14,9 @@ const deadline=data.endsAt===undefined?null:Date.parse(data.endsAt),expired=dead
const title=invalid?"Invalid activity state":data.title||(raw?"Live activity":"Ready to start"),detail=invalid?"Update valid JSON in ScriptWidget.":expired?"Time is up":data.detail||(raw?"Updated from the app":"Start or update this activity in ScriptWidget.");
const hasProgress=data.progress!==undefined,summary=invalid?"Check state":hasProgress?`${data.progress} / ${data.total}`:expired?"Finished":stale?"Needs update":raw?"Active":"Ready";
const Countdown=()=>deadline!==null&&!expired&&!invalid?:{summary};
-$render({title}{detail}{hasProgress&&}{stale&&!expired&&Data needs an update});
+// Small: the state and the title; the detail needs the width of the medium widget.
+if($getenv("widget-size")==="small")$render({deadline!==null&&!expired&&!invalid?:{summary}}{title}{hasProgress&&});
+else $render({title}{detail}{hasProgress&&}{stale&&!expired&&Data needs an update});
$dynamic_island({
expanded:{leading:,trailing:deadline!==null&&!expired&&!invalid?:{summary},center:{title},bottom:{detail}},
compactLeading:,
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/widget.json b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/widget.json
index b2d9cbca..33236863 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/widget.json
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Live Activity Demo/widget.json
@@ -7,6 +7,7 @@
"minimumRuntimeVersion": "1.3",
"entry": "main.jsx",
"supportedFamilies": [
+ "systemSmall",
"systemMedium"
],
"permissions": [],
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Monthly Budget Planner/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Monthly Budget Planner/main.jsx
index d8b5a02b..6fd6afa5 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Monthly Budget Planner/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Monthly Budget Planner/main.jsx
@@ -1,4 +1,4 @@
-// Large widget. widget-param: budget,spent,housing,food,fun
+// Designed for the large widget; the small and medium sizes show the essentials. widget-param: budget,spent,housing,food,fun
const values = ($getenv("widget-param") || "4200,2675,1450,620,280").split(",").map(Number);
const budget = values[0] || 4200;
const spent = Math.max(0, values[1] || 0);
@@ -11,22 +11,46 @@ const categories = [
const money = value => `$${Math.round(value).toLocaleString()}`;
const Category = ({ item }) => (
-
- {item.name}{money(item.value)} / {money(item.cap)}
+
+ {item.name}{money(item.value)} / {money(item.cap)}
);
-$render(
-
- Monthly Budget
-
- REMAINING{money(remaining)}{Math.round(remaining / budget * 100)}% available
- SPENT{money(spent)}of {money(budget)}
+const size = $getenv("widget-size");
+const used = `${Math.round(spent / budget * 100)}% USED`;
+if (size === "small") {
+ // Small: what is left of the budget.
+ $render(
+
+ REMAINING
+ {money(remaining)}of {money(budget)}
+
+ {used.toLowerCase()}
+
+ );
+} else if (size === "medium") {
+ // Medium: what is left, beside the three categories.
+ $render(
+
+ REMAINING{money(remaining)}of {money(budget)}
+
+ {categories.map(item => {item.name}{money(item.value)} / {money(item.cap)})}
+
-
- CATEGORY GUARDRAILS
- {categories.map(item => )}
+ );
+} else {
+ $render(
+
+ Monthly Budget
+
+ REMAINING{money(remaining)}{Math.round(remaining / budget * 100)}% available
+ SPENT{money(spent)}of {money(budget)}
+
+
+ CATEGORY GUARDRAILS
+ {categories.map(item => )}
+
-
-);
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Open Link/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Open Link/main.jsx
index 3b10bc7c..36c93395 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Open Link/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Open Link/main.jsx
@@ -5,9 +5,19 @@
// Template for component link
//
-$render(
-
- TAP TO OPEN
- ScriptWidgetA full-card link with one simple URL.
-
-);
+if ($getenv("widget-size") === "small") {
+ // Small: the name of the link, without the sentence that needs the width.
+ $render(
+
+
+ ScriptWidgetTAP TO OPEN
+
+ );
+} else {
+ $render(
+
+ TAP TO OPEN
+ ScriptWidgetA full-card link with one simple URL.
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Personal Dashboard/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Personal Dashboard/main.jsx
index bb97af24..eca91e7f 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Personal Dashboard/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Personal Dashboard/main.jsx
@@ -6,19 +6,33 @@ const hour = new Date().getHours();
const greeting = hour < 12 ? "Good morning" : hour < 18 ? "Good afternoon" : "Good evening";
const dayProgress = Math.min(1, (hour * 60 + new Date().getMinutes()) / 1440);
-$render(
-
-
-
- {greeting}, {name}
-
+if ($getenv("widget-size") === "small") {
+ // Small: how much of today has passed, under a two-line greeting.
+ $render(
+
+ {greeting},{name}
+
+ {Math.round(dayProgress * 100)}%
+
+ of today complete
-
-
-
-
-
-
- {Math.round(dayProgress * 100)}% of today complete
-
-);
+
+ );
+} else {
+ $render(
+
+
+
+ {greeting}, {name}
+
+
+
+
+
+
+
+
+ {Math.round(dayProgress * 100)}% of today complete
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Pomodoro Focus/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Pomodoro Focus/main.jsx
index 03b2ba62..c02238d5 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Pomodoro Focus/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Pomodoro Focus/main.jsx
@@ -1,3 +1,8 @@
// widget-param: focus minutes (optional)
const minutes = Math.max(5, Number($getenv("widget-param")) || 25);
-$render(Focus session{minutes}:00One task. No distractions.);
+if ($getenv("widget-size") === "small") {
+ // Small: the length of the session.
+ $render(FOCUS{minutes}:00One task at a time.);
+} else {
+ $render(Focus session{minutes}:00One task. No distractions.);
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Reading Goal/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Reading Goal/main.jsx
index 14d263b3..7bdf01d9 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Reading Goal/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Reading Goal/main.jsx
@@ -1,3 +1,8 @@
// widget-param: books read,goal (optional), e.g. 7,12
const values = ($getenv("widget-param") || "7,12").split(",").map(Number); const read = values[0] || 0; const goal = values[1] || 12;
-$render(READING GOAL{read} of {goal} books{Math.max(0, goal-read)} to go · keep turning pages);
+if ($getenv("widget-size") === "small") {
+ // Small: books read out of the goal.
+ $render(READING{read} of {goal}books · {Math.max(0, goal-read)} to go);
+} else {
+ $render(READING GOAL{read} of {goal} books{Math.max(0, goal-read)} to go · keep turning pages);
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Shape/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Shape/main.jsx
index 70dfd2a6..3c89a2cf 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Shape/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Shape/main.jsx
@@ -8,9 +8,19 @@
//
-$render(
-
-
- SHAPESBuild with primitivesCompose, color, rotate.
-
-);
+if ($getenv("widget-size") === "small") {
+ // Small: the shapes alone.
+ $render(
+
+
+ SHAPES
+
+ );
+} else {
+ $render(
+
+
+ SHAPESBuild with primitivesCompose, color, rotate.
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Sleep Schedule/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Sleep Schedule/main.jsx
index c8478d01..9e350779 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Sleep Schedule/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Sleep Schedule/main.jsx
@@ -1,3 +1,8 @@
// widget-param: bedtime,wake time (optional)
const t=($getenv("widget-param")||"10:30 PM,6:30 AM").split(",");
-$render(Sleep scheduleBEDTIME{t[0].trim()}WAKE UP{(t[1]||"6:30 AM").trim()});
+if ($getenv("widget-size") === "small") {
+ // Small: the two times under each other.
+ $render(SLEEPBEDTIME{t[0].trim()}WAKE UP{(t[1]||"6:30 AM").trim()});
+} else {
+ $render(Sleep scheduleBEDTIME{t[0].trim()}WAKE UP{(t[1]||"6:30 AM").trim()});
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Sunrise & Sunset/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Sunrise & Sunset/main.jsx
index 1d88025f..a1370e7e 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Sunrise & Sunset/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Sunrise & Sunset/main.jsx
@@ -32,12 +32,23 @@ const formatTime = (date) => {
return date.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
};
-$render(
-
- Sunrise & Sunset
-
+if ($getenv("widget-size") === "small") {
+ // Small: the two times under each other.
+ $render(
+
+ Sunrise & Sunset
-
-
-);
+
+ );
+} else {
+ $render(
+
+ Sunrise & Sunset
+
+
+
+
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/System Insights/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/System Insights/main.jsx
index f2b697ef..824fb5e8 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/System Insights/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/System Insights/main.jsx
@@ -10,18 +10,32 @@ const uptimeHours = ($system.systemUptime() / 3600).toFixed(1);
const cpuCount = $system.processorCount();
const activeCpu = $system.activeProcessorCount();
-$render(
-
-
- SYSTEM
- {$system.platform().toUpperCase()}
- {$system.osVersionString()}
+if ($getenv("widget-size") === "small") {
+ // Small: the platform and the three numbers, one on each line.
+ const Line = ({ title, value, color }) => {title}{value};
+ $render(
+
+ SYSTEM
+ {$system.platform().toUpperCase()}
+
+
+
-
-
-
-
-
-
-
-);
+ );
+} else {
+ $render(
+
+
+ SYSTEM
+ {$system.platform().toUpperCase()}
+ {$system.osVersionString()}
+
+
+
+
+
+
+
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Text Today Week/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Text Today Week/main.jsx
index ee4f3196..0f86aac5 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Text Today Week/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Text Today Week/main.jsx
@@ -10,8 +10,18 @@ const weekday = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday
let day = weekday[d.getDay()];
-$render(
-
- TODAY{day}
-
-);
+if ($getenv("widget-size") === "small") {
+ // Small: the weekday in a size that fits "Wednesday", and a short date.
+ $render(
+
+ TODAY
+ {day}{d.toLocaleDateString("en-US", { month: "short", day: "numeric" })}
+
+ );
+} else {
+ $render(
+
+ TODAY{day}
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Text Year Days Left/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Text Year Days Left/main.jsx
index 57b104d5..116328f1 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Text Year Days Left/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Text Year Days Left/main.jsx
@@ -8,9 +8,10 @@
//
var today = new Date();
-var lastDay = new Date(today.getFullYear(), 12, 31);
+// Whole days from today's date to 31 December: 0 on the last day of the year.
+// Both are counted as calendar dates, so the time of day does not matter.
var perDay = 1000 * 60 * 60 * 24;
-var leftDays = Math.ceil((lastDay.getTime() - today.getTime()) / perDay);
+var leftDays = Math.round((Date.UTC(today.getFullYear(), 11, 31) - Date.UTC(today.getFullYear(), today.getMonth(), today.getDate())) / perDay);
$render(
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Travel Day Dashboard/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Travel Day Dashboard/main.jsx
index f642007b..171d3dab 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Travel Day Dashboard/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Travel Day Dashboard/main.jsx
@@ -1,4 +1,4 @@
-// Large widget. widget-param: flight|origin|destination|departure|gate|weather|essentials comma-separated
+// Designed for the large widget; the small and medium sizes show the essentials. widget-param: flight|origin|destination|departure|gate|weather|essentials comma-separated
const parts = ($getenv("widget-param") || "SW 218|SFO|SEA|10:40 AM|B12|58° · Light rain|Passport,Headphones,Charger").split("|");
const flight = parts[0] || "SW 218";
const origin = parts[1] || "SFO";
@@ -8,22 +8,50 @@ const gate = parts[4] || "B12";
const weather = parts[5] || "58° · Light rain";
const essentials = (parts[6] || "Passport,Headphones,Charger").split(",").slice(0, 3);
-$render(
-
- Travel DayEverything before boarding
-
- {origin}DEPART
-
- {destination}ARRIVE
-
-
- DEPARTURE{departure}
- GATE{gate}
- DESTINATION{weather}
-
-
- BEFORE YOU GO
- {essentials.map(item => {item.trim()}PACKED?)}
+const size = $getenv("widget-size");
+if (size === "small") {
+ // Small: the route, the departure time and the gate.
+ $render(
+
+
+ {origin} → {destination}
+ GATE {gate}{departure}
-
-);
+ );
+} else if (size === "medium") {
+ // Medium: the route above the departure, the gate and the weather.
+ $render(
+
+
+ {origin}DEPART
+
+ {destination}ARRIVE
+
+
+ DEPARTURE{departure}
+ GATE{gate}
+ DESTINATION{weather}
+
+
+ );
+} else {
+ $render(
+
+ Travel DayEverything before boarding
+
+ {origin}DEPART
+
+ {destination}ARRIVE
+
+
+ DEPARTURE{departure}
+ GATE{gate}
+ DESTINATION{weather}
+
+
+ BEFORE YOU GO
+ {essentials.map(item => {item.trim()}PACKED?)}
+
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Weekly Planner/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Weekly Planner/main.jsx
index 9e3a5982..b6023d2b 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Weekly Planner/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Weekly Planner/main.jsx
@@ -11,19 +11,41 @@ const Day = ({ index }) => (
);
-$render(
-
-
+if ($getenv("widget-size") === "small") {
+ // Small: one letter for each day, so that the seven fit.
+ const Letter = ({ index }) => (
+
+ {names[index][0]}
+
+
+ );
+ $render(
+ This Week
- Make today count
+ {now.toLocaleDateString("en-US", { weekday: "short", month: "short", day: "numeric" })}
-
-
-
-
-
-
-
-
-);
+
+
+
+
+
+ );
+} else {
+ $render(
+
+
+
+ This Week
+ Make today count
+
+
+
+
+
+
+
+
+
+ );
+}
diff --git a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Wellness Dashboard/main.jsx b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Wellness Dashboard/main.jsx
index a5bc40d5..c6a2b7e3 100644
--- a/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Wellness Dashboard/main.jsx
+++ b/Shared/ScriptWidgetRuntime/Resource/Script.bundle/template/Wellness Dashboard/main.jsx
@@ -1,4 +1,4 @@
-// Large widget. widget-param: sleepHours,waterGlasses,steps,mood
+// Designed for the large widget; the small and medium sizes show the essentials. widget-param: sleepHours,waterGlasses,steps,mood
const values = ($getenv("widget-param") || "7.5,6,6840,Calm").split(",");
const sleep = Number(values[0]) || 0;
const water = Number(values[1]) || 0;
@@ -14,18 +14,52 @@ const Metric = ({ icon, title, value, detail, color, progress, total }) => (
);
-$render(
-
- Wellness TodaySmall choices, steady energy
-
-
- DAILY BALANCEGood momentumAdd one glass and a short walk.
-
-
-
-
-
-
-
-
-);
+const size = $getenv("widget-size");
+if (size === "small") {
+ // Small: the balance score.
+ $render(
+
+ DAILY BALANCE
+ {score}
+
+
+ );
+} else if (size === "medium") {
+ // Medium: the balance score above the three numbers.
+ const Figure = ({ icon, title, value, color }) => (
+
+ {title}
+ {value}
+
+ );
+ $render(
+
+
+ {score}
+ DAILY BALANCE· {mood}Good momentum
+
+
+
+
+
+
+
+
+ );
+} else {
+ $render(
+
+ Wellness TodaySmall choices, steady energy
+
+
+ DAILY BALANCEGood momentumAdd one glass and a short walk.
+
+
+
+
+
+
+
+
+ );
+}
diff --git a/Skills/scriptwidget-creator/SKILL.md b/Skills/scriptwidget-creator/SKILL.md
index 27cb31e2..7aa07894 100644
--- a/Skills/scriptwidget-creator/SKILL.md
+++ b/Skills/scriptwidget-creator/SKILL.md
@@ -9,10 +9,22 @@ Use the user's Coding Agent and model. ScriptWidget supplies the runtime contrac
## Before editing
-Read [authoring](references/authoring.md) for the JSX dialect and a working starting point. For a specific tag or API, search [runtime API](references/runtime-api.md); read only the relevant section. Read [package format](references/package-format.md) when changing manifests, permissions, imports or resources. The included references target runtime API 1.4.
+Read [authoring](references/authoring.md) for the JSX dialect and a working starting point. For a specific tag or API, search [runtime API](references/runtime-api.md); read only the relevant section. Read [package format](references/package-format.md) when changing manifests, permissions, imports or resources. The included references target runtime API 1.6.
Keep work in a separate package directory. Preserve the user's existing files and package identity when editing. Prefer `widget.json` and `main.jsx` for new work. Never replace an invalid present manifest with a legacy package.
+## Target systems
+
+One package installs on iPhone, iPad, Mac, Android, Windows and Linux, but not every API has something behind it on every system. Before using a data API, read [platform support](references/platform-support.md) and compare its row with the systems the user named; when they named none, ask, or assume all of them and say so.
+
+- `$device`, `$system`, `$storage`, `$file`, `fetch`, `$http`, `$xml`, `$dataSource` and `$weather` work on all five. Health, location, music and alarms are not on Mac; no personal-data API (calendar, photos, health, location, music and the like) is on Windows or Linux; reminders and Home are Apple only.
+- An API a system lacks answers `false` from `isAvailable()` and rejects with `[unsupported_platform]`. Check `isAvailable()` first and render a real fallback card. Branch on `$system.platform()` only for what cannot be feature-detected.
+- Tell the user which systems the finished widget shows real data on. Do not describe a widget that needs `$health` as working on Windows or Linux.
+- Android, Windows and Linux draw text in Inter, which is wider than Apple's system font, and cut text that does not fit. Leave room: short labels, and a layout for each declared family chosen with `$getenv("widget-size")`, not one layout scaled down. A render on the Mac does not show the other systems' text widths.
+- Lock Screen families, Live Activities, Control Widgets and `backgroundMaterial` are system-specific; the same page lists them.
+
+The steps below use the Mac command line. The Linux app installs a command of the same name with its own options (`check`, `run`, `render --output`, `pack`; no Web Studio handoff): read `scriptwidget --help` there instead of assuming the Mac flags. Windows installs no command line.
+
## Generate, check, preview, repair
1. Discover `scriptwidget --version --format json` and `scriptwidget doctor --format json`. Use CLI 0.2.x/report v1 for browser handoff. If unavailable, explain the dependency and provide the documented Homebrew command; do not install without the user's authorization.
diff --git a/Skills/scriptwidget-creator/references/authoring.md b/Skills/scriptwidget-creator/references/authoring.md
index 73807044..f268ed10 100644
--- a/Skills/scriptwidget-creator/references/authoring.md
+++ b/Skills/scriptwidget-creator/references/authoring.md
@@ -26,4 +26,6 @@ $render(
For meaningful example previews use clearly synthetic values. For real behavior, read records and handle empty/missing data rather than silently treating demonstration records as the user's history. Denied HealthKit reads and no readable samples must not be conflated. Mock success cannot grant a manifest permission or prove real authorization.
+A data API may be missing on the system the widget runs on (see [platform support](platform-support.md)): guard it with `isAvailable()` and draw a fallback, for example `if (!$health.isAvailable()) { $render(Health is not available here); } else { … }`.
+
Prefer a working subset of the user's request over invented APIs. Explain unsupported interaction or platform capabilities, and show the relevant report diagnostic.
diff --git a/Skills/scriptwidget-creator/references/platform-support.md b/Skills/scriptwidget-creator/references/platform-support.md
new file mode 100644
index 00000000..d28b837e
--- /dev/null
+++ b/Skills/scriptwidget-creator/references/platform-support.md
@@ -0,0 +1,66 @@
+# Platform support
+
+What runs where. One Package 2.0 widget installs on every platform below; a feature a platform lacks reports `[unsupported_platform]` or falls back as the notes say. `$system.platform()` tells a script where it is running.
+
+| | iPhone and iPad | Mac | Android | Windows | Linux |
+| --- | --- | --- | --- | --- | --- |
+| Status | Released | Released | Version 1.0.0 on GitHub Releases; Google Play closed test open to testers | Preview; not yet in the Microsoft Store | Preview for Omarchy 4.5 |
+| System version | iOS 16 or later | macOS 26 or later | Android 15 or later | Windows 11 | Omarchy 4.5 (Arch Linux) |
+| Widgets | WidgetKit | WidgetKit | App Widgets | Desktop widgets drawn by the app | Desktop widgets drawn by the app, shown by an Omarchy plugin |
+| JavaScript engine | JavaScriptCore | JavaScriptCore | QuickJS-NG | QuickJS-NG | QuickJS-NG |
+
+The browser preview in [Web Studio](https://github.com/everettjf/scriptwidget/blob/main/docs/web-studio-browser.md) is a design tool, not a place widgets are installed; its coverage is in [Browser preview coverage](https://github.com/everettjf/scriptwidget/blob/main/docs/browser-preview-coverage.md).
+
+## Widgets and system surfaces
+
+| Feature | iPhone and iPad | Mac | Android | Windows | Linux |
+| --- | --- | --- | --- | --- | --- |
+| Small, medium, large and extra-large widgets | Yes | Yes | Yes; the launcher decides the real size | Yes, at the Mac sizes | Yes, at the Mac sizes |
+| Lock Screen (accessory) widgets | Yes | No | No | No | No |
+| Accented and vibrant rendering modes | Yes | Yes | No, always `fullColor` | No, always `fullColor` | No, always `fullColor` |
+| `backgroundMaterial` | Yes | Yes | The opaque `background` fallback | The opaque `background` fallback | The opaque `background` fallback |
+| Buttons and toggles in a widget | Yes | Yes | Yes | Yes | Yes |
+| Timeline with future entries | Yes | Yes | The script runs again at each transition | The script runs again at each transition | The script runs again at each transition |
+| Live Activities and the Dynamic Island | Yes | No | A Live Update notification; the JSX layout is not drawn | No | No |
+| Control Widgets | Yes | No | Quick Settings tiles | No | No |
+| Siri and Shortcuts actions | Yes | Yes | App shortcuts and the automation entry point; no voice | No | No |
+| Push-triggered refresh | On system versions that support it | On system versions that support it | Yes, through Firebase Cloud Messaging | No | No |
+| Scrolling `` | No, shows as an unknown tag | No | Yes | No | No |
+| Wallpaper colors (`material.`) | No, the color is ignored | No | Yes | No | No |
+| Automation entry point for other apps | No | No | Yes | No | No |
+
+## Data APIs
+
+
+| API | iPhone and iPad | Mac | Android | Windows | Linux |
+| --- | --- | --- | --- | --- | --- |
+| `$device`, `$system`, `$storage`, `$file`, `fetch`, `$http`, `$xml` | Yes | Yes | Yes | Yes | Yes |
+| `$dataSource` (Data Source Plugins) | Yes | Yes | Yes | Yes | Yes |
+| `$weather` | Yes | Yes | Yes | Yes | Yes |
+| `$calendar` | Yes | Yes | Yes, for calendars selected in the app | No | No |
+| `$photos` | Yes | Yes | Individual photos picked in the app, no albums | No | No |
+| `$contacts`, `$documents` | Yes | Yes | Yes, for items picked in the app | No | No |
+| `$maps` | Yes | Yes | Geocoding and place search; no `snapshot` | No | No |
+| `$notifications` | Yes | Yes | Yes, delivery is inexact | No | No |
+| `$services` (GitHub) | Yes | Yes | With a fine-grained token, no OAuth sign-in | No | No |
+| `$icloud` | Yes | Yes | A sync folder the user picks; cannot exchange data with an iPhone | No | No |
+| `$location` | Yes | No | Yes; widgets see the position saved while the app was open | No | No |
+| `$health` | Yes | No | Health Connect; no ring goals or stand time | No | No |
+| `$music` | Yes | No | The active media session of any app | No | No |
+| `$alarms` | Yes | No | Yes, inexact, no system alarm UI | No | No |
+| `$reminders` | Yes | Yes | No | No | No |
+| `$home` | Yes | No | No | No | No |
+
+
+This table is written by `npm run docs` in `Editor/editorfe` from `src/platformSupport.js`, which also puts each API's line at the top of that API's page; change it there. The Apple columns follow the generated [data API catalog](https://github.com/everettjf/scriptwidget/blob/main/docs/data-api-catalog.md), which stays the authority for each method. The Android column follows [ScriptWidget for Android](https://github.com/everettjf/scriptwidget/blob/main/docs/android/README.md), which explains every difference and what was tested on which device. The Windows column follows [ScriptWidget for Windows](https://github.com/everettjf/scriptwidget/blob/main/docs/windows/README.md), and the Linux column [ScriptWidget for Linux](https://github.com/everettjf/scriptwidget/blob/main/docs/linux/README.md).
+
+## Authoring tools
+
+| Tool | Runs on |
+| --- | --- |
+| [ScriptWidget Studio](https://github.com/everettjf/scriptwidget/blob/main/docs/studio.md), with multi-size preview, Copilot, Skills and the Data Source Lab | Mac |
+| In-app editor, Gallery, Skills and AI generation | iPhone, iPad and Android |
+| Management window with a code editor and a live preview | Windows, Linux |
+| [Web Studio](https://github.com/everettjf/scriptwidget/blob/main/docs/web-studio-browser.md) | Any desktop browser |
+| [Command line](https://github.com/everettjf/scriptwidget/blob/main/docs/mac-cli.md) | Mac |
+| [Command line `scriptwidget`](https://github.com/everettjf/scriptwidget/blob/main/docs/linux/README.md#the-command-line) | Linux |
diff --git a/Tools/ScriptWidgetCLI/prepare-resources.mjs b/Tools/ScriptWidgetCLI/prepare-resources.mjs
index 499c3af3..cd26e047 100644
--- a/Tools/ScriptWidgetCLI/prepare-resources.mjs
+++ b/Tools/ScriptWidgetCLI/prepare-resources.mjs
@@ -15,7 +15,7 @@ for(const [name,component] of Object.entries(scriptWidgetAPI.components)){
}
fs.writeFileSync(path.join(directory,'Resources/api-catalog.json'),JSON.stringify(dataAPICatalog));
fs.writeFileSync(path.join(directory,'Resources/components.json'),JSON.stringify({tags,properties}));
-for(const [source,target] of [['docs/scriptwidget-runtime-api.md','runtime-api.md'],['docs/package-format.md','package-format.md']]){
+for(const [source,target] of [['docs/scriptwidget-runtime-api.md','runtime-api.md'],['docs/package-format.md','package-format.md'],['docs/platform-support.md','platform-support.md']]){
let text=fs.readFileSync(path.join(root,source),'utf8');
text=text.replace(/\[([^\]]+)\]\(([^)]+)\)/g,(whole,label,url)=>/^(https?:|#)/.test(url)?whole:`[${label}](https://github.com/everettjf/scriptwidget/blob/main/${path.posix.normalize(path.posix.join(path.posix.dirname(source),url))})`);
fs.writeFileSync(path.join(root,'Skills/scriptwidget-creator/references',target),text);
diff --git a/Tools/ScriptWidgetPreview/Scripts/contact-sheets.swift b/Tools/ScriptWidgetPreview/Scripts/contact-sheets.swift
new file mode 100644
index 00000000..4a2fb629
--- /dev/null
+++ b/Tools/ScriptWidgetPreview/Scripts/contact-sheets.swift
@@ -0,0 +1,66 @@
+// Builds the contact sheets of Resource/WidgetDemoScreenshots from the
+// pictures in that folder: 20 templates a sheet, 5 across, name below.
+//
+// swift Tools/ScriptWidgetPreview/Scripts/contact-sheets.swift Resource/WidgetDemoScreenshots
+//
+// The pictures themselves come from the Mac app:
+// ScriptWidget.app/Contents/MacOS/ScriptWidget --render-template-previews
+
+import AppKit
+
+let arguments = CommandLine.arguments
+guard arguments.count == 2 else {
+ FileHandle.standardError.write(Data("usage: contact-sheets.swift \n".utf8))
+ exit(2)
+}
+let folder = URL(fileURLWithPath: arguments[1], isDirectory: true)
+let files = try FileManager.default.contentsOfDirectory(at: folder, includingPropertiesForKeys: nil)
+ .filter { $0.pathExtension == "png" }
+ .sorted { $0.lastPathComponent.localizedStandardCompare($1.lastPathComponent) == .orderedAscending }
+
+for old in try FileManager.default.contentsOfDirectory(at: folder, includingPropertiesForKeys: nil)
+where old.lastPathComponent.hasPrefix("_contact-sheet-") {
+ try FileManager.default.removeItem(at: old)
+}
+
+let columns = 5, rows = 4
+let cellWidth = 380, cellHeight = 390, picture = 338
+let width = columns * cellWidth, height = rows * cellHeight
+let background = CGColor(red: 0.094, green: 0.094, blue: 0.106, alpha: 1)
+
+var sheet = 0
+for start in stride(from: 0, to: files.count, by: columns * rows) {
+ sheet += 1
+ let page = Array(files[start..
+> **Runs on:** iPhone and iPad, Mac, Android (for calendars selected in the app). **Not on:** Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
Native Runtime 1.3 adds read-only EventKit access on iOS, iPadOS and macOS. The browser preview engine simulates these methods with editable Mock Data. This is the current source contract; the previously uploaded 27.1.2 (27012) build does not include it.
## Package and system access
diff --git a/docs/data-api-catalog.md b/docs/data-api-catalog.md
index dcda7217..fabb3a9c 100644
--- a/docs/data-api-catalog.md
+++ b/docs/data-api-catalog.md
@@ -1,11 +1,36 @@
# Data API capability catalog
-> Generated from `Editor/editorfe/src/dataAPICatalog.js`. Native JSExport protocols remain authoritative. This catalog is descriptive and grants no permissions.
+> Generated from `Editor/editorfe/src/dataAPICatalog.js` and `Editor/editorfe/src/platformSupport.js`. Native JSExport protocols remain authoritative. This catalog is descriptive and grants no permissions.
This covers device, system, health, location, calendar, reminders, photos and connected-service data methods. Files, network, storage, rendering and runtime configuration retain their own contracts. Platforms list intended real-data support, not mocked browser execution; hardware and OS authorization still determine availability.
Existing data-method return formats are unchanged. Present manifests now undergo package and minimum-version validation before execution. In particular, HealthKit does not expose individual read-denial status, and location cache presence is not proof that permission is still granted. Default mock values are illustrative, never measurements from the current device.
+## Which systems each API runs on
+
+"Native platforms" in the method table below means the Apple systems. Android, Windows and Linux run the same scripts on another engine; what they support is per API, not per method, and [Platform support](platform-support.md) explains each limit. An API a system lacks answers `false` from `isAvailable()` and rejects with `[unsupported_platform]`.
+
+| API | iPhone and iPad | Mac | Android | Windows | Linux |
+| --- | --- | --- | --- | --- | --- |
+| `$device`, `$system`, `$storage`, `$file`, `fetch`, `$http`, `$xml` | Yes | Yes | Yes | Yes | Yes |
+| `$dataSource` (Data Source Plugins) | Yes | Yes | Yes | Yes | Yes |
+| `$weather` | Yes | Yes | Yes | Yes | Yes |
+| `$calendar` | Yes | Yes | Yes, for calendars selected in the app | No | No |
+| `$photos` | Yes | Yes | Individual photos picked in the app, no albums | No | No |
+| `$contacts`, `$documents` | Yes | Yes | Yes, for items picked in the app | No | No |
+| `$maps` | Yes | Yes | Geocoding and place search; no `snapshot` | No | No |
+| `$notifications` | Yes | Yes | Yes, delivery is inexact | No | No |
+| `$services` (GitHub) | Yes | Yes | With a fine-grained token, no OAuth sign-in | No | No |
+| `$icloud` | Yes | Yes | A sync folder the user picks; cannot exchange data with an iPhone | No | No |
+| `$location` | Yes | No | Yes; widgets see the position saved while the app was open | No | No |
+| `$health` | Yes | No | Health Connect; no ring goals or stand time | No | No |
+| `$music` | Yes | No | The active media session of any app | No | No |
+| `$alarms` | Yes | No | Yes, inexact, no system alarm UI | No | No |
+| `$reminders` | Yes | Yes | No | No | No |
+| `$home` | Yes | No | No | No | No |
+
+## Methods
+
| API | Minimum native API | Native platforms | Execution | Authorization | Operation |
| --- | --- | --- | --- | --- | --- |
| `$music.isAvailable()` | 1.4 | ios | Synchronous | musicRead | availability |
@@ -102,6 +127,8 @@ Existing data-method return formats are unchanged. Present manifests now undergo
Runtime 1.4. Read-only Music app playback, not every audio player. Requires an installed owner, music permission and Music library approval in native Settings. current() is asynchronous and returns provider, state, hasItem, nullable title/artist/album/duration/position and capturedAt. State may be playing while details are absent (Home Sharing). Native player access is main-thread-only: synchronous hosts prepare one snapshot before JSC waits; background previews capture on the main queue. No playback/queue mutation, scans, artwork, credential or subscription inference. No live queries in future entries/Live Activities. Main system-player API is unavailable on macOS; Web supplies editable samples, never actual device access.
+**Runs on:** iPhone and iPad, Android (The active media session of any app). **Not on:** Mac, Windows, Linux.
+
### `$music.isAvailable`
Default editable preview sample:
@@ -140,6 +167,8 @@ Default editable preview sample:
Runtime 1.4: status(service) and profile(service) are asynchronous. Only provider: github. Unknown providers reject with service_operation. Requires an installed owner and services permission. profile additionally requires network and api.github.com in networkDomains, a native connected GitHub account and explicit owner grant. Native Settings handles credentials; scripts cannot log in or obtain tokens. profile returns service, subject, username, displayName, publicRepositories, privateRepositories, followers and following (missing values are null). No live queries in future entries or Live Activities. Eight shared data queries; native requests also share the eight concurrent/32 total network budget, while Web uses its existing preview network budget. Web uses editable best-state samples only; it never authenticates or sends these requests.
+**Runs on:** iPhone and iPad, Mac, Android (With a fine-grained token, no OAuth sign-in). **Not on:** Windows, Linux.
+
### `$services.status`
Default editable preview sample:
@@ -169,6 +198,8 @@ Default editable preview sample:
Device values depend on hardware. Some legacy Mac values are placeholders; inspect the API documentation before using them as measurements.
+**Runs on:** iPhone and iPad, Mac, Android, Windows, Linux.
+
### `$device.screen`
Default editable preview sample:
@@ -252,6 +283,8 @@ Default editable preview sample:
System metadata, not whole-device CPU, FPS or network traffic monitoring. Hardware-specific values may be unavailable.
+**Runs on:** iPhone and iPad, Mac, Android, Windows, Linux.
+
### `$system.appInfo`
Default editable preview sample:
@@ -417,6 +450,8 @@ Default editable preview sample:
Requires photos permission and explicit native photo/album selection (none by default). Limited Photos authorization is supported. items({limit:1..4,offset:0..63,maxAgeSeconds:0..86400}) returns bounded, metadata-stripped JPEG thumbnails as image data URLs. Four 768px / 128KiB thumbnails at most; private snapshots expire after 24h and are rechecked against current access, selected sources and asset revisions. Cloud-only items report unavailableCount; download them in Photos first. Future timeline/Live Activity presentations read matching snapshots only. Web uses editable sample data and photosSelection IDs; no actual library access.
+**Runs on:** iPhone and iPad, Mac, Android (Individual photos picked in the app, no albums). **Not on:** Windows, Linux.
+
### `$photos.isAvailable`
Default editable preview sample:
@@ -485,6 +520,8 @@ Default editable preview sample:
Requires calendar in widget.json and full system Calendar access. The user's native Settings source selection limits metadata, events and cached snapshots; scripts cannot enlarge it. Use calendars() for permitted IDs and show setup when no sources are selected. Queries are read-only, limited to 31 days and 50 items. Preview calendarSelection simulates this scope without granting package permission.
+**Runs on:** iPhone and iPad, Mac, Android (for calendars selected in the app). **Not on:** Windows, Linux.
+
### `$calendar.isAvailable`
Default editable preview sample:
@@ -576,6 +613,8 @@ Default editable preview sample:
Requires reminders in widget.json and full system Reminders access. Reads require native Settings selected lists. create/update/setCompleted additionally require remindersWrite and a native declared action, stable requestID, durable replay receipts and an unchanged selected list. Web writes update preview-only items/receipts; receipt identities are derived from that state, with configurable API errors. Use lists() for IDs. items() selects pending due dates or completed completion dates in a positive window of at most 31 days, up to 50 items. Undated pending reminders are excluded. remindersSelection mocks the user scope without granting permission.
+**Runs on:** iPhone and iPad, Mac. **Not on:** Android, Windows, Linux.
+
### `$reminders.isAvailable`
Default editable preview sample:
@@ -682,6 +721,8 @@ Default editable preview sample:
Read-only HealthKit. Request access in the app. Runtime 1.4 adds sleepSummary (up to 7 days / 256 samples, union with explicit stage-conflict precedence), activitySummary (one local Gregorian day including active-energy or move-time mode and optional goals), and workouts (up to 31 days / 50 fully-contained summaries, optional kcal/meters). These require an explicit health manifest; all share the query budget and cannot run in future/Live Activity presentations. No Health readings are persisted by the API. Authorization completion does not reveal whether individual read types were granted; empty results must not be labelled permission denied. API 1.3 readings add hasSamples: false means no readable samples, never a read-denial verdict. Existing value/unit/start/end fields remain.
+**Runs on:** iPhone and iPad, Android (Health Connect; no ring goals or stand time). **Not on:** Mac, Windows, Linux.
+
### `$health.authorizationStatus`
Default editable preview sample:
@@ -851,6 +892,8 @@ Default editable preview sample:
Package 2.0 requires location permission. Request system access in the app. Widgets also require isAuthorizedForWidgetUpdates. Cache is rechecked against authorization and precision, discarded after 24 hours or revocation, and reports age/isStale.
+**Runs on:** iPhone and iPad, Android (widgets see the position saved while the app was open). **Not on:** Mac, Windows, Linux.
+
### `$location.isAvailable`
Default editable preview sample:
@@ -907,6 +950,8 @@ Default editable preview sample:
Runtime 1.6. Installed widgets require manifest permission, explicit native System Access, system authorization where applicable, an active installation and bounded queries. Writes require a user action; future timelines and Live Activities cannot call this API. Web and CLI fixtures never access real device data.
+**Runs on:** iPhone and iPad, Mac, Android (delivery is inexact). **Not on:** Windows, Linux.
+
### `$notifications.status`
Default editable preview sample:
@@ -951,6 +996,8 @@ Default editable preview sample:
Runtime 1.6. Installed widgets require manifest permission, explicit native System Access, system authorization where applicable, an active installation and bounded queries. Writes require a user action; future timelines and Live Activities cannot call this API. Web and CLI fixtures never access real device data.
+**Runs on:** iPhone and iPad, Mac, Android, Windows, Linux.
+
### `$weather.forecast`
Default editable preview sample:
@@ -982,6 +1029,8 @@ Default editable preview sample:
Runtime 1.6. Installed widgets require manifest permission, explicit native System Access, system authorization where applicable, an active installation and bounded queries. Writes require a user action; future timelines and Live Activities cannot call this API. Web and CLI fixtures never access real device data.
+**Runs on:** iPhone and iPad, Android (inexact, no system alarm UI). **Not on:** Mac, Windows, Linux.
+
### `$alarms.status`
Default editable preview sample:
@@ -1060,6 +1109,8 @@ Default editable preview sample:
Runtime 1.6. Installed widgets require manifest permission, explicit native System Access, system authorization where applicable, an active installation and bounded queries. Writes require a user action; future timelines and Live Activities cannot call this API. Web and CLI fixtures never access real device data.
+**Runs on:** iPhone and iPad, Mac, Android (for items picked in the app). **Not on:** Windows, Linux.
+
### `$documents.list`
Default editable preview sample:
@@ -1120,6 +1171,8 @@ Default editable preview sample:
Runtime 1.6. Installed widgets require manifest permission, explicit native System Access, system authorization where applicable, an active installation and bounded queries. Writes require a user action; future timelines and Live Activities cannot call this API. Web and CLI fixtures never access real device data.
+**Runs on:** iPhone and iPad, Mac, Android (for items picked in the app). **Not on:** Windows, Linux.
+
### `$contacts.selected`
Default editable preview sample:
@@ -1144,6 +1197,8 @@ Default editable preview sample:
Runtime 1.6. Installed widgets require manifest permission, explicit native System Access, system authorization where applicable, an active installation and bounded queries. Writes require a user action; future timelines and Live Activities cannot call this API. Web and CLI fixtures never access real device data.
+**Runs on:** iPhone and iPad, Mac, Android (Geocoding and place search; no `snapshot`). **Not on:** Windows, Linux.
+
### `$maps.search`
Default editable preview sample:
@@ -1206,6 +1261,8 @@ Default editable preview sample:
Runtime 1.6. Installed widgets require manifest permission, explicit native System Access, system authorization where applicable, an active installation and bounded queries. Writes require a user action; future timelines and Live Activities cannot call this API. Web and CLI fixtures never access real device data.
+**Runs on:** iPhone and iPad. **Not on:** Mac, Android, Windows, Linux.
+
### `$home.items`
Default editable preview sample:
diff --git a/docs/file-api.md b/docs/file-api.md
index 0c90548a..54341a5c 100644
--- a/docs/file-api.md
+++ b/docs/file-api.md
@@ -1,5 +1,9 @@
# Package files
+
+> **Runs on:** iPhone and iPad, Mac, Android, Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
`$file` reads only the currently executing package. In installation-bound execution it uses the frozen package snapshot. It does not expose device directories, another widget, system photo albums or account credentials.
- `$file.read(path)` reads UTF-8 text; missing/unreadable text returns an empty string.
diff --git a/docs/health-api.md b/docs/health-api.md
index c4ad4a98..40d1d221 100644
--- a/docs/health-api.md
+++ b/docs/health-api.md
@@ -1,5 +1,9 @@
# Health readings
+
+> **Runs on:** iPhone and iPad, Android (Health Connect; no ring goals or stand time). **Not on:** Mac, Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
`$health` exposes read-only HealthKit access through the iOS/iPadOS adapter when `HKHealthStore.isHealthDataAvailable()` is true. macOS is not a supported native data platform for this contract. Package 2.0 must declare `health`; native uninstalled previews and future timeline projections cannot read it. Query cancellation, execution identity and data-query budgets apply. Request authorization through the main app; widgets cannot present the system consent sheet.
`authorizationStatus()` reports `notDisclosed` when HealthKit is available and the package can use it. It does not return a per-type read grant. Apple deliberately does not disclose read denial: [authorizing access to health data](https://developer.apple.com/documentation/healthkit/authorizing-access-to-health-data). Consent-sheet completion is not evidence that all read types were granted.
diff --git a/docs/http-response-api.md b/docs/http-response-api.md
index 15c49031..36ff9067 100644
--- a/docs/http-response-api.md
+++ b/docs/http-response-api.md
@@ -1,5 +1,9 @@
# HTTP response metadata
+
+> **Runs on:** iPhone and iPad, Mac, Android, Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
Native API 1.3 adds `$http.getResponse(url, options?)`. It returns a Promise of `{status, body, headers}`. `body` is a string, using the same decoding options as `$http.get`; existing HTTP methods keep their string return values. HTTP error statuses resolve with their response; transport and policy failures reject.
Only these response headers are exposed, lowercased: `content-type`, `cache-control`, `expires`, `last-modified`, `date`, and `retry-after`. Each is limited to 2,048 UTF-8 bytes. Cookies, credentials and arbitrary response headers are excluded. The existing response-byte budget, public-host restrictions, declared network permission/domains, redirect checks and execution-session checks still apply. This method grants no additional access.
diff --git a/docs/icloud-json-api.md b/docs/icloud-json-api.md
index 3e0f2f49..f1ef170f 100644
--- a/docs/icloud-json-api.md
+++ b/docs/icloud-json-api.md
@@ -1,5 +1,9 @@
# iCloud JSON API (Runtime 1.5)
+
+> **Runs on:** iPhone and iPad, Mac, Android (A sync folder the user picks; cannot exchange data with an iPhone). **Not on:** Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
`$icloud` is an opt-in JSON revision store in the existing `iCloud.ScriptWidget` iCloud Drive container. It adds no third-party SDK or application server. `$storage` remains local; existing records are never automatically moved. Web Studio uses mocks; native CLI/template previews cannot access real iCloud.
## Explicit native connection
diff --git a/docs/linux/testing.md b/docs/linux/testing.md
index 484e56ed..c8bc7b09 100644
--- a/docs/linux/testing.md
+++ b/docs/linux/testing.md
@@ -476,7 +476,7 @@ node Linux/scripts/find-truncated-text.mjs --pictures <目录> --json <文件>
### 留下没改的候选
-- 只有一种排法、截图是中等或大尺寸的模板,在小尺寸上放不下:Animation Clock、Battery & Brightness、Daily Command Center、Datetime Current、Datetime Timezone、Device Battery Percent、Family Command Board、Live Activity Demo、Monthly Budget Planner、Open Link、Personal Dashboard、Pomodoro Focus、Reading Goal、Shape、Sleep Schedule、Sunrise & Sunset、System Insights、Text Today Week、Travel Day Dashboard、Weekly Planner、Wellness Dashboard;大尺寸的 Travel Day Dashboard 和 Wellness Dashboard 在中等尺寸上也放不下。这不是字体的问题:用苹果的系统字体量同一段文字,绝大多数也放不下。要给它们各做一个小尺寸的排法,这次没做。
+- 只有一种排法、截图是中等或大尺寸的模板,在小尺寸上放不下:Animation Clock、Battery & Brightness、Daily Command Center、Datetime Current、Datetime Timezone、Device Battery Percent、Family Command Board、Live Activity Demo、Monthly Budget Planner、Open Link、Personal Dashboard、Pomodoro Focus、Reading Goal、Shape、Sleep Schedule、Sunrise & Sunset、System Insights、Text Today Week、Travel Day Dashboard、Weekly Planner、Wellness Dashboard;大尺寸的 Travel Day Dashboard 和 Wellness Dashboard 在中等尺寸上也放不下。这不是字体的问题:用苹果的系统字体量同一段文字,绝大多数也放不下。这一节没做;后来做了,见下一节"模板的小尺寸排法"。
- `api/` 下的示例(health、location、storage、system):逐行列出数值的示例,`api/system` 有 14 行,中等尺寸放不下,大尺寸放得下;另外三个只是标题在小尺寸折成两行。
- New Episode Tracker:节目名画在固定 200 点宽的框里,长名字被省略是有意的,而且内容来自网络。
- Now Playing 特大尺寸的"Midnight Drive"、Image Basic Usage 小尺寸的"Photo spotlight":两个词在空格处折成两行,没有被截断。
@@ -487,7 +487,64 @@ node Linux/scripts/find-truncated-text.mjs --pictures <目录> --json <文件>
- 要联网的模板在这台 Mac 上能跑的都跑了,但内容取决于当时的网络;Daily Quote 每次都没有画出来(返回的不是 JSON),Stock Snapshot、New Episode Tracker、Weather Display 各有一轮超过 5 秒没有画出来。
- 没有在苹果的系统上把改过的模板画成图来看:`Tools/ScriptWidgetPreview` 现在编不过(工程里缺新加的存储源文件)。"在苹果上不变差"是按排版规则和用系统字体量出的宽度判断的,不是看图。
- Windows 的测试、Android 的真机测试、`Scripts/release-readiness.sh`、Web Studio 的浏览器冒烟测试都没跑。
-- Text Year Days Left 算的是到下一年 1 月 31 日的天数(`new Date(year, 12, 31)`),比"今年还剩"多 31 天;这次没改。
+
+## 2026-11-18,模板的小尺寸排法
+
+上一节留下两件事:只有一种排法的模板在小尺寸上放不下;Text Year Days Left 多算 31 天。这一节把这两件做了。还是在同一台 Mac 上跑的(macOS 27.2,Apple 芯片),没有在虚拟机或真实的 Linux 上跑。检查的办法和上一节一样。
+
+### 改了什么
+
+- 21 个模板加了小尺寸的排法,用 `$getenv("widget-size") === "small"` 分支,原来的排法放在 `else` 里:Animation Clock、Battery & Brightness、Daily Command Center、Datetime Current、Datetime Timezone、Device Battery Percent、Family Command Board、Live Activity Demo、Monthly Budget Planner、Open Link、Personal Dashboard、Pomodoro Focus、Reading Goal、Shape、Sleep Schedule、Sunrise & Sunset、System Insights、Text Today Week、Travel Day Dashboard、Weekly Planner、Wellness Dashboard。小尺寸只画模板最要紧的内容(一个时间、一个百分比、下一件事),不是把原来的排法缩小;颜色不变。上一节写的是"22 个",实际列出来、脚本也只报出来的是这 21 个。
+- 五个为大尺寸设计的模板(Daily Command Center、Family Command Board、Monthly Budget Planner、Travel Day Dashboard、Wellness Dashboard)还加了中等尺寸的排法。脚本在中等尺寸只报了后两个,但看图五个都不对:卡片叠在一起,或者下半截被切掉。
+- 模板原来设计的那个尺寸的排法没有动,两处例外,都是看图发现本来就是坏的,脚本没报:
+ - Monthly Budget Planner 大尺寸:三行分类的文字和进度条叠在一起,上面两张卡片挤在中间。现在各行有自己的高度,分类名用小一号的字,两张卡片撑满一行。
+ - Personal Dashboard 中等尺寸:内容比小组件高,标题顶到上边、日期压在分隔线上。现在间距从 12 改成 8,去掉了"Keep it simple"这一行。
+- Live Activity Demo 的 `widget.json` 原来只声明中等尺寸,现在加了 `systemSmall`,说明文件也改了。小尺寸画状态和标题,不画说明文字。
+- Text Year Days Left:原来用 `new Date(year, 12, 31)`,那是下一年的 1 月 31 日。现在用今天和 12 月 31 日两个日历日期相减,和几点钟无关。Text Days to End Of Year 和 Text Days To End Of Month 用的是 `moment().endOf(...)` 再取整天数,查过没有这个问题,没改。
+- 这些模板在 `Gallery/` 里都没有副本,`sync-gallery-templates.mjs` 不用 `--write` 就通过。
+
+### 结果
+
+| 检查 | 结果 |
+| --- | --- |
+| `find-truncated-text.mjs`,改之前 | 140 个包,2800 次运行里 2780 次排了版;29 个包有候选 |
+| `find-truncated-text.mjs`,改之后 | 140 个包,2800 次运行里 2777 次排了版;8 个包有候选,都是上一节说明过、有意留下的:`api/health`、`api/location`、`api/storage`、`api/system`、New Episode Tracker、Now Playing、Image Basic Usage、Hydration Goal iCloud。没排版的 23 次是 Daily Quote 和 Stock Snapshot(要联网,返回的不是 JSON 或者超过 5 秒) |
+| 看图 | 改过的 22 个模板(上面 21 个加 Text Year Days Left)在四个尺寸、五个时间各画了一张,共 440 张;小尺寸的 22 个看了三个时间(9 月 16 日、12 月 30 日、1 月 1 日),中等尺寸的 22 个和五个大尺寸模板的大尺寸看了 9 月 16 日,Monthly Budget Planner 的特大尺寸也看了。其余的图没有逐张看,靠的是脚本没有报 |
+| 三个"还剩几天"的模板 | 用命令行在 America/Los_Angeles 时区、13 个时间各运行一次:12 月 31 日 00:00 和 23:59 都是 0,12 月 30 日 00:00、12:00、23:59 都是 1,2026 年 1 月 1 日是 364,2028 年(闰年)1 月 1 日是 365,3 月 7 日(跨夏令时)是 299;Text Year Days Left 和 Text Days to End Of Year 13 个数都相同。月份的那个:2 月 28 日是 0,2 月 1 日是 27,11 月 18 日是 12 |
+| 苹果的参考树 | 在 iOS 27.2 模拟器(iPhone 18 Pro Max)上用 `TEST_RUNNER_SCRIPTWIDGET_UPDATE_PARITY=1` 重新生成了 `native-trees.json`,变了 7 项,只有树变了:五个大尺寸模板(参考树是中等尺寸的,现在走新的排法)、Personal Dashboard、Text Year Days Left。其余 14 个改过的模板的中等尺寸的树一个字都没变。`music-playback-trees.json` 和 `layout-edit-trees.json` 对应的模板没改,没有重新生成。之后在 macOS 上不带生成开关跑了 `BrowserPreviewParityTests`、`MusicRuntimeTests`、`VisualLayoutEditorTests`、`RuntimeExecutionTests`:154 个里 11 个跳过(都是要开关才导出的测试),没有失败 |
+| `cd Web/preview-engine && npm test` | 199 个通过 |
+| `cd Web/studio && npm test`、`cd Editor/editorfe && npm test` | 114 个通过、52 个通过 |
+| `cargo test --locked --workspace`(Mac) | 506 个通过,1 个忽略 |
+| `./gradlew :core:testDebugUnitTest --rerun`(Mac,Android Studio 自带的 JDK 25) | 482 个通过 |
+| `node Scripts/validate-release.mjs`、`validate-doc-links.mjs`、`sync-gallery-templates.mjs`、`node --test Scripts/tests/*.mjs` | 都通过(最后一个是 7 个测试) |
+
+### 没跑的
+
+- 没有在苹果的系统上把新排法画成图来看,原因和上一节一样(`Tools/ScriptWidgetPreview` 编不过)。新排法只用了别的模板已经在用的组件和属性;苹果的小尺寸最窄是 155 点,比这里量的 170 点窄,文字宽度是按 127 点左右留的余量,但没有在 155 点上实际排过。
+- 没有在 Android 或 Windows 上画图。Android 小组件的大小随桌面而变,没有量过。
+- Sunrise & Sunset 要联网,画出来的时间取决于当时的网络;断网时它本来就不画,这次没改这一点。
+- Live Activity Demo 只看了没有状态时的小尺寸图("Ready");有进度、有倒计时、状态不合法这几种没有画图,只按字宽估过。
+- Windows 的测试、Android 的真机测试、`Scripts/release-readiness.sh`、Web Studio 的浏览器冒烟测试、Linux 的 `asan-test.sh` 都没跑。
+
+### 之后补上的:在苹果上画图,并重截了演示截图
+
+`Tools/ScriptWidgetPreview` 仍然编不过,但 Mac 应用本身带一个批量画模板的开关,用它画了:
+
+```sh
+xcodebuild -project macOS/ScriptWidgetMac.xcodeproj -scheme ScriptWidgetMac -configuration Debug -derivedDataPath <目录> CODE_SIGNING_ALLOWED=NO build
+<目录>/Build/Products/Debug/ScriptWidget.app/Contents/MacOS/ScriptWidget --render-template-previews <输出目录>
+swift Tools/ScriptWidgetPreview/Scripts/contact-sheets.swift Resource/WidgetDemoScreenshots
+```
+
+| 检查(同一台 Mac,macOS 27.2,不签名的调试版) | 结果 |
+| --- | --- |
+| 92 个模板各画一张,尺寸是模板原来设计的那个 | 两轮;第一轮 Daily Quote 和 Stock Snapshot 超过 5 秒没画出来,第二轮只有 Stock Snapshot |
+| 看图:这一节和上一节改过的模板,在苹果的系统字体下 | 设计尺寸的图都正常;Monthly Budget Planner 大尺寸不再重叠,Text Year Days Left 在 11 月 18 日是 43 天 |
+| `Resource/WidgetDemoScreenshots` | 87 张换成新图(原来 70 张,缺 22 个模板的图),拼图从 4 张变成 5 张;删掉了已改名模板的旧图 Weather Now (Open-Meteo) |
+
+没换、留着旧图的 5 张:Stock Snapshot(请求超时);Battery & Brightness、Device Battery Percent、Gauge Battery、System Status Panel(这台 Mac 没有电池,画出来是 0%)。这几个模板在设计尺寸上的排法没有变。
+
+仍然没做的:苹果上只画了每个模板设计的那个尺寸,新加的小尺寸、中等尺寸排法没有在苹果上画图。这台 Mac 没有签名、没有授权,所以日历、健康、照片、提醒事项、GitHub、iCloud 这些模板画出来的是"未连接"的样子。Countdown 没设置时的小尺寸标题"Your next mome…"是模板有意把标题截到 14 个字,没改。
## 没跑的(汇总)
diff --git a/docs/location-api.md b/docs/location-api.md
index 0933d890..07e5a148 100644
--- a/docs/location-api.md
+++ b/docs/location-api.md
@@ -1,5 +1,9 @@
# Location and widget authorization
+
+> **Runs on:** iPhone and iPad, Android (widgets see the position saved while the app was open). **Not on:** Mac, Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
`$location` is available on iOS/iPadOS. macOS returns `isAvailable() === false`, `authorizationStatus() === "unavailable"`, and rejected location promises. Package 2.0 must declare `location` in `permissions`; a present invalid manifest fails closed. Genuine legacy packages retain their existing behavior. Mock data does not grant package permission.
## Authorization
diff --git a/docs/music-api.md b/docs/music-api.md
index 6932e0a3..11ebf447 100644
--- a/docs/music-api.md
+++ b/docs/music-api.md
@@ -1,5 +1,9 @@
# Music app playback
+
+> **Runs on:** iPhone and iPad, Android (The active media session of any app). **Not on:** Mac, Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
Runtime API 1.4 adds the read-only `$music` namespace. An installed Package 2.0 widget must declare `"permissions": ["music"]`. Music library authorization is requested by a person in ScriptWidget Settings, never by imported JavaScript. No network permission is needed.
```jsx
diff --git a/docs/photos-api.md b/docs/photos-api.md
index 610b1585..3b2db5e2 100644
--- a/docs/photos-api.md
+++ b/docs/photos-api.md
@@ -1,5 +1,9 @@
# Photos API (Runtime 1.4)
+
+> **Runs on:** iPhone and iPad, Mac, Android (Individual photos picked in the app, no albums). **Not on:** Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
Declare `photos` in Package 2.0. Scripts never receive unrestricted library access. In **ScriptWidget Settings → Photos**, explicitly select up to 24 photos and eight albums. No sources are selected by default, even with full system authorization. The chooser lists at most 64 recent available photos and 32 albums. Limited system access is supported; albums may be unavailable in that mode. Change the system selection in Photos privacy settings and reload the native selection panel.
- `$photos.isAvailable()` reports whether the installed execution can use this API.
diff --git a/docs/platform-support.md b/docs/platform-support.md
index 18d325cf..2d20cd66 100644
--- a/docs/platform-support.md
+++ b/docs/platform-support.md
@@ -31,9 +31,10 @@ The browser preview in [Web Studio](web-studio-browser.md) is a design tool, not
## Data APIs
+
| API | iPhone and iPad | Mac | Android | Windows | Linux |
| --- | --- | --- | --- | --- | --- |
-| `$device`, `$system`, `$storage`, `$file`, `fetch`, `$http` | Yes | Yes | Yes | Yes | Yes |
+| `$device`, `$system`, `$storage`, `$file`, `fetch`, `$http`, `$xml` | Yes | Yes | Yes | Yes | Yes |
| `$dataSource` (Data Source Plugins) | Yes | Yes | Yes | Yes | Yes |
| `$weather` | Yes | Yes | Yes | Yes | Yes |
| `$calendar` | Yes | Yes | Yes, for calendars selected in the app | No | No |
@@ -49,8 +50,9 @@ The browser preview in [Web Studio](web-studio-browser.md) is a design tool, not
| `$alarms` | Yes | No | Yes, inexact, no system alarm UI | No | No |
| `$reminders` | Yes | Yes | No | No | No |
| `$home` | Yes | No | No | No | No |
+
-The Apple columns follow the generated [data API catalog](data-api-catalog.md), which stays the authority for each method. The Android column follows [ScriptWidget for Android](android/README.md), which explains every difference and what was tested on which device. The Windows column follows [ScriptWidget for Windows](windows/README.md), and the Linux column [ScriptWidget for Linux](linux/README.md).
+This table is written by `npm run docs` in `Editor/editorfe` from `src/platformSupport.js`, which also puts each API's line at the top of that API's page; change it there. The Apple columns follow the generated [data API catalog](data-api-catalog.md), which stays the authority for each method. The Android column follows [ScriptWidget for Android](android/README.md), which explains every difference and what was tested on which device. The Windows column follows [ScriptWidget for Windows](windows/README.md), and the Linux column [ScriptWidget for Linux](linux/README.md).
## Authoring tools
diff --git a/docs/reminders-api.md b/docs/reminders-api.md
index b1bedb8b..c5775613 100644
--- a/docs/reminders-api.md
+++ b/docs/reminders-api.md
@@ -1,5 +1,9 @@
# Reminders API
+
+> **Runs on:** iPhone and iPad, Mac. **Not on:** Android, Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
Runtime API 1.4 adds `$reminders` on iOS/iPadOS and macOS. Package 2.0 must declare `"reminders"` in `permissions`. A malformed manifest or missing permission cannot be overridden by Web mocks.
The native app asks for system Reminders access in **Settings → Reminders**. Apple grants full access. Reads require `reminders`; creating, updating and setting completion additionally require `remindersWrite` and a user-triggered declared action. Ordinary rendering, uninstalled previews, future timeline entries and Live Activity presentations cannot write. Deletion is not exposed.
diff --git a/docs/runtime-api.md b/docs/runtime-api.md
index b3723af3..17d1eed8 100644
--- a/docs/runtime-api.md
+++ b/docs/runtime-api.md
@@ -14,6 +14,31 @@ Version 1.1 adds `$xml` to the 1.0 globals: `$component`, `$console`, `$dataSour
Removing or changing the meaning of a 1.0 global requires a new major API version. Additive properties may ship in a minor version.
+### Which systems each API runs on
+
+A widget package installs on every system, but not every API has something behind it everywhere. An API a system lacks answers `false` from `isAvailable()` and rejects its calls with `[unsupported_platform]`; `$system.platform()` tells a script where it runs. [Platform support](platform-support.md) explains each limit and lists the widget features by system; each API's own page repeats its line of this table.
+
+
+| API | iPhone and iPad | Mac | Android | Windows | Linux |
+| --- | --- | --- | --- | --- | --- |
+| `$device`, `$system`, `$storage`, `$file`, `fetch`, `$http`, `$xml` | Yes | Yes | Yes | Yes | Yes |
+| `$dataSource` (Data Source Plugins) | Yes | Yes | Yes | Yes | Yes |
+| `$weather` | Yes | Yes | Yes | Yes | Yes |
+| `$calendar` | Yes | Yes | Yes, for calendars selected in the app | No | No |
+| `$photos` | Yes | Yes | Individual photos picked in the app, no albums | No | No |
+| `$contacts`, `$documents` | Yes | Yes | Yes, for items picked in the app | No | No |
+| `$maps` | Yes | Yes | Geocoding and place search; no `snapshot` | No | No |
+| `$notifications` | Yes | Yes | Yes, delivery is inexact | No | No |
+| `$services` (GitHub) | Yes | Yes | With a fine-grained token, no OAuth sign-in | No | No |
+| `$icloud` | Yes | Yes | A sync folder the user picks; cannot exchange data with an iPhone | No | No |
+| `$location` | Yes | No | Yes; widgets see the position saved while the app was open | No | No |
+| `$health` | Yes | No | Health Connect; no ring goals or stand time | No | No |
+| `$music` | Yes | No | The active media session of any app | No | No |
+| `$alarms` | Yes | No | Yes, inexact, no system alarm UI | No | No |
+| `$reminders` | Yes | Yes | No | No | No |
+| `$home` | Yes | No | No | No | No |
+
+
### Built-in text and data handling
JavaScript already provides `String.prototype.includes`, `indexOf`, `match`, and `replace` for text search, plus `JSON.parse` and `JSON.stringify` for JSON. `$json(value)` remains a shorthand for `JSON.stringify(value)` when a JSX property needs a JSON string.
diff --git a/docs/services-api.md b/docs/services-api.md
index 62958007..7c090505 100644
--- a/docs/services-api.md
+++ b/docs/services-api.md
@@ -1,5 +1,9 @@
# Connected Services API (Runtime 1.4)
+
+> **Runs on:** iPhone and iPad, Mac, Android (With a fine-grained token, no OAuth sign-in). **Not on:** Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
`$services` reads a user-connected account through a fixed native request broker. The only supported provider is `github`. Account connection and per-widget approval live in ScriptWidget Settings > Service Accounts (iOS) or Settings > Services (Mac). Web Studio uses editable samples; it does not authenticate or contact the provider.
```json
diff --git a/docs/storage-api.md b/docs/storage-api.md
index 4710272d..db55f302 100644
--- a/docs/storage-api.md
+++ b/docs/storage-api.md
@@ -1,5 +1,9 @@
# Package storage and atomic updates
+
+> **Runs on:** iPhone and iPad, Mac, Android, Windows, Linux. Details and limits: [Platform support](platform-support.md).
+
+
`$storage` stores local values under the current package namespace. It does not sync records through iCloud. Local record APIs remain available for legacy compatibility, including packages with an empty permissions list. String and JSON keys cannot exceed 256 UTF-8 bytes, and each stored value cannot exceed 256 KiB. Reads return an empty string/object for a missing key; writes return a Boolean that the script must check.
- `getString(key)` / `setString(key, value)` read and write strings.
diff --git a/docs/system-services-api.md b/docs/system-services-api.md
index a31168e1..531376fa 100644
--- a/docs/system-services-api.md
+++ b/docs/system-services-api.md
@@ -1,5 +1,18 @@
# System services (Runtime 1.6)
+
+> **Runs on**
+>
+> - `$weather`: iPhone and iPad, Mac, Android, Windows, Linux.
+> - `$alarms`: iPhone and iPad, Android (inexact, no system alarm UI). **Not on:** Mac, Windows, Linux.
+> - `$contacts`, `$documents`: iPhone and iPad, Mac, Android (for items picked in the app). **Not on:** Windows, Linux.
+> - `$maps`: iPhone and iPad, Mac, Android (Geocoding and place search; no `snapshot`). **Not on:** Windows, Linux.
+> - `$home`: iPhone and iPad. **Not on:** Mac, Android, Windows, Linux.
+> - `$notifications`: iPhone and iPad, Mac, Android (delivery is inexact). **Not on:** Windows, Linux.
+>
+> Details and limits: [Platform support](platform-support.md).
+
+
These APIs extend existing Calendar, HealthKit, network and App Intent capabilities. They use Apple's frameworks and the existing bounded HTTP transport; no third-party SDK, inference server or application server is added. Weather currently uses MET Norway rather than WeatherKit.
## Install and authorize