@atscript/typescript 0.1.23 → 0.1.24

package/dist/utils.cjs

@@ -778,15 +778,24 @@ function build(def, path, mode) {
 				if (isPhantomType(prop)) continue;
 				const childPath = path ? `${path}.${key}` : key;
 				if (prop.optional) {
-					const childResolved = resolveValue(prop, childPath, mode);
-					if (childResolved !== undefined) data[key] = childResolved.value;
+					if (mode === "example") data[key] = build(prop, childPath, mode);
+else {
+						const childResolved = resolveValue(prop, childPath, mode);
+						if (childResolved !== undefined) data[key] = childResolved.value;
+					}
 					continue;
 				}
 				data[key] = build(prop, childPath, mode);
 			}
 			return data;
 		},
-		array: () => [],
+		array: (d) => {
+			if (mode === "example") {
+				const item = build(d.type.of, `${path}.0`, mode);
+				return item !== undefined ? [item] : [];
+			}
+			return [];
+		},
 		tuple: (d) => d.type.items.map((item, i) => build(item, `${path}.${i}`, mode)),
 		union: (d) => {
 			const first = d.type.items[0];

package/dist/utils.d.ts

@@ -332,7 +332,7 @@ interface TCreateDataOptions {
      * How to resolve values:
      * - `'empty'` — structural defaults only (`''`, `0`, `false`, `[]`, `{}`); optional props skipped
      * - `'default'` — use `@meta.default` annotations; optional props skipped unless annotated
-     * - `'example'` — use `@meta.example` annotations; optional props skipped unless annotated
+     * - `'example'` — use `@meta.example` annotations; optional props always included; arrays get one sample item
      * - `function` — custom resolver per field; optional props skipped unless resolver returns a value
      *
      * @default 'empty'
@@ -345,7 +345,7 @@ interface TCreateDataOptions {
  * Supports four modes:
  * - `'empty'` — structural defaults only; optional props omitted
  * - `'default'` — uses `@meta.default` annotations; optional props omitted unless annotated
- * - `'example'` — uses `@meta.example` annotations; optional props omitted unless annotated
+ * - `'example'` — uses `@meta.example` annotations; optional props always included; arrays get one sample item
  * - `function` — custom resolver; optional props omitted unless resolver returns a value
  *
  * When a `@meta.default` / `@meta.example` value is set on a complex type (object, array)

package/dist/utils.mjs

@@ -777,15 +777,24 @@ function build(def, path, mode) {
 				if (isPhantomType(prop)) continue;
 				const childPath = path ? `${path}.${key}` : key;
 				if (prop.optional) {
-					const childResolved = resolveValue(prop, childPath, mode);
-					if (childResolved !== undefined) data[key] = childResolved.value;
+					if (mode === "example") data[key] = build(prop, childPath, mode);
+else {
+						const childResolved = resolveValue(prop, childPath, mode);
+						if (childResolved !== undefined) data[key] = childResolved.value;
+					}
 					continue;
 				}
 				data[key] = build(prop, childPath, mode);
 			}
 			return data;
 		},
-		array: () => [],
+		array: (d) => {
+			if (mode === "example") {
+				const item = build(d.type.of, `${path}.0`, mode);
+				return item !== undefined ? [item] : [];
+			}
+			return [];
+		},
 		tuple: (d) => d.type.items.map((item, i) => build(item, `${path}.${i}`, mode)),
 		union: (d) => {
 			const first = d.type.items[0];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/typescript",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Atscript: typescript-gen support.",
   "keywords": [
     "annotations",
@@ -64,7 +64,7 @@
     "vitest": "3.2.4"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.23"
+    "@atscript/core": "^0.1.24"
   },
   "build": [
     {},

package/skills/atscript-typescript/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: atscript-typescript
-description: Atscript TypeScript language extension — .as file syntax, code generation, runtime type system, validation, and utilities for the Atscript metadata description language.
+description: Use when working with Atscript (.as files) in TypeScript projects — writing or editing .as interfaces/types/annotations, configuring atscript.config.ts or tsPlugin, understanding generated .d.ts/.js output, using runtime APIs (TAtscriptAnnotatedType, metadata, validators), generating JSON Schema or example data from types, serializing/deserializing annotated types, or running the asc CLI.
 ---
 
 # @atscript/typescript

package/skills/atscript-typescript/utilities.md

@@ -257,12 +257,13 @@ const custom = createDataFromAnnotatedType(User, {
 |------|----------|
 | `'empty'` (default) | Structural defaults: `''`, `0`, `false`, `[]`, `{}`. Optional props omitted |
 | `'default'` | Uses `@meta.default` annotations. Optional props only included if annotated |
-| `'example'` | Uses `@meta.example` annotations. Optional props only included if annotated |
+| `'example'` | Uses `@meta.example` annotations. Optional props always included. Arrays get one sample item |
 | `function` | Custom resolver per field. Return `undefined` to fall through |
 
 ### Behavior Notes
 
-- **Optional properties** are omitted unless the mode provides a value for them
+- **Optional properties** are omitted unless the mode provides a value for them (exception: `'example'` mode always includes all optional props)
+- **Arrays** in `'example'` mode generate one sample item from the element type instead of an empty array
 - **Complex types** (object, array): if a `@meta.default`/`@meta.example` annotation is set and passes validation, the entire subtree is replaced (no recursion into inner props)
 - **Annotation values**: strings are used as-is for string types; everything else is parsed via `JSON.parse`
 - **Unions/Intersections**: defaults to first item's value