docs(angular): add jsdoc and regenerate api reference

Author: riccardoperra

docs/config.json

@@ -40,13 +40,11 @@
             },
             {
               "label": "Rendering components",
-              "to": "framework/angular/guide/rendering",
-              "badge": "angular"
+              "to": "framework/angular/guide/rendering"
             },
             {
               "label": "Table composition",
-              "to": "framework/angular/guide/composable-tables",
-              "badge": "angular"
+              "to": "framework/angular/guide/table-composition"
             }
           ]
         },
@@ -323,7 +321,7 @@
           "children": [
             {
               "label": "Angular API Reference",
-              "to": "framework/angular/reference/index"
+              "to": "framework/angular/reference"
             },
             {
               "label": "injectTable",
@@ -353,6 +351,26 @@
               "label": "injectTableHeaderContext",
               "to": "framework/angular/reference/functions/injectTableHeaderContext"
             },
+            {
+              "label": "Interface / FlexRenderComponent",
+              "to": "framework/angular/reference/interfaces/FlexRenderComponent"
+            },
+            {
+              "label": "Type / AngularTable",
+              "to": "framework/angular/reference/type-aliases/AngularTable"
+            },
+            {
+              "label": "Type / AppAngularTable",
+              "to": "framework/angular/reference/type-aliases/AppAngularTable"
+            },
+            {
+              "label": "Type / FlexRenderContent",
+              "to": "framework/angular/reference/type-aliases/FlexRenderContent"
+            },
+                        {
+              "label": "Type / FlexRenderInputContent",
+              "to": "framework/angular/reference/type-aliases/FlexRenderContent"
+            },
             {
               "label": "Directive / FlexRender",
               "to": "framework/angular/reference/variables/FlexRender"

docs/framework/angular/angular-table.md

@@ -33,10 +33,16 @@ import {
   createColumnHelper,
   injectTable,
   type ColumnDef,
+  rowPaginationFeature,
+  stockFeatures
 } from '@tanstack/angular-table'
 
+// Register all table core features
+const _features = tableFeatures(stockFeatures);
+// ...or register only your needed features 
 const _features = tableFeatures({
-  // table features
+  rowPaginationFeature,
+  // ...all other features
 })
 
 const columnHelper = createColumnHelper<typeof _features, Person>()
@@ -74,10 +80,10 @@ export class AppComponent {
     })
   }
 }
-
-// ...render your table in template
 ```
 
+See [injectTable API Reference](reference/functions/injectTable)
+
 ### `createTableHook`
 
 `createTableHook` is the Angular composition API for building reusable table infrastructure.
@@ -90,7 +96,7 @@ At runtime, `createTableHook` wraps `injectTable` and returns typed helpers such
 - `createAppColumnHelper` for strongly typed column definitions
 - pre-typed context helpers (`injectTableContext`, `injectTableCellContext`, `injectTableHeaderContext`, `injectFlexRenderCellContext`, `injectFlexRenderHeaderContext`)
 
-For full setup and patterns, see the [Composable Tables (Angular) Guide](./guide/composable-tables.md).
+For full setup and patterns, see the [Table Composition Guide](./guide/table-composition.md).
 
 ### `FlexRender`
 
@@ -105,7 +111,7 @@ It supports the same content kinds as Angular rendering:
 
 Column render functions (`header`, `cell`, `footer`) run in Angular injection context, so you can use `inject()` and signals directly in render logic.
 
-For complete rendering details (`*flexRender`, shorthand directives, `flexRenderComponent`, `TemplateRef`, component inputs/outputs, and `injectFlexRenderContext`), see the [Rendering (Angular) Guide](./guide/rendering.md).
+For complete rendering details (`*flexRender`, shorthand directives, `flexRenderComponent`, `TemplateRef`, component inputs/outputs, and `injectFlexRenderContext`), see the [Rendering components Guide](./guide/rendering.md).
 
 ### Context helpers and directives
 
@@ -116,3 +122,7 @@ For complete rendering details (`*flexRender`, shorthand directives, `flexRender
 - `TanStackTableHeader` + `injectTableHeaderContext()`
 
 These APIs provide signal-based context values and are available from nearest directives or from `*flexRender`-rendered components when matching props are present.
+
+### Full API Reference
+
+See [Angular API Reference](reference/index.md)

…ework/angular/guide/composable-tables.md …ework/angular/guide/table-composition.mddocs/framework/angular/guide/composable-tables.md renamed to docs/framework/angular/guide/table-composition.md docs/framework/angular/guide/composable-tables.md renamed to docs/framework/angular/guide/table-composition.md

