feat(manifest): quick-filter tabs + "link" widget + built-in date formatters + readOnly + pages[].permission (closes #224)

[rubenvdlinde]

What

§1–7 of the manifest-index-page-followups opsx change — closes #224. A tight bundle of small additions surfaced by the fleet conversion wave (pipelinq #351, procest #436, scholiq #71, zaakafhandelapp #203, softwarecatalog #231, decidesk #197).

1. Quick-filter tabs (config.quickFilters) — REQ-MIPFU-1

type:"index" pages gain config.quickFilters: [{label, filter, default?, icon?}]. CnIndexPage renders the new CnQuickFilterBar above the table; the active tab's filter is merged into the useListView fetch after config.filter (so the tab wins on a colliding key) and before the user's activeFilters (which still narrow within the active tab). @route.<name> resolution parity with config.filter. Closes procest's filter-tabs gap (Voorstellen's Concept/InBehandeling/Afgerond tabs were dropped in the conversion — config.filter is fixed, not switchable; this is the missing piece).

2. Built-in widget:"link" — REQ-MIPFU-2

CnCellRenderer resolves widget:"link" to:

• <router-link> when widgetProps.route is set (a manifest page id; default {id: row[rowKey]} param map; override via widgetProps.params: {routeParam: "rowField"})
• <a target="_blank" rel="noopener"> when widgetProps.href is set (with {key} placeholder substitution from the row)
• plain-text fallback + once-per-session console.warn (silence with widgetProps.fallback:"silent")

Consumer-registered link still wins. Resolves decidesk's Decisions.title widget:"link" no-op.

3. Built-in "date" / "datetime" / "relative-time" formatters — REQ-MIPFU-3

CnAppRoot provides cnFormatters as {...BUILT_IN_FORMATTERS, ...props.formatters} so consumer overrides win. All three are safe against null / empty / non-parseable inputs (Intl.DateTimeFormat / Intl.RelativeTimeFormat; return '' or the original value, no throw). Resolves decidesk's Decisions.decisionDate formatter:"date" no-op.

4. config.readOnly:true shorthand — REQ-MIPFU-4

CnPageRenderer expands config.readOnly:true on a type:"index" page to selectable:false, showAdd:false, showFormDialog:false, showEditAction:false, showCopyAction:false, showDeleteAction:false, showMassImport:false, showMassCopy:false, showMassDelete:false — merged under explicit config.* props so an explicit config.showAdd:true still wins. Replaces the 9-line CRUD-off boilerplate scholiq #71 had to spell out for its read-only AssessmentResults / LearningPlanEvaluations / Signatures pages.

5. pages[].permission — REQ-MIPFU-5

$defs.page (additionalProperties:false) now allows an optional permission: <string>. Schema-only — no runtime gating (consumers filter the manifest themselves if they want enforcement). Resolves procest's WmsLayers* / LhsMatrices* validation errors.

6. handler:"emit" — REQ-MIPFU-6

Verified the existing CnIndexPage.mergedActions already strips the handler key for "emit" (and unknown / non-resolvable handlers) → CnRowActions doesn't see a function → page emits @action only. No code change needed; spec scenario updated to match the existing {action: <label>, row: <item>} payload shape.

Verification

• npm test — 91 suites / 1294 tests green (no regression; +27 new — formatters 12, CnPageRenderer readOnly 3, CnCellRenderer link 5, CnIndexPage quickFilters 7)
• npm run lint — 0 errors (was 2 from the new <a> attribute wrap; fixed). 306 warnings are all pre-existing.
• npm run build — ✓ (dist/nextcloud-vue.esm.js + dist/nextcloud-vue.cjs.js created)
• npm run check:docs — 89/89 component docs cover their props and slots (added CnQuickFilterBar; rowKey + quickFilters props documented)
• openspec validate manifest-index-page-followups — valid

opsx

openspec/changes/manifest-index-page-followups/ — proposal, design, specs (REQ-MIPFU-1…6), tasks all included.

Closes #224.

🤖 Generated with Claude Code

[github-actions]

🎉 This PR is included in version 1.0.0-beta.42 🎉

The release is available on:

• v1.0.0-beta.42
• GitHub release

Your semantic-release bot 📦🚀