@satinhq/kit 0.0.0-stage → 0.1.0-beta.1

package/dist/acknowledgements/Acknowledgements.d.ts

@@ -0,0 +1,4 @@
+import { type ScreenRegistry } from '../navigation/registry.js';
+export declare const ACKNOWLEDGEMENTS = "__satin:acknowledgements";
+/** Add transient framework destinations to the existing primary stack. */
+export declare function acknowledgementsRegistry(registry: ScreenRegistry): ScreenRegistry;

package/dist/acknowledgements/Acknowledgements.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { licenseNotices } from './inventory.js';
+import { List } from '../public/controls.js';
+import { Screen } from '../public/chrome.js';
+import { useColorScheme } from '../public/environment.js';
+import { Section, Row, NavigationRow } from '../list-form/ListForm.js';
+import { ScrollSurface } from '../scroll/ScrollSurface.js';
+import { Selectable } from '../root/SatinRoot.js';
+import { createScreenRegistry, defineScreen } from '../navigation/registry.js';
+import { useNavigator, useParams } from '../navigation/navigationContext.js';
+function NoticeList() {
+    const navigator = useNavigator();
+    return (_jsx(Screen, { title: "Acknowledgements", titleDisplay: "inline", children: _jsxs(List, { id: "satin-acknowledgements", children: [_jsx(Section, { header: "Satin", children: _jsx(Row, { label: "Built with Satin" }) }), _jsx(Section, { header: "Open source", children: licenseNotices().map((notice, index) => (_jsx(NavigationRow, { label: notice.name, onPress: () => navigator.push(LICENSE, { index }) }, `${notice.name}:${notice.version}`))) })] }) }));
+}
+function NoticeText() {
+    const scheme = useColorScheme();
+    const { index } = useParams();
+    const notice = licenseNotices()[index];
+    if (!notice)
+        throw new Error('Acknowledgements notice is unavailable');
+    return (_jsx(Screen, { title: notice.name, titleDisplay: "inline", children: _jsx(ScrollSurface, { id: "satin-license", axis: "vertical", primary: true, style: { background: scheme === 'dark' ? '#000' : '#fff' }, children: _jsx(Selectable, { style: {
+                    padding: 16,
+                    fontSize: 17,
+                    lineHeight: '22px',
+                    whiteSpace: 'pre-wrap',
+                    overflowWrap: 'anywhere',
+                }, children: notice.text }) }) }));
+}
+export const ACKNOWLEDGEMENTS = '__satin:acknowledgements';
+const LICENSE = '__satin:license';
+/** Add transient framework destinations to the existing primary stack. */
+export function acknowledgementsRegistry(registry) {
+    if (registry.has(ACKNOWLEDGEMENTS) || registry.has(LICENSE))
+        throw new Error('Acknowledgements destination identities are reserved by Satin');
+    return createScreenRegistry(...registry.definitions, defineScreen(ACKNOWLEDGEMENTS, {
+        component: NoticeList,
+        navigation: { title: 'Acknowledgements', display: 'inline' },
+    }), defineScreen(LICENSE, {
+        component: NoticeText,
+        navigation: { title: 'License', display: 'inline' },
+    }));
+}

package/dist/acknowledgements/bundledNotices.d.ts

@@ -0,0 +1,4 @@
+import { renderNotices, type LicenseNotice } from './inventory.js';
+/** Inspect modules surviving tree shaking, never package.json's development dependency list. */
+export declare function bundledLicenseNotices(moduleIds: readonly string[]): Promise<readonly LicenseNotice[]>;
+export { renderNotices };

package/dist/acknowledgements/bundledNotices.js

