@jasonshimmy/cer-material 0.1.2

package/dist/components/md-app-bar.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-badge.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-bottom-sheet.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-button-group.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-button.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-card.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-carousel.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-checkbox.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-chip.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-date-picker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-dialog.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-divider.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-fab-menu.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-fab.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-icon-button.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-list.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-loading-indicator.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-menu.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-navigation-bar.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-navigation-drawer.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-navigation-rail.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-progress.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-radio.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-search.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-segmented-button.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-side-sheet.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-slider.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-snackbar.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-split-button.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-switch.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-tabs.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-text-field.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-time-picker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/md-tooltip.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/composables/useControlledValue.d.ts

@@ -0,0 +1,14 @@
+import { ReactiveState } from '@jasonshimmy/custom-elements-runtime';
+/**
+ * Creates an internal reactive ref that mirrors an external prop value and
+ * stays in sync when the prop changes — both via DOM attribute changes and
+ * JS property assignment (e.g. `:bind` from a parent component).
+ *
+ * @param getProp - A getter that returns the current coerced prop value.
+ *                  e.g. `() => props.value || ''`
+ *
+ * @example
+ * const query = useControlledValue(() => props.value || '');
+ * query.value = 'typed by user'; // internal mutation works
+ */
+export declare function useControlledValue<T>(getProp: () => T): ReactiveState<T>;

package/dist/composables/useEscapeKey.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Registers a document-level `keydown` listener for the Escape key that fires
+ * for the lifetime of the host element.  The provided `guard` function is
+ * called on every keydown; when it returns `true` the event is cancelled and
+ * `onEscape` is invoked.
+ *
+ * Using `createComposable` ensures the lifecycle hooks are bound to the correct
+ * component context even when called from outside the component render closure.
+ *
+ * @example
+ * useEscapeKey(
+ *   () => props.open,           // guard: only active when open
+ *   () => emit('close'),
+ * )();
+ */
+export declare function useEscapeKey(guard: () => boolean, onEscape: () => void): (ctx?: Record<string, unknown>) => void;

package/dist/composables/useFocusReturn.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Creates a lightweight focus-return handler (no Tab trapping) for overlays
+ * that don't need full keyboard confinement — e.g. side sheets, drawers, menus.
+ *
+ * Wire the returned callbacks into a CER `Transition`:
+ *   `onAfterEnter: focusReturn.onAfterEnter, onAfterLeave: focusReturn.onAfterLeave`
+ *
+ * State is stored on the component context so it survives re-renders.
+ *
+ * @example
+ * const focusReturn = createFocusReturn();
+ * // In template:
+ * Transition({ show: props.open, onAfterEnter: focusReturn.onAfterEnter, onAfterLeave: focusReturn.onAfterLeave }, html`...`)
+ */
+export declare function createFocusReturn(): {
+    onAfterEnter: (el?: HTMLElement) => void;
+    onAfterLeave: (el?: HTMLElement) => void;
+};

package/dist/composables/useFocusTrap.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Creates a focus trap for an overlay.
+ *
+ * Wire the returned callbacks directly into a CER `Transition`:
+ *   `onAfterEnter: trap.onAfterEnter, onAfterLeave: trap.onAfterLeave`
+ *
+ * State is stored on the component context so it survives re-renders without
+ * losing the saved "previous focus" element or leaking event listeners.
+ *
+ * Behaviour:
+ *   - `onAfterEnter(el)`: saves the currently focused element, registers a
+ *     Tab/Shift+Tab keydown guard, and focuses the first tabbable inside `el`.
+ *   - `onAfterLeave()`: removes the keydown guard and restores focus to the
+ *     previously focused element.
+ *   - `cleanup()`: removes the keydown guard — call from `useOnDisconnected`
+ *     to avoid leaks if the component is removed while the overlay is open.
+ *
+ * Drills into shadow roots so nested custom elements (e.g. `<md-button>`)
+ * are discovered and included in the tab cycle.
+ *
+ * @example
+ * const trap = createFocusTrap();
+ * useOnDisconnected(() => trap.cleanup());
+ * // In template:
+ * Transition({ show: props.open, onAfterEnter: trap.onAfterEnter, onAfterLeave: trap.onAfterLeave }, html`...`)
+ */
+export declare function createFocusTrap(): {
+    onAfterEnter: (el: HTMLElement) => void;
+    onAfterLeave: () => void;
+    cleanup: () => void;
+};

package/dist/composables/useListKeyNav.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Options for useListKeyNav.
+ */
+export interface ListKeyNavOptions {
+    /** Whether arrow keys navigate left/right or up/down. */
+    orientation: 'horizontal' | 'vertical';
+    /**
+     * CSS selector (relative to the container) used to find navigable items.
+     * Disabled items should be excluded, e.g. `'[role="menuitem"]:not([disabled])'`.
+     */
+    itemSelector: string;
+    /**
+     * Optional callback invoked after focus moves to the new item.
+     * Use this to update component state in addition to focus movement,
+     * e.g. activating a tab or selecting a radio segment.
+     */
+    onNavigate?: (item: HTMLElement, index: number) => void;
+}
+/**
+ * Returns a `keydown` event handler that implements arrow-key, Home, and End
+ * navigation within a container element.  Attach the handler to the container
+ * element via `@keydown`.
+ *
+ * The handler queries `:focus` within the container to determine the current
+ * item.  This correctly resolves focus inside shadow DOM where
+ * `document.activeElement` would only return the host element.
+ *
+ * @example
+ * // Vertical list (menu):
+ * const handleKeyDown = useListKeyNav({
+ *   orientation: 'vertical',
+ *   itemSelector: '[role="menuitem"]:not([disabled])',
+ * });
+ *
+ * // Horizontal list with activation callback (tabs):
+ * const handleKeyDown = useListKeyNav({
+ *   orientation: 'horizontal',
+ *   itemSelector: '[role="tab"]',
+ *   onNavigate: (_, idx) => { active.value = tabs[idx].id; emit('tab-change', tabs[idx].id); },
+ * });
+ */
+export declare function useListKeyNav(options: ListKeyNavOptions): (e: KeyboardEvent) => void;

package/dist/composables/useScrollLock.d.ts

@@ -0,0 +1,4 @@
+export declare function useScrollLock(): {
+    lock(): void;
+    unlock(): void;
+};