@nodetool-ai/node-sdk 0.7.0-rc.11

package/dist/docs/overview.js

@@ -0,0 +1,71 @@
+import { slugifyNodeFilename } from "./nodes.js";
+function shortDescription(text) {
+    if (!text)
+        return "";
+    const firstLine = text.split(/\r?\n/)[0] ?? "";
+    return firstLine.trim();
+}
+function exampleLabel(example) {
+    if (!example || typeof example !== "object" || Array.isArray(example)) {
+        return String(example);
+    }
+    const record = example;
+    return ((typeof record["name"] === "string" && record["name"]) ||
+        (typeof record["id"] === "string" && record["id"]) ||
+        "example");
+}
+export function generatePackageOverviewMarkdown(pkg, opts = {}) {
+    const nodes = pkg.nodes ?? [];
+    const examples = pkg.examples ?? [];
+    const authors = (pkg.authors ?? []).join(", ");
+    if (opts.compact) {
+        const nodeList = nodes
+            .map((n) => `- ${n.title} (\`${n.node_type}\`)${shortDescription(n.description)
+            ? ` — ${shortDescription(n.description)}`
+            : ""}`)
+            .join("\n");
+        const header = [
+            `# ${pkg.name}${pkg.version ? ` (${pkg.version})` : ""}`,
+            pkg.description ?? "",
+            `Nodes: ${nodes.length}  Examples: ${examples.length}`
+        ]
+            .filter(Boolean)
+            .join(" · ");
+        return `${header}\n\n${nodeList}\n`;
+    }
+    const lines = [];
+    lines.push(`# ${pkg.name}`, "");
+    if (pkg.description) {
+        lines.push(pkg.description, "");
+    }
+    if (pkg.version)
+        lines.push(`**Version:** ${pkg.version}`);
+    if (authors)
+        lines.push(`**Authors:** ${authors}`);
+    if (pkg.version || authors)
+        lines.push("");
+    lines.push(`## Nodes (${nodes.length})`, "");
+    if (nodes.length === 0) {
+        lines.push("_(no nodes)_", "");
+    }
+    else {
+        for (const node of nodes) {
+            const desc = shortDescription(node.description);
+            const file = slugifyNodeFilename(node);
+            lines.push(`- [${node.title}](${file})${desc ? ` — ${desc}` : ""}`);
+        }
+        lines.push("");
+    }
+    lines.push(`## Examples (${examples.length})`, "");
+    if (examples.length === 0) {
+        lines.push("_(no examples)_", "");
+    }
+    else {
+        for (const example of examples) {
+            lines.push(`- ${exampleLabel(example)}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=overview.js.map

package/dist/docs/overview.js.map

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

package/dist/docs/workflows.d.ts

@@ -0,0 +1,10 @@
+export interface WorkflowDocOptions {
+    packageName?: string;
+}
+export interface WorkflowFile {
+    path: string;
+    data: Record<string, unknown>;
+}
+export declare function generateWorkflowMarkdown(wf: WorkflowFile): string;
+export declare function generateAllWorkflowDocs(workflows: WorkflowFile[], opts?: WorkflowDocOptions): Map<string, string>;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/docs/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/docs/workflows.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAyDD,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAgEjE;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,YAAY,EAAE,EACzB,IAAI,GAAE,kBAAuB,GAC5B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAerB"}

package/dist/docs/workflows.js

@@ -0,0 +1,112 @@
+import path from "node:path";
+function asGraph(data) {
+    const graph = (data["graph"] ?? data);
+    const nodes = Array.isArray(graph["nodes"])
+        ? graph["nodes"]
+        : [];
+    const edges = Array.isArray(graph["edges"])
+        ? graph["edges"]
+        : [];
+    return { nodes, edges };
+}
+function filterIO(nodes, prefix) {
+    return nodes.filter((n) => typeof n.type === "string" && n.type.startsWith(prefix));
+}
+function slotName(node) {
+    const props = (node.properties ?? node.data ?? {});
+    if (typeof props["name"] === "string" && props["name"])
+        return props["name"];
+    return node.id ?? (node.type ?? "unknown");
+}
+function slotDescription(node) {
+    const props = (node.properties ?? node.data ?? {});
+    if (typeof props["description"] === "string")
+        return props["description"];
+    return "";
+}
+function slotType(node) {
+    const t = node.type ?? "";
+    const lastDot = t.lastIndexOf(".");
+    return lastDot > 0 ? t.slice(lastDot + 1) : t;
+}
+function slugifyWorkflowName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+export function generateWorkflowMarkdown(wf) {
+    const { nodes, edges } = asGraph(wf.data);
+    const name = typeof wf.data["name"] === "string"
+        ? wf.data["name"]
+        : path.basename(wf.path, ".json");
+    const description = typeof wf.data["description"] === "string" ? wf.data["description"] : "";
+    const inputs = filterIO(nodes, "nodetool.input.");
+    const outputs = filterIO(nodes, "nodetool.output.");
+    const lines = [];
+    lines.push(`# ${name}`, "");
+    if (description)
+        lines.push(description, "");
+    lines.push(`**Source:** \`${wf.path}\``);
+    lines.push(`**Nodes:** ${nodes.length}`);
+    lines.push(`**Edges:** ${edges.length}`, "");
+    lines.push("## Inputs", "");
+    if (inputs.length === 0) {
+        lines.push("_(none)_", "");
+    }
+    else {
+        lines.push("| Name | Type | Description |");
+        lines.push("|------|------|-------------|");
+        for (const input of inputs) {
+            const cells = [
+                slotName(input),
+                slotType(input),
+                slotDescription(input)
+            ].map((c) => c
+                .replace(/\\/g, "\\\\")
+                .replace(/\|/g, "\\|")
+                .replace(/\r?\n/g, " "));
+            lines.push(`| ${cells.join(" | ")} |`);
+        }
+        lines.push("");
+    }
+    lines.push("## Outputs", "");
+    if (outputs.length === 0) {
+        lines.push("_(none)_", "");
+    }
+    else {
+        lines.push("| Name | Type | Description |");
+        lines.push("|------|------|-------------|");
+        for (const output of outputs) {
+            const cells = [
+                slotName(output),
+                slotType(output),
+                slotDescription(output)
+            ].map((c) => c
+                .replace(/\\/g, "\\\\")
+                .replace(/\|/g, "\\|")
+                .replace(/\r?\n/g, " "));
+            lines.push(`| ${cells.join(" | ")} |`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+export function generateAllWorkflowDocs(workflows, opts = {}) {
+    const docs = new Map();
+    for (const wf of workflows) {
+        if (opts.packageName) {
+            const pkg = wf.data["package_name"];
+            if (typeof pkg === "string" && pkg !== opts.packageName)
+                continue;
+        }
+        const name = typeof wf.data["name"] === "string"
+            ? wf.data["name"]
+            : path.basename(wf.path, ".json");
+        const filename = `${slugifyWorkflowName(name)}.md`;
+        docs.set(filename, generateWorkflowMarkdown(wf));
+    }
+    return docs;
+}
+//# sourceMappingURL=workflows.js.map

package/dist/docs/workflows.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./base-node.js";
+export * from "./registry.js";
+export * from "./metadata.js";
+export * from "./node-metadata.js";
+export * from "./decorators.js";
+export * from "./search.js";
+export * from "./validation.js";
+export * from "./nodes/test-nodes.js";
+export * from "./package-registry-client.js";
+export * from "./docs/index.js";
+export * from "./python-package-scan.js";
+export type { StreamingInputs, StreamingOutputs } from "@nodetool-ai/runtime";
+export type { ImageRef, AudioRef, VideoRef, TextRef, DataframeRef } from "@nodetool-ai/protocol";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,YAAY,EACb,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from "./base-node.js";
+export * from "./registry.js";
+export * from "./metadata.js";
+export * from "./node-metadata.js";
+export * from "./decorators.js";
+export * from "./search.js";
+export * from "./validation.js";
+export * from "./nodes/test-nodes.js";
+export * from "./package-registry-client.js";
+export * from "./docs/index.js";
+export * from "./python-package-scan.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,76 @@
+export interface TypeMetadata {
+    type: string;
+    optional?: boolean;
+    values?: Array<string | number>;
+    type_args: TypeMetadata[];
+    type_name?: string | null;
+}
+/** Ensure a raw type object from JSON always has type_args as an array. */
+export declare function normalizeTypeMetadata(t: TypeMetadata): TypeMetadata;
+export interface PropertyMetadata {
+    name: string;
+    type: TypeMetadata;
+    default?: unknown;
+    title?: string | null;
+    description?: string | null;
+    min?: number | null;
+    max?: number | null;
+    values?: Array<string | number> | null;
+    json_schema_extra?: Record<string, unknown> | null;
+    required?: boolean;
+}
+export interface OutputSlotMetadata {
+    type: TypeMetadata;
+    name: string;
+    stream?: boolean;
+}
+export interface NodeMetadata {
+    title: string;
+    description: string;
+    namespace: string;
+    node_type: string;
+    layout?: string;
+    properties: PropertyMetadata[];
+    outputs: OutputSlotMetadata[];
+    recommended_models?: unknown[];
+    basic_fields?: string[];
+    required_settings?: string[];
+    /**
+     * Runtime packages this node depends on (e.g. "ffmpeg", "python", "ollama").
+     * The frontend uses this to show install prompts before execution.
+     */
+    required_runtimes?: string[];
+    is_dynamic?: boolean;
+    is_streaming_input?: boolean;
+    is_streaming_output?: boolean;
+    is_controlled?: boolean;
+    expose_as_tool?: boolean;
+    supports_dynamic_outputs?: boolean;
+    auto_save_asset?: boolean;
+    model_packs?: unknown[];
+}
+export interface PackageMetadata {
+    name: string;
+    description?: string;
+    version?: string;
+    authors?: string[];
+    repo_id?: string | null;
+    nodes?: NodeMetadata[];
+    examples?: unknown[];
+    assets?: unknown[];
+    /** Absolute path to the source root (e.g. /path/to/nodetool-base/src or /path/to/nodetool-base) */
+    sourceFolder?: string;
+}
+export interface PythonMetadataLoadOptions {
+    roots?: string[];
+    maxDepth?: number;
+}
+export interface PythonMetadataLoadResult {
+    files: string[];
+    packages: PackageMetadata[];
+    nodesByType: Map<string, NodeMetadata>;
+    duplicates: string[];
+    warnings: string[];
+}
+export declare function loadPythonPackageMetadata(options?: PythonMetadataLoadOptions): PythonMetadataLoadResult;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

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

package/dist/metadata.js

@@ -0,0 +1,247 @@
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import os from "node:os";
+/** Ensure a raw type object from JSON always has type_args as an array. */
+export function normalizeTypeMetadata(t) {
+    return {
+        ...t,
+        type_args: (t.type_args ?? []).map(normalizeTypeMetadata)
+    };
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function walkForMetadataFiles(root, maxDepth, files, warnings, depth = 0) {
+    if (depth > maxDepth)
+        return;
+    const normalizedRoot = root.split(path.sep).join("/");
+    if (normalizedRoot.endsWith("/src/nodetool/package_metadata") ||
+        normalizedRoot.endsWith("/nodetool/package_metadata")) {
+        try {
+            const metadataFiles = fs
+                .readdirSync(root, { withFileTypes: true })
+                .filter((f) => f.isFile() && f.name.endsWith(".json"))
+                .map((f) => path.join(root, f.name));
+            files.push(...metadataFiles);
+        }
+        catch (error) {
+            warnings.push(`Failed to scan metadata dir ${root}: ${String(error)}`);
+        }
+        return;
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(root, { withFileTypes: true });
+    }
+    catch (error) {
+        warnings.push(`Failed to read directory ${root}: ${String(error)}`);
+        return;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(root, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === ".git" ||
+                entry.name === "node_modules" ||
+                entry.name === "dist") {
+                continue;
+            }
+            const normalized = fullPath.split(path.sep).join("/");
+            if (normalized.endsWith("/src/nodetool/package_metadata") ||
+                normalized.endsWith("/nodetool/package_metadata")) {
+                try {
+                    const metadataFiles = fs
+                        .readdirSync(fullPath, { withFileTypes: true })
+                        .filter((f) => f.isFile() && f.name.endsWith(".json"))
+                        .map((f) => path.join(fullPath, f.name));
+                    files.push(...metadataFiles);
+                }
+                catch (error) {
+                    warnings.push(`Failed to scan metadata dir ${fullPath}: ${String(error)}`);
+                }
+                continue;
+            }
+            walkForMetadataFiles(fullPath, maxDepth, files, warnings, depth + 1);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Metadata cache — avoids re-reading and re-parsing JSON files on every startup
+// when the underlying metadata files haven't changed.
+// ---------------------------------------------------------------------------
+const CACHE_DIR = path.join(os.tmpdir(), "nodetool-metadata-cache");
+const CACHE_VERSION = 1;
+/** Build a fingerprint from sorted file paths + their mtime/size. */
+function buildFingerprint(files) {
+    const hash = crypto.createHash("sha256");
+    for (const file of files) {
+        hash.update(file);
+        try {
+            const stat = fs.statSync(file);
+            hash.update(`|${stat.mtimeMs}|${stat.size}`);
+        }
+        catch {
+            hash.update("|missing");
+        }
+    }
+    return hash.digest("hex");
+}
+function getCachePath(roots) {
+    const key = crypto
+        .createHash("sha256")
+        .update(roots.join(":"))
+        .digest("hex")
+        .slice(0, 16);
+    return path.join(CACHE_DIR, `metadata-${key}.json`);
+}
+function tryReadCache(cachePath, fingerprint) {
+    try {
+        if (!fs.existsSync(cachePath))
+            return null;
+        const raw = fs.readFileSync(cachePath, "utf8");
+        const entry = JSON.parse(raw);
+        if (entry.version !== CACHE_VERSION || entry.fingerprint !== fingerprint)
+            return null;
+        return {
+            files: entry.files,
+            packages: entry.packages,
+            nodesByType: new Map(entry.nodesByType),
+            duplicates: entry.duplicates,
+            warnings: entry.warnings
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(cachePath, fingerprint, result) {
+    try {
+        fs.mkdirSync(CACHE_DIR, { recursive: true });
+        const entry = {
+            version: CACHE_VERSION,
+            fingerprint,
+            files: result.files,
+            packages: result.packages,
+            nodesByType: [...result.nodesByType.entries()],
+            duplicates: result.duplicates,
+            warnings: result.warnings
+        };
+        fs.writeFileSync(cachePath, JSON.stringify(entry));
+    }
+    catch {
+        // Cache write failure is non-fatal
+    }
+}
+function parseMetadataFiles(files) {
+    const packages = [];
+    const nodesByType = new Map();
+    const duplicates = new Set();
+    const warnings = [];
+    for (const file of files) {
+        let parsed;
+        try {
+            // Python's json module allows NaN/Infinity which are not valid JSON; replace them with null.
+            const raw = fs
+                .readFileSync(file, "utf8")
+                .replace(/\bNaN\b|-?Infinity\b/g, "null");
+            parsed = JSON.parse(raw);
+        }
+        catch (error) {
+            warnings.push(`Failed to parse JSON ${file}: ${String(error)}`);
+            continue;
+        }
+        if (!isRecord(parsed)) {
+            warnings.push(`Skipping non-object metadata file: ${file}`);
+            continue;
+        }
+        // Infer source folder from the metadata file path:
+        // file is at {root}/nodetool/package_metadata/{name}.json or {root}/src/nodetool/package_metadata/{name}.json
+        const metaDir = path.dirname(file); // .../nodetool/package_metadata
+        const sourceFolder = path.dirname(path.dirname(metaDir)); // strip /nodetool/package_metadata
+        const pkg = {
+            name: typeof parsed.name === "string"
+                ? parsed.name
+                : path.basename(file, ".json"),
+            description: typeof parsed.description === "string" ? parsed.description : undefined,
+            version: typeof parsed.version === "string" ? parsed.version : undefined,
+            authors: Array.isArray(parsed.authors)
+                ? parsed.authors
+                : undefined,
+            repo_id: typeof parsed.repo_id === "string" ? parsed.repo_id : undefined,
+            nodes: Array.isArray(parsed.nodes)
+                ? parsed.nodes
+                : undefined,
+            examples: Array.isArray(parsed.examples) ? parsed.examples : undefined,
+            assets: Array.isArray(parsed.assets) ? parsed.assets : undefined,
+            sourceFolder
+        };
+        packages.push(pkg);
+        for (const node of pkg.nodes ?? []) {
+            if (!node ||
+                typeof node !== "object" ||
+                typeof node.node_type !== "string") {
+                continue;
+            }
+            if (nodesByType.has(node.node_type)) {
+                duplicates.add(node.node_type);
+            }
+            // Normalize type_args to always be an array (some JSON files omit it)
+            const normalized = {
+                ...node,
+                properties: (node.properties ?? []).map((p) => ({
+                    ...p,
+                    type: normalizeTypeMetadata(p.type)
+                })),
+                outputs: (node.outputs ?? []).map((o) => ({
+                    ...o,
+                    type: normalizeTypeMetadata(o.type)
+                }))
+            };
+            nodesByType.set(node.node_type, normalized);
+        }
+    }
+    return {
+        files,
+        packages,
+        nodesByType,
+        duplicates: [...duplicates].sort(),
+        warnings
+    };
+}
+export function loadPythonPackageMetadata(options = {}) {
+    const roots = (options.roots && options.roots.length > 0 ? options.roots : [process.cwd()]).map((p) => path.resolve(p));
+    const maxDepth = options.maxDepth ?? 8;
+    const warnings = [];
+    const fileSet = new Set();
+    for (const root of roots) {
+        if (!fs.existsSync(root)) {
+            warnings.push(`Metadata root does not exist: ${root}`);
+            continue;
+        }
+        const found = [];
+        walkForMetadataFiles(root, maxDepth, found, warnings);
+        for (const file of found) {
+            fileSet.add(path.resolve(file));
+        }
+    }
+    const files = [...fileSet].sort();
+    // Try cache first — avoids re-reading and parsing all JSON files.
+    const fingerprint = buildFingerprint(files);
+    const cachePath = getCachePath(roots);
+    const cached = tryReadCache(cachePath, fingerprint);
+    if (cached) {
+        // Merge any walk warnings into the cached result
+        if (warnings.length > 0) {
+            cached.warnings = [...warnings, ...cached.warnings];
+        }
+        return cached;
+    }
+    const result = parseMetadataFiles(files);
+    if (warnings.length > 0) {
+        result.warnings = [...warnings, ...result.warnings];
+    }
+    // Persist cache for next startup
+    writeCache(cachePath, fingerprint, result);
+    return result;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

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

package/dist/node-metadata.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Node metadata introspection.
+ *
+ * TS classes are authoritative when no Python metadata is loaded. When Python
+ * metadata is available for a node, registry-emitted metadata should match the
+ * Python package JSON exactly so downstream consumers see a stable shape.
+ */
+import type { NodeClass } from "./base-node.js";
+import type { NodeMetadata } from "./metadata.js";
+export interface GetNodeMetadataOptions {
+    pythonMetadata?: NodeMetadata;
+    mergePythonBackfill?: boolean;
+}
+export declare function getNodeMetadata(nodeClass: NodeClass, options?: GetNodeMetadataOptions): NodeMetadata;
+export declare function getNodeMetadataBatch(nodeClasses: NodeClass[], options?: GetNodeMetadataOptions): NodeMetadata[];
+//# sourceMappingURL=node-metadata.d.ts.map

package/dist/node-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-metadata.d.ts","sourceRoot":"","sources":["../src/node-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAmPD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,sBAA2B,GACnC,YAAY,CA0Cd;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,SAAS,EAAE,EACxB,OAAO,GAAE,sBAA2B,GACnC,YAAY,EAAE,CAEhB"}