@esheet/builder 0.0.4-0 → 0.0.4-2

package/dist/index.d.ts

@@ -30,9 +30,11 @@ export declare const BUILDER_TOOL_DEFINITIONS: readonly ToolDefinition[];
 /**
  * BuilderHeader — top bar with Build/Code/Preview mode toggle and Import/Export actions.
  */
-export declare function BuilderHeader(_props: BuilderHeaderProps): JSX.Element;
+export declare function BuilderHeader({ allowDangerousJS, }: BuilderHeaderProps): JSX.Element;
 
 export declare interface BuilderHeaderProps {
+    /** When false (default), hides the JS toggle and prevents enabling dangerous JS. */
+    allowDangerousJS?: boolean;
 }
 
 export { BuilderMode }
@@ -79,6 +81,7 @@ export declare interface BuilderTools {
     option: {
         add: (fieldId: string, value?: string) => string | null;
         update: (fieldId: string, optionId: string, value: string) => boolean;
+        setScore: (fieldId: string, optionId: string, score: number | undefined) => boolean;
         remove: (fieldId: string, optionId: string) => boolean;
     };
     /** Granular row mutations (matrix fields). */
@@ -91,6 +94,7 @@ export declare interface BuilderTools {
     column: {
         add: (fieldId: string, value?: string) => string | null;
         update: (fieldId: string, columnId: string, value: string) => boolean;
+        setScore: (fieldId: string, columnId: string, score: number | undefined) => boolean;
         remove: (fieldId: string, columnId: string) => boolean;
     };
     /** Move a field to a new index. */
@@ -145,6 +149,13 @@ export declare interface EsheetBuilderProps {
     definition?: FormDefinition | Record<string, unknown>;
     /** Callback fired when the form definition changes. */
     onChange?: (definition: FormDefinition) => void;
+    /**
+     * Opt-in to allow dangerously embedded JavaScript in this builder instance.
+     * When `false` (default), the JS toggle is hidden and any `dangerouslyAllowJS: true`
+     * flag in the loaded schema is suppressed — JS never executes regardless of schema content.
+     * Only set to `true` when you fully control and trust the form schemas being authored.
+     */
+    allowDangerousJS?: boolean;
     /**
      * Called once after the builder mounts, providing a narrow `BuilderTools`
      * facade for MCP / AI tool integrations. Not intended for general developer use —
@@ -228,7 +239,7 @@ export declare interface FieldSummary {
  * </FieldWrapper>
  * ```
  */
-export declare function FieldWrapper({ fieldId, form, ui, dragHandleRef, isSelectedOverride, onSelectOverride, selectedVariant, forceExpandVersion, forceCollapseVersion, children, }: FieldWrapperProps): JSX.Element | null;
+export declare function FieldWrapper({ fieldId, form, ui, dragHandleRef, isSelectedOverride, onSelectOverride, selectedVariant, forceExpandVersion, forceCollapseVersion, computedValue, children, }: FieldWrapperProps): JSX.Element | null;
 
 export declare interface FieldWrapperProps {
     /** The field ID */
@@ -249,6 +260,8 @@ export declare interface FieldWrapperProps {
     forceExpandVersion?: number;
     /** Optional signal used to force collapse a field wrapper. */
     forceCollapseVersion?: number;
+    /** Computed value from setValue effects (if applicable). */
+    computedValue?: string | number | null;
     /** Render function that receives field data and tools */
     children: (props: FieldWrapperRenderProps) => default_2.ReactNode;
 }
@@ -266,6 +279,8 @@ export declare interface FormApi {
     isVisible: boolean;
     isEnabled: boolean;
     isRequired: boolean;
+    isReadOnly: boolean;
+    isSoftRequired: boolean;
     normalized: NormalizedDefinition;
     responses: FieldResponseMap;
     instanceId: string;
@@ -289,6 +304,7 @@ export declare interface FormApi {
     option: {
         add: (value?: string) => string | null;
         update: (optId: string, value: string) => boolean;
+        setScore: (optId: string, score: number | undefined) => boolean;
         remove: (optId: string) => boolean;
     };
     row: {
@@ -299,6 +315,7 @@ export declare interface FormApi {
     column: {
         add: (value?: string) => string | null;
         update: (colId: string, value: string) => boolean;
+        setScore: (colId: string, score: number | undefined) => boolean;
         remove: (colId: string) => boolean;
     };
     _form: FormStore;