@styx-api/core 0.6.1 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@styx-api/core",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Styx compiler core: parses CLI tool descriptors (e.g. Boutiques), optimizes an IR, solves typed parameter bindings, and generates type-safe wrappers (TypeScript, Python, JSON Schema). Part of the Styx/NiWrap ecosystem.",
   "keywords": [
     "styx",

package/src/backend/argtype/__fixtures__/microsyntax.argtype

@@ -0,0 +1,15 @@
+---
+exe: "cut"
+version: "9.0"
+extensions:
+  - mediatypes
+---
+
+/// Cut fields from each line, exercising join micro-syntax and media types
+cut: seq(
+  input: path.mediaType("text/plain"),
+  seq("--fields=", fields: rep(int).join(",")).join(),
+  opt("-d", delimiter: str),
+  defines: rep(seq(str, "=", str).join("")),
+  out: path.mediaType("application/json").mediaType("text/csv"),
+)

package/src/backend/argtype/__fixtures__/subcommands.argtype

@@ -0,0 +1,25 @@
+---
+exe: "vcs"
+version: "1.2.0"
+authors:
+  - "VCS Authors"
+---
+
+/// Mini version control with subcommands
+vcs: alt(
+  /// Record changes to the repository
+  commit: seq(
+    "commit",
+    opt("-m", message: str),
+    opt("--amend"),
+    opt("--author", author: str),
+  ),
+  /// Publish local commits to a remote
+  push: seq(
+    "push",
+    opt("-u", upstream: str),
+    opt("--force"),
+    remote: str = "origin",
+    branch: str,
+  ),
+)

package/src/backend/argtype/argtype.ts

@@ -0,0 +1,45 @@
+import type { CodegenContext } from "../../manifest/index.js";
+import type { Backend, EmittedApp } from "../backend.js";
+import { Scope } from "../scope.js";
+import { snakeCase } from "../string-case.js";
+import { generateArgtype } from "./emit.js";
+
+/**
+ * A per-tool file stem, so co-located tools in a catalog build don't clobber one
+ * another's `descriptor.argtype`. Standalone single-tool builds (no scope) keep
+ * the bare name. Mirrors the JSON Schema backend's `schemaStem`.
+ */
+function argtypeStem(ctx: CodegenContext, scope?: Scope): string | undefined {
+  const id = ctx.app?.id;
+  if (!id || !scope) return undefined;
+  return scope.add(snakeCase(id) || "descriptor");
+}
+
+/**
+ * Serialization backend: emit argtype sugar-DSL source from the IR + `AppMeta`.
+ *
+ * The dogfooding / round-trip counterpart to the argtype frontend. Like the
+ * Boutiques backend it only needs the IR (`ctx.expr`) and app metadata
+ * (`ctx.app`), never the solved bindings, so it ignores the rest of the context.
+ */
+export class ArgtypeBackend implements Backend {
+  readonly name = "argtype";
+  readonly target = "argtype";
+
+  /** One scope per package so per-tool file stems stay unique in the suite dir. */
+  newPackageScope(): Scope {
+    return new Scope();
+  }
+
+  emitApp(ctx: CodegenContext, scope?: Scope): EmittedApp {
+    const { source, warnings } = generateArgtype(ctx.expr, ctx.app);
+    const stem = argtypeStem(ctx, scope);
+    const filename = stem ? `${stem}.argtype` : "descriptor.argtype";
+    return {
+      meta: ctx.app,
+      files: new Map([[filename, source]]),
+      errors: [],
+      warnings,
+    };
+  }
+}