@esheet/adapters 0.0.3 → 0.0.4-1

package/dist/fhir/utils.js

@@ -0,0 +1,440 @@
+// ---------------------------------------------------------------------------
+// FHIR Adapter Utilities
+// ---------------------------------------------------------------------------
+import { generateOptionId } from '@esheet/core';
+// ---------------------------------------------------------------------------
+// Extension URLs (Constants)
+// ---------------------------------------------------------------------------
+export const FHIR_EXT = {
+    // Questionnaire item control
+    ITEM_CONTROL: 'http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl',
+    // Validation
+    MIN_VALUE: 'http://hl7.org/fhir/StructureDefinition/minValue',
+    MAX_VALUE: 'http://hl7.org/fhir/StructureDefinition/maxValue',
+    MIN_LENGTH: 'http://hl7.org/fhir/StructureDefinition/minLength',
+    REGEX: 'http://hl7.org/fhir/StructureDefinition/regex',
+    // Option scoring
+    ORDINAL_VALUE: 'http://hl7.org/fhir/StructureDefinition/ordinalValue',
+    // Display
+    HIDDEN: 'http://hl7.org/fhir/StructureDefinition/questionnaire-hidden',
+    ITEM_MEDIA: 'http://hl7.org/fhir/StructureDefinition/questionnaire-itemMedia',
+    // Slider
+    SLIDER_STEP: 'http://hl7.org/fhir/StructureDefinition/questionnaire-sliderStepValue',
+    // Signature
+    SIGNATURE_REQUIRED: 'http://hl7.org/fhir/StructureDefinition/questionnaire-signatureRequired',
+    // SDC / DTR
+    INITIAL_EXPRESSION: 'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-initialExpression',
+    CALCULATED_EXPRESSION: 'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-calculatedExpression',
+    ENABLE_WHEN_EXPRESSION: 'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-enableWhenExpression',
+    VARIABLE: 'http://hl7.org/fhir/StructureDefinition/variable',
+};
+export const ITEM_CONTROL_SYSTEM = 'http://hl7.org/fhir/questionnaire-item-control';
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+/**
+ * Type guard to check if a value is a FHIR Questionnaire resource.
+ */
+export function isFhirQuestionnaire(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return v['resourceType'] === 'Questionnaire';
+}
+/**
+ * Type guard to check if a value is a FHIR QuestionnaireResponse resource.
+ */
+export function isFhirQuestionnaireResponse(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return v['resourceType'] === 'QuestionnaireResponse';
+}
+/**
+ * Map a FHIR item type to eSheet field type.
+ */
+export function mapFhirTypeToEsheet(fhirType, item) {
+    const itemControl = getItemControlCode(item.extension);
+    switch (fhirType) {
+        case 'string':
+            return { fieldType: 'text', inputType: 'string' };
+        case 'text':
+            return { fieldType: 'longtext' };
+        case 'boolean':
+            return { fieldType: 'boolean' };
+        case 'decimal':
+            return { fieldType: 'text', inputType: 'number' };
+        case 'integer':
+            if (itemControl === 'slider') {
+                return { fieldType: 'slider' };
+            }
+            return { fieldType: 'text', inputType: 'number' };
+        case 'date':
+            return { fieldType: 'text', inputType: 'date' };
+        case 'dateTime':
+            return { fieldType: 'text', inputType: 'datetime-local' };
+        case 'time':
+            return { fieldType: 'text', inputType: 'time' };
+        case 'url':
+            return { fieldType: 'text', inputType: 'url' };
+        case 'choice':
+        case 'open-choice':
+            return mapChoiceType(item, itemControl);
+        case 'group':
+            return { fieldType: 'section' };
+        case 'display':
+            return { fieldType: 'display' };
+        case 'attachment':
+            if (hasSignatureRequired(item.extension)) {
+                return { fieldType: 'signature' };
+            }
+            return { fieldType: 'diagram' };
+        case 'reference':
+            return { fieldType: 'text', subType: 'reference' };
+        case 'quantity':
+            return { fieldType: 'text', inputType: 'number', subType: 'quantity' };
+        default:
+            return { fieldType: 'text' };
+    }
+}
+function mapChoiceType(item, itemControl) {
+    const repeats = item.repeats ?? false;
+    if (itemControl === 'drop-down' || itemControl === 'autocomplete') {
+        return repeats
+            ? { fieldType: 'multiselectdropdown' }
+            : { fieldType: 'dropdown' };
+    }
+    if (itemControl === 'check-box') {
+        return { fieldType: 'check' };
+    }
+    if (itemControl === 'radio-button') {
+        return { fieldType: 'radio' };
+    }
+    // Default based on repeats
+    return repeats ? { fieldType: 'check' } : { fieldType: 'radio' };
+}
+/**
+ * Map an eSheet field type to FHIR item type.
+ */
+export function mapEsheetTypeToFhir(esheetType, inputType, subType) {
+    switch (esheetType) {
+        case 'text':
+            return mapTextTypeToFhir(inputType);
+        case 'longtext':
+            return { type: 'text' };
+        case 'boolean':
+            return { type: 'boolean' };
+        case 'radio':
+            return { type: 'choice', itemControl: 'radio-button' };
+        case 'check':
+            return { type: 'choice', itemControl: 'check-box', repeats: true };
+        case 'dropdown':
+            return { type: 'choice', itemControl: 'drop-down' };
+        case 'multiselectdropdown':
+            return { type: 'choice', itemControl: 'drop-down', repeats: true };
+        case 'rating':
+            return { type: 'integer', itemControl: 'slider' };
+        case 'slider':
+            return { type: 'decimal', itemControl: 'slider' };
+        case 'section':
+            return { type: 'group' };
+        case 'display':
+            return { type: 'display' };
+        case 'signature':
+            return { type: 'attachment' };
+        case 'diagram':
+            return { type: 'attachment' };
+        case 'singlematrix':
+        case 'multimatrix':
+            return { type: 'group' };
+        case 'image':
+        case 'html':
+            return { type: 'display' };
+        default:
+            return { type: 'string' };
+    }
+}
+function mapTextTypeToFhir(inputType) {
+    switch (inputType) {
+        case 'number':
+            return { type: 'decimal' };
+        case 'date':
+            return { type: 'date' };
+        case 'datetime-local':
+            return { type: 'dateTime' };
+        case 'time':
+            return { type: 'time' };
+        case 'url':
+            return { type: 'url' };
+        default:
+            return { type: 'string' };
+    }
+}
+// ---------------------------------------------------------------------------
+// Options Conversion
+// ---------------------------------------------------------------------------
+/**
+ * Convert a FHIR Coding to an eSheet FieldOption.
+ */
+export function convertFhirCodingToOption(coding, existingIds, fallbackIndex) {
+    const id = coding.code ?? generateOptionId(existingIds, `opt-${fallbackIndex}`);
+    existingIds.add(id);
+    return {
+        id,
+        value: coding.code ?? '',
+        ...(coding.display ? { text: coding.display } : {}),
+    };
+}
+/**
+ * Convert a FHIR answerOption to an eSheet FieldOption.
+ */
+export function convertAnswerOptionToFieldOption(option, existingIds, index) {
+    const opt = {
+        id: '',
+        value: '',
+    };
+    if (option.valueCoding) {
+        opt.id =
+            option.valueCoding.code ?? generateOptionId(existingIds, `opt-${index}`);
+        opt.value = option.valueCoding.code ?? '';
+        if (option.valueCoding.display) {
+            opt.text = option.valueCoding.display;
+        }
+    }
+    else if (option.valueString !== undefined) {
+        opt.id = toKebabCase(option.valueString) || `opt-${index}`;
+        opt.value = option.valueString;
+    }
+    else if (option.valueInteger !== undefined) {
+        opt.id = String(option.valueInteger);
+        opt.value = String(option.valueInteger);
+    }
+    else if (option.valueDate !== undefined) {
+        opt.id = `date-${index}`;
+        opt.value = option.valueDate;
+    }
+    else if (option.valueTime !== undefined) {
+        opt.id = `time-${index}`;
+        opt.value = option.valueTime;
+    }
+    else {
+        opt.id = generateOptionId(existingIds, `opt-${index}`);
+    }
+    existingIds.add(opt.id);
+    // Extract ordinalValue score from extension
+    const ordinalExt = option.extension?.find((e) => e.url === FHIR_EXT.ORDINAL_VALUE);
+    if (ordinalExt?.valueDecimal !== undefined) {
+        opt.score = ordinalExt.valueDecimal;
+    }
+    else if (ordinalExt?.valueInteger !== undefined) {
+        opt.score = ordinalExt.valueInteger;
+    }
+    return opt;
+}
+/**
+ * Convert an eSheet FieldOption to a FHIR answerOption.
+ */
+export function convertOptionToFhirAnswerOption(option) {
+    const result = {};
+    // Prefer valueCoding for rich options (with display text or score)
+    if (option.text || option.score !== undefined) {
+        result.valueCoding = {
+            code: option.value,
+            display: option.text ?? option.value,
+            system: 'urn:esheet:options',
+        };
+        if (option.score !== undefined) {
+            result.extension = [
+                {
+                    url: FHIR_EXT.ORDINAL_VALUE,
+                    valueDecimal: option.score,
+                },
+            ];
+        }
+    }
+    else {
+        result.valueString = option.value;
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Condition/EnableWhen Conversion
+// ---------------------------------------------------------------------------
+/**
+ * Map a FHIR enableWhen operator to an eSheet condition operator.
+ */
+export function mapFhirOperatorToEsheet(operator, answerBoolean) {
+    switch (operator) {
+        case '=':
+            return 'equals';
+        case '!=':
+            return 'notEquals';
+        case '>':
+            return 'greaterThan';
+        case '>=':
+            return 'greaterThanOrEqual';
+        case '<':
+            return 'lessThan';
+        case '<=':
+            return 'lessThanOrEqual';
+        case 'exists':
+            return answerBoolean === true ? 'notEmpty' : 'empty';
+        default:
+            return null;
+    }
+}
+/**
+ * Map an eSheet condition operator to a FHIR enableWhen operator.
+ */
+export function mapEsheetOperatorToFhir(operator) {
+    switch (operator) {
+        case 'equals':
+            return { operator: '=' };
+        case 'notEquals':
+            return { operator: '!=' };
+        case 'greaterThan':
+            return { operator: '>' };
+        case 'greaterThanOrEqual':
+            return { operator: '>=' };
+        case 'lessThan':
+            return { operator: '<' };
+        case 'lessThanOrEqual':
+            return { operator: '<=' };
+        case 'empty':
+            return { operator: 'exists', answerBoolean: false };
+        case 'notEmpty':
+            return { operator: 'exists', answerBoolean: true };
+        case 'contains':
+        case 'includes':
+            // These require FHIRPath expressions, not supported in basic enableWhen
+            return null;
+        default:
+            return null;
+    }
+}
+/**
+ * Map FHIR enableBehavior to eSheet logic mode.
+ */
+export function mapEnableBehaviorToLogic(behavior) {
+    return behavior === 'any' ? 'OR' : 'AND';
+}
+/**
+ * Extract the answer value from a FHIR enableWhen condition.
+ */
+export function extractEnableWhenAnswer(enableWhen) {
+    if (enableWhen.answerBoolean !== undefined) {
+        return String(enableWhen.answerBoolean);
+    }
+    if (enableWhen.answerDecimal !== undefined) {
+        return String(enableWhen.answerDecimal);
+    }
+    if (enableWhen.answerInteger !== undefined) {
+        return String(enableWhen.answerInteger);
+    }
+    if (enableWhen.answerDate !== undefined) {
+        return enableWhen.answerDate;
+    }
+    if (enableWhen.answerDateTime !== undefined) {
+        return enableWhen.answerDateTime;
+    }
+    if (enableWhen.answerTime !== undefined) {
+        return enableWhen.answerTime;
+    }
+    if (enableWhen.answerString !== undefined) {
+        return enableWhen.answerString;
+    }
+    if (enableWhen.answerCoding?.code !== undefined) {
+        return enableWhen.answerCoding.code;
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Extension Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Get the value of an extension by URL.
+ */
+export function getExtensionValue(extensions, url) {
+    if (!extensions)
+        return undefined;
+    const ext = extensions.find((e) => e.url === url);
+    if (!ext)
+        return undefined;
+    // Return the first non-url value property
+    for (const key of Object.keys(ext)) {
+        if (key.startsWith('value')) {
+            return ext[key];
+        }
+    }
+    return undefined;
+}
+/**
+ * Get the itemControl code from extensions.
+ */
+export function getItemControlCode(extensions) {
+    if (!extensions)
+        return undefined;
+    const ext = extensions.find((e) => e.url === FHIR_EXT.ITEM_CONTROL);
+    if (!ext)
+        return undefined;
+    // itemControl uses valueCodeableConcept
+    const coding = ext.valueCodeableConcept?.coding?.[0];
+    return coding?.code;
+}
+/**
+ * Check if the signatureRequired extension is present and true.
+ */
+export function hasSignatureRequired(extensions) {
+    if (!extensions)
+        return false;
+    const ext = extensions.find((e) => e.url === FHIR_EXT.SIGNATURE_REQUIRED);
+    return ext?.valueBoolean === true;
+}
+/**
+ * Create an itemControl extension.
+ */
+export function createItemControlExtension(controlType) {
+    return {
+        url: FHIR_EXT.ITEM_CONTROL,
+        valueCodeableConcept: {
+            coding: [
+                {
+                    system: ITEM_CONTROL_SYSTEM,
+                    code: controlType,
+                },
+            ],
+        },
+    };
+}
+/**
+ * Create a signatureRequired extension.
+ */
+export function createSignatureRequiredExtension() {
+    return {
+        url: FHIR_EXT.SIGNATURE_REQUIRED,
+        valueBoolean: true,
+    };
+}
+// ---------------------------------------------------------------------------
+// String Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Convert a string to kebab-case for use as an ID.
+ */
+export function toKebabCase(str) {
+    return str
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Generate a simple UUID v4.
+ */
+export function generateUUID() {
+    // Simple UUID v4 implementation
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-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';
+export { convertSurveyJS, convertSurveyJSToESheet, importFromSurveyJS, exportToSurveyJS, isSurveyJSSchema, SURVEYJS_SYSTEM_PROMPT, type SurveyJSDetectionSchema, } from './lib/surveyjs-converter.js';
+export { importFromMcp, exportToMcp, isMcpElicitationRequest, type McpElicitationSchema, type McpElicitationRequest, type McpProperty, type McpStringProp, type McpNumberProp, type McpBooleanProp, type McpArrayProp, type McpConstOption, } from './lib/mcp.js';
+export * from './fhir/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,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;AACtB,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 // =============================================================================
 // @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';
+export { convertSurveyJS, convertSurveyJSToESheet, importFromSurveyJS, exportToSurveyJS, isSurveyJSSchema, SURVEYJS_SYSTEM_PROMPT, } from './lib/surveyjs-converter.js';
+export { importFromMcp, exportToMcp, isMcpElicitationRequest, } from './lib/mcp.js';
+export * from './fhir/index.js';

package/dist/lib/mcp.d.ts

@@ -96,6 +96,8 @@ export interface McpElicitationRequest {
  * `minimum`, `maximum`, `minItems`, `maxItems`) are preserved in each
  * field's `_sourceData` so they survive a round-trip export.
  */
+/** Type guard — detects an MCP elicitation/create JSON-RPC envelope. */
+export declare function isMcpElicitationRequest(value: unknown): value is McpElicitationRequest;
 export declare function importFromMcp(schema: McpElicitationSchema, options?: {
     formId?: string;
     title?: string;

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

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

package/dist/lib/mcp.js

@@ -20,6 +20,13 @@ import { generateOptionId } from '@esheet/core';
  * `minimum`, `maximum`, `minItems`, `maxItems`) are preserved in each
  * field's `_sourceData` so they survive a round-trip export.
  */
+/** Type guard — detects an MCP elicitation/create JSON-RPC envelope. */
+export function isMcpElicitationRequest(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return v['jsonrpc'] === '2.0' && v['method'] === 'elicitation/create';
+}
 export function importFromMcp(schema, options) {
     const existingIds = new Set();
     const requiredKeys = new Set(schema.required ?? []);

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

@@ -116,5 +116,15 @@ export declare const importFromSurveyJS: typeof convertSurveyJSToESheet;
  * Alias for importFromSurveyJS / convertSurveyJSToESheet.
  */
 export declare const convertSurveyJS: typeof convertSurveyJSToESheet;
+/** Minimal SurveyJS schema shape for detection. */
+export interface SurveyJSDetectionSchema {
+    pages?: unknown[];
+    elements?: unknown[];
+}
+/**
+ * Type guard — returns true if the value looks like a SurveyJS schema
+ * (has top-level `pages` or `elements` array but NOT eSheet's `fields` property).
+ */
+export declare function isSurveyJSSchema(value: unknown): value is SurveyJSDetectionSchema;
 export {};
 //# sourceMappingURL=surveyjs-converter.d.ts.map

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

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

package/dist/lib/surveyjs-converter.js

@@ -72,12 +72,15 @@ function convertChoice(choice, index) {
     if (typeof choice === 'string') {
         return { id: toKebabCase(choice) || `opt-${index}`, value: choice };
     }
-    return {
+    const opt = {
         id: toKebabCase(choice.value) || `opt-${index}`,
         value: choice.value,
         text: choice.text,
-        score: choice.score,
     };
+    if (choice.score !== undefined) {
+        opt.score = choice.score;
+    }
+    return opt;
 }
 function convertMatrixRow(item, index) {
     if (typeof item === 'string') {
@@ -92,11 +95,14 @@ function convertMatrixColumn(item, index) {
     if (typeof item === 'string') {
         return { id: toKebabCase(item) || `item-${index}`, value: item };
     }
-    return {
+    const col = {
         id: toKebabCase(item.value) || `item-${index}`,
         value: item.text ?? item.value,
-        score: item.score,
     };
+    if (item.score !== undefined) {
+        col.score = item.score;
+    }
+    return col;
 }
 /**
  * Parse SurveyJS visibleIf expression into eSheet rules.
@@ -418,8 +424,9 @@ export function convertSurveyJSToESheet(survey) {
                 fields.push(...page.elements.map((el) => convertElement(el)));
             }
             else {
-                // Multiple pages become sections
-                const sectionId = toKebabCase(page.name ?? page.title ?? 'page');
+                // Multiple pages become sections — prefix with "page-" to avoid
+                // collisions when a page name matches one of its element names.
+                const sectionId = 'page-' + toKebabCase(page.name ?? page.title ?? 'page');
                 const sectionAncestors = new Set([sectionId]);
                 fields.push({
                     id: sectionId,
@@ -696,3 +703,16 @@ export const importFromSurveyJS = convertSurveyJSToESheet;
  * Alias for importFromSurveyJS / convertSurveyJSToESheet.
  */
 export const convertSurveyJS = convertSurveyJSToESheet;
+/**
+ * Type guard — returns true if the value looks like a SurveyJS schema
+ * (has top-level `pages` or `elements` array but NOT eSheet's `fields` property).
+ */
+export function isSurveyJSSchema(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    const hasPages = Array.isArray(v['pages']);
+    const hasElements = Array.isArray(v['elements']);
+    const hasESheetFields = typeof v['fields'] !== 'undefined';
+    return (hasPages || hasElements) && !hasESheetFields;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esheet/adapters",
-  "version": "0.0.3",
+  "version": "0.0.4-1",
   "description": "Convert external form schemas (SurveyJS, etc.) to eSheet FormDefinition",
   "repository": {
     "type": "git",
@@ -32,7 +32,7 @@
     ]
   },
   "dependencies": {
-    "@esheet/core": "*",
+    "@esheet/core": "0.0.4-1",
     "tslib": "^2.3.0"
   },
   "devDependencies": {}