@atscript/typescript 0.1.27 → 0.1.28

package/dist/utils.cjs

@@ -901,6 +901,17 @@ function mergeJsonSchemas(types) {
 		if (prop.validator({ unknownProps: "ignore" }).validate(raw, true)) return { value: raw };
 		return undefined;
 	}
+	if (mode === "db") {
+		const dbValue = prop.metadata.get("db.default.value");
+		if (dbValue !== undefined) {
+			const parsed$1 = parseRawValue(dbValue, prop);
+			if (parsed$1 !== undefined && prop.validator({ unknownProps: "ignore" }).validate(parsed$1, true)) return { value: parsed$1 };
+			return undefined;
+		}
+		const dbFn = prop.metadata.get("db.default.fn");
+		if (dbFn !== undefined) return { value: dbFn };
+		return undefined;
+	}
 	const metaKey = mode === "default" ? "meta.default" : "meta.example";
 	const rawStr = prop.metadata.get(metaKey);
 	if (rawStr === undefined) return undefined;

package/dist/utils.d.ts

@@ -354,19 +354,21 @@ interface TCreateDataOptions {
      * - `'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 always included; arrays get one sample item
+     * - `'db'` — use `@db.default.value` (parsed) or `@db.default.fn` (returns fn name string); optional props skipped unless annotated
      * - `function` — custom resolver per field; optional props skipped unless resolver returns a value
      *
      * @default 'empty'
      */
-    mode?: 'empty' | 'default' | 'example' | TValueResolver;
+    mode?: 'empty' | 'default' | 'example' | 'db' | TValueResolver;
 }
 /**
  * Creates a data object from an ATScript annotated type definition.
  *
- * Supports four modes:
+ * Supports five 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 always included; arrays get one sample item
+ * - `'db'` — uses `@db.default.value` (parsed) or `@db.default.fn` (fn name string); optional props omitted unless annotated
  * - `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

@@ -900,6 +900,17 @@ function mergeJsonSchemas(types) {
 		if (prop.validator({ unknownProps: "ignore" }).validate(raw, true)) return { value: raw };
 		return undefined;
 	}
+	if (mode === "db") {
+		const dbValue = prop.metadata.get("db.default.value");
+		if (dbValue !== undefined) {
+			const parsed$1 = parseRawValue(dbValue, prop);
+			if (parsed$1 !== undefined && prop.validator({ unknownProps: "ignore" }).validate(parsed$1, true)) return { value: parsed$1 };
+			return undefined;
+		}
+		const dbFn = prop.metadata.get("db.default.fn");
+		if (dbFn !== undefined) return { value: dbFn };
+		return undefined;
+	}
 	const metaKey = mode === "default" ? "meta.default" : "meta.example";
 	const rawStr = prop.metadata.get(metaKey);
 	if (rawStr === undefined) return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/typescript",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "description": "Atscript: typescript-gen support.",
   "keywords": [
     "annotations",
@@ -57,14 +57,14 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@moostjs/event-cli": "^0.6.0",
-    "moost": "^0.6.0"
+    "@moostjs/event-cli": "^0.6.2",
+    "moost": "^0.6.2"
   },
   "devDependencies": {
     "vitest": "3.2.4"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.27"
+    "@atscript/core": "^0.1.28"
   },
   "build": [
     {},

package/skills/atscript-typescript/SKILL.md

@@ -15,7 +15,7 @@ Read the domain file that matches the task. Do not load all files — only what
 | ------------------------ | -------------------------------- | ------------------------------------------------------------------------------------------- |
 | Setup & configuration    | [core.md](core.md)               | Installing, configuring `atscript.config.ts`, using the `tsPlugin`, running the CLI         |
 | `.as` file syntax        | [syntax.md](syntax.md)           | Writing `.as` files — interfaces, types, imports/exports, property syntax                   |
-| Annotations & primitives | [annotations.md](annotations.md) | Using built-in `@meta.*`/`@expect.*` annotations, defining custom annotations or primitives |
+| Annotations & primitives | [annotations.md](annotations.md) | Using built-in `@meta.*`/`@expect.*`/`@ui.*`/`@db.*` annotations, defining custom annotations or primitives |
 | Code generation          | [codegen.md](codegen.md)         | Understanding what `.d.ts` and `.js` files are generated, `atscript.d.ts` global types      |
 | Runtime type system      | [runtime.md](runtime.md)         | Reading/writing metadata, walking type definitions, understanding `TAtscriptAnnotatedType`  |
 | Validation               | [validation.md](validation.md)   | Validating data, type guards, error handling, custom validator plugins                      |

package/skills/atscript-typescript/annotations.md

@@ -9,16 +9,15 @@
 | Annotation            | Arguments                  | Description                                                        |
 | --------------------- | -------------------------- | ------------------------------------------------------------------ |
 | `@meta.label`         | `text: string`             | Human-readable label for UI, logs, documentation                   |
-| `@meta.id`            | `name?: string` (optional) | Mark field as unique identifier; optional custom name              |
+| `@meta.id`            | _(none)_                   | Mark field as unique identifier; multiple fields form composite PK |
 | `@meta.description`   | `text: string`             | Detailed description of a field or entity                          |
 | `@meta.documentation` | `text: string`             | Multi-line docs (Markdown). Multiple allowed — each appends        |
-| `@meta.placeholder`   | `text: string`             | Placeholder for UI input fields (props/types only)                 |
 | `@meta.sensitive`     | _(none)_                   | Mark as sensitive (passwords, API keys). Strips from serialization |
 | `@meta.readonly`      | _(none)_                   | Mark as read-only                                                  |
 | `@meta.required`      | `message?: string`         | Required field. Strings: non-whitespace. Booleans: must be `true`  |
 | `@meta.default`       | `value: string`            | Default value (strings as-is, others parsed as JSON)               |
 | `@meta.example`       | `value: string`            | Example value (strings as-is, others parsed as JSON)               |
-| `@meta.isKey`         | _(none)_                   | Mark field as key inside array (string/number types only)          |
+| `@expect.array.key`   | _(none)_                   | Mark field as key inside array (string/number types only)          |
 
 ### `@expect.*` — Validation Constraints
 
@@ -31,6 +30,24 @@
 | `@expect.int`       | _(none)_                                                | number        | Must be integer                                        |
 | `@expect.pattern`   | `pattern: string`, `flags?: string`, `message?: string` | string        | Regex validation. **Multiple allowed** (all must pass) |
 
+### `@ui.*` — UI / Presentation Hints
+
+| Annotation        | Arguments                      | Description                                    |
+| ----------------- | ------------------------------ | ---------------------------------------------- |
+| `@ui.placeholder` | `text: string`                 | Input placeholder text                         |
+| `@ui.component`   | `name: string`                 | UI component hint (`"select"`, `"datepicker"`) |
+| `@ui.hidden`      | _(none)_                       | Hide from UI forms/tables                      |
+| `@ui.group`       | `name: string`                 | Group fields into form sections                |
+| `@ui.order`       | `order: number`                | Display order (lower = first)                  |
+| `@ui.width`       | `width: string`                | Layout hint (`"half"`, `"full"`, `"third"`)    |
+| `@ui.icon`        | `name: string`                 | Icon hint                                      |
+| `@ui.hint`        | `text: string`                 | Help text / tooltip                            |
+| `@ui.disabled`    | _(none)_                       | Non-interactive field                          |
+| `@ui.type`        | `type: string`                 | Input type (`"textarea"`, `"password"`, etc.)  |
+| `@ui.attr`        | `key: string`, `value: string` | Arbitrary attribute (**multiple**, append)      |
+| `@ui.class`       | `names: string`                | CSS class names (**multiple**, append)          |
+| `@ui.style`       | `css: string`                  | Inline CSS styles (**multiple**, append)        |
+
 ### `@emit.*` — Build-time Directives
 
 | Annotation         | Applies To | Description                                     |
@@ -49,21 +66,21 @@ export default defineConfig({
   plugins: [tsPlugin()],
   annotations: {
     // Namespaced annotations use nested objects
-    ui: {
-      // @ui.component "DatePicker"
-      component: new AnnotationSpec({
-        argument: { name: 'name', type: 'string' },
-        description: 'UI component to render this field',
+    grid: {
+      // @grid.column 200
+      column: new AnnotationSpec({
+        argument: { name: 'width', type: 'number' },
+        description: 'Table column width in data grid',
       }),
 
-      // @ui.hidden (no arguments — boolean flag)
+      // @grid.hidden (no arguments — boolean flag)
       hidden: new AnnotationSpec({
-        description: 'Hide this field in the UI',
+        description: 'Hide column in data grid',
       }),
 
-      // @ui.order 5
-      order: new AnnotationSpec({
-        argument: { name: 'position', type: 'number' },
+      // @grid.sortable
+      sortable: new AnnotationSpec({
+        description: 'Allow sorting by this column',
       }),
     },