@esheet/adapters 0.0.3

package/README.md

@@ -0,0 +1 @@
+# Adapter Pakcage

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { convertSurveyJS, convertSurveyJSToESheet, importFromSurveyJS, exportToSurveyJS, SURVEYJS_SYSTEM_PROMPT, } from './lib/surveyjs-converter.js';
+export { importFromMcp, exportToMcp, type McpElicitationSchema, type McpElicitationRequest, type McpProperty, type McpStringProp, type McpNumberProp, type McpBooleanProp, type McpArrayProp, type McpConstOption, } from './lib/mcp.js';
+//# 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":"AAIA,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// =============================================================================
+// @esheet/adapters - Convert external form schemas to eSheet FormDefinition
+// =============================================================================
+export { convertSurveyJS, convertSurveyJSToESheet, importFromSurveyJS, exportToSurveyJS, SURVEYJS_SYSTEM_PROMPT, } from './lib/surveyjs-converter.js';
+export { importFromMcp, exportToMcp, } from './lib/mcp.js';

package/dist/lib/mcp.d.ts

@@ -0,0 +1,128 @@
+import type { FormDefinition } from '@esheet/core';
+/** A literal const/title pair used in single- and multi-select enums. */
+export interface McpConstOption {
+    const: string;
+    title: string;
+}
+/** String property — plain text, formatted text, or single-select enum. */
+export interface McpStringProp {
+    type: 'string';
+    title?: string;
+    description?: string;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: 'email' | 'uri' | 'date' | 'date-time';
+    /** Simple named enum (parallel array to `enum`). Spec 2025-11-25. */
+    enum?: string[];
+    enumNames?: string[];
+    oneOf?: McpConstOption[];
+    default?: string;
+}
+/** Numeric property. */
+export interface McpNumberProp {
+    type: 'number' | 'integer';
+    title?: string;
+    description?: string;
+    minimum?: number;
+    maximum?: number;
+    default?: number;
+}
+/** Boolean property. */
+export interface McpBooleanProp {
+    type: 'boolean';
+    title?: string;
+    description?: string;
+    default?: boolean;
+}
+/** Multi-select enum property. */
+export interface McpArrayProp {
+    type: 'array';
+    title?: string;
+    description?: string;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    /** Spec 2025-11-25 wraps enum inside `{ type: "string", enum: [...] }` or uses `anyOf`. */
+    items: {
+        type?: string;
+        enum: string[];
+    } | {
+        anyOf: McpConstOption[];
+    };
+    default?: string[];
+}
+export type McpProperty = McpStringProp | McpNumberProp | McpBooleanProp | McpArrayProp;
+/** The `requestedSchema` object in an MCP form-mode elicitation request. */
+export interface McpElicitationSchema {
+    type: 'object';
+    title?: string;
+    properties: Record<string, McpProperty>;
+    required?: string[];
+}
+/** Full MCP JSON-RPC 2.0 elicitation/create request envelope (spec 2025-11-25). */
+export interface McpElicitationRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: 'elicitation/create';
+    params: {
+        /** Form mode (default when omitted). */
+        mode?: 'form';
+        message: string;
+        requestedSchema: McpElicitationSchema;
+    } | {
+        /** URL mode — out-of-band interaction, no requestedSchema. */
+        mode: 'url';
+        message: string;
+        url: string;
+        elicitationId: string;
+    };
+}
+/**
+ * Convert an MCP elicitation `requestedSchema` into an eSheet `FormDefinition`.
+ *
+ * Field IDs are taken directly from the property key names so that a round-trip
+ * export preserves the original MCP property names.
+ *
+ * Field types are mapped as follows:
+ * - `string` (plain)                    → `text` (+ `inputType` from `format`)
+ * - `string` with `enum`/`enumNames`    → `radio`
+ * - `string` with `oneOf`               → `radio` (options carry display titles)
+ * - `number` / `integer`                → `text` + `inputType: 'number'`
+ * - `boolean`                           → `boolean`
+ * - `array` with enum items             → `check` (multi-select)
+ *
+ * All MCP constraints (`default`, `minLength`, `maxLength`, `pattern`,
+ * `minimum`, `maximum`, `minItems`, `maxItems`) are preserved in each
+ * field's `_sourceData` so they survive a round-trip export.
+ */
+export declare function importFromMcp(schema: McpElicitationSchema, options?: {
+    formId?: string;
+    title?: string;
+    description?: string;
+    mcpId?: string | number;
+    mcpMessage?: string;
+    /** Top-level envelope `meta` field (non-standard, preserved for round-trip). */
+    mcpMeta?: unknown;
+}): FormDefinition;
+/**
+ * Convert an eSheet `FormDefinition` into an MCP elicitation request (form mode).
+ *
+ * Section containers are flattened — their leaf fields are promoted to the
+ * top-level properties object. Field types with no MCP equivalent (matrix,
+ * ranking, image, html, signature, diagram, display, multitext) are silently
+ * skipped.
+ *
+ * All MCP constraints stored in `_sourceData` during import are restored so
+ * the output is a lossless round-trip of the original schema.
+ *
+ * Field types map as follows:
+ * - `text` / `longtext`             → `string` (+ `format` from `inputType`)
+ * - `boolean`                       → `boolean`
+ * - `radio` / `dropdown`            → `string` enum (with or without titles)
+ * - `check` / `multiselectdropdown` → `array` enum (with or without titles)
+ * - `rating`                        → `integer` (min=1, max=option count)
+ * - `slider`                        → `number`
+ */
+export declare function exportToMcp(definition: FormDefinition): McpElicitationRequest;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/lib/mcp.d.ts.map

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

