janela 0.8.0 → 0.10.0

data/docs/theming.md

@@ -31,7 +31,7 @@ Three, and setting them moves everything that depends on them.
 | --- | --- | --- |
 | `--janela-space` | `0.25rem` | The base unit of the whole spacing scale. Every gap and padding is a multiple of it. |
 | `--janela-line` | `rgba(128, 128, 128, 0.3)` | Rules between rows, borders on cards and fields. |
-| `--janela-accent` | `rgb(54, 162, 235)` | A selected value, a hovered card. |
+| `--janela-accent` | `rgb(54, 162, 235)` | A selected value, a hovered card, a chart's bars (#62). |
 
 ```css
 :root {
@@ -64,22 +64,27 @@ the names a theme spends most of its time on.
 
 | Class | On | Rendered when |
 | --- | --- | --- |
-| `janela-pane` | `<table>`, `<p>` or `<canvas>` | every pane, whatever the renderer |
+| `janela-pane` | `<table>`, `<p>`, `<figure>` or `<div>` | every pane, whatever the renderer |
 | `janela-value` | `<p>` | a single value pane |
 | `janela-value-label` | `<span>` | its caption |
 | `janela-value-number` | `<strong>` | the number itself |
-| `janela-chart` | `<canvas>` | a bar or line pane |
+| `janela-chart` | `<canvas>` | a bar or line pane, inside its `<figure>` |
+| `janela-chart-title` | `<figcaption>` | its caption (ADR 042) |
 | `janela-empty` | `<p>` | a pane whose query returned nothing |
 | `janela-error` | `<p>` | a pane that could not be read |
+| `janela-content` | `<div>` | a stored pane holding words or a host partial rather than a query (ADR 039) |
+| `janela-content-heading` | `<h2>` | a text pane's heading |
 
-A table pane also renders a `<caption>`, its accessible name, and a
-chart pane carries the same string as `aria-label`.
+A table pane renders a `<caption>` and a chart pane a `<figcaption>`,
+each its own accessible name; the chart's canvas points to its
+figcaption with `aria-labelledby` rather than repeating the string in
+`aria-label`, so the two cannot drift apart (ADR 042).
 
 ### Hiding a heading you already wrote
 
-Put `janela-own-headings` on any ancestor and a pane's caption and a
-single value's label are hidden from sight while staying in the
-accessibility tree.
+Put `janela-own-headings` on any ancestor and a table's caption, a
+single value's label and a chart's title are hidden from sight while
+staying in the accessibility tree.
 
 ```erb
 <div class="janela-own-headings">
