Tables is the eighth HTML tool: a read-only tabular view over a
directory of YAML files declared via `tables:` in `.zddc`. Anchor use
case is the Master Deliverables List, where each row is one
`<tracking>.yaml` under `Archive/<Party>/MDL/`. Rows click through to
the existing form renderer for editing.
Schema (zddc/internal/zddc/file.go)
- New `Tables map[string]string` on ZddcFile. Map key becomes the URL
stem (`tables[MDL]` → `<dir>/MDL.table.html`); the value is a path
relative to the .zddc pointing at a `*.table.yaml` spec describing
columns + the rows directory. No upward cascade in v1 — each
directory hosting a table declares it directly.
Server handler (zddc/internal/handler/tablehandler.go)
- `RecognizeTableRequest` matches GET `/<dir>/<name>.table.html`
against the cascade's `tables:` declarations. Dispatch routes
table requests before the form-system intercept.
- `ServeTable` ACL-gates with `policy.ActionRead` and serves the
embedded `tables.html` template; client walks the directory itself
via the listing JSON or FS Access API.
- tables.html embedded via //go:embed — same pattern as form.html.
Frontend (tables/)
- Vanilla JS: app/context/util/filters/sort/render/main modules.
- Reads spec + row YAML files via window.zddc.source (HTTP polyfill
or local FS handle); js-yaml 4.1.0 vendored in shared/vendor for
client-side parsing.
- Sample fixtures under tables/sample/ for local testing.
Build + CI
- Lockstep build registers tables alongside the other 7 tools (HTML
output, embed mirror, versions.txt, release-output, tags).
- Playwright project added; `npx playwright test --project=tables`
is part of `npm test`.
Drive-by: rename mdedit Playwright selectors `#select-directory` →
`#addDirectoryBtn` to fix three pre-existing failing tests.
Drive-by: ignore locally-built `zddc/zddc-server` binary so it doesn't
get accidentally staged.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
64 lines
2.1 KiB
JavaScript
64 lines
2.1 KiB
JavaScript
(function (app) {
|
|
'use strict';
|
|
|
|
// A filter is per-column and has one of two shapes:
|
|
// - free-text: { kind: 'contains', value: '<string>' }
|
|
// - enum: { kind: 'enum', value: ['<choice>', ...] }
|
|
// An empty value (empty string or empty array) matches everything.
|
|
|
|
function isEnumColumn(col) {
|
|
return Array.isArray(col.enum) && col.enum.length > 0;
|
|
}
|
|
|
|
function defaultFilterFor(col) {
|
|
return isEnumColumn(col) ? { kind: 'enum', value: [] } : { kind: 'contains', value: '' };
|
|
}
|
|
|
|
function rowMatches(filter, cellValue) {
|
|
if (filter.kind === 'enum') {
|
|
if (!Array.isArray(filter.value) || filter.value.length === 0) {
|
|
return true;
|
|
}
|
|
const s = cellValue == null ? '' : String(cellValue);
|
|
return filter.value.indexOf(s) !== -1;
|
|
}
|
|
// contains
|
|
if (!filter.value) {
|
|
return true;
|
|
}
|
|
const needle = String(filter.value).toLowerCase();
|
|
const hay = cellValue == null ? '' : String(cellValue).toLowerCase();
|
|
return hay.indexOf(needle) !== -1;
|
|
}
|
|
|
|
function isEmpty(filter) {
|
|
if (filter.kind === 'enum') {
|
|
return !Array.isArray(filter.value) || filter.value.length === 0;
|
|
}
|
|
return !filter.value;
|
|
}
|
|
|
|
function apply(rows, columns, filterMap, resolveField) {
|
|
return rows.filter(function (row) {
|
|
for (let i = 0; i < columns.length; i++) {
|
|
const col = columns[i];
|
|
const filter = filterMap[col.field];
|
|
if (!filter || isEmpty(filter)) {
|
|
continue;
|
|
}
|
|
const cellValue = resolveField(row.data, col.field);
|
|
if (!rowMatches(filter, cellValue)) {
|
|
return false;
|
|
}
|
|
}
|
|
return true;
|
|
});
|
|
}
|
|
|
|
app.modules.filters = {
|
|
defaultFilterFor: defaultFilterFor,
|
|
isEnumColumn: isEnumColumn,
|
|
isEmpty: isEmpty,
|
|
apply: apply
|
|
};
|
|
})(window.tablesApp);
|