@satinhq/kit 0.1.0-beta.1 → 0.1.0-beta.3

package/NOTICE

@@ -1,6 +1,6 @@
 # Satin distribution notices
 
-Generated from packages/pwakit/src/acknowledgements/inventory.json.
+Generated from packages/kit/src/acknowledgements/inventory.json.
 
 Satin-authored framework packages use MIT; third-party terms are preserved.
 Retain the copyright and permission notices required by MIT in copies or
@@ -12,7 +12,7 @@ is a separately installed build dependency. Consumer Vite builds emit NOTICE.txt
 and licenses.json from their actual emitted module graph, including runtime peers.
 Development dependencies are not assumed to be bundled.
 
-## Satin 0.1.0-beta.1
+## Satin 0.1.0-beta.3
 
 License: MIT
 Source: https://opensource.org/license/mit

package/README.md

@@ -219,7 +219,7 @@ falls back to the base glyph when no fill exists. See the shipped [available sym
 
 ## Public API inventory
 
-See the packaged [Satin API reference](dist/docs/swiftui-reference.md) for behavior, limitations, unavailable concepts and the exact export coverage inventory. The index lists supported APIs and known gaps.
+See the packaged [Satin API reference](dist/docs/reference.md) for behavior, limits, unsupported capabilities and the exact export inventory. The index lists supported APIs and known gaps.
 
 For a Safari-tab development build, set `advanced: { updateProfile: 'preview' }` in `defineApp`. No environment switch is needed. It retains the iOS WebKit platform gate and uses the existing live-update service-worker policy, which may reload on update. Use the default `release` profile for installed production apps and cold-launch update activation. A query parameter cannot opt a release build into preview. The profile does not change status style, viewport geometry, glass or lifecycle ownership.
 

package/dist/acknowledgements/inventory.json

@@ -1,13 +1,13 @@
 [
     {
         "name": "Satin",
-        "version": "0.1.0-beta.1",
+        "version": "0.1.0-beta.3",
         "license": "MIT",
         "source": "https://opensource.org/license/mit",
         "text": "MIT License\n\nCopyright (c) 2026 Satin contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n",
         "sha256": "a9ca5be2844d1d12fbd9b77cd7446d1895c44b4c5253aed536c2c60ad8d10caa",
         "bundledPaths": [
-            "packages/pwakit/src"
+            "packages/kit/src"
         ],
         "role": "framework"
     },
@@ -19,8 +19,8 @@
         "text": "The MIT License (MIT)\n\nCopyright (c) 2016 Vladimir Kharlampidi\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\nthe Software, and to permit persons to whom the Software is furnished to do so,\nsubject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\nFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\nCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n",
         "sha256": "61afeee2f1d59f21412901a0015ccbec0315ae4806e3f4fbd167201ebb17b2f8",
         "bundledPaths": [
-            "packages/pwakit/src/symbols/glyphs",
-            "packages/pwakit/src/glass/lens/icons.ts"
+            "packages/kit/src/symbols/glyphs",
+            "packages/kit/src/glass/lens/icons.ts"
         ],
         "role": "adapted or generated source"
     },
@@ -32,7 +32,7 @@
         "text": "MIT License\n\nCopyright (c) 2026 Pallav Agarwal\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n",
         "sha256": "949e33ed2f105f112b392ce9832799a1c6d2c1fe89784a87c919dfc6b115eacc",
         "bundledPaths": [
-            "packages/pwakit/src/glass/lens"
+            "packages/kit/src/glass/lens"
         ],
         "role": "adapted or generated source"
     }

package/dist/actions/RowActions.d.ts

