@taylordb/query-builder 0.17.0 → 0.18.1

package/docs/field-types.md

@@ -1,6 +1,23 @@
 # Field Types
 
-Every column in a TaylorDB table is represented by a strongly-typed column type. These types encode what value you can write on insert/update, what value you read back on select, and which filter operators are valid for that field.
+Every column in a TaylorDB table is represented by a runtime field descriptor and an inferred TypeScript column type. The runtime descriptor is emitted in `taylorSchema` and can be inspected by applications for validation or UI. `InferTaylorDatabase<typeof taylorSchema>` maps those descriptors to the strongly-typed column types used by the query builder.
+
+```ts
+export const taylorSchema = defineTaylorSchema({
+  tasks: {
+    title: textField({ required: true }),
+    status: selectField({
+      required: false,
+      mode: 'single',
+      options: ['Todo', 'Done'] as const,
+    }),
+  },
+});
+
+export type TaylorDatabase = InferTaylorDatabase<typeof taylorSchema>;
+```
+
+Available runtime helpers: `textField`, `numberField`, `checkboxField`, `dateField`, `searchField`, `linkField`, `attachmentField`, `selectField`, `autoNumberField`, and `autoDateField`.
 
 ## Column type anatomy
 
@@ -130,10 +147,11 @@ Same filter operators and aggregations as `DateColumnType`.
 
 ---
 
-## Single select — `SingleSelectColumnType<Options, IsRequired>`
+## Single select — `selectField({ mode: 'single' })`
 
 - **Select / Insert / Update**: `Options[number]` — one of the allowed string values
-- `Options` is the `typeof YourTableFieldOptions` const generated by the CLI
+- `Options` is the literal `options` array on the runtime field descriptor
+- Inferred column type: `SingleSelectColumnType<Options, IsRequired>`
 
 **Available filter operators**
 
@@ -151,9 +169,10 @@ Same filter operators and aggregations as `DateColumnType`.
 
 ---
 
-## Multi select — `MultiSelectColumnType<Options, IsRequired>`
+## Multi select — `selectField({ mode: 'multi' })`
 
 - **Select / Insert / Update**: `Options[number][]` — array of allowed string values
+- Inferred column type: `MultiSelectColumnType<Options, IsRequired>`
 
 Same filter operators as `SingleSelectColumnType`.
 
@@ -213,3 +232,23 @@ Read-only computed field.
 | `containsStrict` | `string` |
 | `isEmpty` | _(no value)_ |
 | `isNotEmpty` | _(no value)_ |
+
+## Runtime Descriptor Shape
+
+All field helpers return plain objects with at least:
+
+| Property | Meaning |
+|----------|---------|
+| `type` | Runtime field kind such as `'text'`, `'number'`, `'select'`, `'link'` |
+| `required` | Whether the field is required by the TaylorDB schema |
+| `insertable` | Whether application code may write the field on insert |
+| `updatable` | Whether application code may write the field on update |
+
+Additional metadata is included where useful:
+
+| Field helper | Extra metadata |
+|--------------|----------------|
+| `selectField` | `mode: 'single' \| 'multi'`, `options: readonly string[]` |
+| `linkField` | `linkedTo: string` |
+| `attachmentField` | `linkedTo: 'attachmentTable'` |
+| `autoNumberField`, `autoDateField` | `insertable: false`, `updatable: false` |

package/llm.txt

@@ -1,11 +1,11 @@
 # @taylordb/query-builder — LLM Documentation Index
 
-This package is the TypeScript query builder for TaylorDB. It provides a fluent, type-safe API for reading and writing data. Use `createQueryBuilder<TaylorDatabase>(config)` as the entry point — the `TaylorDatabase` type is generated by `@taylordb/cli`.
+This package is the TypeScript query builder for TaylorDB. It provides a fluent, type-safe API for reading and writing data. Use `createQueryBuilder<TaylorDatabase>(config)` as the entry point. `@taylordb/cli` generates a runtime `taylorSchema` object and `export type TaylorDatabase = InferTaylorDatabase<typeof taylorSchema>`.
 
 ## Documentation
 
 - [Field Types](./docs/field-types.md)
-  All column types (`TextColumnType`, `NumberColumnType`, `DateColumnType`, `CheckboxColumnType`, `SingleSelectColumnType`, `MultiSelectColumnType`, `LinkColumnType`, `AttachmentColumnType`, `SearchColumnType`, auto-generated variants). What value each type accepts on insert/update, what is returned on select, and which filter operators are available per type.
+  Runtime field helpers (`textField`, `numberField`, `checkboxField`, `dateField`, `searchField`, `linkField`, `attachmentField`, `selectField`, `autoNumberField`, `autoDateField`), how `InferTaylorDatabase` maps descriptors to column types, what value each type accepts on insert/update, what is returned on select, and which filter operators are available per type.
 
 - [Insert](./docs/insert.md)
   How to create records using `insertInto().values().returning().execute()`. Single and batch inserts, the default return value, how attachment and link fields are handled on insert, and which tables cannot be inserted into.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taylordb/query-builder",
-  "version": "0.17.0",
+  "version": "0.18.1",
   "description": "A type-safe query builder for TaylorDB",
   "private": false,
   "main": "./dist/cjs/index.js",
@@ -31,7 +31,7 @@
     "lodash": "^4.17.21",
     "socket.io-client": "^4.8.1",
     "zod": "^4.1.12",
-    "@taylordb/shared": "0.17.0"
+    "@taylordb/shared": "0.18.1"
   },
   "devDependencies": {
     "@types/eventemitter3": "^2.0.4",