@@ -0,0 +1,58 @@
+import { readFile, readdir, realpath } from 'node:fs/promises';
+import { dirname, join, parse } from 'node:path';
+import { createHash } from 'node:crypto';
+import bundled from './inventory.json' with { type: 'json' };
+import { renderNotices } from './inventory.js';
+/** Inspect modules surviving tree shaking, never package.json's development dependency list. */
+export async function bundledLicenseNotices(moduleIds) {
+    const packages = new Map();
+    for (const id of moduleIds) {
+        const path = id.split('?')[0];
+        if (!path.includes('/node_modules/') || path.startsWith('\0'))
+            continue;
+        const source = await realpath(path);
+        let directory = dirname(source);
+        while (directory !== parse(directory).root) {
+            const metadata = await readFile(join(directory, 'package.json'), 'utf8').catch(() => null);
+            if (metadata) {
+                const manifest = JSON.parse(metadata);
+                if (manifest.name && manifest.version) {
+                    if (manifest.name !== '@satinhq/kit') {
+                        const entry = packages.get(directory) ?? { root: directory, files: new Set() };
+                        entry.files.add(source.slice(directory.length + 1));
+                        packages.set(directory, entry);
+                    }
+                    break;
+                }
+            }
+            directory = dirname(directory);
+        }
+    }
+    const notices = [...bundled];
+    for (const { root, files } of packages.values()) {
+        const manifest = JSON.parse(await readFile(join(root, 'package.json'), 'utf8'));
+        const names = (await readdir(root))
+            .filter(name => /^(?:licen[cs]e|copying|notice)(?:[._-].*)?$/i.test(name))
+            .sort();
+        if (!names.some(name => /^(?:licen[cs]e|copying)/i.test(name)))
+            throw new Error(`Satin bundled dependency ${manifest.name}@${manifest.version} has no license text. Supply and audit its notice before building.`);
+        const texts = await Promise.all(names.map(async (name) => `${name}\n\n${await readFile(join(root, name), 'utf8')}`));
+        const text = texts.join('\n\n');
+        const repository = typeof manifest.repository === 'string' ? manifest.repository : manifest.repository?.url;
+        notices.push({
+            name: manifest.name,
+            version: manifest.version,
+            license: typeof manifest.license === 'string' ? manifest.license : 'See license text',
+            source: repository ?? manifest.homepage ?? `https://www.npmjs.com/package/${manifest.name}`,
+            text,
+            sha256: createHash('sha256').update(text).digest('hex'),
+            bundledPaths: [...files].sort(),
+            role: 'consumer emitted module graph',
+        });
+    }
+    return [
+        ...notices.slice(0, 1),
+        ...notices.slice(1).sort((left, right) => left.name.localeCompare(right.name)),
+    ];
+}
+export { renderNotices };

package/dist/acknowledgements/inventory.d.ts

@@ -0,0 +1,17 @@
+export interface LicenseNotice {
+    readonly name: string;
+    readonly version: string | null;
+    readonly license: string;
+    readonly source: string;
+    readonly text: string;
+    readonly sha256: string;
+    readonly bundledPaths: readonly string[];
+    readonly role: string;
+}
+declare global {
+    interface Window {
+        __SATIN_ACKNOWLEDGEMENTS__?: readonly LicenseNotice[];
+    }
+}
+export declare function licenseNotices(): readonly LicenseNotice[];
+export declare function renderNotices(notices: readonly LicenseNotice[]): string;

package/dist/acknowledgements/inventory.js

@@ -0,0 +1,10 @@
+import bundled from './inventory.json' with { type: 'json' };
+export function licenseNotices() {
+    return typeof window === 'undefined' ? bundled : (window.__SATIN_ACKNOWLEDGEMENTS__ ?? bundled);
+}
+export function renderNotices(notices) {
+    return notices
+        .map(notice => `## ${notice.name}${notice.version ? ` ${notice.version}` : ''}\n\n` +
+        `License: ${notice.license}\nSource: ${notice.source}\n\n${notice.text}\n`)
+        .join('\n');
+}

package/dist/acknowledgements/inventory.json

@@ -0,0 +1,39 @@
+[
+    {
+        "name": "Satin",
+        "version": "0.1.0-beta.1",
+        "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"
+        ],
+        "role": "framework"
+    },
+    {
+        "name": "Framework7 Icons",
+        "version": "5.0.5",
+        "license": "MIT",
+        "source": "https://github.com/framework7io/framework7-icons/blob/master/LICENSE",
+        "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"
+        ],
+        "role": "adapted or generated source"
+    },
+    {
+        "name": "liquid-glass-web-react",
+        "version": null,
+        "license": "MIT",
+        "source": "https://github.com/PallavAg/liquid-glass-web-react/blob/main/LICENSE",
+        "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"
+        ],
+        "role": "adapted or generated source"
+    }
+]

