softr-vibe-coding 1.11.0 → 1.11.2

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this skill are documented here. Versions follow [Semantic
 
 Entries from 1.3.1 onward are generated automatically from git commit subjects between version bumps (see `.github/workflows/publish.yml`). Entries before 1.3.1 were backfilled by hand from the existing commit history.
 
+## [1.11.2] - 2026-07-08
+- Bump to 1.11.2 — publish recordId-less useRecord note and input.textAsync correction
+- Correct input.textAsync in airtable-automations.md — it is not a real method in EITHER Airtable scripting environment; calling it in the Scripting Extension throws TypeError: input.textAsync is not a function. buttonsAsync is the only interactive runtime prompt; free-text values (e.g. an API key) go through an input.config({...}) setting at the top or a hardcoded constant. Also generalize the Automation Scripts bullet to "no interactive prompts".
+- Document recordId-less useRecord via Studio data binding
+
+## [1.11.1] - 2026-06-12
+- Document the tabbed-list visibility gotcha in native-block-filters.md — Softr renders tabs with Radix and keeps the INACTIVE tab's blocks in the DOM (display:none, not unmounted), so a data-block-id lookup on a tabbed page matches BOTH tabs' lists; injecting a custom control into the hidden one makes it 'disappear' on tab switch. Add §4d: require the matched block to be visible (offsetParent !== null) and home into whichever tab is active so one control follows all tabs (each tab-list keeps its own conditional filter; ~250ms interval for snappier flips), plus a Gotchas bullet. Bump to 1.11.1
+
 ## [1.11.0] - 2026-06-12
 - Add references/native-block-filters.md — dynamic date / URL-param filters and custom filter controls on native Softr List/Grid blocks. Covers driving a native block's conditional filter from a Custom Code Static block via {URL_PARAM:…}, the empty-param 'match nothing' wide-range sentinel that otherwise empties the list on load, injecting the control into the block's filter row scoped by data-block-id (a page-wide text search wrongly matches the nav 'Clients' link), resolving the row by filter-label-text + lowest-common-ancestor instead of hashed chip classes, and the key gotcha that Softr re-renders its List/Grid block and discards injected nodes so the control must be re-homed on a short interval rather than relocated once. Includes a full worked date-range picker (wide-range sentinel + wait-for-both + Clear + relocation + re-render survival) and a DevTools how-to for finding data-block-id and the filter row. Wire into the SKILL.md reference table and README structure listing; bump to 1.11.0
 

package/datasources/reading.md

@@ -84,6 +84,8 @@ var result = useRecord({
 });
 ```
 
+**`recordId` can be omitted when Softr Studio supplies the record context.** `useRecord({ select })` with no `recordId` loads the record the block is bound to via its data-source binding in Studio — verified by deployed block, July 2026 (an Airtable-backed stats block rendered live values this way). Keep `useCurrentRecordId()` + explicit `recordId` as the pattern for URL-driven detail pages (`/page?recordId=...`). When editing an existing **working** block that already omits `recordId`, leave the call shape as-is: adding an explicit `recordId` from `useCurrentRecordId()` can change behavior on pages whose URL carries no `recordId` param. Corollary for reviews: a recordId-less `useRecord` is NOT by itself a defect — check whether the block is deployed and loading data before flagging it.
+
 ## useLinkedRecords -- Fetch Linked/Related Options
 
 ```jsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "softr-vibe-coding",
-  "version": "1.11.0",
+  "version": "1.11.2",
   "description": "Claude Code skill for generating production-ready Softr Vibe Coding blocks (JSX). Installs into ~/.claude/skills/ and auto-updates on each Claude Code session.",
   "bin": {
     "softr-vibe-coding": "./bin/cli.js"

package/references/airtable-automations.md

@@ -28,7 +28,7 @@ Background-only. No UI. Receives input from the automation trigger; can output v
 - Output to downstream steps via `output.set(key, value)`.
 - `console.log()` appears in the automation's run log (NOT the browser console). This is your ONLY progress / debug surface.
 - **NO `output.markdown`, NO `output.text`, NO `output.table`, NO `output.inspect`** — those throw `TypeError: output.<x> is not a function` here. They're Scripting-Extension-only.
-- **NO `input.buttonsAsync` / `input.textAsync`** — interactive UI is not available in the background runner.
+- **NO interactive prompts** (`input.buttonsAsync` and friends) — interactive UI is not available in the background runner. (Note: `input.textAsync` is not a real method in *either* environment — see the Scripting Extension section.)
 - Execution cap: 120 seconds (recently raised from 30s).
 - Can be triggered manually via the "Test" button on the automation, useful for one-shot scripts you don't want to set up a real trigger for.
 
@@ -59,7 +59,7 @@ await main();
 Foreground, interactive. Used for one-off transforms, bulk fixes, building admin dashboards. Has a richer API. Requires installing the "Scripting" extension in the base — most bases don't have it by default.
 
 - Configure interactive inputs via `input.config({ title, items: [...] })` — note: takes an OBJECT here, unlike Automation Scripts.
-- Show prompts with `await input.buttonsAsync(prompt, options)`, `input.textAsync(...)`, etc.
+- Show prompts with `await input.buttonsAsync(prompt, options)` — this is the **only** interactive runtime prompt. **There is no `input.textAsync`**; calling it throws `TypeError: input.textAsync is not a function`. For a free-text value (e.g. an API key), declare it as an `input.config({...})` setting at the top, or hardcode a constant for a one-off script.
 - Render output with `output.markdown(...)`, `output.table(...)`.
 - `console.log()` shows in the browser devtools console.
 

package/references/native-block-filters.md

@@ -172,6 +172,29 @@ setInterval(ensureHomed, 500); // and re-home after every Softr re-render
 
 `ensureHomed` is idempotent (it only re-appends when the control is *not* already in the row), so the interval is cheap and can't loop.
 
+### 4d. Tabbed pages — home into the VISIBLE tab's list ⚠️
+**Softr renders tabs with Radix, and the *inactive* tab's blocks stay in the DOM — just `display:none`, not unmounted.** So on a tabbed page (e.g. a worker "Pending / All" view) *both* tabs' list blocks match a `data-block-id` lookup. Grab the hidden one and your control gets injected into the invisible panel — it looks like it "vanished" the moment the user switches tabs.
+
+Two rules:
+1. **Require the matched block to be visible** — `el.offsetParent !== null` (it's `null` when the element or an ancestor tab panel is `display:none`). Skip hidden matches.
+2. **One control can serve every tab** — list all the tab-lists' block-ids and home into whichever is visible; the re-home interval then makes the control *follow the active tab*.
+
+```js
+// Both tab lists. Softr keeps the INACTIVE tab's list in the DOM (hidden), so an id-only
+// match could grab the wrong one — only the VISIBLE tab's block should win.
+var LIST_BLOCK_IDS = ["<pending-tab-list-id>", "<all-tab-list-id>"];
+
+function activeListBlock() {
+  for (var i = 0; i < LIST_BLOCK_IDS.length; i++) {
+    var el = document.querySelector('[data-block-id="' + LIST_BLOCK_IDS[i] + '"]');
+    if (el && el.offsetParent !== null) return el; // offsetParent === null → in a hidden tab
+  }
+  return null;
+}
+```
+
+Use `activeListBlock()` in place of the single-id lookup inside `findFilterRow()`. Each tab-list still needs its OWN copy of the conditional filter (the control only sets the URL params; every list reads them independently). A ~250ms interval feels snappier than 500ms when the user flips tabs.
+
 ---
 
 ## 5. Full worked example — date-range picker that joins the filter row
@@ -280,6 +303,7 @@ A complete Custom Code Static block: range picker with the wide-range sentinel,
 
 - **Empty `{URL_PARAM}` = match NOTHING.** A blank/missing param empties a filtered list. Seed a wide sentinel range (and map it back to blank inputs) so "no selection" shows all. §2.
 - **Softr re-renders its list block and discards injected nodes.** One-shot relocation vanishes on the first interaction. Re-home on an interval/observer. §4c.
+- **Tabbed pages keep the inactive tab's list in the DOM (`display:none`).** A `data-block-id` match can grab the hidden tab's copy → the injected control "disappears" on tab switch. Require `offsetParent !== null` and home into the visible list; one control can follow all tabs. §4d.
 - **Page-wide DOM searches hit the native chrome.** Matching by text "Client" also matches a "Clients" nav link → control lands in the sidebar. Always scope to the block's `data-block-id`. §4a.
 - **Filter chips have only hashed classes** (`a0e85ef_…`) that change on deploys. Anchor on your **filter label text + lowest common ancestor**; keep the hash as a fallback only. §4b.
 - **`window.location.reload()` is how Softr re-reads the param.** `replaceState` alone updates the URL but won't re-run the conditional filter — you must reload.

package/references/quick-reference.md

@@ -65,6 +65,8 @@ var recordId = useCurrentRecordId();
 var result = useRecord({ recordId: recordId, select: select });
 ```
 
+`recordId` may be omitted when the block's Studio data binding supplies the record context (verified by deployed block, July 2026) — see [reading.md](../datasources/reading.md#userecord----fetch-a-single-record).
+
 ## Current User
 
 ```jsx