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

package/dist/search/useSearchPresentation.js

@@ -7,9 +7,10 @@ import { validateSearchPresentation } from './searchable.js';
  * controller. The bottom toolbar field uses it (SearchToolbarField.tsx); the navigation bar drawer
  * keeps its own copy until reference adopts this hook (spec notes, reference construction update).
  */
-export function useSearchPresentation(configuration, input) {
+export function useSearchPresentation(configuration, input, pad = false) {
     validateSearchPresentation(configuration);
     const [ownPresented, setOwnPresented] = useState(false);
+    const [focused, setFocused] = useState(false);
     const presented = configuration.isPresented ?? ownPresented;
     const [submittedText, setSubmittedText] = useState(null);
     const configurationRef = useRef(configuration);
@@ -17,6 +18,7 @@ export function useSearchPresentation(configuration, input) {
         configurationRef.current = configuration;
     });
     const mounted = useRef(false);
+    const dismissing = useRef(false);
     const setPresented = useCallback((next) => {
         const current = configurationRef.current;
         if (current.isPresented === undefined)
@@ -24,11 +26,15 @@ export function useSearchPresentation(configuration, input) {
         current.onPresentedChange?.(next);
     }, []);
     const present = () => {
+        if (pad)
+            setFocused(true);
         if (!presented)
             setPresented(true);
     };
     const dismiss = () => {
+        dismissing.current = true;
         input.current?.blur();
+        dismissing.current = false;
         setSubmittedText(null);
         if (configurationRef.current.text)
             configurationRef.current.onTextChange('');
@@ -43,6 +49,14 @@ export function useSearchPresentation(configuration, input) {
         input.current?.blur();
         configuration.onSubmit?.();
     };
+    // An empty iPad field collapses on resigning focus. Submitted text stays
+    // visible and expanded; clearing is a separate action from keyboard dismissal.
+    const resign = () => {
+        if (pad)
+            setFocused(false);
+        if (pad && !dismissing.current && presented && !configurationRef.current.text)
+            setPresented(false);
+    };
     const complete = (suggestion) => {
         change(suggestion.text);
         if (input.current)
@@ -51,11 +65,15 @@ export function useSearchPresentation(configuration, input) {
     // Native presents the field focused, including a programmatic `isPresented`.
     useEffect(() => {
         const element = input.current;
-        if (presented && element && document.activeElement !== element && mounted.current) {
+        if (presented && element && document.activeElement !== element && (pad || mounted.current)) {
             focusFromFramework(element, { preventScroll: true });
         }
+        if (pad && !presented && element === document.activeElement)
+            element?.blur();
         mounted.current = true;
-    }, [presented, input]);
-    const suggestions = presented && submittedText !== configuration.text ? (configuration.suggestions ?? []) : [];
-    return { presented, present, dismiss, change, submit, complete, suggestions };
+    }, [presented, input, pad]);
+    const suggestions = presented && (!pad || focused) && submittedText !== configuration.text
+        ? (configuration.suggestions ?? [])
+        : [];
+    return { presented, present, dismiss, change, submit, complete, suggestions, resign };
 }

package/dist/server.d.ts

@@ -1,7 +1,7 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
-/** Node static adapter. Stream GET/HEAD with single byte ranges, no cache or
- * compression. A fallback is used only for missing extensionless routes.
- * Other methods are left to the caller. Root and every file must resolve
- * inside the same real directory, including symlink targets.
+/** Serves a built app's static files from Node. It streams GET and HEAD requests and supports
+ * single byte ranges, with no caching or compression. The `fallback` file answers only missing
+ * extensionless routes; other methods are left to the caller. The root and every file, symlink
+ * targets included, must resolve inside the same real directory.
  */
 export declare function serveStaticFile(request: IncomingMessage, response: ServerResponse, root: string, fallback?: string): Promise<void>;

package/dist/server.js

@@ -44,10 +44,10 @@ function singleRange(header, size) {
         end: Number(last === undefined || last >= length ? length - 1n : last),
     };
 }
-/** Node static adapter. Stream GET/HEAD with single byte ranges, no cache or
- * compression. A fallback is used only for missing extensionless routes.
- * Other methods are left to the caller. Root and every file must resolve
- * inside the same real directory, including symlink targets.
+/** Serves a built app's static files from Node. It streams GET and HEAD requests and supports
+ * single byte ranges, with no caching or compression. The `fallback` file answers only missing
+ * extensionless routes; other methods are left to the caller. The root and every file, symlink
+ * targets included, must resolve inside the same real directory.
  */
 export async function serveStaticFile(request, response, root, fallback) {
     const end = (status) => {

package/dist/shapes/corners.d.ts

@@ -1,4 +1,5 @@
-/** A deliberate shape choice overrides the framework's semantic default. */
+/** A shape for `cornerClipPath` and swipe action faces: a capsule, an ellipse, a rounded rectangle
+ * or a custom clip path. Choosing one overrides the framework's default shape. */
 export type CornerShape = 'capsule' | 'ellipse' | Readonly<{
     kind: 'custom';
     clipPath: string;
@@ -9,6 +10,5 @@ export type CornerShape = 'capsule' | 'ellipse' | Readonly<{
 }>;
 /** SVG geometry shared by DOM clips and shape consumers. No layout reads. */
 export declare function roundedCornerPath(width: number, height: number, radii: readonly number[], style?: 'continuous' | 'circular'): string;
-/** CSS clip for an explicitly sized shape. Radii are CSS points; ellipse and
- * capsule are intentional alternatives, not native-default validation errors. */
+/** Returns a CSS `clip-path` for a shape at an explicit width and height. Radii are in points. */
 export declare function cornerClipPath(shape: CornerShape, width: number, height: number): string;

package/dist/shapes/corners.js

@@ -67,8 +67,7 @@ export function roundedCornerPath(width, height, radii, style = 'continuous') {
     corner(corners[0], false, false, true);
     return `${commands.join(' ')} Z`;
 }
-/** CSS clip for an explicitly sized shape. Radii are CSS points; ellipse and
- * capsule are intentional alternatives, not native-default validation errors. */
+/** Returns a CSS `clip-path` for a shape at an explicit width and height. Radii are in points. */
 export function cornerClipPath(shape, width, height) {
     if (shape === 'ellipse')
         return 'ellipse(50% 50% at 50% 50%)';