@invinite-org/chartlang-compiler 1.0.1 → 1.2.0

package/dist/typesEmit.js

@@ -1,11 +1,13 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
 /**
- * Generate the Phase-1 minimal `.d.ts` sibling for a compiled script. The
- * declarations mirror the runtime expectation in §5.2 — a default-exported
- * `CompiledScriptObject` plus the `__manifest` symbol the bundler emits at
- * the bottom of the JS. Identical content for every script in Phase 1;
- * Phase 4+ specialises per-script inputs / outputs.
+ * Generate the `.d.ts` sibling for a compiled script. Single-script files
+ * with no `outputs` / `dependencies` emit the Phase-1 minimal declarations
+ * byte-identically so existing snapshot tests stay green. Multi-export
+ * files (array input) or single-export files carrying `outputs` /
+ * `dependencies` emit per-binding typed declarations — `output<K extends
+ * "title1" | "title2">(name: K): Series<number>` overloads + `withInputs`
+ * typed against the binding's `inputs` schema.
  *
  * @since 0.1
  * @example
@@ -14,8 +16,16 @@
  *     const fn: typeof emitTypes = emitTypes;
  *     void fn;
  */
-export function emitTypes(_opts) {
-    return `// auto-generated by @invinite-org/chartlang-compiler
+export function emitTypes(opts) {
+    const manifests = Array.isArray(opts.manifest)
+        ? opts.manifest
+        : [opts.manifest];
+    if (manifests.length === 1 && !needsTypedExports(manifests[0])) {
+        return BACK_COMPAT_DTS;
+    }
+    return emitTypedDeclarations(manifests);
+}
+const BACK_COMPAT_DTS = `// auto-generated by @invinite-org/chartlang-compiler
 import type { CompiledScriptObject, ScriptManifest } from "@invinite-org/chartlang-core";
 
 declare const script: CompiledScriptObject;
@@ -23,5 +33,79 @@ export default script;
 
 export declare const __manifest: ScriptManifest;
 `;
+function needsTypedExports(manifest) {
+    const hasOutputs = manifest.outputs !== undefined && manifest.outputs.length > 0;
+    const hasDependencies = manifest.dependencies !== undefined && manifest.dependencies.length > 0;
+    return hasOutputs || hasDependencies;
+}
+function emitTypedDeclarations(manifests) {
+    const lines = [
+        "// auto-generated by @invinite-org/chartlang-compiler",
+        'import type { CompiledScriptObject, ScriptManifest, Series } from "@invinite-org/chartlang-core";',
+        "",
+    ];
+    for (const m of manifests) {
+        const exportName = m.exportName ?? "default";
+        const localName = exportName === "default" ? "script" : exportName;
+        lines.push(`declare const ${localName}: CompiledScriptObject & {`, `    output${outputOverloadSignature(m)}: Series<number>;`, `    withInputs(overrides: ${inputsOverrideType(m)}): typeof ${localName};`, "};");
+        if (exportName === "default") {
+            lines.push(`export default ${localName};`, "");
+        }
+        else {
+            lines.push(`export { ${localName} };`, "");
+        }
+    }
+    const manifestType = manifests.length > 1 ? "ReadonlyArray<ScriptManifest>" : "ScriptManifest";
+    lines.push(`export declare const __manifest: ${manifestType};`, "");
+    return lines.join("\n");
+}
+function outputOverloadSignature(manifest) {
+    const outputs = manifest.outputs ?? [];
+    if (outputs.length === 0) {
+        return "<K extends never>(name: K)";
+    }
+    const titleUnion = outputs.map((o) => JSON.stringify(o.title)).join(" | ");
+    return `<K extends ${titleUnion}>(name: K)`;
+}
+function inputsOverrideType(manifest) {
+    const inputs = manifest.inputs;
+    const keys = Object.keys(inputs);
+    if (keys.length === 0) {
+        return "Readonly<Record<string, never>>";
+    }
+    const fields = [];
+    for (const key of keys) {
+        const descriptor = inputs[key];
+        const tsType = descriptorToTsType(descriptor);
+        fields.push(`${quoteFieldKey(key)}?: ${tsType}`);
+    }
+    /* v8 ignore next */
+    return `Readonly<{ ${fields.join("; ")} }>`;
+}
+const KIND_TO_TS_TYPE = new Map([
+    ["int", "number"],
+    ["float", "number"],
+    ["price", "number"],
+    ["time", "number"],
+    ["string", "string"],
+    ["enum", "string"],
+    ["color", "string"],
+    ["source", "string"],
+    ["symbol", "string"],
+    ["interval", "string"],
+    ["bool", "boolean"],
+    ["external-series", "unknown"],
+]);
+function descriptorToTsType(descriptor) {
+    const kind = descriptor.kind;
+    /* v8 ignore next 2 */
+    if (typeof kind !== "string")
+        return "unknown";
+    return KIND_TO_TS_TYPE.get(kind) ?? "unknown";
+}
+const SAFE_FIELD_NAME = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function quoteFieldKey(key) {
+    /* v8 ignore next */
+    return SAFE_FIELD_NAME.test(key) ? key : JSON.stringify(key);
 }
 //# sourceMappingURL=typesEmit.js.map

package/dist/typesEmit.js.map

@@ -1 +1 @@
-{"version":3,"file":"typesEmit.js","sourceRoot":"","sources":["../src/typesEmit.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAuB/D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAAC,KAAuB;IAC7C,OAAO;;;;;;;CAOV,CAAC;AACF,CAAC"}
+{"version":3,"file":"typesEmit.js","sourceRoot":"","sources":["../src/typesEmit.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invinite-org/chartlang-compiler",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "type": "module",
   "license": "MIT",
   "description": "TypeScript transformer + bundler for .chart.ts files",
@@ -21,7 +21,7 @@
   "dependencies": {
     "esbuild": "^0.24.0",
     "typescript": "^5.6.0",
-    "@invinite-org/chartlang-core": "1.0.1"
+    "@invinite-org/chartlang-core": "1.1.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",