@satinhq/kit 0.1.0-beta.2 → 0.1.0-beta.4

package/dist/web/openURL.js

@@ -30,7 +30,8 @@ export function createOpenURLAction(options) {
         }
     };
 }
-/** Open a web URL from an action. Registered app URLs stay in the current document. */
+/** Returns a function that opens a URL from an action. App URLs that match a registered route
+ * navigate inside the app; other URLs go to the browser. */
 export function useOpenURL() {
     const runtime = useAppContext();
     return useMemo(() => createOpenURLAction({
@@ -79,7 +80,8 @@ export function useOpenURL() {
         },
     }), [runtime]);
 }
-/** An accessible URL action with the framework's press and scroll-cancellation policy. */
+/** Opens a URL when pressed, like `useOpenURL`. A press that turns into a scroll does not open
+ * it. */
 export function Link({ destination, prefersInApp, onResult, children, ...props }) {
     const openURL = useOpenURL();
     return (_jsx(Pressable, { ...props, role: "link", onPress: () => {

package/dist/web/useWebAuthentication.d.ts

@@ -1,3 +1,4 @@
 import type { WebAuthentication, WebAuthenticationState } from './authentication.js';
-/** Subscribe to durable authentication state and reconcile on launch and resume. */
+/** Returns a sign-in flow's current state and re-renders when it changes. It checks for a finished
+ * sign-in on launch and when the app returns to the foreground. */
 export declare function useWebAuthentication(authentication: WebAuthentication): WebAuthenticationState;

package/dist/web/useWebAuthentication.js

@@ -1,5 +1,6 @@
 import { useEffect, useSyncExternalStore } from 'react';
-/** Subscribe to durable authentication state and reconcile on launch and resume. */
+/** Returns a sign-in flow's current state and re-renders when it changes. It checks for a finished
+ * sign-in on launch and when the app returns to the foreground. */
 export function useWebAuthentication(authentication) {
     useEffect(() => authentication.connect(), [authentication]);
     return useSyncExternalStore(authentication.subscribe, authentication.getSnapshot, authentication.getSnapshot);

package/dist/zoom/Zoomable.d.ts

@@ -1,10 +1,10 @@
 import { type HTMLAttributes } from 'react';
-/** Zoomable's maximum scale and scale callback; Satin owns its pointer handlers. */
+/** The maximum zoom (4 by default) and a scale callback. Satin owns the pointer handlers. */
 export interface ZoomableProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onPointerDown' | 'onPointerMove' | 'onPointerUp' | 'onPointerCancel' | 'onLostPointerCapture'> {
     /** Maximum content magnification. Page scale always remains one. */
     maxScale?: number;
     onScaleChange?: (scale: number) => void;
 }
-/** A bounded image/map viewport. Pinch and pan belong only to this content role.
- * Keyboard + / - zoom about the center; 0 resets. Supply an accessible label. */
+/** A region the user can pinch to zoom and pan, such as a photo or a map. The + and - keys zoom
+ * about the centre and 0 resets. Give it an accessible label. */
 export declare function Zoomable({ children, maxScale, onScaleChange, style, onKeyDown, ...props }: ZoomableProps): import("react").JSX.Element;

package/dist/zoom/Zoomable.js

@@ -1,8 +1,8 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useCallback, useLayoutEffect, useRef } from 'react';
 import { boundZoom, pinchZoom } from './geometry.js';
-/** A bounded image/map viewport. Pinch and pan belong only to this content role.
- * Keyboard + / - zoom about the center; 0 resets. Supply an accessible label. */
+/** A region the user can pinch to zoom and pan, such as a photo or a map. The + and - keys zoom
+ * about the centre and 0 resets. Give it an accessible label. */
 export function Zoomable({ children, maxScale = 4, onScaleChange, style, onKeyDown, ...props }) {
     if (!Number.isFinite(maxScale) || maxScale < 1)
         throw new Error('Zoomable maxScale must be finite and at least 1.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@satinhq/kit",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.4",
   "type": "module",
   "description": "Opinionated single-target framework for agent-generated personal iOS Home Screen apps.",
   "main": "./dist/index.js",
@@ -96,7 +96,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/satinhq/satin.git",
-    "directory": "packages/pwakit"
+    "directory": "packages/kit"
   },
   "engines": {
     "node": "^22.12.0 || >=24.0.0"
@@ -111,8 +111,8 @@
   "scripts": {
     "build": "node scripts/build.mjs",
     "typecheck": "tsc -p tsconfig.json --pretty false",
-    "lint": "oxlint && node ../pwakit-lint/scripts/check-webgpu-worker.mjs src/glass/webgpu/entry.worker.ts && node ../pwakit-lint/scripts/check-sidebar-artwork.mjs src/navigation/SidebarSymbol.tsx && node ../pwakit-lint/scripts/check-modal-lifecycle.mjs src",
-    "test": "vitest run && node scripts/check-readme-examples.mjs && node scripts/check-public-exports.mjs && node scripts/api-report.mjs && node --test scripts/api-graph.node-test.mjs scripts/public-types.node-test.mjs scripts/swiftui-reference.node-test.mjs scripts/path-spaces.node-test.mjs",
+    "lint": "oxlint && node ../lint/scripts/check-webgpu-worker.mjs src/glass/webgpu/entry.worker.ts && node ../lint/scripts/check-sidebar-artwork.mjs src/navigation/SidebarSymbol.tsx && node ../lint/scripts/check-modal-lifecycle.mjs src",
+    "test": "vitest run && node scripts/check-readme-examples.mjs && node scripts/check-public-exports.mjs && node scripts/api-report.mjs && node --test scripts/api-graph.node-test.mjs scripts/public-types.node-test.mjs scripts/api-reference.node-test.mjs scripts/path-spaces.node-test.mjs",
     "api:write": "node scripts/api-report.mjs --write",
     "api:check": "node scripts/api-report.mjs"
   }