greeble.manifest.yaml

# greeble.manifest.yaml (Placeholder)
version: 1
library:
  name: "Greeble"
  description: "HTML-first, HTMX-powered copy and paste components for Python-first apps"
  packages:
    - greeble-core
    - greeble-components
    - greeble-hyperscript
    - greeble-tailwind-preset
    - greeble-django
    - greeble-fastapi
    - greeble-flask
  tokens_file: "static/greeble/greeble-core.css"
  docs_site: "docs/site"

components:
  - key: button
    title: "Buttons"
    summary: "Primary, secondary, icon, and split buttons"
    files:
      - templates/greeble/button.html
      - static/greeble/button.css
      - docs/components/button.md
    endpoints: []
    events:
      emits: ["greeble:click"]
      listens: []
    accessibility:
      notes: ["Visible focus", "aria-pressed for toggle variants"]

  - key: input
    title: "Inputs"
    summary: "Text input, textarea, select, and combobox"
    files:
      - templates/greeble/input.html
      - static/greeble/input.css
      - docs/components/input.md
    endpoints:
      - method: POST
        path: "/input/validate"
        description: "Optional server validation for demo purposes"
    events:
      emits: ["greeble:validate"]
      listens: []
    accessibility:
      notes: ["Labels required", "aria-describedby for help and errors"]

  - key: modal
    title: "Modal"
    summary: "Dialog with focus trap and backdrop"
    files:
      - templates/greeble/modal.html
      - templates/greeble/modal.partial.html
      - templates/greeble/modal.hyperscript.html
      - static/greeble/modal.css
      - docs/components/modal.md
    endpoints:
      - method: GET
        path: "/modal/example"
        description: "Return the modal partial"
      - method: GET
        path: "/modal/close"
        description: "Close the modal by clearing the root"
      - method: POST
        path: "/modal/submit"
        description: "Handle form submit and return success or errors"
    events:
      emits: ["greeble:modal:open", "greeble:modal:close"]
      listens: []
    accessibility:
      notes: ["role=dialog with aria-modal", "focus sent to panel on open"]

  - key: drawer
    title: "Drawer"
    summary: "Edge panel for settings and filters"
    files:
      - templates/greeble/drawer.html
      - templates/greeble/drawer.partial.html
      - static/greeble/drawer.css
      - docs/components/drawer.md
    endpoints:
      - method: GET
        path: "/drawer/open"
      - method: GET
        path: "/drawer/close"
    events:
      emits: ["greeble:drawer:open", "greeble:drawer:close"]
      listens: []
    accessibility:
      notes: ["role=dialog", "label with heading"]

  - key: dropdown
    title: "Dropdown Menu"
    summary: "Button-triggered menu with keyboard navigation"
    files:
      - templates/greeble/dropdown.html
      - static/greeble/dropdown.css
      - docs/components/dropdown.md
    endpoints: []
    events:
      emits: ["greeble:menu:select"]
      listens: []
    accessibility:
      notes: ["role=menu with roving tabindex", "arrow key navigation"]

  - key: tabs
    title: "Tabs"
    summary: "Tablist with per-tab content"
    files:
      - templates/greeble/tabs.html
      - templates/greeble/tabs.partial.html
      - static/greeble/tabs.css
      - docs/components/tabs.md
    endpoints:
      - method: GET
        path: "/tabs/{tabKey}"
        description: "Return content for a given tab key"
    events:
      emits: ["greeble:tab:change"]
      listens: []
    accessibility:
      notes: ["role=tablist and role=tab", "aria-selected and aria-controls"]

  - key: table
    title: "Table"
    summary: "Sortable, pageable table with row actions"
    files:
      - templates/greeble/table.html
      - templates/greeble/table.partial.html
      - static/greeble/table.css
      - docs/components/table.md
    endpoints:
      - method: GET
        path: "/table"
        description: "Accepts page and sort query parameters"
    events:
      emits: ["greeble:table:sorted", "greeble:table:paged"]
      listens: []
    accessibility:
      notes: ["caption recommended", "scope attributes on headers"]

  - key: toast
    title: "Toasts"
    summary: "Global toast queue using out of band swaps"
    files:
      - templates/greeble/toast.root.html
      - templates/greeble/toast.item.html
      - static/greeble/toast.css
      - docs/components/toast.md
    endpoints: []
    events:
      emits: ["greeble:toast"]
      listens: []
    accessibility:
      notes: ["aria-live=assertive on root", "dismiss buttons with labels"]

  - key: palette
    title: "Command Palette"
    summary: "Search input with server-backed results"
    files:
      - templates/greeble/palette.html
      - templates/greeble/palette.partial.html
      - static/greeble/palette.css
      - docs/components/palette.md
    endpoints:
      - method: POST
        path: "/palette/search"
        description: "Return result list items"
    events:
      emits: ["greeble:palette:select"]
      listens: []
    accessibility:
      notes: ["role=dialog with listbox semantics", "announce result counts"]

  - key: stepper
    title: "Stepper"
    summary: "Multi-step wizard"
    files:
      - templates/greeble/stepper.html
      - templates/greeble/stepper.partial.html
      - static/greeble/stepper.css
      - docs/components/stepper.md
    endpoints:
      - method: GET
        path: "/stepper/{stepKey}"
      - method: POST
        path: "/stepper/{stepKey}"
    events:
      emits: ["greeble:stepper:change"]
      listens: []
    accessibility:
      notes: ["announce step changes", "disable next when invalid"]

  - key: infinite-list
    title: "Infinite List"
    summary: "Lazy loading list triggered on reveal"
    files:
      - templates/greeble/infinite-list.html
      - templates/greeble/infinite-list.partial.html
      - static/greeble/infinite-list.css
      - docs/components/infinite-list.md
    endpoints:
      - method: GET
        path: "/list"
        description: "Accepts cursor query parameter"
    events:
      emits: ["greeble:list:append"]
      listens: []
    accessibility:
      notes: ["maintain scroll position", "announce new content"]

  - key: form-validated
    title: "Form with Validation"
    summary: "Server-validated form that replaces invalid groups"
    files:
      - templates/greeble/form.html
      - templates/greeble/form.partial.html
      - static/greeble/form.css
      - docs/components/form.md
    endpoints:
      - method: POST
        path: "/form/validate"
      - method: POST
        path: "/form/submit"
    events:
      emits: ["greeble:form:invalid", "greeble:form:submitted"]
      listens: []
    accessibility:
      notes: ["associate errors with fields via aria-describedby"]

  - key: audio-recorder
    title: "Audio Recorder"
    summary: "Microphone recording with MediaRecorder API and upload support"
    files:
      - templates/greeble/audio-recorder.html
      - templates/greeble/audio-recorder.partial.html
      - static/greeble/audio-recorder.css
      - static/greeble/audio-recorder.js
      - docs/components/audio-recorder.md
    endpoints:
      - method: POST
        path: "/audio/upload"
        description: "Upload recorded audio blob"
    events:
      emits: ["greeble:audio:start", "greeble:audio:stop", "greeble:audio:complete", "greeble:audio:submit", "greeble:audio:discard", "greeble:audio:error"]
      listens: []
    accessibility:
      notes: ["aria-label on buttons", "aria-live on status region"]

  - key: drop-zone
    title: "Drop Zone"
    summary: "Drag-and-drop file upload with validation and preview"
    files:
      - templates/greeble/drop-zone.html
      - templates/greeble/drop-zone.partial.html
      - static/greeble/drop-zone.css
      - static/greeble/drop-zone.js
      - docs/components/drop-zone.md
    endpoints:
      - method: POST
        path: "/files/upload"
        description: "Upload dropped files"
    events:
      emits: ["greeble:dropzone:files", "greeble:dropzone:remove", "greeble:dropzone:clear", "greeble:dropzone:upload", "greeble:dropzone:error"]
      listens: []
    accessibility:
      notes: ["aria-describedby for help text", "keyboard accessible via file input"]

  - key: swap-select
    title: "Swap Select"
    summary: "Paired select dropdowns with swap button for source/target selection"
    files:
      - templates/greeble/swap-select.html
      - templates/greeble/swap-select.partial.html
      - static/greeble/swap-select.css
      - static/greeble/swap-select.js
      - docs/components/swap-select.md
    endpoints:
      - method: GET
        path: "/options/source"
        description: "Load source options"
      - method: GET
        path: "/options/target"
        description: "Load target options"
    events:
      emits: ["greeble:swap:swapped", "greeble:swap:change"]
      listens: []
    accessibility:
      notes: ["labels for selects", "keyboard shortcut Ctrl+Shift+S to swap"]

  - key: file-upload
    title: "File Upload"
    summary: "Multi-mode file input with tabs for file, URL, and paste"
    files:
      - templates/greeble/file-upload.html
      - static/greeble/file-upload.css
      - static/greeble/file-upload.js
      - docs/components/file-upload.md
    endpoints: []
    events:
      emits: ["greeble:fileupload:input", "greeble:fileupload:tab", "greeble:fileupload:fetch", "greeble:fileupload:error"]
      listens: []
    accessibility:
      notes: ["ARIA tabs pattern", "keyboard navigation", "labeled inputs"]

  - key: draggable-card
    title: "Draggable Card"
    summary: "Draggable card for pipeline/workflow builders with type badges"
    files:
      - templates/greeble/draggable-card.html
      - static/greeble/draggable-card.css
      - static/greeble/draggable-card.js
      - docs/components/draggable-card.md
    endpoints: []
    events:
      emits: ["greeble:card:dragstart", "greeble:card:dragend"]
      listens: []
    accessibility:
      notes: ["native draggable attribute", "keyboard support via browser"]

  - key: drop-canvas
    title: "Drop Canvas"
    summary: "Drop target for building pipelines with type validation"
    files:
      - templates/greeble/drop-canvas.html
      - templates/greeble/drop-canvas.partial.html
      - static/greeble/drop-canvas.css
      - static/greeble/drop-canvas.js
      - docs/components/drop-canvas.md
    endpoints:
      - method: POST
        path: "/pipeline/run"
        description: "Execute the pipeline"
    events:
      emits: ["greeble:canvas:stepadded", "greeble:canvas:stepremoved", "greeble:canvas:stepschanged", "greeble:canvas:cleared", "greeble:canvas:run"]
      listens: ["greeble:card:dragstart", "greeble:card:dragend"]
    accessibility:
      notes: ["keyboard accessible step controls", "ARIA live regions"]

  - key: step-progress
    title: "Step Progress"
    summary: "Progress indicator for multi-step workflows with timing"
    files:
      - templates/greeble/step-progress.html
      - templates/greeble/step-progress.partial.html
      - static/greeble/step-progress.css
      - static/greeble/step-progress.js
      - docs/components/step-progress.md
    endpoints: []
    events:
      emits: ["greeble:progress:stepstart", "greeble:progress:stepcomplete", "greeble:progress:steperror", "greeble:progress:complete"]
      listens: []
    accessibility:
      notes: ["semantic list structure", "status conveyed via text"]

  - key: type-badge
    title: "Type Badge"
    summary: "Colored badges for data types, categories, and statuses"
    files:
      - templates/greeble/type-badge.html
      - static/greeble/type-badge.css
      - docs/components/type-badge.md
    endpoints: []
    events:
      emits: []
      listens: []
    accessibility:
      notes: ["color supplemented with text labels"]

  # SEO Audit Components
  - key: score-gauge
    title: "Score Gauge"
    summary: "Radial SVG gauge for displaying scores 0-100 with grade labels"
    files:
      - templates/greeble/score-gauge.html
      - templates/greeble/score-gauge.partial.html
      - static/greeble/score-gauge.css
      - docs/components/score-gauge.md
    endpoints: []
    events:
      emits: []
      listens: []
    accessibility:
      notes: ["score value as text", "grade provides semantic context"]

  - key: forecast-chart
    title: "Forecast Chart"
    summary: "Server-rendered SVG area chart with min/expected/max bands"
    files:
      - templates/greeble/forecast-chart.html
      - templates/greeble/forecast-chart.partial.html
      - static/greeble/forecast-chart.css
      - docs/components/forecast-chart.md
    endpoints: []
    events:
      emits: []
      listens: []
    accessibility:
      notes: ["supplement with data table for screen readers", "legend uses text labels"]

  - key: factor-breakdown
    title: "Factor Breakdown"
    summary: "Weighted scoring factors as cards with progress bars"
    files:
      - templates/greeble/factor-breakdown.html
      - templates/greeble/factor-breakdown.partial.html
      - static/greeble/factor-breakdown.css
      - docs/components/factor-breakdown.md
    endpoints: []
    events:
      emits: []
      listens: []
    accessibility:
      notes: ["progress bars visual only", "percentage values as text"]

  - key: metric-grid
    title: "Metric Grid"
    summary: "Grid of key-value metric cards for diagnostic data"
    files:
      - templates/greeble/metric-grid.html
      - templates/greeble/metric-grid.partial.html
      - static/greeble/metric-grid.css
      - docs/components/metric-grid.md
    endpoints: []
    events:
      emits: []
      listens: []
    accessibility:
      notes: ["values as plain text", "color supplemented with value"]

  - key: citation-list
    title: "Citation List"
    summary: "Scrollable list of citation cards with NAP data"
    files:
      - templates/greeble/citation-list.html
      - templates/greeble/citation-list.partial.html
      - static/greeble/citation-list.css
      - docs/components/citation-list.md
    endpoints:
      - method: GET
        path: "/citations"
        description: "Accepts cursor parameter for infinite scroll"
    events:
      emits: []
      listens: []
    accessibility:
      notes: ["links open in new tabs", "scrollable region has visible scrollbar"]

  - key: audit-dashboard
    title: "Audit Dashboard"
    summary: "Composite dashboard for Local SEO audits"
    files:
      - templates/greeble/audit-dashboard.html
      - templates/greeble/audit-dashboard.partial.html
      - static/greeble/audit-dashboard.css
      - docs/components/audit-dashboard.md
    endpoints:
      - method: POST
        path: "/api/audit"
        description: "Run audit and return results partial"
    events:
      emits: ["htmx:beforeRequest", "htmx:afterSwap"]
      listens: []
    accessibility:
      notes: ["form has labeled input", "semantic heading hierarchy"]