@galaxy-tool-util/schema 0.1.0

package/dist/workflow/lint.js

@@ -0,0 +1,402 @@
+/**
+ * Workflow linting — structural checks and best-practice warnings.
+ *
+ * Port of gxformat2's lint.py + linting.py. Checks workflow structure,
+ * output labels, step errors, tool references, output source resolution,
+ * input default types, and report markdown.
+ */
+import { normalizedFormat2 } from "./normalized/format2.js";
+import { normalizedNative } from "./normalized/native.js";
+import { ensureFormat2 } from "./normalized/ensure.js";
+import { detectFormat } from "./detect-format.js";
+// ---------------------------------------------------------------------------
+// LintContext — tracks errors and warnings during linting
+// ---------------------------------------------------------------------------
+export class LintContext {
+    errors = [];
+    warnings = [];
+    _prefix;
+    constructor(prefix = "") {
+        this._prefix = prefix;
+    }
+    error(message) {
+        this.errors.push(`${this._prefix}${message}`);
+    }
+    warn(message) {
+        this.warnings.push(`${this._prefix}${message}`);
+    }
+    child(prefix) {
+        const fullPrefix = this._prefix ? `${this._prefix.slice(0, -1)} > ${prefix}] ` : `[${prefix}] `;
+        const ctx = new LintContext();
+        ctx._prefix = fullPrefix;
+        // Share message arrays with parent
+        ctx.errors = this.errors;
+        ctx.warnings = this.warnings;
+        return ctx;
+    }
+}
+function toLintResult(ctx) {
+    return {
+        errors: ctx.errors,
+        warnings: ctx.warnings,
+        error_count: ctx.errors.length,
+        warn_count: ctx.warnings.length,
+    };
+}
+// ---------------------------------------------------------------------------
+// Shared lint helpers
+// ---------------------------------------------------------------------------
+function lintStepErrors(ctx, errors) {
+    if (errors != null) {
+        ctx.warn(`tool step contains error indicated during Galaxy export - ${errors}`);
+    }
+}
+function lintToolIfPresent(ctx, toolId) {
+    if (toolId && toolId.includes("testtoolshed")) {
+        ctx.warn("Step references a tool from the test tool shed, this should be replaced with a production tool");
+    }
+}
+function validateReport(ctx, report) {
+    if (report == null)
+        return;
+    const markdown = report.markdown;
+    if (typeof markdown !== "string") {
+        ctx.error(`expected value [${String(markdown)}] with key [markdown] to be of class string`);
+    }
+    // Note: Galaxy markdown validation (```galaxy directives) not yet ported
+}
+// ---------------------------------------------------------------------------
+// Native workflow linting
+// ---------------------------------------------------------------------------
+function lintNativeWorkflow(ctx, nnw, rawDict) {
+    // Raw-dict presence checks (fields that normalized models default-fill)
+    if (rawDict != null) {
+        if (!("a_galaxy_workflow" in rawDict)) {
+            ctx.error("expected to find key [a_galaxy_workflow] but absent");
+        }
+        else if (rawDict.a_galaxy_workflow !== "true") {
+            ctx.error(`expected value [${String(rawDict.a_galaxy_workflow)}] with key [a_galaxy_workflow] to be true`);
+        }
+        if (!("format-version" in rawDict)) {
+            ctx.error("expected to find key [format-version] but absent");
+        }
+        else if (rawDict["format-version"] !== "0.1") {
+            ctx.error(`expected value [${String(rawDict["format-version"])}] with key [format-version] to be 0.1`);
+        }
+        if (!("steps" in rawDict)) {
+            ctx.error("expected to find key [steps] but absent");
+            return;
+        }
+    }
+    let foundOutputs = false;
+    let foundOutputWithoutLabel = false;
+    for (const [orderIndex, step] of Object.entries(nnw.steps)) {
+        if (!/^\d+$/.test(orderIndex)) {
+            ctx.error(`expected step_key to be integer not [${orderIndex}]`);
+        }
+        for (const wo of step.workflow_outputs) {
+            foundOutputs = true;
+            if (!wo.label) {
+                foundOutputWithoutLabel = true;
+            }
+        }
+        // Recurse into subworkflows
+        if (step.type === "subworkflow" && step.subworkflow) {
+            if (!step.subworkflow.steps || Object.keys(step.subworkflow.steps).length === 0) {
+                ctx.error("subworkflow is missing steps or steps are empty");
+            }
+            else {
+                lintNativeWorkflow(ctx, step.subworkflow);
+            }
+        }
+        lintStepErrors(ctx, step.errors);
+        lintToolIfPresent(ctx, step.tool_id);
+    }
+    validateReport(ctx, nnw.report);
+    if (!foundOutputs) {
+        ctx.warn("Workflow contained no outputs");
+    }
+    if (foundOutputWithoutLabel) {
+        ctx.warn("Workflow contained output without a label");
+    }
+}
+// ---------------------------------------------------------------------------
+// Format2 workflow linting
+// ---------------------------------------------------------------------------
+function validateOutputSources(ctx, nf2) {
+    if (!nf2.outputs || nf2.outputs.length === 0)
+        return;
+    // Collect known labels: step labels/ids + input ids
+    const knownLabels = new Set();
+    for (const inp of nf2.inputs) {
+        if (inp.id)
+            knownLabels.add(inp.id);
+        if (inp.label)
+            knownLabels.add(inp.label);
+    }
+    for (const step of nf2.steps) {
+        if (step.id)
+            knownLabels.add(step.id);
+        if (step.label)
+            knownLabels.add(step.label);
+    }
+    for (const output of nf2.outputs) {
+        const outputSource = output.outputSource;
+        if (!outputSource || typeof outputSource !== "string")
+            continue;
+        // outputSource is "step_label/output_name" — extract step ref
+        const slashIdx = outputSource.indexOf("/");
+        const stepRef = slashIdx >= 0 ? outputSource.slice(0, slashIdx) : outputSource;
+        if (!knownLabels.has(stepRef)) {
+            const outputId = output.id || "?";
+            ctx.error(`Output '${outputId}' references step '${stepRef}' via outputSource ` +
+                `'${outputSource}', but no step or input with that label exists`);
+        }
+    }
+}
+function validateInputTypes(ctx, nf2) {
+    for (const inp of nf2.inputs) {
+        if (inp.default == null)
+            continue;
+        const inputType = inp.type;
+        if (Array.isArray(inputType))
+            continue; // array types — skip
+        if (inputType === "int" || inputType === "integer") {
+            if (typeof inp.default !== "number" || !Number.isInteger(inp.default)) {
+                ctx.error("Input default is of invalid type");
+            }
+        }
+        else if (inputType === "float" || inputType === "double") {
+            if (typeof inp.default !== "number") {
+                ctx.error("Input default is of invalid type");
+            }
+        }
+        else if (inputType === "string" || inputType === "text") {
+            if (typeof inp.default !== "string") {
+                ctx.error("Input default is of invalid type");
+            }
+        }
+    }
+}
+function lintFormat2Workflow(ctx, nf2, rawDict) {
+    if (rawDict != null) {
+        if (!("steps" in rawDict)) {
+            ctx.error("expected to find key [steps] but absent");
+        }
+        if (!("class" in rawDict)) {
+            ctx.error("expected to find key [class] but absent");
+        }
+    }
+    for (const step of nf2.steps) {
+        lintStepErrors(ctx, step.errors);
+        lintToolIfPresent(ctx, step.tool_id);
+        if (step.run &&
+            typeof step.run === "object" &&
+            step.run.class === "GalaxyWorkflow") {
+            const subWf = step.run;
+            if (!subWf.steps || subWf.steps.length === 0) {
+                ctx.error("subworkflow is missing steps or steps are empty");
+            }
+            else {
+                lintFormat2Workflow(ctx, subWf);
+            }
+        }
+    }
+    validateOutputSources(ctx, nf2);
+    validateInputTypes(ctx, nf2);
+    validateReport(ctx, nf2.report);
+}
+// ---------------------------------------------------------------------------
+// Public API — lint operations returning LintResult
+// ---------------------------------------------------------------------------
+/**
+ * Lint a native Galaxy workflow (.ga format).
+ * Returns structured lint results with errors and warnings.
+ */
+export function lintNative(workflowDict) {
+    const ctx = new LintContext();
+    let nnw;
+    try {
+        nnw = normalizedNative(workflowDict);
+    }
+    catch {
+        nnw = { steps: {} };
+    }
+    lintNativeWorkflow(ctx, nnw, workflowDict);
+    return toLintResult(ctx);
+}
+/**
+ * Lint a Format2 Galaxy workflow (.gxwf.yml format).
+ * Returns structured lint results with errors and warnings.
+ */
+export function lintFormat2(workflowDict) {
+    const ctx = new LintContext();
+    let nf2;
+    try {
+        nf2 = normalizedFormat2(workflowDict);
+    }
+    catch {
+        nf2 = { steps: [], inputs: [], outputs: [] };
+    }
+    lintFormat2Workflow(ctx, nf2, workflowDict);
+    return toLintResult(ctx);
+}
+/**
+ * Lint a workflow, auto-detecting format.
+ * Returns structured lint results with errors and warnings.
+ */
+export function lintWorkflow(workflowDict) {
+    const format = detectFormat(workflowDict);
+    return format === "native" ? lintNative(workflowDict) : lintFormat2(workflowDict);
+}
+// ---------------------------------------------------------------------------
+// Best practices linting
+// ---------------------------------------------------------------------------
+const UNTYPED_PARAM_RE = /\$\{.+?\}/;
+function checkJsonForUntypedParams(value) {
+    if (Array.isArray(value)) {
+        return value.some(checkJsonForUntypedParams);
+    }
+    if (value !== null && typeof value === "object") {
+        return Object.values(value).some(checkJsonForUntypedParams);
+    }
+    if (typeof value === "string") {
+        return UNTYPED_PARAM_RE.test(value);
+    }
+    return false;
+}
+const SKIP_DISCONNECTED_NATIVE_TYPES = new Set([
+    "data_input",
+    "data_collection_input",
+    "parameter_input",
+    "pause",
+]);
+function lintStepBestPractices(ctx, step) {
+    const stepId = step.label || step.id;
+    // disconnected inputs
+    for (const stepInput of step.in) {
+        if (stepInput.source == null && stepInput.default == null) {
+            ctx.warn(`Input ${stepInput.id} of workflow step ${stepId} is disconnected.`);
+        }
+    }
+    // missing doc
+    if (!step.doc) {
+        ctx.warn(`Workflow step ${stepId} has no annotation.`);
+    }
+    // missing label
+    if (!step.label) {
+        ctx.warn(`Workflow step ${stepId} has no label.`);
+    }
+    // untyped params in state
+    const toolState = step.state || step.tool_state;
+    if (toolState && checkJsonForUntypedParams(toolState)) {
+        ctx.warn(`Workflow step ${stepId} specifies an untyped parameter as an input.`);
+    }
+    // untyped params in outputs (PJA equivalents)
+    if (step.out && step.out.length > 0 && checkJsonForUntypedParams(step.out)) {
+        ctx.warn(`Workflow step ${stepId} specifies an untyped parameter in the post-job actions.`);
+    }
+}
+function lintNativeStepBestPractices(ctx, step) {
+    const stepId = step.label || step.annotation || String(step.id);
+    // disconnected inputs
+    if (!step.type || !SKIP_DISCONNECTED_NATIVE_TYPES.has(step.type)) {
+        for (const inputDef of step.inputs) {
+            if (inputDef.name && !(inputDef.name in step.input_connections)) {
+                ctx.warn(`Input ${inputDef.name} of workflow step ${stepId} is disconnected.`);
+            }
+        }
+    }
+    // untyped params in post_job_actions
+    if (step.post_job_actions && Object.keys(step.post_job_actions).length > 0) {
+        if (checkJsonForUntypedParams(step.post_job_actions)) {
+            ctx.warn(`Workflow step with ID ${step.id} specifies an untyped parameter in the post-job actions.`);
+        }
+    }
+}
+function lintBestPractices(ctx, nf2, rawDict) {
+    // annotation/doc
+    if (!nf2.doc || !nf2.doc.trim()) {
+        ctx.warn("Workflow is not annotated.");
+    }
+    // creator — access from raw dict since normalization may strip it
+    const nf2Creators = nf2.creator;
+    const creators = (nf2Creators ?? rawDict.creator);
+    if (!creators || !Array.isArray(creators) || creators.length === 0) {
+        ctx.warn("Workflow does not specify a creator.");
+    }
+    else {
+        for (const creator of creators) {
+            if (creator && typeof creator === "object") {
+                const c = creator;
+                if (c.class === "Person" && c.identifier && typeof c.identifier === "string") {
+                    // Check for URI scheme (e.g. https:, orcid:)
+                    if (!/^[a-zA-Z][a-zA-Z0-9+\-.]*:/.test(c.identifier)) {
+                        ctx.warn(`Creator identifier "${c.identifier}" should be a fully qualified URI, ` +
+                            `for example "https://orcid.org/0000-0002-1825-0097".`);
+                    }
+                }
+            }
+        }
+    }
+    // license
+    if (!nf2.license) {
+        ctx.warn("Workflow does not specify a license.");
+    }
+    // step-level
+    for (const step of nf2.steps) {
+        lintStepBestPractices(ctx, step);
+    }
+}
+/**
+ * Lint best practices for a Format2 Galaxy workflow.
+ * Returns structured lint results with warnings about missing annotations,
+ * creators, licenses, step labels, and disconnected inputs.
+ */
+export function lintBestPracticesFormat2(workflowDict) {
+    const ctx = new LintContext();
+    let nf2;
+    try {
+        nf2 = ensureFormat2(workflowDict);
+    }
+    catch {
+        nf2 = null;
+    }
+    if (nf2) {
+        lintBestPractices(ctx, nf2, workflowDict);
+    }
+    return toLintResult(ctx);
+}
+/**
+ * Lint best practices for a native Galaxy workflow.
+ * Runs shared format2 best practices plus native-specific checks.
+ */
+export function lintBestPracticesNative(workflowDict) {
+    const ctx = new LintContext();
+    // Shared best practices on format2 view
+    let nf2;
+    try {
+        nf2 = ensureFormat2(workflowDict);
+    }
+    catch {
+        nf2 = null;
+    }
+    if (nf2) {
+        lintBestPractices(ctx, nf2, workflowDict);
+    }
+    // Native-specific checks
+    let nnw;
+    try {
+        nnw = normalizedNative(workflowDict);
+    }
+    catch {
+        nnw = null;
+    }
+    if (nnw) {
+        for (const step of Object.values(nnw.steps)) {
+            lintNativeStepBestPractices(ctx, step);
+        }
+    }
+    return toLintResult(ctx);
+}
+//# sourceMappingURL=lint.js.map

package/dist/workflow/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/workflow/lint.ts"],"names":[],"mappings":"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"}

package/dist/workflow/normalized/comments.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Helpers for converting comments between native and Format2 representations.
+ *
+ * Port of gxformat2/_comment_helpers.py.
+ */
+/**
+ * Convert a native comment dict to Format2 representation.
+ *
+ * Hoists type-specific fields from nested `data` dict to top level.
+ * Renames child_steps → contains_steps and child_comments → contains_comments.
+ * Drops the `id` field.
+ */
+export declare function flattenCommentData(nativeComment: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Convert a Format2 comment dict to native representation.
+ *
+ * Collects type-specific top-level fields back into a nested `data` dict.
+ * Renames contains_steps → child_steps and contains_comments → child_comments.
+ */
+export declare function unflattenCommentData(format2Comment: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=comments.d.ts.map

package/dist/workflow/normalized/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/workflow/normalized/comments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BzB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BzB"}

package/dist/workflow/normalized/comments.js

@@ -0,0 +1,80 @@
+/**
+ * Helpers for converting comments between native and Format2 representations.
+ *
+ * Port of gxformat2/_comment_helpers.py.
+ */
+// Mapping from native comment data.* field names to Format2 top-level field names.
+const COMMENT_DATA_FIELDS = {
+    text: { text: "text", bold: "bold", italic: "italic", size: "text_size" },
+    markdown: { text: "text" },
+    frame: { title: "title" },
+    freehand: { thickness: "thickness", line: "line" },
+};
+const COMMENT_COMMON_FIELDS = ["type", "position", "size", "color"];
+/**
+ * Convert a native comment dict to Format2 representation.
+ *
+ * Hoists type-specific fields from nested `data` dict to top level.
+ * Renames child_steps → contains_steps and child_comments → contains_comments.
+ * Drops the `id` field.
+ */
+export function flattenCommentData(nativeComment) {
+    const commentType = nativeComment.type;
+    const result = {};
+    for (const field of COMMENT_COMMON_FIELDS) {
+        if (field in nativeComment) {
+            result[field] = nativeComment[field];
+        }
+    }
+    if ("label" in nativeComment) {
+        result.label = nativeComment.label;
+    }
+    const data = (nativeComment.data ?? {});
+    const fieldMap = COMMENT_DATA_FIELDS[commentType] ?? {};
+    for (const [nativeName, format2Name] of Object.entries(fieldMap)) {
+        if (nativeName in data) {
+            result[format2Name] = data[nativeName];
+        }
+    }
+    if ("child_steps" in nativeComment) {
+        result.contains_steps = nativeComment.child_steps;
+    }
+    if ("child_comments" in nativeComment) {
+        result.contains_comments = nativeComment.child_comments;
+    }
+    return result;
+}
+/**
+ * Convert a Format2 comment dict to native representation.
+ *
+ * Collects type-specific top-level fields back into a nested `data` dict.
+ * Renames contains_steps → child_steps and contains_comments → child_comments.
+ */
+export function unflattenCommentData(format2Comment) {
+    const commentType = format2Comment.type;
+    const result = {};
+    for (const field of COMMENT_COMMON_FIELDS) {
+        if (field in format2Comment) {
+            result[field] = format2Comment[field];
+        }
+    }
+    if ("label" in format2Comment) {
+        result.label = format2Comment.label;
+    }
+    const data = {};
+    const fieldMap = COMMENT_DATA_FIELDS[commentType] ?? {};
+    for (const [nativeName, format2Name] of Object.entries(fieldMap)) {
+        if (format2Name in format2Comment) {
+            data[nativeName] = format2Comment[format2Name];
+        }
+    }
+    result.data = data;
+    if ("contains_steps" in format2Comment) {
+        result.child_steps = format2Comment.contains_steps;
+    }
+    if ("contains_comments" in format2Comment) {
+        result.child_comments = format2Comment.contains_comments;
+    }
+    return result;
+}
+//# sourceMappingURL=comments.js.map

package/dist/workflow/normalized/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/workflow/normalized/comments.ts"],"names":[],"mappings":"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"}

package/dist/workflow/normalized/ensure.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Polymorphic entry points: accept any workflow representation,
+ * return the desired typed model.
+ *
+ * Port of gxformat2/normalized/_conversion.py ensure_format2/ensure_native.
+ */
+import type { NormalizedFormat2Workflow } from "./format2.js";
+import type { NormalizedNativeWorkflow } from "./native.js";
+/**
+ * Ensure a workflow is returned as normalized Format2.
+ *
+ * Accepts native or Format2 inputs (raw dict), normalizing/converting as needed.
+ */
+export declare function ensureFormat2(raw: unknown): NormalizedFormat2Workflow;
+/**
+ * Ensure a workflow is returned as normalized native.
+ *
+ * Accepts native or Format2 inputs (raw dict), normalizing/converting as needed.
+ */
+export declare function ensureNative(raw: unknown): NormalizedNativeWorkflow;
+//# sourceMappingURL=ensure.d.ts.map

package/dist/workflow/normalized/ensure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.d.ts","sourceRoot":"","sources":["../../../src/workflow/normalized/ensure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAK5D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,yBAAyB,CAUrE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,wBAAwB,CAenE"}

package/dist/workflow/normalized/ensure.js

@@ -0,0 +1,43 @@
+/**
+ * Polymorphic entry points: accept any workflow representation,
+ * return the desired typed model.
+ *
+ * Port of gxformat2/normalized/_conversion.py ensure_format2/ensure_native.
+ */
+import { normalizedFormat2 } from "./format2.js";
+import { normalizedNative } from "./native.js";
+import { toFormat2 } from "./toFormat2.js";
+import { toNative } from "./toNative.js";
+/**
+ * Ensure a workflow is returned as normalized Format2.
+ *
+ * Accepts native or Format2 inputs (raw dict), normalizing/converting as needed.
+ */
+export function ensureFormat2(raw) {
+    const obj = raw;
+    // Native workflow → convert
+    if (obj.a_galaxy_workflow === "true") {
+        return toFormat2(raw);
+    }
+    // Format2 workflow → normalize
+    return normalizedFormat2(raw);
+}
+/**
+ * Ensure a workflow is returned as normalized native.
+ *
+ * Accepts native or Format2 inputs (raw dict), normalizing/converting as needed.
+ */
+export function ensureNative(raw) {
+    const obj = raw;
+    // Native workflow → normalize directly
+    if (obj.a_galaxy_workflow === "true") {
+        return normalizedNative(raw);
+    }
+    // Format2 workflow → convert
+    if (obj.class === "GalaxyWorkflow") {
+        return toNative(raw);
+    }
+    // Fallback: assume native
+    return normalizedNative(raw);
+}
+//# sourceMappingURL=ensure.js.map

package/dist/workflow/normalized/ensure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.js","sourceRoot":"","sources":["../../../src/workflow/normalized/ensure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,MAAM,GAAG,GAAG,GAA8B,CAAC;IAE3C,4BAA4B;IAC5B,IAAI,GAAG,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,+BAA+B;IAC/B,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,MAAM,GAAG,GAAG,GAA8B,CAAC;IAE3C,uCAAuC;IACvC,IAAI,GAAG,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC;QACrC,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,6BAA6B;IAC7B,IAAI,GAAG,CAAC,KAAK,KAAK,gBAAgB,EAAE,CAAC;QACnC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,0BAA0B;IAC1B,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/workflow/normalized/expanded.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Expanded workflow models.
+ *
+ * Expansion resolves all external references (@import, URL, TRS, base64)
+ * in step run/subworkflow fields. Supports async URL fetching via a
+ * configurable resolver callback.
+ *
+ * Port of gxformat2/normalized/_conversion.py expanded_format2/expanded_native
+ * and gxformat2/options.py (UrlResolverFn, default_url_resolver, ConversionOptions).
+ */
+import type { NormalizedFormat2Workflow, NormalizedFormat2Step } from "./format2.js";
+import type { NormalizedNativeWorkflow, NormalizedNativeStep } from "./native.js";
+export type ExpandedFormat2Workflow = NormalizedFormat2Workflow;
+export type ExpandedFormat2Step = NormalizedFormat2Step;
+export type ExpandedNativeWorkflow = NormalizedNativeWorkflow;
+export type ExpandedNativeStep = NormalizedNativeStep;
+/**
+ * Async callback to resolve a reference string and return a parsed workflow dict.
+ *
+ * For URL references: fetches the URL and parses the response.
+ * For file path references: reads the file and parses it.
+ *
+ * The resolver receives the raw reference string (URL or file path)
+ * and must return a parsed workflow dict.
+ */
+export type RefResolver = (ref: string) => Promise<Record<string, unknown>>;
+/**
+ * Options controlling subworkflow expansion.
+ */
+export interface ExpansionOptions {
+    /**
+     * Resolver for external references. Receives a reference string
+     * (URL, base64 URI, or file path) and must return a parsed workflow dict.
+     *
+     * Must handle both URL references (containing "://") and file path
+     * references (bare paths from @import). If not provided, string run
+     * values pass through unresolved.
+     *
+     * See @galaxy-tool-util/cli's createDefaultResolver() for a Node.js
+     * implementation handling base64, TRS, HTTP, and file paths.
+     */
+    resolver?: RefResolver;
+}
+export declare const MAX_EXPANSION_DEPTH = 10;
+/** Check if a URL matches the GA4GH TRS v2 tools/versions pattern. */
+export declare function isTrsUrl(url: string): boolean;
+/**
+ * Normalize and expand a Format2 workflow.
+ *
+ * Resolves @import, URL, TRS URL, and base64 references in step `run`
+ * fields. Uses `options.resolver` (or a no-op that leaves strings as-is)
+ * for fetching external references.
+ */
+export declare function expandedFormat2(raw: unknown, options?: ExpansionOptions): Promise<ExpandedFormat2Workflow>;
+/**
+ * Normalize and expand a native workflow.
+ *
+ * Resolves content_id URL references by fetching and converting them.
+ * Uses `options.resolver` for fetching external references.
+ */
+export declare function expandedNative(raw: unknown, options?: ExpansionOptions): Promise<ExpandedNativeWorkflow>;
+//# sourceMappingURL=expanded.d.ts.map