tjs-lang 0.5.2 → 0.5.4

package/dist/src/lang/emitters/js.d.ts

@@ -150,7 +150,7 @@ interface SafetyOptions {
  *   if (typeof input !== 'object' || input === null ||
  *       typeof input.x !== 'number' ||
  *       typeof input.y !== 'number') {
- *     return { $error: true, message: '...', path: 'funcName.input' }
+ *     return __tjs.typeError('funcName.input', 'object', input)
  *   }
  */
 export declare function generateInlineValidation(funcName: string, paramName: string, shape: Record<string, TypeDescriptor>, requiredFields: Set<string>): string;
@@ -162,7 +162,7 @@ export declare function generateInlineValidation(funcName: string, paramName: st
  *   const _original_funcName = funcName
  *   funcName = function(__input) {
  *     if (typeof __input !== 'object' || __input === null || ...) {
- *       return { $error: true, message: '...', path: '...' }
+ *       return __tjs.typeError('funcName.input', 'object', __input)
  *     }
  *     return _original_funcName.call(this, __input)
  *   }

package/dist/src/lang/inference.d.ts

@@ -6,8 +6,8 @@
  *   10 -> { kind: 'number' }
  *   ['string'] -> { kind: 'array', items: { kind: 'string' } }
  *   { name: 'string' } -> { kind: 'object', shape: { name: { kind: 'string' } } }
- *   'string' || null -> { kind: 'string', nullable: true }
- *   'string' || 0 -> { kind: 'union', members: [{ kind: 'string' }, { kind: 'number' }] }
+ *   'string' | null -> { kind: 'string', nullable: true }
+ *   'string' | 0 -> { kind: 'union', members: [{ kind: 'string' }, { kind: 'number' }] }
  */
 import type { Expression, Pattern } from 'acorn';
 import type { TypeDescriptor, ParameterDescriptor } from './types';

package/dist/src/test-examples.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Helpers for loading and testing playground example markdown files.
+ *
+ * Usage:
+ *   import { loadExample, loadExamples } from './test-examples'
+ *
+ *   const ex = loadExample('guides/examples/tjs/wasm-starfield.md')
+ *   // ex.code     — the source code from the first code block
+ *   // ex.language — 'tjs', 'ajs', 'javascript', etc.
+ *   // ex.title    — from the markdown # heading
+ *   // ex.metadata — parsed JSON from <!--{...}--> comment
+ *
+ *   const all = loadExamples('guides/examples/tjs')
+ *   // array of all examples in that directory
+ */
+export interface ExampleFile {
+    /** Absolute or relative path to the source .md file */
+    path: string;
+    /** Title from the first # heading */
+    title: string;
+    /** Description — first paragraph between title and code block */
+    description: string;
+    /** Source code from the first fenced code block */
+    code: string;
+    /** Language tag from the code fence (e.g. 'tjs', 'ajs', 'javascript') */
+    language: string;
+    /** Parsed metadata from the <!--{...}--> comment, if present */
+    metadata: Record<string, any>;
+}
+/**
+ * Load a single example from a markdown file.
+ */
+export declare function loadExample(filePath: string): ExampleFile;
+/**
+ * Load all .md examples from a directory.
+ */
+export declare function loadExamples(dirPath: string): ExampleFile[];
+/**
+ * Parse example content from markdown source.
+ */
+export declare function parseExample(content: string, filePath?: string): ExampleFile;