package/dist/lib/mcp.js

@@ -0,0 +1,408 @@
+import { generateOptionId } from '@esheet/core';
+// ---------------------------------------------------------------------------
+// Import: MCP elicitation schema → FormDefinition
+// ---------------------------------------------------------------------------
+/**
+ * Convert an MCP elicitation `requestedSchema` into an eSheet `FormDefinition`.
+ *
+ * Field IDs are taken directly from the property key names so that a round-trip
+ * export preserves the original MCP property names.
+ *
+ * Field types are mapped as follows:
+ * - `string` (plain)                    → `text` (+ `inputType` from `format`)
+ * - `string` with `enum`/`enumNames`    → `radio`
+ * - `string` with `oneOf`               → `radio` (options carry display titles)
+ * - `number` / `integer`                → `text` + `inputType: 'number'`
+ * - `boolean`                           → `boolean`
+ * - `array` with enum items             → `check` (multi-select)
+ *
+ * All MCP constraints (`default`, `minLength`, `maxLength`, `pattern`,
+ * `minimum`, `maximum`, `minItems`, `maxItems`) are preserved in each
+ * field's `_sourceData` so they survive a round-trip export.
+ */
+export function importFromMcp(schema, options) {
+    const existingIds = new Set();
+    const requiredKeys = new Set(schema.required ?? []);
+    const fields = Object.entries(schema.properties ?? {}).map(([key, prop]) => mcpPropToField(key, prop, requiredKeys.has(key), existingIds));
+    // Preserve MCP envelope + schema metadata for lossless round-trip export.
+    const mcpMeta = {};
+    if (options?.mcpId !== undefined)
+        mcpMeta['mcpId'] = options.mcpId;
+    if (options?.mcpMessage !== undefined)
+        mcpMeta['mcpMessage'] = options.mcpMessage;
+    if (schema.title !== undefined)
+        mcpMeta['schemaTitle'] = schema.title;
+    if (options?.mcpMeta !== undefined)
+        mcpMeta['meta'] = options.mcpMeta;
+    const hasMcpMeta = Object.keys(mcpMeta).length > 0;
+    return {
+        id: options?.formId ?? 'mcp-form',
+        ...(options?.title !== undefined ? { title: options.title } : {}),
+        ...(options?.description !== undefined
+            ? { description: options.description }
+            : {}),
+        ...(hasMcpMeta ? { _sourceData: mcpMeta } : {}),
+        fields,
+    };
+}
+function mcpPropToField(key, prop, isRequired, existingIds) {
+    const question = prop.title;
+    // Collect all preservable MCP metadata into _sourceData.
+    const meta = {};
+    if (prop.description !== undefined)
+        meta.description = prop.description;
+    const shared = {
+        id: key,
+        ...(question !== undefined ? { question } : {}),
+        ...(isRequired ? { required: true } : {}),
+    };
+    if (prop.type === 'object') {
+        // Nested objects are outside the MCP flat-form spec — import as longtext
+        // so the user can inspect/paste the JSON value. Full definition preserved
+        // in _sourceData so export restores it verbatim.
+        return {
+            ...shared,
+            _sourceData: { ...meta, mcpPropDefinition: prop },
+            fieldType: 'longtext',
+        };
+    }
+    if (prop.type === 'array') {
+        if (prop.default !== undefined)
+            meta.default = prop.default;
+        if (prop.minItems !== undefined)
+            meta.minItems = prop.minItems;
+        if (prop.maxItems !== undefined)
+            meta.maxItems = prop.maxItems;
+        if (prop.uniqueItems !== undefined)
+            meta.uniqueItems = prop.uniqueItems;
+        const options = mcpItemsToOptions(prop.items, existingIds);
+        // Array of objects (no enum/anyOf) is outside spec — fall back to longtext,
+        // full definition preserved for verbatim export.
+        if (options === null) {
+            return {
+                ...shared,
+                _sourceData: { ...meta, mcpPropDefinition: prop },
+                fieldType: 'longtext',
+            };
+        }
+        return {
+            ...shared,
+            ...(Object.keys(meta).length > 0 ? { _sourceData: meta } : {}),
+            fieldType: 'check',
+            options,
+        };
+    }
+    if (prop.type === 'boolean') {
+        if (prop.default !== undefined)
+            meta.default = prop.default;
+        return {
+            ...shared,
+            ...(Object.keys(meta).length > 0 ? { _sourceData: meta } : {}),
+            fieldType: 'boolean',
+        };
+    }
+    if (prop.type === 'number' || prop.type === 'integer') {
+        meta.mcpType = prop.type;
+        if (prop.default !== undefined)
+            meta.default = prop.default;
+        if (prop.minimum !== undefined)
+            meta.minimum = prop.minimum;
+        if (prop.maximum !== undefined)
+            meta.maximum = prop.maximum;
+        return {
+            ...shared,
+            ...(Object.keys(meta).length > 0 ? { _sourceData: meta } : {}),
+            fieldType: 'text',
+            inputType: 'number',
+        };
+    }
+    // prop.type === 'string'
+    const strProp = prop;
+    if (strProp.default !== undefined)
+        meta.default = strProp.default;
+    if (strProp.minLength !== undefined)
+        meta.minLength = strProp.minLength;
+    if (strProp.maxLength !== undefined)
+        meta.maxLength = strProp.maxLength;
+    if (strProp.pattern !== undefined)
+        meta.pattern = strProp.pattern;
+    const metaSpread = Object.keys(meta).length > 0 ? { _sourceData: meta } : {};
+    if (strProp.oneOf) {
+        return {
+            ...shared,
+            ...metaSpread,
+            fieldType: 'radio',
+            options: strProp.oneOf.map(({ const: v, title: t }) => makeOption(v, existingIds, t)),
+        };
+    }
+    if (strProp.enum) {
+        // `enumNames` (parallel array) provides display titles — spec 2025-11-25.
+        const names = strProp.enumNames;
+        return {
+            ...shared,
+            ...metaSpread,
+            fieldType: 'radio',
+            options: strProp.enum.map((v, i) => makeOption(v, existingIds, names?.[i])),
+        };
+    }
+    // plain string
+    return {
+        ...shared,
+        ...metaSpread,
+        fieldType: 'text',
+        ...(strProp.format !== undefined
+            ? { inputType: mcpFormatToInputType(strProp.format) }
+            : {}),
+    };
+}
+/**
+ * Returns null when items is an array-of-objects (outside MCP flat-form spec).
+ * Returns an empty array for a valid but empty enum.
+ */
+function mcpItemsToOptions(items, existingIds) {
+    if ('anyOf' in items) {
+        return items.anyOf.map(({ const: v, title: t }) => makeOption(v, existingIds, t));
+    }
+    if (!Array.isArray(items.enum)) {
+        // items is an object schema (array-of-objects) — not a flat enum.
+        return null;
+    }
+    return items.enum.map((v) => makeOption(v, existingIds));
+}
+function makeOption(value, existingIds, text) {
+    const id = generateOptionId(existingIds);
+    existingIds.add(id);
+    return text !== undefined ? { id, value, text } : { id, value };
+}
+function mcpFormatToInputType(format) {
+    const map = {
+        email: 'email',
+        uri: 'url',
+        date: 'date',
+        'date-time': 'datetime-local',
+    };
+    return format !== undefined ? map[format] : undefined;
+}
+// ---------------------------------------------------------------------------
+// Export: FormDefinition → MCP elicitation schema
+// ---------------------------------------------------------------------------
+/**
+ * Convert an eSheet `FormDefinition` into an MCP elicitation request (form mode).
+ *
+ * Section containers are flattened — their leaf fields are promoted to the
+ * top-level properties object. Field types with no MCP equivalent (matrix,
+ * ranking, image, html, signature, diagram, display, multitext) are silently
+ * skipped.
+ *
+ * All MCP constraints stored in `_sourceData` during import are restored so
+ * the output is a lossless round-trip of the original schema.
+ *
+ * Field types map as follows:
+ * - `text` / `longtext`             → `string` (+ `format` from `inputType`)
+ * - `boolean`                       → `boolean`
+ * - `radio` / `dropdown`            → `string` enum (with or without titles)
+ * - `check` / `multiselectdropdown` → `array` enum (with or without titles)
+ * - `rating`                        → `integer` (min=1, max=option count)
+ * - `slider`                        → `number`
+ */
+export function exportToMcp(definition) {
+    const properties = {};
+    const required = [];
+    for (const field of collectLeafFields(definition.fields)) {
+        const prop = fieldToMcpProp(field);
+        if (prop === null)
+            continue;
+        properties[field.id] = prop;
+        if (field.required)
+            required.push(field.id);
+    }
+    const src = definition._sourceData;
+    const requestedSchema = { type: 'object', properties };
+    if (src?.schemaTitle !== undefined)
+        requestedSchema.title = src.schemaTitle;
+    if (required.length > 0)
+        requestedSchema.required = required;
+    const envelopeId = src?.mcpId ?? definition.id;
+    const message = src?.mcpMessage ?? definition.description ?? definition.title ?? '';
+    const envelope = {
+        jsonrpc: '2.0',
+        id: envelopeId,
+        method: 'elicitation/create',
+        params: { mode: 'form', message, requestedSchema },
+    };
+    // Restore non-standard top-level meta if it was preserved during import.
+    if (src?.meta !== undefined) {
+        envelope['meta'] = src.meta;
+    }
+    return envelope;
+}
+/** Recursively flatten sections to their answerable leaf fields. */
+function collectLeafFields(fields) {
+    const result = [];
+    for (const f of fields) {
+        if (f.fieldType === 'section' && f.fields) {
+            result.push(...collectLeafFields(f.fields));
+        }
+        else {
+            result.push(f);
+        }
+    }
+    return result;
+}
+function fieldToMcpProp(field) {
+    const title = field.question;
+    const meta = field._sourceData;
+    const description = meta?.description;
+    switch (field.fieldType) {
+        case 'text':
+        case 'longtext': {
+            // If this field was imported from a non-flat MCP type (object or
+            // array-of-objects), restore the original property definition verbatim.
+            if (meta?.mcpPropDefinition !== undefined) {
+                return meta.mcpPropDefinition;
+            }
+            // Restore number/integer fields that were imported as text+inputType:number.
+            if (meta?.mcpType !== undefined) {
+                return {
+                    type: meta.mcpType,
+                    ...(title !== undefined ? { title } : {}),
+                    ...(description !== undefined ? { description } : {}),
+                    ...(meta.minimum !== undefined ? { minimum: meta.minimum } : {}),
+                    ...(meta.maximum !== undefined ? { maximum: meta.maximum } : {}),
+                    ...(meta.default !== undefined
+                        ? { default: meta.default }
+                        : {}),
+                };
+            }
+            const format = inputTypeToMcpFormat(field.inputType);
+            return {
+                type: 'string',
+                ...(title !== undefined ? { title } : {}),
+                ...(description !== undefined ? { description } : {}),
+                ...(meta?.minLength !== undefined ? { minLength: meta.minLength } : {}),
+                ...(meta?.maxLength !== undefined ? { maxLength: meta.maxLength } : {}),
+                ...(meta?.pattern !== undefined ? { pattern: meta.pattern } : {}),
+                ...(format !== undefined ? { format } : {}),
+                ...(meta?.default !== undefined
+                    ? { default: meta.default }
+                    : {}),
+            };
+        }
+        case 'boolean':
+            return {
+                type: 'boolean',
+                ...(title !== undefined ? { title } : {}),
+                ...(description !== undefined ? { description } : {}),
+                ...(meta?.default !== undefined
+                    ? { default: meta.default }
+                    : {}),
+            };
+        case 'radio':
+        case 'dropdown': {
+            const options = field.options ?? [];
+            if (options.length === 0) {
+                return {
+                    type: 'string',
+                    ...(title !== undefined ? { title } : {}),
+                    ...(description !== undefined ? { description } : {}),
+                    ...(meta?.default !== undefined
+                        ? { default: meta.default }
+                        : {}),
+                };
+            }
+            const hasText = options.some((o) => o.text !== undefined);
+            if (hasText) {
+                return {
+                    type: 'string',
+                    ...(title !== undefined ? { title } : {}),
+                    ...(description !== undefined ? { description } : {}),
+                    oneOf: options.map((o) => ({
+                        const: o.value,
+                        title: o.text ?? o.value,
+                    })),
+                    ...(meta?.default !== undefined
+                        ? { default: meta.default }
+                        : {}),
+                };
+            }
+            return {
+                type: 'string',
+                ...(title !== undefined ? { title } : {}),
+                ...(description !== undefined ? { description } : {}),
+                enum: options.map((o) => o.value),
+                ...(meta?.default !== undefined
+                    ? { default: meta.default }
+                    : {}),
+            };
+        }
+        case 'check':
+        case 'multiselectdropdown': {
+            const options = field.options ?? [];
+            const hasText = options.some((o) => o.text !== undefined);
+            const items = hasText
+                ? {
+                    anyOf: options.map((o) => ({
+                        const: o.value,
+                        title: o.text ?? o.value,
+                    })),
+                }
+                : { type: 'string', enum: options.map((o) => o.value) };
+            return {
+                type: 'array',
+                ...(title !== undefined ? { title } : {}),
+                ...(description !== undefined ? { description } : {}),
+                ...(meta?.minItems !== undefined ? { minItems: meta.minItems } : {}),
+                ...(meta?.maxItems !== undefined ? { maxItems: meta.maxItems } : {}),
+                ...(meta?.uniqueItems !== undefined
+                    ? { uniqueItems: meta.uniqueItems }
+                    : {}),
+                items,
+                ...(meta?.default !== undefined
+                    ? { default: meta.default }
+                    : {}),
+            };
+        }
+        case 'rating': {
+            const max = field.options?.length;
+            return {
+                type: 'integer',
+                minimum: 1,
+                ...(max !== undefined ? { maximum: max } : {}),
+                ...(title !== undefined ? { title } : {}),
+                ...(description !== undefined ? { description } : {}),
+                ...(meta?.default !== undefined
+                    ? { default: meta.default }
+                    : {}),
+            };
+        }
+        case 'slider': {
+            // Restore number vs integer distinction from original import.
+            const numType = meta?.mcpType ?? 'number';
+            return {
+                type: numType,
+                ...(title !== undefined ? { title } : {}),
+                ...(description !== undefined ? { description } : {}),
+                ...(meta?.minimum !== undefined ? { minimum: meta.minimum } : {}),
+                ...(meta?.maximum !== undefined ? { maximum: meta.maximum } : {}),
+                ...(meta?.default !== undefined
+                    ? { default: meta.default }
+                    : {}),
+            };
+        }
+        default:
+            // ranking, multitext, singlematrix, multimatrix, image, html,
+            // signature, diagram, display → no MCP equivalent
+            return null;
+    }
+}
+function inputTypeToMcpFormat(inputType) {
+    if (inputType === undefined)
+        return undefined;
+    const map = {
+        email: 'email',
+        url: 'uri',
+        date: 'date',
+        'datetime-local': 'date-time',
+    };
+    return map[inputType];
+}

