Update kitops-ts documentation (#1152)

* Update kitops-ts documentation

Update kitops-ts documentation to reflect commit 6002c0868372f87a8cf39f0bc5c0ded5777dc223
in repository https://github.com/kitops-ml/kitops-ts

Signed-off-by: GitHub <noreply@github.com>

* Update types.md

Signed-off-by: Javis V. Pérez <javisperez@gmail.com>

---------

Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: Javis V. Pérez <javisperez@gmail.com>
Co-authored-by: javisperez <4766570@users.noreply.github.com>
Co-authored-by: Javis V. Pérez <javisperez@gmail.com>

Author: 3 people

docs/src/docs/kitops-ts/examples.md

@@ -32,7 +32,7 @@ const yaml = buildKitfile({
   model: {
     name: 'sentiment-classifier',
     path: './model/weights.pt',
-    format: 'pytorch',
+    framework: 'pytorch',
   },
   datasets: [
     { name: 'training-set', path: './data/train.csv', license: 'CC-BY-4.0' },

docs/src/docs/kitops-ts/types.md

@@ -427,31 +427,49 @@ type Package = {
 
 ---
 
+### `LayerCommons`
+
+Base interface extended by all Kitfile layer types. Provides the common `path` and `description` fields.
+
+```typescript
+interface LayerCommons {
+  path: string;
+  description?: string;
+}
+```
+
+| Property | Type | Description |
+|---|---|---|
+| `path` | `string` | Path to the artifact file or directory. |
+| `description` | `string` | Human-readable description. |
+
+---
+
 ### `Model`
 
-Model artifact definition in a Kitfile.
+Model artifact definition in a Kitfile. Extends [`LayerCommons`](#layerbase).
 
 ```typescript
-interface Model {
+interface Model extends LayerCommons {
   name?: string;
-  path?: string;
-  parts?: ModelPart[];
+  framework?: string;
+  version?: string;
   license?: string;
-  description?: string;
-  format?: string;
-  parameters?: Record<string, string | number>;
+  parts?: ModelPart[];
+  parameters?: unknown;
 }
 ```
 
 | Property | Type | Description |
 |---|---|---|
+| `path` | `string` | Path to the model file or directory. *(from `LayerCommons`)* |
+| `description` | `string` | Human-readable description. *(from `LayerCommons`)* |
 | `name` | `string` | Display name for the model. |
-| `path` | `string` | Path to the model file or directory. |
-| `parts` | [`ModelPart[]`](#modelpart) | Sub-parts of a composite model (e.g. split weight files). |
+| `framework` | `string` | ML framework (e.g. `'pytorch'`, `'tensorflow'`). |
+| `version` | `string` | Model version. |
 | `license` | `string` | SPDX license identifier. |
-| `description` | `string` | Human-readable description. |
-| `format` | `string` | Model format (e.g. `'gguf'`, `'safetensors'`). |
-| `parameters` | `Record<string, string \| number>` | Arbitrary model parameters (e.g. context length, quantization). |
+| `parts` | [`ModelPart[]`](#modelpart) | Sub-parts of a composite model (e.g. split weight files). |
+| `parameters` | `unknown` | Arbitrary model parameters. |
 
 ---
 
@@ -461,67 +479,88 @@ A sub-part of a composite model.
 
 ```typescript
 interface ModelPart {
+  name?: string;
   path?: string;
   type?: string;
-  license?: string;
 }
 ```
 
+| Property | Type | Description |
+|---|---|---|
+| `name` | `string` | Display name for this part. |
+| `path` | `string` | Path to the part file. |
+| `type` | `string` | Part type identifier. |
+
 ---
 
 ### `Dataset`
 
-Dataset artifact definition in a Kitfile.
+Dataset artifact definition in a Kitfile. Extends [`LayerCommons`](#layerbase).
 
 ```typescript
-interface Dataset {
+interface Dataset extends LayerCommons {
   name?: string;
-  path?: string;
-  description?: string;
   license?: string;
   parameters?: unknown;
 }
 ```
 
+| Property | Type | Description |
+|---|---|---|
+| `path` | `string` | Path to the dataset file or directory. *(from `LayerCommons`)* |
+| `description` | `string` | Human-readable description. *(from `LayerCommons`)* |
+| `name` | `string` | Display name for the dataset. |
+| `license` | `string` | SPDX license identifier. |
+| `parameters` | `unknown` | Arbitrary dataset parameters. |
+
 ---
 
 ### `Code`
 
-Source code artifact definition in a Kitfile.
+Source code artifact definition in a Kitfile. Extends [`LayerCommons`](#layerbase).
 
 ```typescript
-interface Code {
-  path: string;
-  description: string;
+interface Code extends LayerCommons {
+  license?: string;
 }
 ```
 
+| Property | Type | Description |
+|---|---|---|
+| `path` | `string` | Path to the source code file or directory. *(from `LayerCommons`)* |
+| `description` | `string` | Human-readable description. *(from `LayerCommons`)* |
+| `license` | `string` | SPDX license identifier. |
+
 ---
 
 ### `Doc`
 
-Documentation artifact definition in a Kitfile.
+Documentation artifact definition in a Kitfile. Extends [`LayerCommons`](#layerbase).
 
 ```typescript
-interface Doc {
-  path: string;
-  description: string;
-}
+interface Doc extends LayerCommons {}
 ```
 
+| Property | Type | Description |
+|---|---|---|
+| `path` | `string` | Path to the documentation file or directory. *(from `LayerCommons`)* |
+| `description` | `string` | Human-readable description. *(from `LayerCommons`)* |
+
 ---
 
 ### `Prompt`
 
-Prompt artifact definition in a Kitfile.
+Prompt artifact definition in a Kitfile. Extends [`LayerCommons`](#layerbase).
 
 ```typescript
-interface Prompt {
-  path?: string;
-  description?: string;
-}
+interface Prompt extends LayerCommons {}
 ```
 
+| Property | Type | Description |
+|---|---|---|
+| `path` | `string` | Path to the prompt file or directory. *(from `LayerCommons`)* |
+| `description` | `string` | Human-readable description. *(from `LayerCommons`)* |
+
 ---
 
 ## Manifest Types