@@ -284,5 +284,5 @@ export const {
 
 ## Examples
 
-- [Composable Tables](../angular/composable-tables) — full example with two tables sharing the same `createTableHook` configuration, including table/cell/header component registries, sorting, filtering, and pagination.
-- [Basic App Table](../angular/basic-app-table) — minimal example using `createTableHook` with no pre-bound components.
+- [Composable Tables](../examples/composable-tables) — full example with two tables sharing the same `createTableHook` configuration, including table/cell/header component registries, sorting, filtering, and pagination.
+- [Basic App Table](../examples/basic-app-table) — minimal example using `createTableHook` with no pre-bound components.

docs/framework/angular/reference/functions/injectTable.md

@@ -9,7 +9,18 @@ title: injectTable
 function injectTable<TFeatures, TData, TSelected>(options, selector): AngularTable<TFeatures, TData, TSelected>;
 ```
 
-Defined in: [injectTable.ts:40](https://github.com/TanStack/table/blob/main/packages/angular-table/src/injectTable.ts#L40)
+Defined in: [injectTable.ts:96](https://github.com/TanStack/table/blob/main/packages/angular-table/src/injectTable.ts#L96)
+
+Creates and returns an Angular-reactive table instance.
+
+The initializer is intentionally re-evaluated whenever any signal read inside it changes.
+This is how the adapter keeps the table in sync with Angular's reactivity model.
+
+Because of that behavior, keep expensive/static values (for example `columns`, feature setup, row models)
+as stable references outside the initializer, and only read reactive state (`data()`, pagination/filter/sorting signals, etc.) 
+inside it.
+
+The returned table is also signal-reactive: table state and table APIs are wired for Angular signals, so you can safely consume table methods inside `computed(...)` and `effect(...)`.
 
 ## Type Parameters
 
@@ -38,3 +49,48 @@ Defined in: [injectTable.ts:40](https://github.com/TanStack/table/blob/main/pack
 ## Returns
 
 [`AngularTable`](../type-aliases/AngularTable.md)\<`TFeatures`, `TData`, `TSelected`\>
+
+An Angular-reactive TanStack Table instance.
+
+## Example
+
+1. Register the table features you need
+```ts
+// Register only the features you need
+import {tableFeatures, rowPaginationFeature} from '@tanstack/angular-table';
+const _features = tableFeatures({ 
+ rowPaginationFeature,
+ // ...all other features you need
+})
+
+// Use all table core features
+import {stockFeatures} from '@tanstack/angular-table';
+const _features = tableFeatures(stockFeatures);
+```
+2. Prepare the table columns
+```ts
+import {ColumnDef} from '@tanstack/angular-table';
+
+type MyData = {}
+
+const columns: ColumnDef<typeof _features, MyData>[] = [
+  // ...column definitions
+]
+
+// or using createColumnHelper
+import {createColumnHelper} from '@tanstack/angular-table';
+const columnHelper = createColumnHelper<typeof _features, MyData>();
+const columns = columnHelper.columns([
+ columnHelper.accessor(...),
+ // ...other columns
+]) 
+```
+3. Create the table instance with `injectTable`
+```ts
+const table = injectTable(() => {
+  // ...table options,
+  _features,
+  columns: columns,
+  data: myDataSignal(),
+})
+```

docs/framework/angular/reference/index.md

@@ -36,7 +36,6 @@ title: "@tanstack/angular-table"
 
 ## Variables
 
-- [angularReactivityFeature](variables/angularReactivityFeature.md)
 - [FlexRender](variables/FlexRender.md)
 - [TanStackTableCellToken](variables/TanStackTableCellToken.md)
 - [TanStackTableHeaderToken](variables/TanStackTableHeaderToken.md)

docs/framework/angular/reference/interfaces/AngularReactivityFlags.md

@@ -5,7 +5,7 @@ title: AngularReactivityFlags
 
 # Interface: AngularReactivityFlags
 
-Defined in: [angularReactivityFeature.ts:40](https://github.com/TanStack/table/blob/main/packages/angular-table/src/angularReactivityFeature.ts#L40)
+Defined in: [angularReactivityFeature.ts:55](https://github.com/TanStack/table/blob/main/packages/angular-table/src/angularReactivityFeature.ts#L55)
 
 Fine-grained configuration for Angular reactivity.
 
@@ -16,6 +16,22 @@ objects are wrapped with signal-aware access.
 - `false` disables wrapping entirely for that object type.
 - a function allows customizing the skip rules (see SkipPropertyFn).
 
+## Example
+
+```ts
+const table = injectTable(() => {
+ // ...table options,
+ reactivity: {
+   // fine-grained control over which table objects have reactive properties,
+   // and which properties are wrapped
+   header: true,
+   column: true,
+   row: true,
+   cell: true,
+ }
+})
+```
+
 ## Properties
 
 ### cell
@@ -24,7 +40,7 @@ objects are wrapped with signal-aware access.
 cell: boolean | SkipPropertyFn;
 ```
 
-Defined in: [angularReactivityFeature.ts:48](https://github.com/TanStack/table/blob/main/packages/angular-table/src/angularReactivityFeature.ts#L48)
+Defined in: [angularReactivityFeature.ts:63](https://github.com/TanStack/table/blob/main/packages/angular-table/src/angularReactivityFeature.ts#L63)
 
 Controls reactive wrapping for `Cell` instances.
 
@@ -36,7 +52,7 @@ Controls reactive wrapping for `Cell` instances.
 column: boolean | SkipPropertyFn;
 ```
 
-Defined in: [angularReactivityFeature.ts:44](https://github.com/TanStack/table/blob/main/packages/angular-table/src/angularReactivityFeature.ts#L44)
+Defined in: [angularReactivityFeature.ts:59](https://github.com/TanStack/table/blob/main/packages/angular-table/src/angularReactivityFeature.ts#L59)
 
 Controls reactive wrapping for `Column` instances.
 
@@ -48,7 +64,7 @@ Controls reactive wrapping for `Column` instances.
 header: boolean | SkipPropertyFn;
 ```
 
-Defined in: [angularReactivityFeature.ts:42](https://github.com/TanStack/table/blob/main/packages/angular-table/src/angularReactivityFeature.ts#L42)
+Defined in: [angularReactivityFeature.ts:57](https://github.com/TanStack/table/blob/main/packages/angular-table/src/angularReactivityFeature.ts#L57)
 
 Controls reactive wrapping for `Header` instances.
 
@@ -60,6 +76,6 @@ Controls reactive wrapping for `Header` instances.
 row: boolean | SkipPropertyFn;
 ```
 
-Defined in: [angularReactivityFeature.ts:46](https://github.com/TanStack/table/blob/main/packages/angular-table/src/angularReactivityFeature.ts#L46)
+Defined in: [angularReactivityFeature.ts:61](https://github.com/TanStack/table/blob/main/packages/angular-table/src/angularReactivityFeature.ts#L61)
 
 Controls reactive wrapping for `Row` instances.

docs/framework/angular/reference/type-aliases/FlexRenderContent.md

@@ -19,7 +19,10 @@ type FlexRenderContent<TProps> =
   | undefined;
 ```
 
-Defined in: [flex-render/renderer.ts:36](https://github.com/TanStack/table/blob/main/packages/angular-table/src/flex-render/renderer.ts#L36)
+Defined in: [flex-render/renderer.ts:40](https://github.com/TanStack/table/blob/main/packages/angular-table/src/flex-render/renderer.ts#L40)
+
+Content supported by the `flexRender` directive when declaring
+a table column header/cell.
 
 ## Type Parameters
 

docs/framework/angular/reference/type-aliases/FlexRenderInputContent.md

@@ -14,7 +14,9 @@ type FlexRenderInputContent<TProps> =
   | undefined;
 ```
 
-Defined in: [flex-render/renderer.ts:46](https://github.com/TanStack/table/blob/main/packages/angular-table/src/flex-render/renderer.ts#L46)
+Defined in: [flex-render/renderer.ts:53](https://github.com/TanStack/table/blob/main/packages/angular-table/src/flex-render/renderer.ts#L53)
+
+Input content supported by the `flexRender` directives.
 
 ## Type Parameters
 

docs/framework/angular/reference/variables/FlexRender.md

@@ -9,6 +9,13 @@ title: FlexRender
 const FlexRender: readonly [typeof FlexRenderDirective, typeof FlexRenderCell];
 ```
 
-Defined in: [index.ts:20](https://github.com/TanStack/table/blob/main/packages/angular-table/src/index.ts#L20)
+Defined in: [index.ts:25](https://github.com/TanStack/table/blob/main/packages/angular-table/src/index.ts#L25)
 
 Constant helper to import FlexRender directives.
+
+You should prefer to use this constant over importing the directives separately,
+as it ensures you always have the correct set of directives over library updates.
+
+## See
+
+[FlexRenderDirective](../classes/FlexRenderDirective.md) and [FlexRenderCell](../classes/FlexRenderCell.md) for more details on the directives included in this export.