package/dist/lib/surveyjs-converter.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Convert SurveyJS schema to eSheet FormDefinition.
+ *
+ * SurveyJS is well-known with lots of training data, so AI models
+ * generate better SurveyJS output. We leverage this by having AI
+ * generate SurveyJS, then converting to eSheet format.
+ */
+import type { FormDefinition } from '@esheet/core';
+interface SurveyJSChoice {
+    value: string;
+    text?: string;
+    score?: number;
+}
+interface SurveyJSMatrixItem {
+    value: string;
+    text?: string;
+    score?: number;
+}
+interface SurveyJSMultipleTextItem {
+    name: string;
+    title?: string;
+    isRequired?: boolean;
+    inputType?: string;
+    placeholder?: string;
+}
+interface SurveyJSElement {
+    type: string;
+    name: string;
+    title?: string;
+    description?: string;
+    isRequired?: boolean;
+    inputType?: string;
+    choices?: (string | SurveyJSChoice)[];
+    rows?: (string | SurveyJSMatrixItem)[];
+    columns?: (string | SurveyJSMatrixItem)[];
+    visibleIf?: string;
+    enableIf?: string;
+    requiredIf?: string;
+    elements?: SurveyJSElement[];
+    html?: string;
+    imageLink?: string;
+    altText?: string;
+    expression?: string;
+    placeholder?: string;
+    defaultValue?: unknown;
+    defaultValueExpression?: string;
+    min?: number | string;
+    max?: number | string;
+    step?: number;
+    rateMin?: number;
+    rateMax?: number;
+    rateStep?: number;
+    minRateDescription?: string;
+    maxRateDescription?: string;
+    showOtherItem?: boolean;
+    otherText?: string;
+    showNoneItem?: boolean;
+    noneText?: string;
+    showSelectAllItem?: boolean;
+    selectAllText?: string;
+    storeOthersAsComment?: boolean;
+    colCount?: number;
+    allowMultiple?: boolean;
+    acceptedTypes?: string;
+    items?: SurveyJSMultipleTextItem[];
+}
+interface SurveyJSPage {
+    name?: string;
+    title?: string;
+    elements?: SurveyJSElement[];
+}
+interface SurveyJSSchemaMeta {
+    locale?: string;
+    logo?: string;
+    logoPosition?: string;
+    showProgressBar?: string;
+    progressBarType?: string;
+    completedHtml?: string;
+    showQuestionNumbers?: string | boolean;
+    questionTitleLocation?: string;
+    calculatedValues?: unknown[];
+    triggers?: unknown[];
+}
+interface SurveyJSSchema extends SurveyJSSchemaMeta {
+    title?: string;
+    description?: string;
+    pages?: SurveyJSPage[];
+    elements?: SurveyJSElement[];
+}
+/**
+ * Convert a SurveyJS schema to eSheet FormDefinition.
+ */
+export declare function convertSurveyJSToESheet(survey: SurveyJSSchema): FormDefinition;
+/**
+ * System prompt for generating SurveyJS format.
+ * AI models have better training data for SurveyJS.
+ */
+export declare const SURVEYJS_SYSTEM_PROMPT = "You are an expert form designer. Output ONLY a valid SurveyJS JSON schema \u2014 no markdown, no explanation, no code blocks, raw JSON only. STRUCTURE: {\"title\":\"...\",\"pages\":[{\"name\":\"page1\",\"title\":\"...\",\"elements\":[...]}]} FIELD TYPES \u2014 always pick most specific: short text\u2192text (add inputType:\"email\"/\"tel\"/\"date\"/\"number\"/\"url\"), long text\u2192comment, single choice\u2192radiogroup (NOT text), multiple choice\u2192checkbox (NOT text), long list single\u2192dropdown, long list multi\u2192tagbox, yes/no\u2192boolean (NOT radiogroup), 1-N scale\u2192rating (set rateMin/rateMax/minRateDescription/maxRateDescription), ordered preference\u2192ranking, grid single answer\u2192matrix (rows=items columns=scale labels), grid multi answer\u2192matrixdropdown, signature\u2192signaturepad (NEVER use text), file upload\u2192file, image pick\u2192imagepicker, multiple short inputs\u2192multipletext. RULES: use pages only to group related fields \u2014 never use panel type; every page must have a title; add \"isRequired\":true on important fields; use \"visibleIf\" for follow-up questions: \"{field} = 'value'\"; choices format: [{\"value\":\"id\",\"text\":\"Label\"}]. For scored surveys: use numeric strings as column values (\"0\",\"1\",\"2\",\"3\"), add calculatedValues at top level. OUTPUT: raw JSON only, no prose.";
+/**
+ * Convert an eSheet FormDefinition back to a SurveyJS schema.
+ *
+ * Preserves original SurveyJS element names, types, and conditional expressions
+ * stored in `_sourceData` during import, enabling a lossless round-trip.
+ * Fields without `_sourceData` are reverse-mapped from eSheet types.
+ *
+ * Section fields become pages; non-section fields are placed in a single page.
+ */
+export declare function exportToSurveyJS(form: FormDefinition): SurveyJSSchema;
+/**
+ * Convert a SurveyJS schema to eSheet FormDefinition.
+ * Primary named export matching the importFromMcp / exportToMcp naming convention.
+ */
+export declare const importFromSurveyJS: typeof convertSurveyJSToESheet;
+/**
+ * Convert a SurveyJS schema to eSheet FormDefinition.
+ * Alias for importFromSurveyJS / convertSurveyJSToESheet.
+ */
+export declare const convertSurveyJS: typeof convertSurveyJSToESheet;
+export {};
+//# sourceMappingURL=surveyjs-converter.d.ts.map