markdowndocs 0.11.3 → 0.11.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee414b6e508ae906b792f1abd65e21135a1439cf740998f69a1ad7cde743f1c1
-  data.tar.gz: 55f37cb07e8d2e274ca25fdc73e3448075fb945a7d10e852e596203893643190
+  metadata.gz: 1f1cb7d3191ecb664710cd650b934dc133ba887db48cfd49ec9c7758fbcfaf69
+  data.tar.gz: 7a236c92a2b4d755c882b3c257b2b52b900ceae73312989433ff6ab93d35a1bd
 SHA512:
-  metadata.gz: e0a49a7d046d2539060dd9bb4cab2f4d9d626c58020a41c898ee8627ae11eb99e2c28a9ff336291acbfd72b3903405e101abac33152fa99e3f0c2a6806d3be00
-  data.tar.gz: 8a7ef92900c9e99f9702838b7ab68cc619509c84cace45e1c0f86c94085154e546cc8dd4b94cfc89af9fcbaed6691db4722b556439405320f3fb33ceb00a9db1
+  metadata.gz: '028f7855c0d94dc53fd363f2f8ac34d13c8e417a64f20753fa42aa9b3f07534f9d62f91ba7f1af137cbb9787ed28f5b4680d467fcf4850d30562e7ecca4ae79b'
+  data.tar.gz: 948e320c78060772faf7b4cba7ce6ee66936af28e71d702694d433f801937c872439a7e6becff8dd78c7d6a7573b1097df64b57ed19faf936951ed575bb8a1e2

data/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.11.4] - 2026-09-23
+
+Two search fixes. Neither changes an API, but the second one asks something of
+apps that have overridden the docs index template.
+
+### Fixed
+
+- **A query typed before the search index arrives is no longer dropped.**
+  `performSearch` returns through `showAll()` while `miniSearch` is still null,
+  and nothing re-read the input once the fetch resolved — so on a slow
+  connection the filter looked dead to anyone who started typing straight away.
+  The controller now re-runs the search as soon as the index is usable. Proved
+  by a browser spec in a host app rather than here: this repo has no
+  JavaScript test harness, and standing one up is tracked separately.
+
+- **The docs index filter no longer hides every card.** `search_index` keys each
+  entry on `path_slug`, but the index template tagged each card with the bare
+  `slug`, and `docs_search_controller` matches a card by comparing the two. A
+  mode-scoped document therefore never matched its own index entry, so any query
+  emptied the page. Cards now carry `path_slug`. Apps that copied
+  `docs/index.html.erb` into their own `app/views/markdowndocs/docs/` need the
+  same change locally — a gem upgrade does not reach an override.
+
 ## [0.11.3] - 2026-09-03
 
 ### Accessibility

data/app/assets/javascripts/markdowndocs/controllers/docs_search_controller.js

@@ -32,6 +32,12 @@ export default class extends Controller {
         }
       })
       this.miniSearch.addAll(docs)
+
+      // A query typed while the index was still loading was dropped:
+      // performSearch returns through showAll() while miniSearch is null, and
+      // nothing re-read the input once the fetch resolved, so the filter looked
+      // dead to anyone who started typing straight away (#42).
+      if (this.hasInputTarget && this.inputTarget.value.trim()) this.performSearch()
     } catch (e) {
       console.warn("Markdowndocs: failed to load search index", e)
     }

data/app/views/markdowndocs/docs/index.html.erb

@@ -56,7 +56,12 @@
                 md:grid-cols-2
                 lg:grid-cols-3">
               <% docs.each do |doc| %>
-                <div <% if @search_enabled %>data-docs-search-target="card" data-slug="<%= doc.slug %>"<% end %>>
+                <%# path_slug, NOT the bare slug: search_index keys every entry on
+                    path_slug, and docs_search_controller matches a card by testing
+                    this attribute against those ids. A mode-scoped document tagged
+                    with its bare slug matches nothing, which hid every card on
+                    every query (#40). %>
+                <div <% if @search_enabled %>data-docs-search-target="card" data-slug="<%= doc.path_slug %>"<% end %>>
                   <%= render "markdowndocs/docs/card", doc: doc %>
                 </div>
               <% end %>

data/lib/markdowndocs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Markdowndocs
-  VERSION = "0.11.3"
+  VERSION = "0.11.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: markdowndocs
 version: !ruby/object:Gem::Version
-  version: 0.11.3
+  version: 0.11.4
 platform: ruby
 authors:
 - Dave Chmura
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-04 00:00:00.000000000 Z
+date: 2026-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails