@shardworks/clerk-apparatus 0.1.259 → 0.1.261

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardworks/clerk-apparatus",
-  "version": "0.1.259",
+  "version": "0.1.261",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -20,12 +20,12 @@
   },
   "dependencies": {
     "zod": "4.3.6",
-    "@shardworks/stacks-apparatus": "0.1.259",
-    "@shardworks/tools-apparatus": "0.1.259"
+    "@shardworks/stacks-apparatus": "0.1.261",
+    "@shardworks/tools-apparatus": "0.1.261"
   },
   "devDependencies": {
     "@types/node": "25.5.0",
-    "@shardworks/nexus-core": "0.1.259"
+    "@shardworks/nexus-core": "0.1.261"
   },
   "files": [
     "dist",

package/pages/writs/index.html

@@ -342,7 +342,7 @@
      * tree of `WritTreeNode` entries. Guards against cycles with `visited` and
      * bounds recursion at `maxDepth` (default 10) to keep the UI responsive on
      * pathological data. Children at each level are sorted by createdAt ascending
-     * (oldest first), matching fetchChildrenForRoots behavior.
+     * (oldest first).
      *
      * Returns `WritTreeNode[]` — the direct children of `rootId`, each with their
      * own nested `children` list.
@@ -462,12 +462,31 @@
 
     // ── Render ─────────────────────────────────────────────────────────
 
+    /**
+     * Pure empty-state message chooser — invoked from renderTable's empty
+     * branch. When the operator has deselected every type filter, name both
+     * the cause and the remedy; for every other empty case (empty backend
+     * result, phase filter with no hits, search text with no matches) fall
+     * back to the generic "No writs found." message. `forestIsEmpty`
+     * documents the caller's precondition (this helper is only meaningful
+     * when the table is actually empty) but does not change the decision —
+     * the type-deselected branch always wins when it applies, because that
+     * is the only case where loadWrits short-circuits the network fetch.
+     */
+    function chooseEmptyStateMessage(noTypesSelected, forestIsEmpty) {
+      if (noTypesSelected) {
+        return 'All types deselected — select at least one type to see writs';
+      }
+      return 'No writs found.';
+    }
+
     function renderTable() {
       const tbody = document.getElementById('writ-tbody');
       const visible = sortedFilteredWrits();
 
       if (visible.length === 0 && forest.length === 0) {
-        tbody.innerHTML = `<tr><td colspan="6"><div class="empty-state">No writs found.</div></td></tr>`;
+        const message = chooseEmptyStateMessage(currentType.size === 0, forest.length === 0);
+        tbody.innerHTML = `<tr><td colspan="6"><div class="empty-state">${message}</div></td></tr>`;
         return;
       }
 

package/pages/writs/writs-hierarchy.test.js

@@ -226,6 +226,20 @@ function depthIndentStyle(depth) {
   return `padding-left:${rem}rem`;
 }
 
+/**
+ * Mirrors chooseEmptyStateMessage in index.html. Pure: decides which
+ * empty-state message to show when the writs table is empty. When the
+ * operator has deselected every type filter, name both the cause and the
+ * remedy; every other empty case (empty backend result, phase filter with
+ * no hits, search text with no matches) falls back to the generic message.
+ */
+function chooseEmptyStateMessage(noTypesSelected, forestIsEmpty) {
+  if (noTypesSelected) {
+    return 'All types deselected — select at least one type to see writs';
+  }
+  return 'No writs found.';
+}
+
 /**
  * Extracted renderDetail logic for parent link and children table.
  * The detail view stays direct-children-only (D20).
@@ -1001,3 +1015,27 @@ describe('Deep descendant rendering in detail view', () => {
     assert.ok(!html.match(/data-action="row-publish"[^>]*data-id="g"/));
   });
 });
+
+describe('chooseEmptyStateMessage — empty-state message chooser', () => {
+  it('returns the type-deselected message when no types are selected', () => {
+    // When the operator toggles off every type filter, loadWrits short-
+    // circuits with forest = [] and renderTable reaches the empty branch
+    // with currentType.size === 0. The chooser must name the deselection
+    // as the cause and direct the operator to the remedy — verbatim.
+    assert.equal(
+      chooseEmptyStateMessage(true, true),
+      'All types deselected — select at least one type to see writs',
+    );
+  });
+
+  it('returns the generic "No writs found." message when at least one type is selected but the forest is empty', () => {
+    // Phase filter with no hits, search text with no matches, or a valid
+    // filter set that genuinely returns nothing — all fall through to the
+    // generic message. The string is kept exact so wording drift breaks
+    // the suite.
+    assert.equal(
+      chooseEmptyStateMessage(false, true),
+      'No writs found.',
+    );
+  });
+});