@copilotkit/react-textarea 0.9.0 → 0.11.0

package/dist/chunk-YICIML6J.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/base-copilot-textarea/base-copilot-textarea.tsx"],"names":["_a","value"],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useState } from \"react\";\nimport { Descendant, Editor } from \"slate\";\nimport { Editable, Slate } from \"slate-react\";\nimport { twMerge } from \"tailwind-merge\";\nimport { useAutosuggestions } from \"../../hooks/use-autosuggestions\";\nimport { useCopilotTextareaEditor } from \"../../hooks/use-copilot-textarea-editor\";\nimport {\n  getFullEditorTextWithNewlines,\n  getTextAroundCursor,\n} from \"../../lib/get-text-around-cursor\";\nimport { addAutocompletionsToEditor } from \"../../lib/slatejs-edits/add-autocompletions\";\nimport { clearAutocompletionsFromEditor } from \"../../lib/slatejs-edits/clear-autocompletions\";\nimport { replaceEditorText } from \"../../lib/slatejs-edits/replace-text\";\nimport {\n  AutosuggestionsBareFunction,\n  BaseAutosuggestionsConfig,\n  defaultBaseAutosuggestionsConfig,\n} from \"../../types/base\";\nimport { AutosuggestionState } from \"../../types/base/autosuggestion-state\";\nimport { BaseCopilotTextareaProps } from \"../../types/base/base-copilot-textarea-props\";\nimport \"./base-copilot-textarea.css\";\nimport { makeRenderElementFunction } from \"./render-element\";\nimport { makeRenderPlaceholderFunction } from \"./render-placeholder\";\nimport { useAddBrandingCss } from \"./use-add-branding-css\";\n\nexport function BaseCopilotTextarea(\n  props: BaseCopilotTextareaProps & {\n    autosuggestionsFunction: AutosuggestionsBareFunction;\n  }\n): JSX.Element {\n  const autosuggestionsConfig: BaseAutosuggestionsConfig = {\n    ...defaultBaseAutosuggestionsConfig,\n    ...props.autosuggestionsConfig,\n  };\n\n  const valueOnInitialRender = useMemo(() => props.value ?? \"\", []);\n  const [lastKnownFullEditorText, setLastKnownFullEditorText] =\n    useState(valueOnInitialRender);\n\n  const initialValue: Descendant[] = useMemo(() => {\n    return [\n      {\n        type: \"paragraph\",\n        children: [{ text: valueOnInitialRender }],\n      },\n    ];\n  }, [valueOnInitialRender]);\n\n  const editor = useCopilotTextareaEditor();\n\n  const insertText = useCallback(\n    (autosuggestion: AutosuggestionState) => {\n      Editor.insertText(editor, autosuggestion.text, {\n        at: autosuggestion.point,\n      });\n    },\n    [editor]\n  );\n\n  const {\n    currentAutocompleteSuggestion,\n    onChangeHandler: onChangeHandlerForAutocomplete,\n    onKeyDownHandler: onKeyDownHandlerForAutocomplete,\n  } = useAutosuggestions(\n    autosuggestionsConfig.debounceTime,\n    autosuggestionsConfig.acceptAutosuggestionKey,\n    props.autosuggestionsFunction,\n    insertText,\n    autosuggestionsConfig.disableWhenEmpty,\n    autosuggestionsConfig.disabled\n  );\n\n  // sync autosuggestions state with the editor\n  useEffect(() => {\n    clearAutocompletionsFromEditor(editor);\n    if (currentAutocompleteSuggestion) {\n      addAutocompletionsToEditor(\n        editor,\n        currentAutocompleteSuggestion.text,\n        currentAutocompleteSuggestion.point\n      );\n    }\n  }, [currentAutocompleteSuggestion]);\n\n  const suggestionStyleAugmented: React.CSSProperties = useMemo(() => {\n    return {\n      fontStyle: \"italic\",\n      color: \"gray\",\n      ...props.suggestionsStyle,\n    };\n  }, [props.suggestionsStyle]);\n\n  useAddBrandingCss(suggestionStyleAugmented, props.disableBranding);\n\n  const renderElementMemoized = useMemo(() => {\n    return makeRenderElementFunction(suggestionStyleAugmented);\n  }, [suggestionStyleAugmented]);\n\n  const renderPlaceholderMemoized = useMemo(() => {\n    // For some reason slateJS specifies a top value of 0, which makes for strange styling. We override this here.\n    const placeholderStyleSlatejsOverrides: React.CSSProperties = {\n      top: undefined,\n    };\n\n    const placeholderStyleAugmented: React.CSSProperties = {\n      ...placeholderStyleSlatejsOverrides,\n      ...props.placeholderStyle,\n    };\n\n    return makeRenderPlaceholderFunction(placeholderStyleAugmented);\n  }, [props.placeholderStyle]);\n\n  // update the editor text, but only when the value changes from outside the component\n  useEffect(() => {\n    if (props.value === lastKnownFullEditorText) {\n      return;\n    }\n\n    setLastKnownFullEditorText(props.value ?? \"\");\n    replaceEditorText(editor, props.value ?? \"\");\n  }, [props.value]);\n\n  // separate into TextareaHTMLAttributes<HTMLDivElement> and CopilotTextareaProps\n  const {\n    placeholderStyle,\n    value,\n    onValueChange,\n    autosuggestionsConfig: autosuggestionsConfigFromProps,\n    autosuggestionsFunction,\n    className,\n    onChange,\n    onKeyDown,\n    ...propsToForward\n  } = props;\n\n  const moddedClassName = (() => {\n    const baseClassName = \"copilot-textarea\";\n    const brandingClass = props.disableBranding\n      ? \"no-branding\"\n      : \"with-branding\";\n    const defaultTailwindClassName = \"bg-white overflow-y-auto resize-y\";\n    const mergedClassName = twMerge(defaultTailwindClassName, className ?? \"\");\n    return `${baseClassName} ${brandingClass} ${mergedClassName}`;\n  })();\n\n  return (\n    // Add the editable component inside the context.\n    <Slate\n      editor={editor}\n      initialValue={initialValue}\n      onChange={(value) => {\n        const newEditorState = getTextAroundCursor(editor);\n\n        const fullEditorText = newEditorState\n          ? newEditorState.textBeforeCursor + newEditorState.textAfterCursor\n          : getFullEditorTextWithNewlines(editor); // we don't double-parse the editor. When `newEditorState` is null, we didn't parse the editor yet.\n\n        setLastKnownFullEditorText(fullEditorText);\n        onChangeHandlerForAutocomplete(newEditorState);\n\n        props.onValueChange?.(fullEditorText);\n        props.onChange?.(makeSemiFakeReactTextAreaEvent(fullEditorText));\n      }}\n    >\n      <Editable\n        renderElement={renderElementMemoized}\n        renderPlaceholder={renderPlaceholderMemoized}\n        onKeyDown={(event) => {\n          onKeyDownHandlerForAutocomplete(event); // forward the event for internal use\n          props.onKeyDown?.(event); // forward the event for external use\n        }}\n        className={moddedClassName}\n        {...propsToForward}\n      />\n    </Slate>\n  );\n}\n\n// Consumers of <textarea> expect a `onChange: (React.ChangeEvent<HTMLTextAreaElement>) => void` event handler to be passed in.\n// This is *extremely* common, and we want to support it.\n//\n// We can't support the full functionality, but in 99% of cases, the consumer only cares about the `event.target.value` property --\n// that's how they get the new value of the textarea.\n//\n// So, the tradeoff we are making is minimizing compiler complaint, with a small chance of runtime error.\n// The alternative would be defining a different onChange entrypoint (we actually do have that in `onValueChange`),\n// And starting to explain subtleties to users the moment they try to use the component for the first time for very basic functionality.\n//\n// If this proves problematic, we can always revisit this decision.\nfunction makeSemiFakeReactTextAreaEvent(\n  currentText: string\n): React.ChangeEvent<HTMLTextAreaElement> {\n  return {\n    target: {\n      value: currentText,\n      type: \"copilot-textarea\",\n    },\n    currentTarget: {\n      value: currentText,\n      type: \"copilot-textarea\",\n    },\n  } as React.ChangeEvent<HTMLTextAreaElement>;\n}\n"]}