package/dist/actions/ActionMenu.d.ts

@@ -0,0 +1,30 @@
+import { type SensoryButtonProps } from '../haptics/SensoryButton.js';
+import { type KeyboardEvent, type ReactNode } from 'react';
+import type { Action, ActionItem } from './types.js';
+export declare function activateMenuAction(element: HTMLElement): void;
+/** A menu row: activated by taps, keyboard and menu contacts alike (activateMenuAction). */
+export declare function ActionButton({ onPress, disabled, ...props }: Omit<SensoryButtonProps, 'onPress'> & {
+    onPress: () => void;
+}): import("react").JSX.Element;
+export declare function menuKeyDown(event: KeyboardEvent<HTMLElement>): void;
+/** A row that opens a nested menu. */
+export type SubmenuAction = Extract<Action, {
+    submenu: readonly Action[];
+}>;
+/**
+ * One level of a menu: its rows, sections and keyboard traversal. Nested menus are separate
+ * levels drawn by the menu stack (glass/MenuStack.tsx); this level only reports which submenu row
+ * was chosen and shows which one is open.
+ */
+export declare function ActionMenu({ actions, select, openSubmenu, expandedId, onBack, header, }: {
+    actions: readonly Action[];
+    select: (action: ActionItem) => void;
+    /** A submenu row was chosen. */
+    openSubmenu?: (action: SubmenuAction, row: HTMLButtonElement) => void;
+    /** The id of the row whose submenu is open above this level. */
+    expandedId?: string;
+    /** Leave this level for its parent (Left arrow). Only nested levels have one. */
+    onBack?: () => void;
+    /** A nested level's title row, drawn above its rows and reached by the arrow keys. */
+    header?: ReactNode;
+}): import("react").JSX.Element;