@@ -16,13 +16,13 @@ export type RowActionsController = {
  * A row's swipe actions and context menu. Inside an editable `List` item, the item owns the row's
  * one gesture host (it adds swipe-to-delete), so the row hands its actions to the item instead of
  * hosting a second recognizer. Swipe actions are unavailable while the list is editing, as in
- * SwiftUI; the context menu stays.
+ * selection; the context menu stays.
  */
 export declare function RowActions(props: RowActionsEngineProps): import("react").JSX.Element;
 /**
  * The one gesture host of an editable `List` item. It hosts the row's own swipe actions and context
  * menu (handed over by the row, or declared on its `ListRow`) and adds the `onDelete` action as the
- * trailing swipe, unless the row declares trailing actions of its own: SwiftUI's `swipeActions`
+ * trailing swipe, unless the row declares its own trailing `swipeActions`
  * replace swipe-to-delete.
  */
 export declare function ListItemActions({ children, swipeActions, contextMenu, deleteAction, controller, }: RowActionsProps & {

package/dist/actions/RowActions.js

@@ -762,7 +762,7 @@ function RowActionsEngine({ children, swipeActions, contextMenu, disabled = fals
  * A row's swipe actions and context menu. Inside an editable `List` item, the item owns the row's
  * one gesture host (it adds swipe-to-delete), so the row hands its actions to the item instead of
  * hosting a second recognizer. Swipe actions are unavailable while the list is editing, as in
- * SwiftUI; the context menu stays.
+ * selection; the context menu stays.
  */
 export function RowActions(props) {
     const item = useContext(ListItemContext);
@@ -781,7 +781,7 @@ function DelegatedRowActions({ children, swipeActions, contextMenu, disabled, de
 /**
  * The one gesture host of an editable `List` item. It hosts the row's own swipe actions and context
  * menu (handed over by the row, or declared on its `ListRow`) and adds the `onDelete` action as the
- * trailing swipe, unless the row declares trailing actions of its own: SwiftUI's `swipeActions`
+ * trailing swipe, unless the row declares its own trailing `swipeActions`
  * replace swipe-to-delete.
  */
 export function ListItemActions({ children, swipeActions, contextMenu, deleteAction, controller, }) {

package/dist/app/deployment.js

@@ -57,7 +57,7 @@ export async function checkDeployment(expected, pageUrl, fetcher = fetch, includ
         fail('HTTPS is required for installation and service workers.', page.href, false, 'Serve the app over trusted HTTPS.');
         return failures;
     }
-    const request = async (path, kind, allowDirectoryCanonicalization = false) => {
+    const request = async (path, kind, allowDirectoryCanonicalization = false, attempt = 0) => {
         const url = new URL(path, page).href;
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), requestTimeoutMs);
@@ -68,7 +68,7 @@ export async function checkDeployment(expected, pageUrl, fetcher = fetch, includ
                 cache: 'no-store',
                 redirect: path === expected.scope + 'sw.js' ? 'manual' : 'follow',
             });
-            definite = true;
+            definite = response.status < 500 && response.status !== 408 && response.status !== 429;
             if (response.status !== 200)
                 throw new Error(`HTTP ${response.status}`);
             const finalUrl = new URL(response.url || url);
@@ -119,6 +119,12 @@ export async function checkDeployment(expected, pageUrl, fetcher = fetch, includ
         }
         catch (error) {
             const reason = error instanceof Error ? error.message : String(error);
+            // Retry transport failures only. A mismatched deployment cannot heal with backoff.
+            if ((!definite || controller.signal.aborted) && attempt < 2) {
+                clearTimeout(timer);
+                await new Promise(resolve => setTimeout(resolve, 250 * 2 ** attempt));
+                return request(path, kind, allowDirectoryCanonicalization, attempt + 1);
+            }
             if (controller.signal.aborted) {
                 fail(`${label(url)} did not finish within ${requestTimeoutMs / 1000} s`, url, true, 'Check the server or connection, then try again.');
             }

package/dist/app/installCheck.js

@@ -100,7 +100,7 @@ onPass) {
     title.textContent = standalone
         ? 'Wrong Home Screen icon'
         : unverified
-            ? 'Could not verify this app'
+            ? "Can't reach the app right now"
             : 'This app is misconfigured';
     const explanation = document.createElement('p');
     const action = document.createElement('p');
@@ -119,11 +119,12 @@ onPass) {
         return;
     }
     if (unverified) {
-        explanation.textContent = 'The connection may be slow or offline.';
-        action.textContent = 'Try again when your connection is ready.';
+        explanation.textContent = 'Check your connection and try again.';
+        action.remove();
         const retry = document.createElement('button');
         retry.textContent = 'Retry';
         retry.addEventListener('click', () => {
+            retry.disabled = true;
             void installPageCheck(expected, check, 30_000, onPass);
         });
         content.append(retry);

package/dist/app/launchWatchdog.js

@@ -173,8 +173,13 @@ export function installLaunchWatchdog(budgetMs) {
         if (progress?.type === 'SATIN_DOWNLOAD_PROGRESS' &&
             progress.downloading &&
             Number.isFinite(progress.loaded) &&
-            progress.loaded >= 0)
+            progress.loaded >= 0) {
             receiveProgress(progress);
+            // A first install can download before the application module is available.
+            // Controlled documents are cached launches/updates and keep their existing policy.
+            if (!navigator.serviceWorker?.controller && !revealed)
+                window.__SATIN_LAUNCH_SCREEN__?.progress(progress);
+        }
     });
     // A client's worker messages are queued until DOMContentLoaded, and a bootstrap module that
     // never finishes holds DOMContentLoaded back: the worker's "this resource stalled" message

package/dist/controls/civilDate.d.ts

@@ -2,7 +2,7 @@
  * Calendar fields for DatePicker, kept apart from instants.
  *
  * A DatePicker edits calendar fields: a day, a time of day, or both. A `Date` selection reads and
- * writes those fields in the device's time zone, as SwiftUI does. A string selection is a civil
+ * writes those fields in the device's time zone. A string selection is a civil
  * value with no time zone at all ('2026-10-14', '09:41', '2026-10-14T09:41'), so a due date
  * chosen in New York is still October 14 when the app is opened in Tokyo.
  *

package/dist/controls/civilDate.js

@@ -2,7 +2,7 @@
  * Calendar fields for DatePicker, kept apart from instants.
  *
  * A DatePicker edits calendar fields: a day, a time of day, or both. A `Date` selection reads and
- * writes those fields in the device's time zone, as SwiftUI does. A string selection is a civil
+ * writes those fields in the device's time zone. A string selection is a civil
  * value with no time zone at all ('2026-10-14', '09:41', '2026-10-14T09:41'), so a due date
  * chosen in New York is still October 14 when the app is opened in Tokyo.
  *

package/dist/docs/components/file-importer.md

@@ -1,6 +1,6 @@
 # FileImporter
 
-Imports file bytes through the system file chooser. `FileImporter` requires a user gesture and does not expose a presentation flag that would open a chooser outside a user gesture.
+Imports file bytes through the system file chooser. `FileImporter` opens the system chooser from a press. It does not expose a presentation flag that would open a chooser outside a user gesture.
 
 Pass `selection` as the accepted File array and update it in `onSelectionChange`. `allowedContentTypes` accepts MIME strings or file extensions, for example `['application/pdf', '.txt']`. These are chooser hints, not content validation or Swift uniform type identifiers. `allowsMultipleSelection` defaults to false.
 

package/dist/docs/components/paste-button.md

@@ -4,7 +4,7 @@ Reads plain text with the async Clipboard API inside the user's press. `onPaste`
 
 WebKit may show its own Paste confirmation before returning text. Dismissal and denial cannot be reliably distinguished. The component never reads clipboard contents during render or probes whether a paste is available. It cannot pre-disable itself based on clipboard contents.
 
-This version supports plain text only, not arbitrary transferable objects or clipboard images. No hidden editable field, synthetic paste, permission polling or clipboard cache bypasses WebKit's prompt.
+This version supports plain text only. Structured clipboard objects and images are unsupported. No hidden editable field, synthetic paste, permission polling or clipboard cache bypasses WebKit's prompt.
 
 ## Example
 

package/dist/docs/components/photos-picker.md

@@ -4,7 +4,7 @@ Selects one photo or video using a real file input. The browser chooses the sour
 
 `selection` is the accepted `File | null`; `onSelectionChange` receives a new File. `matching` accepts `images`, `videos`, or `imagesAndVideos`. `capture="user"` or `"environment"` supplies a browser camera preference, not a camera guarantee. No photo-library permission probe runs.
 
-The browser may offer Photo Library, camera or Files. The control does not expose PhotosPickerItem identifiers, ordered multi-selection, persistent library access, or native filter objects. File decoding, object URLs, storage and validation belong to the app.
+The browser may offer Photo Library, camera or Files. The control does not expose PhotosPickerItem identifiers, ordered multi-selection, persistent library access, or library-specific content filters. File decoding, object URLs, storage and validation belong to the app.
 
 ## Example
 

package/dist/docs/components/share-link.md

@@ -4,7 +4,7 @@ Opens the platform share sheet using Web Share. Pass prepared `item` data contai
 
 `onCompletion` reports the browser's completed handoff, not delivery to a recipient. `onError` is required. An AbortError can mean dismissal or no suitable target; it is not proof of a user cancellation. Unsupported sharing or files report NotSupportedError. Other browser errors retain their names.
 
-The operating system chooses share targets and previews. Custom transferable objects, preview models and activity lists are unavailable. Keep `item` stable while sharing; changing its identity invalidates delivery to the old owner.
+The operating system chooses share targets and previews. Structured transfer objects, custom previews and custom activity lists are unsupported. Keep `item` stable while sharing; changing its identity invalidates delivery to the old owner.
 
 ## Example
 

package/dist/docs/limitations.md

@@ -37,4 +37,4 @@ What each part of Satin does today, and where it stops. Limits that come from iO
 - **Video player.** There's no general video player control.
 - **Full search tab.** `searchable` gives a search field and results, but not the full search tab.
 
-`@satinhq/kit/unstable` exports are experimental and may change. The [API reference](https://github.com/satinhq/satin/blob/main/packages/pwakit/api/swiftui-reference.md) lists every export.
+`@satinhq/kit/unstable` exports are experimental and may change. The [API reference](https://github.com/satinhq/satin/blob/main/packages/kit/api/reference.md) lists every export.

package/dist/docs/push.md

@@ -7,13 +7,13 @@ Node 22.12+ sender and private relay for an installed iPhone Home Screen app. Th
 Run from this workspace after `pnpm install && pnpm --filter @satinhq/kit build`. Replace the URLs with your installed app scope and trusted HTTPS relay URL.
 
 ```sh
-node packages/pwakit-push/src/cli.mjs init --out "$HOME/.config/satin-push/push.json" --app-url https://your-app.example/app/ --relay-url https://your-app.example/push/ --subject https://example.com/contact
+node packages/push/src/cli.mjs init --out "$HOME/.config/satin-push/push.json" --app-url https://your-app.example/app/ --relay-url https://your-app.example/push/ --subject https://example.com/contact
 ```
 
 `init` generates a detail/title route at version 1, matching the starter, and writes the private configuration and owner token with mode 0600. Custom apps must align both the rule and notification route versions with their screen schema. It never prints secrets. Copy the generated public `client.env` into the starter's `.env.local`, then build and deploy the app. Supply the owner token at runtime through the app's authenticated session or token field; never bundle it.
 
 ```sh
-node packages/pwakit-push/src/cli.mjs relay --config "$HOME/.config/satin-push/push.json" --port 5466
+node packages/push/src/cli.mjs relay --config "$HOME/.config/satin-push/push.json" --port 5466
 ```
 
 The default bind address is loopback. Forward the trusted HTTPS `/push/` path to this listener, stripping `/push` before forwarding. Keep the private Node listener on loopback or a permitted Tailscale address. A phone cannot call an HTTP relay from an HTTPS app. Keep CORS restricted to the configured app origin, as the relay does by default. Never create a public tunnel.
@@ -23,7 +23,7 @@ Open the installed app's Notifications screen, supply its owner token, read the
 ## Send in one line
 
 ```sh
-node packages/pwakit-push/src/cli.mjs send --config "$HOME/.config/satin-push/push.json" --title 'Reminder' --body 'Review your list' --route '{"screen":"detail","version":1,"params":{"title":"Welcome"}}' --badge 3
+node packages/push/src/cli.mjs send --config "$HOME/.config/satin-push/push.json" --title 'Reminder' --body 'Review your list' --route '{"screen":"detail","version":1,"params":{"title":"Welcome"}}' --badge 3
 ```
 
 Once published, the equivalent entry is `npm exec --package @satinhq/push -- satin-push send` with those same options. Use the workspace command above when working from source.