package/dist/{chunk-ROH375UB.mjs → chunk-YTT5NE6B.mjs}

@@ -1,6 +1,6 @@
 import { useMakeStandardAutosuggestionFunction } from './chunk-A3SFEHWZ.mjs';
-import { defaultAutosuggestionsConfig } from './chunk-ZPACRCJ6.mjs';
-import { BaseCopilotTextarea } from './chunk-4EA7I44O.mjs';
+import { defaultAutosuggestionsConfig } from './chunk-EHQ5TN4R.mjs';
+import { BaseCopilotTextarea } from './chunk-YICIML6J.mjs';
 import { __spreadValues, __spreadProps } from './chunk-MRXNTQOX.mjs';
 import { jsx } from 'react/jsx-runtime';
 
@@ -22,4 +22,4 @@ function CopilotTextarea(props) {
 
 export { CopilotTextarea };
 //# sourceMappingURL=out.js.map
-//# sourceMappingURL=chunk-ROH375UB.mjs.map
+//# sourceMappingURL=chunk-YTT5NE6B.mjs.map

package/dist/chunk-YTT5NE6B.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/copilot-textarea/copilot-textarea.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;AA+BI;AAhBG,SAAS,gBAAgB,OAA0C;AACxE,QAAM,wBAA+C,kCAChD,+BACA,MAAM;AAGX,QAAM,0BAA0B;AAAA,IAC9B,sBAAsB;AAAA,IACtB,sBAAsB;AAAA,IACtB,sBAAsB;AAAA,IACtB,sBAAsB;AAAA,IACtB,sBAAsB;AAAA,IACtB,sBAAsB;AAAA,EACxB;AAEA,SACE,oBAAC,sDACK,QADL;AAAA,IAEC;AAAA,IACA;AAAA,IACF;AAEJ","sourcesContent":["// This example is for an Editor with `ReactEditor` and `HistoryEditor`\nimport { useMakeStandardAutosuggestionFunction } from \"../../hooks/make-autosuggestions-function/use-make-standard-autosuggestions-function\";\nimport { BaseCopilotTextareaProps } from \"../../types/base/base-copilot-textarea-props\";\nimport {\n  AutosuggestionsConfig,\n  defaultAutosuggestionsConfig,\n} from \"../../types/standard-autosuggestions\";\nimport { BaseCopilotTextarea } from \"../base-copilot-textarea/base-copilot-textarea\";\n\nexport interface CopilotTextareaProps extends BaseCopilotTextareaProps {\n  autosuggestionsConfig: Partial<AutosuggestionsConfig> & {\n    purposePrompt: string;\n  };\n}\n\nexport function CopilotTextarea(props: CopilotTextareaProps): JSX.Element {\n  const autosuggestionsConfig: AutosuggestionsConfig = {\n    ...defaultAutosuggestionsConfig,\n    ...props.autosuggestionsConfig,\n  };\n\n  const autosuggestionsFunction = useMakeStandardAutosuggestionFunction(\n    autosuggestionsConfig.purposePrompt,\n    autosuggestionsConfig.apiEndpoint,\n    autosuggestionsConfig.makeSystemPrompt,\n    autosuggestionsConfig.fewShotMessages,\n    autosuggestionsConfig.externalContextCategories,\n    autosuggestionsConfig.forwardedParams\n  );\n\n  return (\n    <BaseCopilotTextarea\n      {...props}\n      autosuggestionsConfig={autosuggestionsConfig}\n      autosuggestionsFunction={autosuggestionsFunction}\n    />\n  );\n}\n"]}

package/dist/components/base-copilot-textarea/base-copilot-textarea.d.ts

@@ -1,19 +1,10 @@
-import { TextareaHTMLAttributes } from 'react';
-import { BaseAutosuggestionsConfig } from '../../types/base/base-autosuggestions-config.js';
 import { AutosuggestionsBareFunction } from '../../types/base/autosuggestions-bare-function.js';
+import { BaseCopilotTextareaProps } from '../../types/base/base-copilot-textarea-props.js';
+import 'react';
+import '../../types/base/base-autosuggestions-config.js';
 
-interface BaseCopilotTextareaProps extends TextareaHTMLAttributes<HTMLDivElement> {
-    disableBranding?: boolean;
-    placeholderStyle?: React.CSSProperties;
-    suggestionsStyle?: React.CSSProperties;
-    value?: string;
-    onValueChange?: (value: string) => void;
-    autosuggestionsConfig: Partial<BaseAutosuggestionsConfig> & {
-        purposePrompt: string;
-    };
-}
 declare function BaseCopilotTextarea(props: BaseCopilotTextareaProps & {
     autosuggestionsFunction: AutosuggestionsBareFunction;
 }): JSX.Element;
 
-export { BaseCopilotTextarea, BaseCopilotTextareaProps };
+export { BaseCopilotTextarea };

package/dist/components/base-copilot-textarea/base-copilot-textarea.mjs

@@ -1,14 +1,14 @@
-export { BaseCopilotTextarea } from '../../chunk-4EA7I44O.mjs';
-import '../../chunk-THWPPG6M.mjs';
+export { BaseCopilotTextarea } from '../../chunk-YICIML6J.mjs';
 import '../../chunk-WJYQWL4I.mjs';
 import '../../chunk-4XYYSJ5C.mjs';
 import '../../chunk-TSF4AJIK.mjs';
 import '../../chunk-3UQM3NLM.mjs';
 import '../../chunk-WJHSY5T6.mjs';
-import '../../chunk-6LKDH2UJ.mjs';
+import '../../chunk-7KWRVIYV.mjs';
 import '../../chunk-LNAIMEB2.mjs';
 import '../../chunk-OELUUJZY.mjs';
-import '../../chunk-24IOWJS4.mjs';
+import '../../chunk-THWPPG6M.mjs';
+import '../../chunk-E2UEE45I.mjs';
 import '../../chunk-UW3ITU2Y.mjs';
 import '../../chunk-KGKLUWKW.mjs';
 import '../../chunk-6SYD77G6.mjs';

package/dist/components/copilot-textarea/copilot-textarea.d.ts

@@ -1,9 +1,8 @@
+import { BaseCopilotTextareaProps } from '../../types/base/base-copilot-textarea-props.js';
 import { AutosuggestionsConfig } from '../../types/standard-autosuggestions/autosuggestions-config.js';
-import { BaseCopilotTextareaProps } from '../base-copilot-textarea/base-copilot-textarea.js';
+import 'react';
 import '../../types/base/base-autosuggestions-config.js';
 import '../../types/standard-autosuggestions/minimal-chat-gpt-message.js';
-import 'react';
-import '../../types/base/autosuggestions-bare-function.js';
 
 interface CopilotTextareaProps extends BaseCopilotTextareaProps {
     autosuggestionsConfig: Partial<AutosuggestionsConfig> & {

package/dist/components/copilot-textarea/copilot-textarea.mjs

@@ -1,18 +1,18 @@
-export { CopilotTextarea } from '../../chunk-ROH375UB.mjs';
+export { CopilotTextarea } from '../../chunk-YTT5NE6B.mjs';
 import '../../chunk-A3SFEHWZ.mjs';
 import '../../chunk-AZQCUNBV.mjs';
-import '../../chunk-ZPACRCJ6.mjs';
-import '../../chunk-4EA7I44O.mjs';
-import '../../chunk-THWPPG6M.mjs';
+import '../../chunk-EHQ5TN4R.mjs';
+import '../../chunk-YICIML6J.mjs';
 import '../../chunk-WJYQWL4I.mjs';
 import '../../chunk-4XYYSJ5C.mjs';
 import '../../chunk-TSF4AJIK.mjs';
 import '../../chunk-3UQM3NLM.mjs';
 import '../../chunk-WJHSY5T6.mjs';
-import '../../chunk-6LKDH2UJ.mjs';
+import '../../chunk-7KWRVIYV.mjs';
 import '../../chunk-LNAIMEB2.mjs';
 import '../../chunk-OELUUJZY.mjs';
-import '../../chunk-24IOWJS4.mjs';
+import '../../chunk-THWPPG6M.mjs';
+import '../../chunk-E2UEE45I.mjs';
 import '../../chunk-UW3ITU2Y.mjs';
 import '../../chunk-KGKLUWKW.mjs';
 import '../../chunk-6SYD77G6.mjs';

package/dist/components/index.d.ts

@@ -1,7 +1,8 @@
-export { BaseCopilotTextarea, BaseCopilotTextareaProps } from './base-copilot-textarea/base-copilot-textarea.js';
+export { BaseCopilotTextarea } from './base-copilot-textarea/base-copilot-textarea.js';
 export { CopilotTextarea, CopilotTextareaProps } from './copilot-textarea/copilot-textarea.js';
+import '../types/base/autosuggestions-bare-function.js';
+import '../types/base/base-copilot-textarea-props.js';
 import 'react';
 import '../types/base/base-autosuggestions-config.js';
-import '../types/base/autosuggestions-bare-function.js';
 import '../types/standard-autosuggestions/autosuggestions-config.js';
 import '../types/standard-autosuggestions/minimal-chat-gpt-message.js';

package/dist/components/index.mjs

@@ -1,19 +1,19 @@
 import '../chunk-MMVDU6DF.mjs';
-export { CopilotTextarea } from '../chunk-ROH375UB.mjs';
+export { CopilotTextarea } from '../chunk-YTT5NE6B.mjs';
 import '../chunk-A3SFEHWZ.mjs';
 import '../chunk-AZQCUNBV.mjs';
-import '../chunk-ZPACRCJ6.mjs';
-export { BaseCopilotTextarea } from '../chunk-4EA7I44O.mjs';
-import '../chunk-THWPPG6M.mjs';
+import '../chunk-EHQ5TN4R.mjs';
+export { BaseCopilotTextarea } from '../chunk-YICIML6J.mjs';
 import '../chunk-WJYQWL4I.mjs';
 import '../chunk-4XYYSJ5C.mjs';
 import '../chunk-TSF4AJIK.mjs';
 import '../chunk-3UQM3NLM.mjs';
 import '../chunk-WJHSY5T6.mjs';
-import '../chunk-6LKDH2UJ.mjs';
+import '../chunk-7KWRVIYV.mjs';
 import '../chunk-LNAIMEB2.mjs';
 import '../chunk-OELUUJZY.mjs';
-import '../chunk-24IOWJS4.mjs';
+import '../chunk-THWPPG6M.mjs';
+import '../chunk-E2UEE45I.mjs';
 import '../chunk-UW3ITU2Y.mjs';
 import '../chunk-KGKLUWKW.mjs';
 import '../chunk-6SYD77G6.mjs';

package/dist/hooks/use-autosuggestions.d.ts

@@ -8,6 +8,6 @@ interface UseAutosuggestionsResult {
     onChangeHandler: (newEditorState: EditorAutocompleteState | null) => void;
     onKeyDownHandler: (event: React.KeyboardEvent<HTMLDivElement>) => void;
 }
-declare function useAutosuggestions(debounceTime: number, acceptAutosuggestionKey: string, autosuggestionFunction: AutosuggestionsBareFunction, insertAutocompleteSuggestion: (suggestion: AutosuggestionState) => void, disableWhenEmpty: boolean): UseAutosuggestionsResult;
+declare function useAutosuggestions(debounceTime: number, acceptAutosuggestionKey: string, autosuggestionFunction: AutosuggestionsBareFunction, insertAutocompleteSuggestion: (suggestion: AutosuggestionState) => void, disableWhenEmpty: boolean, disabled: boolean): UseAutosuggestionsResult;
 
 export { UseAutosuggestionsResult, useAutosuggestions };

package/dist/hooks/use-autosuggestions.mjs

@@ -1,4 +1,4 @@
-export { useAutosuggestions } from '../chunk-24IOWJS4.mjs';
+export { useAutosuggestions } from '../chunk-E2UEE45I.mjs';
 import '../chunk-UW3ITU2Y.mjs';
 import '../chunk-KGKLUWKW.mjs';
 import '../chunk-NKW5OU2S.mjs';

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-export { BaseCopilotTextarea, BaseCopilotTextareaProps } from './components/base-copilot-textarea/base-copilot-textarea.js';
+export { BaseCopilotTextarea } from './components/base-copilot-textarea/base-copilot-textarea.js';
 export { CopilotTextarea, CopilotTextareaProps } from './components/copilot-textarea/copilot-textarea.js';
 export { BaseAutosuggestionsConfig, defaultBaseAutosuggestionsConfig } from './types/base/base-autosuggestions-config.js';
 export { AutosuggestionsBareFunction } from './types/base/autosuggestions-bare-function.js';
+export { BaseCopilotTextareaProps } from './types/base/base-copilot-textarea-props.js';
 export { AutosuggestionsConfig, MakeSystemPrompt, defaultAutosuggestionsConfig, defaultFewShotMessages, defaultMakeSystemPrompt } from './types/standard-autosuggestions/autosuggestions-config.js';
 export { MinimalChatGPTMessage } from './types/standard-autosuggestions/minimal-chat-gpt-message.js';
 import 'react';

package/dist/index.mjs

@@ -1,22 +1,22 @@
 import './chunk-FD6FGKYY.mjs';
 import './chunk-MMVDU6DF.mjs';
-export { CopilotTextarea } from './chunk-ROH375UB.mjs';
+export { CopilotTextarea } from './chunk-YTT5NE6B.mjs';
 import './chunk-A3SFEHWZ.mjs';
 import './chunk-AZQCUNBV.mjs';
-export { defaultAutosuggestionsConfig, defaultFewShotMessages, defaultMakeSystemPrompt } from './chunk-ZPACRCJ6.mjs';
-export { BaseCopilotTextarea } from './chunk-4EA7I44O.mjs';
-import './chunk-THWPPG6M.mjs';
+export { defaultAutosuggestionsConfig, defaultFewShotMessages, defaultMakeSystemPrompt } from './chunk-EHQ5TN4R.mjs';
+export { BaseCopilotTextarea } from './chunk-YICIML6J.mjs';
 import './chunk-WJYQWL4I.mjs';
 import './chunk-4XYYSJ5C.mjs';
 import './chunk-TSF4AJIK.mjs';
 import './chunk-3UQM3NLM.mjs';
 import './chunk-WJHSY5T6.mjs';
-export { defaultBaseAutosuggestionsConfig } from './chunk-6LKDH2UJ.mjs';
+export { defaultBaseAutosuggestionsConfig } from './chunk-7KWRVIYV.mjs';
 import './chunk-LNAIMEB2.mjs';
 import './chunk-OELUUJZY.mjs';
+import './chunk-THWPPG6M.mjs';
 import './chunk-IU3WTXLQ.mjs';
 import './chunk-H4VKQGVU.mjs';
-import './chunk-24IOWJS4.mjs';
+import './chunk-E2UEE45I.mjs';
 import './chunk-UW3ITU2Y.mjs';
 import './chunk-KGKLUWKW.mjs';
 import './chunk-6SYD77G6.mjs';

package/dist/types/base/base-autosuggestions-config.d.ts

@@ -3,6 +3,7 @@ interface BaseAutosuggestionsConfig {
     debounceTime: number;
     acceptAutosuggestionKey: string;
     disableWhenEmpty: boolean;
+    disabled: boolean;
 }
 declare const defaultBaseAutosuggestionsConfig: Omit<BaseAutosuggestionsConfig, "purposePrompt">;
 

package/dist/types/base/base-autosuggestions-config.mjs

@@ -1,4 +1,4 @@
-export { defaultBaseAutosuggestionsConfig } from '../../chunk-6LKDH2UJ.mjs';
+export { defaultBaseAutosuggestionsConfig } from '../../chunk-7KWRVIYV.mjs';
 import '../../chunk-MRXNTQOX.mjs';
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=base-autosuggestions-config.mjs.map

package/dist/types/base/base-copilot-textarea-props.d.ts

@@ -0,0 +1,38 @@
+import { TextareaHTMLAttributes } from 'react';
+import { BaseAutosuggestionsConfig } from './base-autosuggestions-config.js';
+
+/**
+ * `BaseCopilotTextareaProps` defines the properties for the `BaseCopilotTextarea` component.
+ *
+ * @extends {Omit<TextareaHTMLAttributes<HTMLDivElement>, "onChange">}
+ *
+ * @property {boolean} [disableBranding=false] - Determines whether branding should be disabled. Default is `false`.
+ *
+ * @property {React.CSSProperties} [placeholderStyle] - Specifies the CSS styles to apply to the placeholder text.
+ *
+ * @property {React.CSSProperties} [suggestionsStyle] - Specifies the CSS styles to apply to the suggestions list.
+ *
+ * @property {string} [value] - The initial value of the textarea. Can be controlled via `onValueChange`.
+ *
+ * @property {(value: string) => void} [onValueChange] - Callback invoked when the value of the textarea changes.
+ *
+ * @property {(event: React.ChangeEvent<HTMLTextAreaElement>) => void} [onChange] - Callback invoked when a `change` event is triggered on the textarea element. The event only actually includes the `event.target.value` and `event.currentTarget.value` properties (all that is required in 99% of cases).
+ *
+ * @property {Partial<BaseAutosuggestionsConfig> & {
+ *   purposePrompt: string;
+ * }} autosuggestionsConfig - Configuration settings for the autosuggestions feature.
+ * Includes a mandatory `purposePrompt` to guide the autosuggestions.
+ */
+interface BaseCopilotTextareaProps extends Omit<TextareaHTMLAttributes<HTMLDivElement>, "onChange"> {
+    disableBranding?: boolean;
+    placeholderStyle?: React.CSSProperties;
+    suggestionsStyle?: React.CSSProperties;
+    value?: string;
+    onValueChange?: (value: string) => void;
+    onChange?: (event: React.ChangeEvent<HTMLTextAreaElement>) => void;
+    autosuggestionsConfig: Partial<BaseAutosuggestionsConfig> & {
+        purposePrompt: string;
+    };
+}
+
+export { BaseCopilotTextareaProps };

package/dist/types/base/base-copilot-textarea-props.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=base-copilot-textarea-props.mjs.map

package/dist/types/base/base-copilot-textarea-props.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/types/base/index.d.ts

@@ -1,2 +1,4 @@
 export { BaseAutosuggestionsConfig, defaultBaseAutosuggestionsConfig } from './base-autosuggestions-config.js';
 export { AutosuggestionsBareFunction } from './autosuggestions-bare-function.js';
+export { BaseCopilotTextareaProps } from './base-copilot-textarea-props.js';
+import 'react';

package/dist/types/base/index.mjs

@@ -1,5 +1,5 @@
 import '../../chunk-WJHSY5T6.mjs';
-export { defaultBaseAutosuggestionsConfig } from '../../chunk-6LKDH2UJ.mjs';
+export { defaultBaseAutosuggestionsConfig } from '../../chunk-7KWRVIYV.mjs';
 import '../../chunk-MRXNTQOX.mjs';
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.mjs.map

package/dist/types/index.d.ts

@@ -1,4 +1,6 @@
 export { BaseAutosuggestionsConfig, defaultBaseAutosuggestionsConfig } from './base/base-autosuggestions-config.js';
 export { AutosuggestionsBareFunction } from './base/autosuggestions-bare-function.js';
+export { BaseCopilotTextareaProps } from './base/base-copilot-textarea-props.js';
 export { AutosuggestionsConfig, MakeSystemPrompt, defaultAutosuggestionsConfig, defaultFewShotMessages, defaultMakeSystemPrompt } from './standard-autosuggestions/autosuggestions-config.js';
 export { MinimalChatGPTMessage } from './standard-autosuggestions/minimal-chat-gpt-message.js';
+import 'react';

package/dist/types/index.mjs

@@ -1,8 +1,8 @@
 import '../chunk-FD6FGKYY.mjs';
 import '../chunk-AZQCUNBV.mjs';
-export { defaultAutosuggestionsConfig, defaultFewShotMessages, defaultMakeSystemPrompt } from '../chunk-ZPACRCJ6.mjs';
+export { defaultAutosuggestionsConfig, defaultFewShotMessages, defaultMakeSystemPrompt } from '../chunk-EHQ5TN4R.mjs';
 import '../chunk-WJHSY5T6.mjs';
-export { defaultBaseAutosuggestionsConfig } from '../chunk-6LKDH2UJ.mjs';
+export { defaultBaseAutosuggestionsConfig } from '../chunk-7KWRVIYV.mjs';
 import '../chunk-MRXNTQOX.mjs';
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.mjs.map

package/dist/types/standard-autosuggestions/autosuggestions-config.mjs

@@ -1,6 +1,6 @@
-export { defaultAutosuggestionsConfig, defaultFewShotMessages, defaultMakeSystemPrompt } from '../../chunk-ZPACRCJ6.mjs';
+export { defaultAutosuggestionsConfig, defaultFewShotMessages, defaultMakeSystemPrompt } from '../../chunk-EHQ5TN4R.mjs';
 import '../../chunk-WJHSY5T6.mjs';
-import '../../chunk-6LKDH2UJ.mjs';
+import '../../chunk-7KWRVIYV.mjs';
 import '../../chunk-MRXNTQOX.mjs';
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=autosuggestions-config.mjs.map

package/dist/types/standard-autosuggestions/index.mjs

@@ -1,7 +1,7 @@
 import '../../chunk-AZQCUNBV.mjs';
-export { defaultAutosuggestionsConfig, defaultFewShotMessages, defaultMakeSystemPrompt } from '../../chunk-ZPACRCJ6.mjs';
+export { defaultAutosuggestionsConfig, defaultFewShotMessages, defaultMakeSystemPrompt } from '../../chunk-EHQ5TN4R.mjs';
 import '../../chunk-WJHSY5T6.mjs';
-import '../../chunk-6LKDH2UJ.mjs';
+import '../../chunk-7KWRVIYV.mjs';
 import '../../chunk-MRXNTQOX.mjs';
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.9.0",
+  "version": "0.11.0",
   "sideEffects": [
     "**/*.css"
   ],
@@ -31,8 +31,8 @@
     "tsup": "^6.1.3",
     "typescript": "^4.9.4",
     "eslint-config-custom": "0.2.0",
-    "tsconfig": "0.3.0",
-    "tailwind-config": "0.1.0"
+    "tailwind-config": "0.1.0",
+    "tsconfig": "0.3.0"
   },
   "dependencies": {
     "ai": "^2.1.22",

package/src/components/base-copilot-textarea/base-copilot-textarea.tsx

@@ -1,11 +1,4 @@
-import "./base-copilot-textarea.css";
-import {
-  TextareaHTMLAttributes,
-  useCallback,
-  useEffect,
-  useMemo,
-  useState,
-} from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import { Descendant, Editor } from "slate";
 import { Editable, Slate } from "slate-react";
 import { twMerge } from "tailwind-merge";
@@ -24,22 +17,12 @@ import {
   defaultBaseAutosuggestionsConfig,
 } from "../../types/base";
 import { AutosuggestionState } from "../../types/base/autosuggestion-state";
+import { BaseCopilotTextareaProps } from "../../types/base/base-copilot-textarea-props";
+import "./base-copilot-textarea.css";
 import { makeRenderElementFunction } from "./render-element";
 import { makeRenderPlaceholderFunction } from "./render-placeholder";
 import { useAddBrandingCss } from "./use-add-branding-css";
 
-export interface BaseCopilotTextareaProps
-  extends TextareaHTMLAttributes<HTMLDivElement> {
-  disableBranding?: boolean;
-  placeholderStyle?: React.CSSProperties;
-  suggestionsStyle?: React.CSSProperties;
-  value?: string;
-  onValueChange?: (value: string) => void;
-  autosuggestionsConfig: Partial<BaseAutosuggestionsConfig> & {
-    purposePrompt: string;
-  };
-}
-
 export function BaseCopilotTextarea(
   props: BaseCopilotTextareaProps & {
     autosuggestionsFunction: AutosuggestionsBareFunction;
@@ -83,7 +66,8 @@ export function BaseCopilotTextarea(
     autosuggestionsConfig.acceptAutosuggestionKey,
     props.autosuggestionsFunction,
     insertText,
-    autosuggestionsConfig.disableWhenEmpty
+    autosuggestionsConfig.disableWhenEmpty,
+    autosuggestionsConfig.disabled
   );
 
   // sync autosuggestions state with the editor
@@ -144,6 +128,8 @@ export function BaseCopilotTextarea(
     autosuggestionsConfig: autosuggestionsConfigFromProps,
     autosuggestionsFunction,
     className,
+    onChange,
+    onKeyDown,
     ...propsToForward
   } = props;
 
@@ -171,16 +157,47 @@ export function BaseCopilotTextarea(
 
         setLastKnownFullEditorText(fullEditorText);
         onChangeHandlerForAutocomplete(newEditorState);
+
         props.onValueChange?.(fullEditorText);
+        props.onChange?.(makeSemiFakeReactTextAreaEvent(fullEditorText));
       }}
     >
       <Editable
         renderElement={renderElementMemoized}
         renderPlaceholder={renderPlaceholderMemoized}
-        onKeyDown={onKeyDownHandlerForAutocomplete}
+        onKeyDown={(event) => {
+          onKeyDownHandlerForAutocomplete(event); // forward the event for internal use
+          props.onKeyDown?.(event); // forward the event for external use
+        }}
         className={moddedClassName}
         {...propsToForward}
       />
     </Slate>
   );
 }
+
+// Consumers of <textarea> expect a `onChange: (React.ChangeEvent<HTMLTextAreaElement>) => void` event handler to be passed in.
+// This is *extremely* common, and we want to support it.
+//
+// We can't support the full functionality, but in 99% of cases, the consumer only cares about the `event.target.value` property --
+// that's how they get the new value of the textarea.
+//
+// So, the tradeoff we are making is minimizing compiler complaint, with a small chance of runtime error.
+// The alternative would be defining a different onChange entrypoint (we actually do have that in `onValueChange`),
+// And starting to explain subtleties to users the moment they try to use the component for the first time for very basic functionality.
+//
+// If this proves problematic, we can always revisit this decision.
+function makeSemiFakeReactTextAreaEvent(
+  currentText: string
+): React.ChangeEvent<HTMLTextAreaElement> {
+  return {
+    target: {
+      value: currentText,
+      type: "copilot-textarea",
+    },
+    currentTarget: {
+      value: currentText,
+      type: "copilot-textarea",
+    },
+  } as React.ChangeEvent<HTMLTextAreaElement>;
+}

package/src/components/copilot-textarea/copilot-textarea.tsx

@@ -1,13 +1,11 @@
 // This example is for an Editor with `ReactEditor` and `HistoryEditor`
 import { useMakeStandardAutosuggestionFunction } from "../../hooks/make-autosuggestions-function/use-make-standard-autosuggestions-function";
+import { BaseCopilotTextareaProps } from "../../types/base/base-copilot-textarea-props";
 import {
   AutosuggestionsConfig,
   defaultAutosuggestionsConfig,
 } from "../../types/standard-autosuggestions";
-import {
-  BaseCopilotTextarea,
-  BaseCopilotTextareaProps,
-} from "../base-copilot-textarea/base-copilot-textarea";
+import { BaseCopilotTextarea } from "../base-copilot-textarea/base-copilot-textarea";
 
 export interface CopilotTextareaProps extends BaseCopilotTextareaProps {
   autosuggestionsConfig: Partial<AutosuggestionsConfig> & {

package/src/components/index.ts

@@ -1,5 +1,4 @@
 export { BaseCopilotTextarea } from "./base-copilot-textarea/base-copilot-textarea";
-export type { BaseCopilotTextareaProps } from "./base-copilot-textarea/base-copilot-textarea";
 
 export { CopilotTextarea } from "./copilot-textarea/copilot-textarea";
 export type { CopilotTextareaProps } from "./copilot-textarea/copilot-textarea";

package/src/hooks/use-autosuggestions.ts

@@ -19,7 +19,8 @@ export function useAutosuggestions(
   acceptAutosuggestionKey: string,
   autosuggestionFunction: AutosuggestionsBareFunction,
   insertAutocompleteSuggestion: (suggestion: AutosuggestionState) => void,
-  disableWhenEmpty: boolean
+  disableWhenEmpty: boolean,
+  disabled: boolean
 ): UseAutosuggestionsResult {
   const [previousAutocompleteState, setPreviousAutocompleteState] =
     useState<EditorAutocompleteState | null>(null);
@@ -35,6 +36,11 @@ export function useAutosuggestions(
       editorAutocompleteState: EditorAutocompleteState,
       abortSignal: AbortSignal
     ) => {
+      // early return if disabled
+      if (disabled) {
+        return;
+      }
+
       if (
         disableWhenEmpty &&
         editorAutocompleteState.textBeforeCursor === "" &&
@@ -43,6 +49,7 @@ export function useAutosuggestions(
         return;
       }
 
+      // fetch the suggestion
       const suggestion = await autosuggestionFunction(
         editorAutocompleteState.textBeforeCursor,
         editorAutocompleteState.textAfterCursor,
@@ -59,7 +66,12 @@ export function useAutosuggestions(
         point: editorAutocompleteState.cursorPoint,
       });
     },
-    [autosuggestionFunction, setCurrentAutocompleteSuggestion, disableWhenEmpty]
+    [
+      autosuggestionFunction,
+      setCurrentAutocompleteSuggestion,
+      disableWhenEmpty,
+      disabled,
+    ]
   );
 
   const debouncedFunction = useMemo(

package/src/types/base/base-autosuggestions-config.tsx

@@ -3,6 +3,7 @@ export interface BaseAutosuggestionsConfig {
   debounceTime: number;
   acceptAutosuggestionKey: string;
   disableWhenEmpty: boolean;
+  disabled: boolean;
 }
 
 export const defaultBaseAutosuggestionsConfig: Omit<
@@ -12,4 +13,5 @@ export const defaultBaseAutosuggestionsConfig: Omit<
   debounceTime: 500,
   acceptAutosuggestionKey: "Tab",
   disableWhenEmpty: true,
+  disabled: false,
 };

package/src/types/base/base-copilot-textarea-props.tsx

@@ -0,0 +1,37 @@
+import { TextareaHTMLAttributes } from "react";
+import { BaseAutosuggestionsConfig } from ".";
+
+/**
+ * `BaseCopilotTextareaProps` defines the properties for the `BaseCopilotTextarea` component.
+ *
+ * @extends {Omit<TextareaHTMLAttributes<HTMLDivElement>, "onChange">}
+ *
+ * @property {boolean} [disableBranding=false] - Determines whether branding should be disabled. Default is `false`.
+ *
+ * @property {React.CSSProperties} [placeholderStyle] - Specifies the CSS styles to apply to the placeholder text.
+ *
+ * @property {React.CSSProperties} [suggestionsStyle] - Specifies the CSS styles to apply to the suggestions list.
+ *
+ * @property {string} [value] - The initial value of the textarea. Can be controlled via `onValueChange`.
+ *
+ * @property {(value: string) => void} [onValueChange] - Callback invoked when the value of the textarea changes.
+ *
+ * @property {(event: React.ChangeEvent<HTMLTextAreaElement>) => void} [onChange] - Callback invoked when a `change` event is triggered on the textarea element. The event only actually includes the `event.target.value` and `event.currentTarget.value` properties (all that is required in 99% of cases).
+ *
+ * @property {Partial<BaseAutosuggestionsConfig> & {
+ *   purposePrompt: string;
+ * }} autosuggestionsConfig - Configuration settings for the autosuggestions feature.
+ * Includes a mandatory `purposePrompt` to guide the autosuggestions.
+ */
+export interface BaseCopilotTextareaProps
+  extends Omit<TextareaHTMLAttributes<HTMLDivElement>, "onChange"> {
+  disableBranding?: boolean;
+  placeholderStyle?: React.CSSProperties;
+  suggestionsStyle?: React.CSSProperties;
+  value?: string;
+  onValueChange?: (value: string) => void;
+  onChange?: (event: React.ChangeEvent<HTMLTextAreaElement>) => void;
+  autosuggestionsConfig: Partial<BaseAutosuggestionsConfig> & {
+    purposePrompt: string;
+  };
+}

package/src/types/base/index.ts

@@ -1,4 +1,6 @@
 export { defaultBaseAutosuggestionsConfig } from "./base-autosuggestions-config";
 
-export type { BaseAutosuggestionsConfig } from "./base-autosuggestions-config";
 export type { AutosuggestionsBareFunction } from "./autosuggestions-bare-function";
+export type { BaseAutosuggestionsConfig } from "./base-autosuggestions-config";
+
+export type { BaseCopilotTextareaProps } from "./base-copilot-textarea-props";

package/dist/chunk-24IOWJS4.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/use-autosuggestions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,SAAS,aAAa,SAAS,gBAAgB;AAgBxC,SAAS,mBACd,cACA,yBACA,wBACA,8BACA,kBAC0B;AAC1B,QAAM,CAAC,2BAA2B,4BAA4B,IAC5D,SAAyC,IAAI;AAE/C,QAAM,CAAC,+BAA+B,gCAAgC,IACpE,SAAqC,IAAI;AAE3C,QAAM,8BAGe;AAAA,IACnB,CACE,yBACA,gBACG;AACH,UACE,oBACA,wBAAwB,qBAAqB,MAC7C,wBAAwB,oBAAoB,IAC5C;AACA;AAAA,MACF;AAEA,YAAM,aAAa,MAAM;AAAA,QACvB,wBAAwB;AAAA,QACxB,wBAAwB;AAAA,QACxB;AAAA,MACF;AAGA,UAAI,CAAC,cAAc,YAAY,SAAS;AACtC,cAAM,IAAI,aAAa,WAAW,YAAY;AAAA,MAChD;AAEA,uCAAiC;AAAA,QAC/B,MAAM;AAAA,QACN,OAAO,wBAAwB;AAAA,MACjC,CAAC;AAAA,IACH;AAAA,IACA,CAAC,wBAAwB,kCAAkC,gBAAgB;AAAA,EAC7E;AAEA,QAAM,oBAAoB;AAAA,IACxB,MACE,IAAI;AAAA,MACF;AAAA,IACF;AAAA,IACF,CAAC,YAAY;AAAA,EACf;AAEA,QAAM,WAAW;AAAA,IACf,CAAC,mBAAmD;AAClD,YAAM,wBAAwB,CAAC;AAAA,QAC7B;AAAA,QACA;AAAA,QACA;AAAA,MACF;AACA,mCAA6B,cAAc;AAG3C,UAAI,CAAC,uBAAuB;AAC1B;AAAA,MACF;AAGA,uCAAiC,IAAI;AAGrC,UAAI,gBAAgB;AAClB,0BAAkB,SAAS,6BAA6B,cAAc;AAAA,MACxE,OAAO;AACL,0BAAkB,OAAO;AAAA,MAC3B;AAAA,IACF;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,iBAAiB;AAAA,IACrB,CAAC,UAA+C;AAC9C,UAAI,+BAA+B;AACjC,YAAI,MAAM,QAAQ,yBAAyB;AACzC,gBAAM,eAAe;AACrB,uCAA6B,6BAA6B;AAC1D,2CAAiC,IAAI;AAAA,QACvC;AAAA,MACF;AAAA,IACF;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,iBAAiB;AAAA,IACjB,kBAAkB;AAAA,EACpB;AACF","sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\nimport { Debouncer } from \"../lib/debouncer\";\nimport { nullableCompatibleEqualityCheck } from \"../lib/utils\";\nimport { AutosuggestionsBareFunction } from \"../types/base\";\nimport { AutosuggestionState } from \"../types/base/autosuggestion-state\";\nimport {\n  EditorAutocompleteState,\n  areEqual_autocompleteState,\n} from \"../types/base/editor-autocomplete-state\";\n\nexport interface UseAutosuggestionsResult {\n  currentAutocompleteSuggestion: AutosuggestionState | null;\n  onChangeHandler: (newEditorState: EditorAutocompleteState | null) => void;\n  onKeyDownHandler: (event: React.KeyboardEvent<HTMLDivElement>) => void;\n}\n\nexport function useAutosuggestions(\n  debounceTime: number,\n  acceptAutosuggestionKey: string,\n  autosuggestionFunction: AutosuggestionsBareFunction,\n  insertAutocompleteSuggestion: (suggestion: AutosuggestionState) => void,\n  disableWhenEmpty: boolean\n): UseAutosuggestionsResult {\n  const [previousAutocompleteState, setPreviousAutocompleteState] =\n    useState<EditorAutocompleteState | null>(null);\n\n  const [currentAutocompleteSuggestion, setCurrentAutocompleteSuggestion] =\n    useState<AutosuggestionState | null>(null);\n\n  const awaitForAndAppendSuggestion: (\n    editorAutocompleteState: EditorAutocompleteState,\n    abortSignal: AbortSignal\n  ) => Promise<void> = useCallback(\n    async (\n      editorAutocompleteState: EditorAutocompleteState,\n      abortSignal: AbortSignal\n    ) => {\n      if (\n        disableWhenEmpty &&\n        editorAutocompleteState.textBeforeCursor === \"\" &&\n        editorAutocompleteState.textAfterCursor === \"\"\n      ) {\n        return;\n      }\n\n      const suggestion = await autosuggestionFunction(\n        editorAutocompleteState.textBeforeCursor,\n        editorAutocompleteState.textAfterCursor,\n        abortSignal\n      );\n\n      // We'll assume for now that the autocomplete function might or might not respect the abort signal.\n      if (!suggestion || abortSignal.aborted) {\n        throw new DOMException(\"Aborted\", \"AbortError\");\n      }\n\n      setCurrentAutocompleteSuggestion({\n        text: suggestion,\n        point: editorAutocompleteState.cursorPoint,\n      });\n    },\n    [autosuggestionFunction, setCurrentAutocompleteSuggestion, disableWhenEmpty]\n  );\n\n  const debouncedFunction = useMemo(\n    () =>\n      new Debouncer<[editorAutocompleteState: EditorAutocompleteState]>(\n        debounceTime\n      ),\n    [debounceTime]\n  );\n\n  const onChange = useCallback(\n    (newEditorState: EditorAutocompleteState | null) => {\n      const editorStateHasChanged = !nullableCompatibleEqualityCheck(\n        areEqual_autocompleteState,\n        previousAutocompleteState,\n        newEditorState\n      );\n      setPreviousAutocompleteState(newEditorState);\n\n      // if no change, do nothing\n      if (!editorStateHasChanged) {\n        return;\n      }\n\n      // if change, then first null out the current suggestion\n      setCurrentAutocompleteSuggestion(null);\n\n      // then try to get a new suggestion, debouncing to avoid too many requests while typing\n      if (newEditorState) {\n        debouncedFunction.debounce(awaitForAndAppendSuggestion, newEditorState);\n      } else {\n        debouncedFunction.cancel();\n      }\n    },\n    [\n      previousAutocompleteState,\n      setPreviousAutocompleteState,\n      debouncedFunction,\n      awaitForAndAppendSuggestion,\n      setCurrentAutocompleteSuggestion,\n    ]\n  );\n\n  const keyDownHandler = useCallback(\n    (event: React.KeyboardEvent<HTMLDivElement>) => {\n      if (currentAutocompleteSuggestion) {\n        if (event.key === acceptAutosuggestionKey) {\n          event.preventDefault();\n          insertAutocompleteSuggestion(currentAutocompleteSuggestion);\n          setCurrentAutocompleteSuggestion(null);\n        }\n      }\n    },\n    [\n      currentAutocompleteSuggestion,\n      setCurrentAutocompleteSuggestion,\n      insertAutocompleteSuggestion,\n      acceptAutosuggestionKey,\n    ]\n  );\n\n  return {\n    currentAutocompleteSuggestion,\n    onChangeHandler: onChange,\n    onKeyDownHandler: keyDownHandler,\n  };\n}\n"]}