package/dist/actions/ActionMenu.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { SymbolImage } from '../symbols/Symbol.js';
+import { ownMenuCompatibilityClick } from '../press/contactReceipt.js';
+import { SensoryButton } from '../haptics/SensoryButton.js';
+import { useRef } from 'react';
+const menuActivations = new WeakMap();
+export function activateMenuAction(element) {
+    ownMenuCompatibilityClick(element.ownerDocument);
+    menuActivations.get(element)?.();
+}
+/** A menu row: activated by taps, keyboard and menu contacts alike (activateMenuAction). */
+export function ActionButton({ onPress, disabled, ...props }) {
+    const activate = () => {
+        if (!disabled)
+            onPress();
+    };
+    return (_jsx(SensoryButton, { ...props, disabled: disabled, onPress: activate, ref: element => {
+            if (!element)
+                return;
+            menuActivations.set(element, activate);
+            return () => {
+                menuActivations.delete(element);
+            };
+        } }));
+}
+export function menuKeyDown(event) {
+    if (event.defaultPrevented)
+        return;
+    const items = [
+        ...event.currentTarget.querySelectorAll(':is([role="menuitem"], [role="menuitemradio"])'),
+    ].filter(item => !item.disabled && item.getAttribute('aria-disabled') !== 'true');
+    const index = items.indexOf(event.currentTarget.ownerDocument.activeElement);
+    const next = event.key === 'ArrowDown'
+        ? (index + 1) % items.length
+        : event.key === 'ArrowUp'
+            ? (index + items.length - 1) % items.length
+            : event.key === 'Home'
+                ? 0
+                : event.key === 'End'
+                    ? items.length - 1
+                    : -1;
+    if (next >= 0) {
+        event.preventDefault();
+        event.stopPropagation();
+        items[next]?.focus();
+    }
+}
+/**
+ * One level of a menu: its rows, sections and keyboard traversal. Nested menus are separate
+ * levels drawn by the menu stack (glass/MenuStack.tsx); this level only reports which submenu row
+ * was chosen and shows which one is open.
+ */
+export function ActionMenu({ actions, select, openSubmenu, expandedId, onBack, header, }) {
+    // Beside sections, a run of loose actions is its own unlabelled section: native separates it
+    // from its neighbours like any section (iOS 27.0 native reference: "Delete List" after Section("View")).
+    const sectioned = (items) => {
+        if (!items.some(action => 'section' in action))
+            return [...items];
+        const grouped = [];
+        for (const action of items) {
+            const last = grouped.at(-1);
+            if ('section' in action)
+                grouped.push(action);
+            else if (last && 'section' in last && loose.has(last))
+                last.section.push(action);
+            else {
+                const run = { section: [action] };
+                loose.add(run);
+                grouped.push(run);
+            }
+        }
+        return grouped;
+    };
+    const loose = new WeakSet();
+    const renderActions = (items) => sectioned(items).map((action, index) => 'section' in action ? (_jsxs("div", { role: "group", "aria-label": action.label, "data-satin-action-section": "true", children: [action.label && (_jsx("div", { "data-satin-action-section-header": "true", "aria-hidden": "true", children: action.label })), renderActions(action.section)] }, `section-${index}`)) : (_jsxs(ActionButton, { role: 'checked' in action && action.checked !== undefined ? 'menuitemradio' : 'menuitem', "aria-checked": 'checked' in action ? action.checked : undefined, disabled: action.disabled, "data-satin-action-id": action.id, "data-destructive": ('role' in action && action.role === 'destructive') || undefined, "data-satin-submenu-open": ('submenu' in action && action.id === expandedId) || undefined, "aria-haspopup": 'submenu' in action ? 'menu' : undefined, "aria-expanded": 'submenu' in action ? action.id === expandedId : undefined, onPress: () => {
+            if (!('submenu' in action))
+                select(action);
+            else if (openSubmenu) {
+                const row = rowElement(action.id);
+                if (row)
+                    openSubmenu(action, row);
+            }
+        }, children: ['checked' in action && action.checked !== undefined && (_jsx("span", { "data-satin-action-check": "true", "aria-hidden": "true", children: action.checked ? '✓' : '' })), action.icon ?? (action.symbol ? _jsx(SymbolImage, { name: action.symbol }) : null), _jsx("span", { "data-satin-action-label": "true", children: action.label }), _jsx("span", { role: "presentation", children: 'submenu' in action ? '›' : null })] }, action.id)));
+    const container = useRef(null);
+    const rowElement = (id) => [
+        ...(container.current?.querySelectorAll('[data-satin-action-id]') ?? []),
+    ].find(row => row.dataset.satinActionId === id);
+    return (_jsxs("div", { ref: container, role: "menu", "data-satin-action-menu": "true", onKeyDown: event => {
+            if (event.key === 'ArrowLeft' && onBack) {
+                event.preventDefault();
+                event.stopPropagation();
+                onBack();
+            }
+            else if (event.key === 'ArrowRight' &&
+                event.target.getAttribute('aria-haspopup') === 'menu') {
+                event.preventDefault();
+                event.stopPropagation();
+                activateMenuAction(event.target);
+            }
+            else
+                menuKeyDown(event);
+        }, children: [header, renderActions(actions)] }));
+}

package/dist/actions/RowActions.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode } from 'react';
+import { type ActionItem, type RowActionsProps } from './types.js';
+type RowActionsEngineProps = RowActionsProps & {
+    children: ReactNode;
+    disabled?: boolean;
+    content?: boolean;
+    controller?: RowActionsController;
+};
+/** Lets a list item open its row's trailing actions, as tapping the editing delete control does. */
+export type RowActionsController = {
+    current?: {
+        revealTrailing(): void;
+    };
+};
+/**
+ * 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.
+ */
+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`
+ * replace swipe-to-delete.
+ */
+export declare function ListItemActions({ children, swipeActions, contextMenu, deleteAction, controller, }: RowActionsProps & {
+    children: ReactNode;
+    deleteAction?: ActionItem;
+    controller?: RowActionsController;
+}): import("react").JSX.Element;
+/**
+ * `contextMenu`: long-pressing the content opens the glass menu of its actions, with an
+ * optional custom `preview`. Rows in a `List` take a `contextMenu` prop instead.
+ */
+export declare function ContextMenu({ children, actions, preview, }: {
+    children: ReactNode;
+    actions: readonly import('./types.js').Action[];
+    preview?: ReactNode;
+}): import("react").JSX.Element;
+export {};