@orkestrel/table 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orkestrel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# @orkestrel/table
+
+The environment-agnostic tabular document for the `@orkestrel` line — a schema of four column cells,
+the rows held against it, and one lens of sort, filter, and page that decides which of them the view
+shows. A grid, a report, a terminal listing, and a CSV export hold the same thing in different
+places, so this package ships what they share and draws none of it. Every row carries its own
+identity in a column the schema names, so a pick survives a re-sort; `view` and every tally are
+worked out on read, so no second copy of an answer can go stale; and six budgets bound what one
+schema may retain, so a document that arrives from a wire costs a known maximum before anything
+decides to trust it.
+Built on `@orkestrel/contract` and `@orkestrel/emitter`.
+
+## Install
+
+```sh
+npm install @orkestrel/table
+```
+
+## Requirements
+
+- Node.js >= 22.12
+- Host-independent: no `node:*`, no DOM. Ships dual ESM+CJS builds.
+
+## Usage
+
+Declare the columns, hold the rows, and read the ones to draw:
+
+```ts
+import { createTable } from '@orkestrel/table'
+
+const table = createTable(
+	{
+		label: 'People',
+		key: 'id',
+		columns: [
+			{ cell: 'text', key: 'id', label: 'Reference' },
+			{ cell: 'text', key: 'name', label: 'Name' },
+			{ cell: 'number', key: 'age', label: 'Age' },
+			{
+				cell: 'choice',
+				key: 'status',
+				label: 'Status',
+				choices: [
+					{ value: 'draft', label: 'Draft' },
+					{ value: 'live', label: 'Live' },
+				],
+			},
+		],
+	},
+	{
+		rows: [
+			{ id: '1', name: 'Ada', age: 36, status: 'live' },
+			{ id: '2', name: 'Grace', age: 45, status: 'draft' },
+			{ id: '3', name: 'Alan', age: 41, status: 'live' },
+		],
+		limit: 2,
+		on: { select: (keys) => console.log(keys.size, 'picked') },
+	},
+)
+
+table.filter.set({ column: 'status', operator: 'equals', value: 'live' })
+table.sort.set({ column: 'age', direction: 'descending' })
+
+table.count // 2 — the rows the filter admits
+table.view.map((row) => row.name) // ['Alan', 'Ada']
+
+table.selection.toggle('1')
+table.selection.keys.has('1') // true — a key, so it survives the next sort
+```
+
+## Guide
+
+See [guides/table.md](./guides/table.md) for the documented surface — the four column cells and what
+each one fixes, the required identity column and the refusals built on it, the lens of sort, filter,
+and page and the order it applies in, the eight events and when each one stays silent, the
+serialize/parse wire boundary and what never crosses it, the budgets that bound a schema, and the
+concept inventory of what this package leaves to the layer above.
+
+## Package
+
+Published as one entry point per the `exports` field in `package.json`: `.`, the host-independent
+core. It ships dual ESM+CJS builds with declarations for both.
+
+## Development
+
+```sh
+npm install
+npm test
+```
+
+## License
+
+MIT © [Orkestrel](https://github.com/orkestrel) — see [LICENSE](./LICENSE).