@@ -89,14 +94,11 @@ accessibility tree.
 ```
 
 Use it when your own markup already says what the pane is, so the text
-is not on screen twice. It hides rather than removes on purpose: a table
-with no caption has no accessible name, so a screen reader lands on a
-grid of numbers with nothing to say what they measure. `display: none`
-would do that, which is why this rule ships here rather than being left
-for each host to write.
-
-A chart pane needs nothing: its title is only ever an `aria-label` and
-was never drawn.
+is not on screen twice. It hides rather than removes on purpose: a pane
+with no visible caption still needs its accessible name, so a screen
+reader lands on a grid of numbers with nothing to say what they
+measure. `display: none` would do that, which is why this rule ships
+here rather than being left for each host to write.
 
 ## What is not the contract
 

data/lib/janela/definition.rb

@@ -97,6 +97,14 @@ module Janela
       dimensions.values.filter_map(&:through).map(&:to_s).uniq
     end
 
+    # A filter the host fixed for a render (ADR 040), applied as its own
+    # condition before the reader's, so the reader's can only narrow inside
+    # it. The same bounds as any filter: declared dimensions, ADR 025's
+    # predicates and value limit.
+    def narrow(relation, conditions)
+      filter(relation, conditions.to_h)
+    end
+
     private
       def filter(relation, params)
         return relation if params.empty?

data/lib/janela/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Janela
-  VERSION = "0.8.0"
+  VERSION = "0.10.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: janela
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Jay Killeen
@@ -114,6 +114,7 @@ files:
 - app/models/janela/query.rb
 - app/models/janela/snapshot.rb
 - app/views/janela/frames/_card.html.erb
+- app/views/janela/frames/_content.html.erb
 - app/views/janela/frames/_form.html.erb
 - app/views/janela/frames/_frame.html.erb
 - app/views/janela/frames/_pane.html.erb
@@ -121,6 +122,7 @@ files:
 - app/views/janela/frames/index.html.erb
 - app/views/janela/frames/new.html.erb
 - app/views/janela/frames/show.html.erb
+- app/views/janela/panes/_content_form.html.erb
 - app/views/janela/panes/_form.html.erb
 - app/views/janela/panes/_row.html.erb
 - app/views/janela/panes/edit.html.erb
@@ -137,6 +139,10 @@ files:
 - db/migrate/20260916000001_create_janela_frames.rb
 - db/migrate/20260916000002_create_janela_panes.rb
 - db/migrate/20260921000001_add_owner_to_janela_snapshots.rb
+- db/migrate/20260924000001_add_content_to_janela_panes.rb
+- db/migrate/20260924000002_add_key_to_janela_frames.rb
+- db/migrate/20260928000001_add_default_filter_to_janela_frames.rb
+- docs/composing.md
 - docs/decisions/001-built-to-be-forked.md
 - docs/decisions/002-measures-and-dimensions-over-ransack.md
 - docs/decisions/003-cross-filtering-with-turbo-frames.md
@@ -174,6 +180,12 @@ files:
 - docs/decisions/035-a-check-does-what-janela-does-or-says-what-it-saw.md
 - docs/decisions/036-janela-publishes-what-a-theme-may-target.md
 - docs/decisions/037-what-1-0-means.md
+- docs/decisions/038-a-ratio-is-a-measure-of-its-own.md
+- docs/decisions/039-a-pane-can-hold-words-and-only-code-writes-markup.md
+- docs/decisions/040-a-host-can-fix-a-frames-filter.md
+- docs/decisions/041-a-host-finds-its-frame-by-owner-and-key.md
+- docs/decisions/042-a-charts-title-is-a-figcaption.md
+- docs/decisions/043-a-frames-default-filter-names-the-model-it-narrows.md
 - docs/decisions/INDEX.md
 - docs/multi-tenancy.md
 - docs/naming.md
@@ -199,24 +211,14 @@ metadata:
   bug_tracker_uri: https://github.com/retail-tasker/janela/issues
   rubygems_mfa_required: 'true'
 post_install_message: |
-  Janela 0.8.0 raises where it used to do nothing. One thing to act on,
-  and one to read.
+  Janela 0.10.0: a migration if you use stored frames. Nobody else
+  has anything to do.
 
-  1. If you set Janela.parent_controller anywhere but an initializer, it
-     now raises instead of being ignored in silence. config.to_prepare
-     and config.after_initialize are both too late, and the README's own
-     layout recipe is a to_prepare block. Until now your dashboards kept
-     inheriting whatever was named first, so your authentication and
-     policy_scope were not the ones you wrote (ADR 035).
-
-  2. bin/rails janela:doctor reports findings it could not reach before,
-     including a Pundit host with no policy for Janela::Frame or
-     Janela::Snapshot, which used to pass the doctor and raise on every
-     request. Expect things that were always true and never printed.
-
-  Also: the class names on Janela's own pages are no longer public API.
-  They are scoped under janela-page and may change in any release. What
-  your own markup contains is unchanged and is listed in docs/theming.md.
+  A frame can now carry its own permanent filter as data, not only
+  the per-record one you pass in code (ADR 043):
+    bin/rails janela:install:migrations && bin/rails db:migrate
+  janela_frames gains default_model and default_where, both nil on
+  every existing frame. Nothing changes unless you set them.
 
   Steps: UPGRADING.md in this gem, or
   https://github.com/retail-tasker/janela/blob/main/UPGRADING.md