cjm-fasthtml-card-stack 0.0.1__py3-none-any.whl → 0.0.3__py3-none-any.whl

demos/shared.py

@@ -0,0 +1,153 @@
+"""Shared utilities for card stack demos."""
+
+from fasthtml.common import Div, H1, P, Span
+
+from cjm_fasthtml_daisyui.utilities.semantic_colors import bg_dui, text_dui
+from cjm_fasthtml_tailwind.utilities.spacing import p, m
+from cjm_fasthtml_tailwind.utilities.sizing import container, max_w
+from cjm_fasthtml_tailwind.utilities.typography import font_size, font_weight
+from cjm_fasthtml_tailwind.utilities.flexbox_and_grid import (
+    flex_display, items, justify, gap
+)
+from cjm_fasthtml_tailwind.utilities.borders import rounded
+from cjm_fasthtml_tailwind.core.base import combine_classes
+
+from cjm_fasthtml_keyboard_navigation.core.manager import ZoneManager
+from cjm_fasthtml_keyboard_navigation.components.system import render_keyboard_system
+
+from cjm_fasthtml_card_stack.components.viewport import render_viewport
+from cjm_fasthtml_card_stack.components.controls import (
+    render_width_slider, render_scale_slider, render_card_count_select
+)
+from cjm_fasthtml_card_stack.components.progress import render_progress_indicator
+from cjm_fasthtml_card_stack.js.core import generate_card_stack_js
+from cjm_fasthtml_card_stack.keyboard.actions import (
+    create_card_stack_focus_zone, create_card_stack_nav_actions,
+    build_card_stack_url_map, render_card_stack_action_buttons
+)
+
+
+def build_keyboard_system(config, btn_ids, ids, urls):
+    """Build keyboard navigation system for a card stack."""
+    zone = create_card_stack_focus_zone(ids)
+    nav_actions = create_card_stack_nav_actions(zone.id, btn_ids, config)
+    manager = ZoneManager(zones=(zone,), actions=nav_actions)
+
+    url_map = build_card_stack_url_map(btn_ids, urls)
+    target_map = {btn_id: f"#{ids.card_stack}" for btn_id in url_map}
+    swap_map = {btn_id: "none" for btn_id in url_map}
+    include_map = {btn_id: f"#{ids.focused_index_input}" for btn_id in url_map}
+
+    return render_keyboard_system(
+        manager,
+        url_map=url_map,
+        target_map=target_map,
+        swap_map=swap_map,
+        include_map=include_map,
+        show_hints=False,
+        include_state_inputs=True,
+    )
+
+
+def render_demo_page(
+    title,
+    description,
+    state_getter,
+    items_getter,
+    render_card,
+    config,
+    ids,
+    btn_ids,
+    urls,
+    container_id,
+    progress_label="Item",
+):
+    """Render a standard card stack demo page.
+
+    Returns a page_content() callable for use with handle_htmx_request.
+    """
+
+    def page_content():
+        state = state_getter()
+        card_items = items_getter()
+
+        kb_system = build_keyboard_system(config, btn_ids, ids, urls)
+
+        js_script = generate_card_stack_js(
+            ids=ids,
+            button_ids=btn_ids,
+            config=config,
+            urls=urls,
+            container_id=container_id,
+        )
+
+        return Div(
+            # Visual content container (used for viewport height calculation)
+            Div(
+                # Header
+                Div(
+                    H1(title, cls=combine_classes(font_size._2xl, font_weight.bold)),
+                    P(description,
+                      cls=combine_classes(text_dui.base_content, font_size.sm, m.b(4))),
+                    cls=m.b(2)
+                ),
+
+                # Controls row
+                Div(
+                    Div(
+                        render_card_count_select(config, ids, state.visible_count),
+                        cls=combine_classes(flex_display, items.center, gap(2)),
+                    ),
+                    Div(
+                        Span("Width:", cls=combine_classes(font_size.sm, text_dui.base_content)),
+                        render_width_slider(config, ids, state.card_width),
+                        cls=combine_classes(flex_display, items.center, gap(2)),
+                    ),
+                    Div(
+                        Span("Scale:", cls=combine_classes(font_size.sm, text_dui.base_content)),
+                        render_scale_slider(config, ids, state.card_scale),
+                        cls=combine_classes(flex_display, items.center, gap(2)),
+                    ),
+                    cls=combine_classes(
+                        flex_display, items.center, justify.between,
+                        gap(4), m.b(2), p(2),
+                        bg_dui.base_200, rounded.lg,
+                    )
+                ),
+
+                # Viewport
+                render_viewport(
+                    card_items=card_items,
+                    state=state,
+                    config=config,
+                    render_card=render_card,
+                    ids=ids,
+                    urls=urls,
+                ),
+
+                # Footer
+                Div(
+                    render_progress_indicator(
+                        state.focused_index, len(card_items), ids, label=progress_label
+                    ),
+                    cls=combine_classes(flex_display, justify.center, m.t(2))
+                ),
+
+                id=container_id,
+            ),
+
+            # Keyboard system
+            kb_system.script,
+            kb_system.hidden_inputs,
+            kb_system.action_buttons,
+
+            # Hidden buttons for JS-callback-triggered actions
+            render_card_stack_action_buttons(btn_ids, urls, ids),
+
+            # Card stack JS
+            js_script,
+
+            cls=combine_classes(container, max_w._6xl, m.x.auto, p(4))
+        )
+
+    return page_content

cjm_fasthtml_card_stack-0.0.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-cjm_fasthtml_card_stack/__init__.py,sha256=sXLh7g3KC4QCFxcZGBTpG2scR7hmmBsMjq6LqRptkRg,22
-cjm_fasthtml_card_stack/_modidx.py,sha256=jYNj6LPbD5I8yDghD3Lx9XWsDnWqc_oNCESguSF8blA,25105
-cjm_fasthtml_card_stack-0.0.1.dist-info/licenses/LICENSE,sha256=xV8xoN4VOL0uw9X8RSs2IMuD_Ss_a9yAbtGNeBWZwnw,11337
-cjm_fasthtml_card_stack-0.0.1.dist-info/METADATA,sha256=PDmhCLd0lgo4dGhsEojEvH6TV0bguLQDC9YnRA3Zwzg,36798
-cjm_fasthtml_card_stack-0.0.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-cjm_fasthtml_card_stack-0.0.1.dist-info/entry_points.txt,sha256=qTw6qaijkEUH1AcPQhpTqJ8TPiUSMnpn0Cvg4hXoX90,68
-cjm_fasthtml_card_stack-0.0.1.dist-info/top_level.txt,sha256=y6h84kPxytZIWTD4ITK2Gsi40KivBsEfSe8131fIoR4,24
-cjm_fasthtml_card_stack-0.0.1.dist-info/RECORD,,