@tslite/react 1.3.0 → 1.5.0

package/dist/full.cjs

@@ -1 +1 @@
-'use strict';var search=require('@tslite/codemirror/search'),format=require('@tslite/format'),editor=require('@tslite/editor');function u(t={}){let{dark:s=true,layout:e="inline",mode:o="expression",segmenter:n="mustache",gutters:i=e==="block",search:a=e==="block",extensions:r=[]}=t;return {layout:e,mode:o,...o==="template"?{}:{segmenter:n},gutters:i,format:o==="program"?format.format:format.formatExpression,features:{chrome:{dark:s},theme:editor.tsliteTokenStyles},extensions:a?[search.searchEditing(),...r]:[...r]}}Object.defineProperty(exports,"searchEditing",{enumerable:true,get:function(){return search.searchEditing}});Object.defineProperty(exports,"format",{enumerable:true,get:function(){return format.format}});Object.defineProperty(exports,"formatExpression",{enumerable:true,get:function(){return format.formatExpression}});Object.defineProperty(exports,"tsliteTokenStyles",{enumerable:true,get:function(){return editor.tsliteTokenStyles}});exports.expressionFieldProps=u;
+'use strict';var search=require('@tslite/codemirror/search'),editor=require('@tslite/editor');function y(r={}){let{dark:s=true,layout:e="inline",mode:o="expression",segmenter:n="mustache",gutters:i=e==="block",search:a=e==="block",extensions:t=[]}=r;return {layout:e,mode:o,...o==="template"?{}:{segmenter:n},gutters:i,features:{chrome:{dark:s},theme:editor.tsliteTokenStyles},extensions:a?[search.searchEditing(),...t]:[...t]}}Object.defineProperty(exports,"searchEditing",{enumerable:true,get:function(){return search.searchEditing}});Object.defineProperty(exports,"tsliteTokenStyles",{enumerable:true,get:function(){return editor.tsliteTokenStyles}});exports.expressionFieldProps=y;

package/dist/full.d.cts

@@ -1,7 +1,6 @@
 import { Extension } from '@codemirror/state';
-import { F as FieldLayout, S as SegmenterOption, U as UseExpressionFieldOptions } from './useExpressionField-RmyW3D9R.cjs';
+import { F as FieldLayout, S as SegmenterOption, U as UseExpressionFieldOptions } from './useExpressionField-Dsh6-SIB.cjs';
 export { searchEditing } from '@tslite/codemirror/search';
-export { format, formatExpression } from '@tslite/format';
 export { tsliteTokenStyles } from '@tslite/editor';
 import 'react';
 import '@codemirror/view';
@@ -32,12 +31,6 @@ interface PresetOptions {
     /**
      * O que o código É. Padrão: `"expression"`.
      *
-     * Decide também qual formatador entra: um programa é reimpresso com `;` e
-     * quebra de statement; uma expressão, não. Injetar o de expressão num programa
-     * faz o `parseExpression` lançar, e o serviço então declara que não sabe
-     * formatar — em silêncio. Foi um defeito real, e é por isso que o preset
-     * escolhe por você.
-     *
      * **`"template"`** liga o controle de fluxo (`{% if %}` / `{% for %}` /
      * `{# #}`). Ele não é o padrão porque um `{%` literal no texto deixaria de ser
      * texto — e num campo que hoje aceita qualquer string isso seria mudança de
@@ -62,8 +55,8 @@ interface PresetOptions {
     /** Extensões suas, acrescentadas às do preset. */
     readonly extensions?: readonly Extension[];
 }
-/** As props que o preset resolve — o resto (`value`, `onChange`, `env`) é seu. */
-type PresetProps = Pick<UseExpressionFieldOptions, "layout" | "mode" | "segmenter" | "gutters" | "format" | "features" | "extensions">;
+/** As props que o preset resolve — o resto (`value`, `onChange`, `world`) é seu. */
+type PresetProps = Pick<UseExpressionFieldOptions, "layout" | "mode" | "segmenter" | "gutters" | "features" | "extensions">;
 /**
  * As props de um campo que já nasce certo.
  *
@@ -75,7 +68,7 @@ type PresetProps = Pick<UseExpressionFieldOptions, "layout" | "mode" | "segmente
  *   {...expressionFieldProps()}
  *   value={v}
  *   onChange={setV}
- *   env={env}
+ *   world={world}
  * />
  * ```
  *

package/dist/full.d.ts

@@ -1,7 +1,6 @@
 import { Extension } from '@codemirror/state';
-import { F as FieldLayout, S as SegmenterOption, U as UseExpressionFieldOptions } from './useExpressionField-RmyW3D9R.js';
+import { F as FieldLayout, S as SegmenterOption, U as UseExpressionFieldOptions } from './useExpressionField-Dsh6-SIB.js';
 export { searchEditing } from '@tslite/codemirror/search';
-export { format, formatExpression } from '@tslite/format';
 export { tsliteTokenStyles } from '@tslite/editor';
 import 'react';
 import '@codemirror/view';
@@ -32,12 +31,6 @@ interface PresetOptions {
     /**
      * O que o código É. Padrão: `"expression"`.
      *
-     * Decide também qual formatador entra: um programa é reimpresso com `;` e
-     * quebra de statement; uma expressão, não. Injetar o de expressão num programa
-     * faz o `parseExpression` lançar, e o serviço então declara que não sabe
-     * formatar — em silêncio. Foi um defeito real, e é por isso que o preset
-     * escolhe por você.
-     *
      * **`"template"`** liga o controle de fluxo (`{% if %}` / `{% for %}` /
      * `{# #}`). Ele não é o padrão porque um `{%` literal no texto deixaria de ser
      * texto — e num campo que hoje aceita qualquer string isso seria mudança de
@@ -62,8 +55,8 @@ interface PresetOptions {
     /** Extensões suas, acrescentadas às do preset. */
     readonly extensions?: readonly Extension[];
 }
-/** As props que o preset resolve — o resto (`value`, `onChange`, `env`) é seu. */
-type PresetProps = Pick<UseExpressionFieldOptions, "layout" | "mode" | "segmenter" | "gutters" | "format" | "features" | "extensions">;
+/** As props que o preset resolve — o resto (`value`, `onChange`, `world`) é seu. */
+type PresetProps = Pick<UseExpressionFieldOptions, "layout" | "mode" | "segmenter" | "gutters" | "features" | "extensions">;
 /**
  * As props de um campo que já nasce certo.
  *
@@ -75,7 +68,7 @@ type PresetProps = Pick<UseExpressionFieldOptions, "layout" | "mode" | "segmente
  *   {...expressionFieldProps()}
  *   value={v}
  *   onChange={setV}
- *   env={env}
+ *   world={world}
  * />
  * ```
  *

package/dist/full.js

@@ -1 +1 @@
-import {searchEditing}from'@tslite/codemirror/search';export{searchEditing}from'@tslite/codemirror/search';import {format,formatExpression}from'@tslite/format';export{format,formatExpression}from'@tslite/format';import {tsliteTokenStyles}from'@tslite/editor';export{tsliteTokenStyles}from'@tslite/editor';function u(t={}){let{dark:s=true,layout:e="inline",mode:o="expression",segmenter:n="mustache",gutters:i=e==="block",search:a=e==="block",extensions:r=[]}=t;return {layout:e,mode:o,...o==="template"?{}:{segmenter:n},gutters:i,format:o==="program"?format:formatExpression,features:{chrome:{dark:s},theme:tsliteTokenStyles},extensions:a?[searchEditing(),...r]:[...r]}}export{u as expressionFieldProps};
+import {searchEditing}from'@tslite/codemirror/search';export{searchEditing}from'@tslite/codemirror/search';import {tsliteTokenStyles}from'@tslite/editor';export{tsliteTokenStyles}from'@tslite/editor';function y(r={}){let{dark:s=true,layout:e="inline",mode:o="expression",segmenter:n="mustache",gutters:i=e==="block",search:a=e==="block",extensions:t=[]}=r;return {layout:e,mode:o,...o==="template"?{}:{segmenter:n},gutters:i,features:{chrome:{dark:s},theme:tsliteTokenStyles},extensions:a?[searchEditing(),...t]:[...t]}}export{y as expressionFieldProps};

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';var n=require('react'),state=require('@codemirror/state'),view=require('@codemirror/view'),commands=require('@codemirror/commands'),autocomplete=require('@codemirror/autocomplete'),codemirror=require('@tslite/codemirror'),editor=require('@tslite/editor'),languageService=require('@tslite/language-service'),jsxRuntime=require('react/jsx-runtime');function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var n__namespace=/*#__PURE__*/_interopNamespace(n);var ae={mustache:languageService.mustache,whole:languageService.whole},le=t=>typeof t=="function"?t:ae[t];function A(t){let{env:o,service:l,segmenter:i="mustache",mode:s="expression",profile:c,limits:d,unused:p,format:a,optional:g}=t;return n__namespace.useMemo(()=>{if(l)return l;if(!o)return null;let x={env:o,...c?{profile:c}:{},...d?{limits:d}:{},...p!==void 0?{unused:p}:{},...a?{format:a}:{},...g?{optional:g}:{}};return s==="template"?editor.createHostService({...x,mode:s}):editor.createHostService({...x,segmenter:le(i),mode:s})},[l,o,i,s,c,d,p,a,g])}var Oe=view.EditorView.theme({".cm-scroller":{overflowX:"auto",overflowY:"hidden"},".cm-content":{padding:"6px 8px"},".cm-line":{padding:"0"},"&.cm-focused":{outline:"none"}}),z=6,Le=view.EditorView.theme({".cm-scroller":{overflowY:"auto"},".cm-content":{padding:`${z}px 8px`},".cm-line":{padding:"0"},"&.cm-focused":{outline:"none"}}),Te=(t,o)=>`${o*t.defaultLineHeight+2*z}px`,we=view.EditorView.theme({"&":{height:"100%"},".cm-scroller":{overflowY:"auto"},".cm-content":{padding:"8px"},"&.cm-focused":{outline:"none"}}),$=t=>t.replace(/\r?\n/g," "),ke=(t,o)=>{if(t===false)return [];let l=o==="block"?{}:{tab:false,indentOnInput:false};return codemirror.codeEditing(typeof t=="object"?{...l,...t}:l)},Ce=t=>t?codemirror.gutters(typeof t=="object"?t:{}):[];function D(t){let{value:o,onChange:l,onCommit:i,layout:s="inline",maxLines:c,wrap:d=s!=="inline",editing:p,gutters:a,readOnly:g=false,placeholder:x,features:I,tooltipParent:T,onTokenAction:V,isTokenActionable:_,definition:w,extensions:ee}=t,h=A(t),k=n__namespace.useRef(null),v=n__namespace.useRef(null),[U,Y]=n__namespace.useState(null),[te,oe]=n__namespace.useState(false),R=n__namespace.useRef({value:o,onChange:l,onCommit:i,onTokenAction:V,isTokenActionable:_});R.current={value:o,onChange:l,onCommit:i,onTokenAction:V,isTokenActionable:_};let C=n__namespace.useCallback(e=>{let{value:r,onCommit:E}=R.current;if(!E)return;let f=e.state.doc.toString();f!==r&&E(f);},[]),u=n__namespace.useRef({service:new state.Compartment,layout:new state.Compartment,editable:new state.Compartment,actions:new state.Compartment}).current,H=n__namespace.useCallback(e=>e?codemirror.languageService(e,{theme:editor.tsliteTokenStyles,...T!==null?{tooltipParent:T??(typeof document<"u"?document.body:void 0)}:{},...I}):[],[I,T]),G=n__namespace.useCallback(e=>autocomplete.completionStatus(e.state)==="active"?autocomplete.acceptCompletion(e)||true:(C(e),true),[C]),P=n__namespace.useCallback((e,r,E,f)=>[e==="block"?[...r?[view.EditorView.lineWrapping]:[],we]:e==="grow"?[...r?[view.EditorView.lineWrapping]:[],Le,state.Prec.highest(view.keymap.of([{key:"Enter",run:G},{key:"Shift-Enter",run:commands.insertNewlineAndIndent}]))]:[codemirror.singleLine,Oe],ke(E,e),Ce(f)],[G]),M=n__namespace.useCallback(()=>{let e=[];return R.current.onTokenAction&&e.push(codemirror.tokenAction({actionable:r=>R.current.isTokenActionable?.(r)??true,onAction:r=>R.current.onTokenAction?.(r)})),w&&h?.definitionAt&&e.push(codemirror.gotoDefinition(w)),e},[w,h]);n__namespace.useEffect(()=>{if(!k.current)return;let e=new view.EditorView({parent:k.current,state:state.EditorState.create({doc:s==="inline"?$(o):o,extensions:[commands.history(),u.service.of(H(h)),u.layout.of(P(s,d,p,a)),u.editable.of(view.EditorView.editable.of(!g)),u.actions.of(M()),...x?[view.placeholder(x)]:[],view.keymap.of([...commands.historyKeymap,...commands.defaultKeymap]),view.EditorView.updateListener.of(r=>{if(r.focusChanged&&oe(r.view.hasFocus),!r.docChanged)return;r.transactions.some(f=>f.annotation(codemirror.externalChange))||R.current.onChange?.(r.state.doc.toString());}),view.EditorView.contentAttributes.of({"aria-label":x??"expression"}),view.EditorView.domEventHandlers({blur:(r,E)=>{let f=r.relatedTarget;return f instanceof Element&&(E.dom.contains(f)||f.closest(".cm-tooltip"))||C(E),false}}),...ee??[]]})});return v.current=e,Y(e),()=>{e.destroy(),v.current=null,Y(null);}},[]),n__namespace.useEffect(()=>{v.current?.dispatch({effects:u.service.reconfigure(H(h))});},[h,H,u]),n__namespace.useEffect(()=>{v.current?.dispatch({effects:u.layout.reconfigure(P(s,d,p,a))});},[s,d,p,a,P,u]),n__namespace.useEffect(()=>{v.current?.dispatch({effects:u.editable.reconfigure(view.EditorView.editable.of(!g))});},[g,u]),n__namespace.useEffect(()=>{let e=v.current;e&&(e.scrollDOM.style.maxHeight=s==="grow"&&c!==void 0&&c>0?Te(e,c):"");},[s,c,U]),n__namespace.useEffect(()=>{v.current?.dispatch({effects:u.actions.reconfigure(M())});},[M,u]),n__namespace.useEffect(()=>{let e=v.current;if(!e)return;let r=s==="inline"?$(o):o;if(r===e.state.doc.toString())return;let{anchor:E,head:f}=e.state.selection.main,N=re=>Math.min(re,r.length);e.dispatch({changes:{from:0,to:e.state.doc.length,insert:r},selection:{anchor:N(E),head:N(f)},annotations:codemirror.externalChange.of(true)});},[o,s]);let ne=n__namespace.useCallback(()=>v.current?.focus(),[]);return {ref:k,view:U,focused:te,service:h,focus:ne}}var X=n__namespace.createContext(null);function q(){let t=n__namespace.useContext(X);if(!t)throw new Error("useFieldContext must be used inside <ExpressionField.Root>");return t}var He=["value","onChange","onCommit","layout","maxLines","wrap","editing","gutters","readOnly","placeholder","features","tooltipParent","onTokenAction","isTokenActionable","definition","extensions","env","service","segmenter","mode","profile","limits","unused","format","optional"];var J=n__namespace.forwardRef(function(o,l){let{children:i,...s}=o,c={},d={};for(let[a,g]of Object.entries(s))(He.includes(a)?c:d)[a]=g;let p=D(c);return jsxRuntime.jsx(X.Provider,{value:p,children:jsxRuntime.jsx("div",{ref:l,...d,children:typeof i=="function"?i(p):i})})}),Q=n__namespace.forwardRef(function(o,l){let i=q();return jsxRuntime.jsx("div",{ref:i.ref,...o})}),Z=n__namespace.forwardRef(function({children:o,...l},i){return jsxRuntime.jsx("button",{ref:i,type:"button",...l,children:o})}),S={Root:J,Editor:Q,ExpandTrigger:Z};var y={fg:"var(--foreground, #cccccc)",mutedFg:"var(--muted-foreground, #8b8b8b)",border:"var(--border, #2b2b2b)",ring:"var(--ring, #0078d4)",input:"var(--input, transparent)",destructive:"var(--destructive, #f14c4c)",font:"var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace)"},Pe=["--foreground","--muted-foreground","--border","--ring","--input","--destructive","--font-mono","--muted","--popover","--popover-foreground","--primary","--primary-foreground","--secondary","--accent"];var Me=jsxRuntime.jsx("svg",{width:"14",height:"14",viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round","aria-hidden":"true",children:jsxRuntime.jsx("path",{d:"M15 3h6v6M9 21H3v-6M21 3l-7 7M3 21l7-7"})});function Ae({invalid:t,className:o,style:l,onExpand:i,expandIcon:s,multiline:c,layout:d,...p}){let a=d??(c?"block":"inline");return jsxRuntime.jsx(S.Root,{...p,layout:a,className:o,children:g=>jsxRuntime.jsxs("div",{style:{position:"relative",border:`1px solid ${t?y.destructive:g.focused?y.ring:y.border}`,borderRadius:"6px",backgroundColor:y.input,color:y.fg,fontFamily:y.font,fontSize:"13px",overflow:"hidden",...a==="block"?{height:"100%",display:"flex",flexDirection:"column"}:{},...l},children:[jsxRuntime.jsx(S.Editor,{style:a==="block"?{flex:1,minHeight:0}:a==="grow"?{paddingRight:i?"28px":void 0}:{paddingRight:i?"24px":void 0}}),i&&jsxRuntime.jsx(S.ExpandTrigger,{onClick:i,"aria-label":"Expandir",title:"Expandir",onMouseEnter:x=>x.currentTarget.style.opacity="1",onMouseLeave:x=>x.currentTarget.style.opacity="0.55",style:{position:"absolute",top:a==="inline"?"50%":"6px",right:"4px",transform:a==="inline"?"translateY(-50%)":void 0,display:"flex",alignItems:"center",justifyContent:"center",width:"20px",height:"20px",padding:0,lineHeight:0,border:"none",borderRadius:"4px",background:y.input,color:y.mutedFg,cursor:"pointer",opacity:.55},children:s??Me})]})})}var Ie="1.3.0";exports.CSS_VARS=Pe;exports.ExpressionField=S;exports.ExpressionFieldEditor=Q;exports.ExpressionFieldExpandTrigger=Z;exports.ExpressionFieldRoot=J;exports.ExpressionInput=Ae;exports.V=y;exports.useExpressionField=D;exports.useFieldContext=q;exports.useLanguageService=A;exports.version=Ie;
+'use strict';var n=require('react'),state=require('@codemirror/state'),view=require('@codemirror/view'),commands=require('@codemirror/commands'),autocomplete=require('@codemirror/autocomplete'),codemirror=require('@tslite/codemirror'),editor=require('@tslite/editor'),languageService=require('@tslite/language-service'),jsxRuntime=require('react/jsx-runtime');function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var n__namespace=/*#__PURE__*/_interopNamespace(n);var xe={mustache:languageService.mustache,whole:languageService.whole},ye=t=>typeof t=="function"?t:xe[t];function N(t){let{world:o,service:s,segmenter:a="mustache",mode:m="expression",type:i,optional:d,profile:u,guards:c}=t,f=n__namespace.useMemo(()=>{if(s||!o)return null;let y={world:o,...i!==void 0?{type:i}:{},...d?{optional:d}:{}},R={...u?{profile:u}:{},...c?{guards:c}:{}};return m==="template"?editor.createHostService({...y,...R,mode:m}):editor.createHostService({...y,...R,segmenter:ye(a),mode:m})},[s,o,a,m,i,d,u,c]);return n__namespace.useEffect(()=>f?()=>f.dispose():void 0,[f]),s??f}var Pe=view.EditorView.theme({".cm-scroller":{overflowX:"auto",overflowY:"hidden"},".cm-content":{padding:"6px 8px"},".cm-line":{padding:"0"},"&.cm-focused":{outline:"none"}}),ne=6,Me=view.EditorView.theme({".cm-scroller":{overflowY:"auto"},".cm-content":{padding:`${ne}px 8px`},".cm-line":{padding:"0"},"&.cm-focused":{outline:"none"}}),Ae=(t,o)=>`${o*t.defaultLineHeight+2*ne}px`,De=view.EditorView.theme({"&":{height:"100%"},".cm-scroller":{overflowY:"auto"},".cm-content":{padding:"8px"},"&.cm-focused":{outline:"none"}}),Ie=t=>t.replace(/\r?\n/g," "),S=(t,o)=>o==="inline"?Ie(t):t,Ve=(t,o)=>{if(t===false)return [];let s=o==="block"?{}:{tab:false,indentOnInput:false};return codemirror.codeEditing(typeof t=="object"?{...s,...t}:s)},_e=t=>t?codemirror.gutters(typeof t=="object"?t:{}):[];function B(t){let{value:o,onChange:s,onCommit:a,onFinish:m,layout:i="inline",maxLines:d,wrap:u=i!=="inline",editing:c,gutters:f,readOnly:y=false,placeholder:R,features:W,tooltipParent:A,onTokenAction:$,isTokenActionable:z,definition:D,extensions:le}=t,F=N(t),I=n__namespace.useRef(null),v=n__namespace.useRef(null),[X,q]=n__namespace.useState(null),[de,pe]=n__namespace.useState(false),h=n__namespace.useRef({value:o,layout:i,onChange:s,onCommit:a,onFinish:m,onTokenAction:$,isTokenActionable:z});h.current={value:o,layout:i,onChange:s,onCommit:a,onFinish:m,onTokenAction:$,isTokenActionable:z};let O=n__namespace.useCallback(e=>{let{value:r,layout:l}=h.current;return e.state.doc.toString()!==S(r,l)},[]),V=n__namespace.useCallback((e,r)=>{let l=O(e);l&&h.current.onCommit?.(e.state.doc.toString()),h.current.onFinish?.({via:r,dirty:l});},[O]),_=n__namespace.useCallback(e=>{let{onFinish:r,value:l,layout:p}=h.current;if(!r||autocomplete.completionStatus(e.state)==="active")return  false;let L=O(e);if(L){let T=S(l,p);e.dispatch({changes:{from:0,to:e.state.doc.length,insert:T},selection:{anchor:T.length},annotations:codemirror.externalChange.of(true)});}return r({via:"escape",dirty:L}),true},[O]),g=n__namespace.useRef({service:new state.Compartment,layout:new state.Compartment,editable:new state.Compartment,actions:new state.Compartment}).current,U=n__namespace.useCallback(e=>e?codemirror.languageService(e,{theme:editor.tsliteTokenStyles,...A!==null?{tooltipParent:A??(typeof document<"u"?document.body:void 0)}:{},...W}):[],[W,A]),J=n__namespace.useCallback(e=>autocomplete.completionStatus(e.state)==="active"?autocomplete.acceptCompletion(e)||true:(V(e,"enter"),true),[V]),Y=n__namespace.useCallback((e,r,l,p)=>[e==="block"?[...r?[view.EditorView.lineWrapping]:[],De]:e==="grow"?[...r?[view.EditorView.lineWrapping]:[],Me,state.Prec.highest(view.keymap.of([{key:"Enter",run:J},{key:"Shift-Enter",run:commands.insertNewlineAndIndent},{key:"Escape",run:_}]))]:[codemirror.singleLine,Pe,state.Prec.highest(view.keymap.of([{key:"Escape",run:_}]))],Ve(l,e),_e(p)],[J,_]),G=n__namespace.useCallback(()=>{let e=[];return h.current.onTokenAction&&e.push(codemirror.tokenAction({actionable:r=>h.current.isTokenActionable?.(r)??true,onAction:r=>h.current.onTokenAction?.(r)})),D&&F?.definitionAt&&e.push(codemirror.gotoDefinition(D)),e},[D,F]);n__namespace.useEffect(()=>{if(!I.current)return;let e=new view.EditorView({parent:I.current,state:state.EditorState.create({doc:S(o,i),extensions:[commands.history(),g.service.of(U(F)),g.layout.of(Y(i,u,c,f)),g.editable.of(view.EditorView.editable.of(!y)),g.actions.of(G()),...R?[view.placeholder(R)]:[],view.keymap.of([...commands.historyKeymap,...commands.defaultKeymap]),view.EditorView.updateListener.of(r=>{if(r.focusChanged&&pe(r.view.hasFocus),!r.docChanged)return;r.transactions.some(p=>p.annotation(codemirror.externalChange))||h.current.onChange?.(r.state.doc.toString());}),view.EditorView.contentAttributes.of({"aria-label":R??"expression"}),view.EditorView.domEventHandlers({blur:(r,l)=>{let p=r.relatedTarget;return p instanceof Element&&(l.dom.contains(p)||p.closest(".cm-tooltip"))||V(l,"blur"),false}}),...le??[]]})});return v.current=e,q(e),()=>{e.destroy(),v.current=null,q(null);}},[]),n__namespace.useEffect(()=>{v.current?.dispatch({effects:g.service.reconfigure(U(F))});},[F,U,g]),n__namespace.useEffect(()=>{v.current?.dispatch({effects:g.layout.reconfigure(Y(i,u,c,f))});},[i,u,c,f,Y,g]),n__namespace.useEffect(()=>{v.current?.dispatch({effects:g.editable.reconfigure(view.EditorView.editable.of(!y))});},[y,g]),n__namespace.useEffect(()=>{let e=v.current;e&&(e.scrollDOM.style.maxHeight=i==="grow"&&d!==void 0&&d>0?Ae(e,d):"");},[i,d,X]),n__namespace.useEffect(()=>{v.current?.dispatch({effects:g.actions.reconfigure(G())});},[G,g]);let Q=n__namespace.useRef({value:o,layout:i});n__namespace.useEffect(()=>{let e=v.current;if(!e)return;let r=Q.current;Q.current={value:o,layout:i};let l=e.state.doc.toString(),p=o!==r.value||l===S(o,r.layout)?S(o,i):S(l,i);if(p===l)return;let{anchor:L,head:T}=e.state.selection.main,Z=fe=>Math.min(fe,p.length);e.dispatch({changes:{from:0,to:e.state.doc.length,insert:p},selection:{anchor:Z(L),head:Z(T)},annotations:codemirror.externalChange.of(true)});},[o,i]);let ue=n__namespace.useCallback(()=>v.current?.focus(),[]);return {ref:I,view:X,focused:de,service:F,focus:ue}}var w=class extends Error{constructor(o,s){super(s),this.name="ExpressionFieldError",this.code=o;}};var re=n__namespace.createContext(null);function ie(){let t=n__namespace.useContext(re);if(!t)throw new w("outside-root","useFieldContext must be used inside <ExpressionField.Root>");return t}var Ue=["value","onChange","onCommit","onFinish","layout","maxLines","wrap","editing","gutters","readOnly","placeholder","features","tooltipParent","onTokenAction","isTokenActionable","definition","extensions","world","service","segmenter","mode","type","optional","profile","guards"];var se=n__namespace.forwardRef(function(o,s){let{children:a,...m}=o,i={},d={};for(let[c,f]of Object.entries(m))(Ue.includes(c)?i:d)[c]=f;let u=B(i);return jsxRuntime.jsx(re.Provider,{value:u,children:jsxRuntime.jsx("div",{ref:s,...d,children:typeof a=="function"?a(u):a})})}),ae=n__namespace.forwardRef(function(o,s){let a=ie();return jsxRuntime.jsx("div",{ref:a.ref,...o})}),ce=n__namespace.forwardRef(function({children:o,...s},a){return jsxRuntime.jsx("button",{ref:a,type:"button",...s,children:o})}),C={Root:se,Editor:ae,ExpandTrigger:ce};var E={fg:"var(--foreground, #cccccc)",mutedFg:"var(--muted-foreground, #8b8b8b)",border:"var(--border, #2b2b2b)",ring:"var(--ring, #0078d4)",input:"var(--input, transparent)",destructive:"var(--destructive, #f14c4c)",font:"var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace)"},Ye=["--foreground","--muted-foreground","--border","--ring","--input","--destructive","--font-mono","--muted","--popover","--popover-foreground","--primary","--primary-foreground","--secondary","--accent"];var Ge=jsxRuntime.jsx("svg",{width:"14",height:"14",viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round","aria-hidden":"true",children:jsxRuntime.jsx("path",{d:"M15 3h6v6M9 21H3v-6M21 3l-7 7M3 21l7-7"})});function Ne({invalid:t,className:o,style:s,onExpand:a,expandIcon:m,multiline:i,layout:d,...u}){let c=d??(i?"block":"inline");return jsxRuntime.jsx(C.Root,{...u,layout:c,className:o,children:f=>jsxRuntime.jsxs("div",{style:{position:"relative",border:`1px solid ${t?E.destructive:f.focused?E.ring:E.border}`,borderRadius:"6px",backgroundColor:E.input,color:E.fg,fontFamily:E.font,fontSize:"13px",overflow:"hidden",...c==="block"?{height:"100%",display:"flex",flexDirection:"column"}:{},...s},children:[jsxRuntime.jsx(C.Editor,{style:c==="block"?{flex:1,minHeight:0}:c==="grow"?{paddingRight:a?"28px":void 0}:{paddingRight:a?"24px":void 0}}),a&&jsxRuntime.jsx(C.ExpandTrigger,{onClick:a,"aria-label":"Expandir",title:"Expandir",onMouseEnter:y=>y.currentTarget.style.opacity="1",onMouseLeave:y=>y.currentTarget.style.opacity="0.55",style:{position:"absolute",top:c==="inline"?"50%":"6px",right:"4px",transform:c==="inline"?"translateY(-50%)":void 0,display:"flex",alignItems:"center",justifyContent:"center",width:"20px",height:"20px",padding:0,lineHeight:0,border:"none",borderRadius:"4px",background:E.input,color:E.mutedFg,cursor:"pointer",opacity:.55},children:m??Ge})]})})}var je="1.5.0";exports.CSS_VARS=Ye;exports.ExpressionField=C;exports.ExpressionFieldEditor=ae;exports.ExpressionFieldError=w;exports.ExpressionFieldExpandTrigger=ce;exports.ExpressionFieldRoot=se;exports.ExpressionInput=Ne;exports.V=E;exports.useExpressionField=B;exports.useFieldContext=ie;exports.useLanguageService=N;exports.version=je;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { U as UseExpressionFieldOptions, E as ExpressionFieldHandle } from './useExpressionField-RmyW3D9R.cjs';
-export { F as FieldLayout, L as LanguageServiceOptions, S as SegmenterOption, u as useExpressionField, a as useLanguageService } from './useExpressionField-RmyW3D9R.cjs';
+import { U as UseExpressionFieldOptions, E as ExpressionFieldHandle } from './useExpressionField-Dsh6-SIB.cjs';
+export { a as FieldFinish, F as FieldLayout, L as LanguageServiceOptions, S as SegmenterOption, u as useExpressionField, b as useLanguageService } from './useExpressionField-Dsh6-SIB.cjs';
 export { TokenActionTarget } from '@tslite/codemirror';
 import '@codemirror/state';
 import '@codemirror/view';
@@ -31,9 +31,9 @@ interface ExpressionInputProps extends UseExpressionFieldOptions {
  * O campo de expressão pronto para uso.
  *
  * ```tsx
- * <ExpressionInput value={v} onChange={setV} env={env} />                 // "Olá {{ user.name }}"
- * <ExpressionInput value={v} onChange={setV} env={env} segmenter="whole" /> // "foo.bar >= 32"
- * <ExpressionInput value={v} onChange={setV} env={env} layout="block" />    // o modal expandido
+ * <ExpressionInput value={v} onChange={setV} world={world} />                 // "Olá {{ user.name }}"
+ * <ExpressionInput value={v} onChange={setV} world={world} segmenter="whole" /> // "foo.bar >= 32"
+ * <ExpressionInput value={v} onChange={setV} world={world} layout="block" />    // o modal expandido
  * ```
  */
 declare function ExpressionInput({ invalid, className, style, onExpand, expandIcon, multiline, layout, ...options }: ExpressionInputProps): React.JSX.Element;
@@ -79,6 +79,16 @@ declare const ExpressionField: {
     ExpandTrigger: React.ForwardRefExoticComponent<ExpandTriggerProps & React.RefAttributes<HTMLButtonElement>>;
 };
 
+/** O motivo de uma recusa. */
+type ExpressionFieldErrorCode = 
+/** O `useFieldContext` foi chamado fora de uma `<ExpressionField.Root>`. */
+"outside-root";
+/** O uso errado das peças do campo. É erro de quem monta a tela, e não do autor. */
+declare class ExpressionFieldError extends Error {
+    readonly code: ExpressionFieldErrorCode;
+    constructor(code: ExpressionFieldErrorCode, message: string);
+}
+
 /** As cores de chrome. Exportadas para o consumidor reusar no que ele desenhar. */
 declare const V: {
     readonly fg: "var(--foreground, #cccccc)";
@@ -93,6 +103,6 @@ declare const V: {
 declare const CSS_VARS: readonly ["--foreground", "--muted-foreground", "--border", "--ring", "--input", "--destructive", "--font-mono", "--muted", "--popover", "--popover-foreground", "--primary", "--primary-foreground", "--secondary", "--accent"];
 
 /** A versão deste package, a do módulo de fato carregado. */
-declare const version = "1.3.0";
+declare const version = "1.5.0";
 
-export { CSS_VARS, ExpressionField, Editor as ExpressionFieldEditor, type EditorProps as ExpressionFieldEditorProps, ExpandTrigger as ExpressionFieldExpandTrigger, type ExpandTriggerProps as ExpressionFieldExpandTriggerProps, ExpressionFieldHandle, Root as ExpressionFieldRoot, type RootProps as ExpressionFieldRootProps, ExpressionInput, type ExpressionInputProps, UseExpressionFieldOptions, V, useFieldContext, version };
+export { CSS_VARS, ExpressionField, Editor as ExpressionFieldEditor, type EditorProps as ExpressionFieldEditorProps, ExpressionFieldError, type ExpressionFieldErrorCode, ExpandTrigger as ExpressionFieldExpandTrigger, type ExpandTriggerProps as ExpressionFieldExpandTriggerProps, ExpressionFieldHandle, Root as ExpressionFieldRoot, type RootProps as ExpressionFieldRootProps, ExpressionInput, type ExpressionInputProps, UseExpressionFieldOptions, V, useFieldContext, version };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { U as UseExpressionFieldOptions, E as ExpressionFieldHandle } from './useExpressionField-RmyW3D9R.js';
-export { F as FieldLayout, L as LanguageServiceOptions, S as SegmenterOption, u as useExpressionField, a as useLanguageService } from './useExpressionField-RmyW3D9R.js';
+import { U as UseExpressionFieldOptions, E as ExpressionFieldHandle } from './useExpressionField-Dsh6-SIB.js';
+export { a as FieldFinish, F as FieldLayout, L as LanguageServiceOptions, S as SegmenterOption, u as useExpressionField, b as useLanguageService } from './useExpressionField-Dsh6-SIB.js';
 export { TokenActionTarget } from '@tslite/codemirror';
 import '@codemirror/state';
 import '@codemirror/view';
@@ -31,9 +31,9 @@ interface ExpressionInputProps extends UseExpressionFieldOptions {
  * O campo de expressão pronto para uso.
  *
  * ```tsx
- * <ExpressionInput value={v} onChange={setV} env={env} />                 // "Olá {{ user.name }}"
- * <ExpressionInput value={v} onChange={setV} env={env} segmenter="whole" /> // "foo.bar >= 32"
- * <ExpressionInput value={v} onChange={setV} env={env} layout="block" />    // o modal expandido
+ * <ExpressionInput value={v} onChange={setV} world={world} />                 // "Olá {{ user.name }}"
+ * <ExpressionInput value={v} onChange={setV} world={world} segmenter="whole" /> // "foo.bar >= 32"
+ * <ExpressionInput value={v} onChange={setV} world={world} layout="block" />    // o modal expandido
  * ```
  */
 declare function ExpressionInput({ invalid, className, style, onExpand, expandIcon, multiline, layout, ...options }: ExpressionInputProps): React.JSX.Element;
@@ -79,6 +79,16 @@ declare const ExpressionField: {
     ExpandTrigger: React.ForwardRefExoticComponent<ExpandTriggerProps & React.RefAttributes<HTMLButtonElement>>;
 };
 
+/** O motivo de uma recusa. */
+type ExpressionFieldErrorCode = 
+/** O `useFieldContext` foi chamado fora de uma `<ExpressionField.Root>`. */
+"outside-root";
+/** O uso errado das peças do campo. É erro de quem monta a tela, e não do autor. */
+declare class ExpressionFieldError extends Error {
+    readonly code: ExpressionFieldErrorCode;
+    constructor(code: ExpressionFieldErrorCode, message: string);
+}
+
 /** As cores de chrome. Exportadas para o consumidor reusar no que ele desenhar. */
 declare const V: {
     readonly fg: "var(--foreground, #cccccc)";
@@ -93,6 +103,6 @@ declare const V: {
 declare const CSS_VARS: readonly ["--foreground", "--muted-foreground", "--border", "--ring", "--input", "--destructive", "--font-mono", "--muted", "--popover", "--popover-foreground", "--primary", "--primary-foreground", "--secondary", "--accent"];
 
 /** A versão deste package, a do módulo de fato carregado. */
-declare const version = "1.3.0";
+declare const version = "1.5.0";
 
-export { CSS_VARS, ExpressionField, Editor as ExpressionFieldEditor, type EditorProps as ExpressionFieldEditorProps, ExpandTrigger as ExpressionFieldExpandTrigger, type ExpandTriggerProps as ExpressionFieldExpandTriggerProps, ExpressionFieldHandle, Root as ExpressionFieldRoot, type RootProps as ExpressionFieldRootProps, ExpressionInput, type ExpressionInputProps, UseExpressionFieldOptions, V, useFieldContext, version };
+export { CSS_VARS, ExpressionField, Editor as ExpressionFieldEditor, type EditorProps as ExpressionFieldEditorProps, ExpressionFieldError, type ExpressionFieldErrorCode, ExpandTrigger as ExpressionFieldExpandTrigger, type ExpandTriggerProps as ExpressionFieldExpandTriggerProps, ExpressionFieldHandle, Root as ExpressionFieldRoot, type RootProps as ExpressionFieldRootProps, ExpressionInput, type ExpressionInputProps, UseExpressionFieldOptions, V, useFieldContext, version };

package/dist/index.js

@@ -1 +1 @@
-import*as n from'react';import {Compartment,Prec,EditorState}from'@codemirror/state';import {EditorView,keymap,placeholder}from'@codemirror/view';import {insertNewlineAndIndent,history,historyKeymap,defaultKeymap}from'@codemirror/commands';import {completionStatus,acceptCompletion}from'@codemirror/autocomplete';import {languageService,singleLine,tokenAction,gotoDefinition,externalChange,codeEditing,gutters}from'@tslite/codemirror';import {tsliteTokenStyles,createHostService}from'@tslite/editor';import {whole,mustache}from'@tslite/language-service';import {jsx,jsxs}from'react/jsx-runtime';var ae={mustache:mustache,whole:whole},le=t=>typeof t=="function"?t:ae[t];function A(t){let{env:o,service:l,segmenter:i="mustache",mode:s="expression",profile:c,limits:d,unused:p,format:a,optional:g}=t;return n.useMemo(()=>{if(l)return l;if(!o)return null;let x={env:o,...c?{profile:c}:{},...d?{limits:d}:{},...p!==void 0?{unused:p}:{},...a?{format:a}:{},...g?{optional:g}:{}};return s==="template"?createHostService({...x,mode:s}):createHostService({...x,segmenter:le(i),mode:s})},[l,o,i,s,c,d,p,a,g])}var Oe=EditorView.theme({".cm-scroller":{overflowX:"auto",overflowY:"hidden"},".cm-content":{padding:"6px 8px"},".cm-line":{padding:"0"},"&.cm-focused":{outline:"none"}}),z=6,Le=EditorView.theme({".cm-scroller":{overflowY:"auto"},".cm-content":{padding:`${z}px 8px`},".cm-line":{padding:"0"},"&.cm-focused":{outline:"none"}}),Te=(t,o)=>`${o*t.defaultLineHeight+2*z}px`,we=EditorView.theme({"&":{height:"100%"},".cm-scroller":{overflowY:"auto"},".cm-content":{padding:"8px"},"&.cm-focused":{outline:"none"}}),$=t=>t.replace(/\r?\n/g," "),ke=(t,o)=>{if(t===false)return [];let l=o==="block"?{}:{tab:false,indentOnInput:false};return codeEditing(typeof t=="object"?{...l,...t}:l)},Ce=t=>t?gutters(typeof t=="object"?t:{}):[];function D(t){let{value:o,onChange:l,onCommit:i,layout:s="inline",maxLines:c,wrap:d=s!=="inline",editing:p,gutters:a,readOnly:g=false,placeholder:x,features:I,tooltipParent:T,onTokenAction:V,isTokenActionable:_,definition:w,extensions:ee}=t,h=A(t),k=n.useRef(null),v=n.useRef(null),[U,Y]=n.useState(null),[te,oe]=n.useState(false),R=n.useRef({value:o,onChange:l,onCommit:i,onTokenAction:V,isTokenActionable:_});R.current={value:o,onChange:l,onCommit:i,onTokenAction:V,isTokenActionable:_};let C=n.useCallback(e=>{let{value:r,onCommit:E}=R.current;if(!E)return;let f=e.state.doc.toString();f!==r&&E(f);},[]),u=n.useRef({service:new Compartment,layout:new Compartment,editable:new Compartment,actions:new Compartment}).current,H=n.useCallback(e=>e?languageService(e,{theme:tsliteTokenStyles,...T!==null?{tooltipParent:T??(typeof document<"u"?document.body:void 0)}:{},...I}):[],[I,T]),G=n.useCallback(e=>completionStatus(e.state)==="active"?acceptCompletion(e)||true:(C(e),true),[C]),P=n.useCallback((e,r,E,f)=>[e==="block"?[...r?[EditorView.lineWrapping]:[],we]:e==="grow"?[...r?[EditorView.lineWrapping]:[],Le,Prec.highest(keymap.of([{key:"Enter",run:G},{key:"Shift-Enter",run:insertNewlineAndIndent}]))]:[singleLine,Oe],ke(E,e),Ce(f)],[G]),M=n.useCallback(()=>{let e=[];return R.current.onTokenAction&&e.push(tokenAction({actionable:r=>R.current.isTokenActionable?.(r)??true,onAction:r=>R.current.onTokenAction?.(r)})),w&&h?.definitionAt&&e.push(gotoDefinition(w)),e},[w,h]);n.useEffect(()=>{if(!k.current)return;let e=new EditorView({parent:k.current,state:EditorState.create({doc:s==="inline"?$(o):o,extensions:[history(),u.service.of(H(h)),u.layout.of(P(s,d,p,a)),u.editable.of(EditorView.editable.of(!g)),u.actions.of(M()),...x?[placeholder(x)]:[],keymap.of([...historyKeymap,...defaultKeymap]),EditorView.updateListener.of(r=>{if(r.focusChanged&&oe(r.view.hasFocus),!r.docChanged)return;r.transactions.some(f=>f.annotation(externalChange))||R.current.onChange?.(r.state.doc.toString());}),EditorView.contentAttributes.of({"aria-label":x??"expression"}),EditorView.domEventHandlers({blur:(r,E)=>{let f=r.relatedTarget;return f instanceof Element&&(E.dom.contains(f)||f.closest(".cm-tooltip"))||C(E),false}}),...ee??[]]})});return v.current=e,Y(e),()=>{e.destroy(),v.current=null,Y(null);}},[]),n.useEffect(()=>{v.current?.dispatch({effects:u.service.reconfigure(H(h))});},[h,H,u]),n.useEffect(()=>{v.current?.dispatch({effects:u.layout.reconfigure(P(s,d,p,a))});},[s,d,p,a,P,u]),n.useEffect(()=>{v.current?.dispatch({effects:u.editable.reconfigure(EditorView.editable.of(!g))});},[g,u]),n.useEffect(()=>{let e=v.current;e&&(e.scrollDOM.style.maxHeight=s==="grow"&&c!==void 0&&c>0?Te(e,c):"");},[s,c,U]),n.useEffect(()=>{v.current?.dispatch({effects:u.actions.reconfigure(M())});},[M,u]),n.useEffect(()=>{let e=v.current;if(!e)return;let r=s==="inline"?$(o):o;if(r===e.state.doc.toString())return;let{anchor:E,head:f}=e.state.selection.main,N=re=>Math.min(re,r.length);e.dispatch({changes:{from:0,to:e.state.doc.length,insert:r},selection:{anchor:N(E),head:N(f)},annotations:externalChange.of(true)});},[o,s]);let ne=n.useCallback(()=>v.current?.focus(),[]);return {ref:k,view:U,focused:te,service:h,focus:ne}}var X=n.createContext(null);function q(){let t=n.useContext(X);if(!t)throw new Error("useFieldContext must be used inside <ExpressionField.Root>");return t}var He=["value","onChange","onCommit","layout","maxLines","wrap","editing","gutters","readOnly","placeholder","features","tooltipParent","onTokenAction","isTokenActionable","definition","extensions","env","service","segmenter","mode","profile","limits","unused","format","optional"];var J=n.forwardRef(function(o,l){let{children:i,...s}=o,c={},d={};for(let[a,g]of Object.entries(s))(He.includes(a)?c:d)[a]=g;let p=D(c);return jsx(X.Provider,{value:p,children:jsx("div",{ref:l,...d,children:typeof i=="function"?i(p):i})})}),Q=n.forwardRef(function(o,l){let i=q();return jsx("div",{ref:i.ref,...o})}),Z=n.forwardRef(function({children:o,...l},i){return jsx("button",{ref:i,type:"button",...l,children:o})}),S={Root:J,Editor:Q,ExpandTrigger:Z};var y={fg:"var(--foreground, #cccccc)",mutedFg:"var(--muted-foreground, #8b8b8b)",border:"var(--border, #2b2b2b)",ring:"var(--ring, #0078d4)",input:"var(--input, transparent)",destructive:"var(--destructive, #f14c4c)",font:"var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace)"},Pe=["--foreground","--muted-foreground","--border","--ring","--input","--destructive","--font-mono","--muted","--popover","--popover-foreground","--primary","--primary-foreground","--secondary","--accent"];var Me=jsx("svg",{width:"14",height:"14",viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round","aria-hidden":"true",children:jsx("path",{d:"M15 3h6v6M9 21H3v-6M21 3l-7 7M3 21l7-7"})});function Ae({invalid:t,className:o,style:l,onExpand:i,expandIcon:s,multiline:c,layout:d,...p}){let a=d??(c?"block":"inline");return jsx(S.Root,{...p,layout:a,className:o,children:g=>jsxs("div",{style:{position:"relative",border:`1px solid ${t?y.destructive:g.focused?y.ring:y.border}`,borderRadius:"6px",backgroundColor:y.input,color:y.fg,fontFamily:y.font,fontSize:"13px",overflow:"hidden",...a==="block"?{height:"100%",display:"flex",flexDirection:"column"}:{},...l},children:[jsx(S.Editor,{style:a==="block"?{flex:1,minHeight:0}:a==="grow"?{paddingRight:i?"28px":void 0}:{paddingRight:i?"24px":void 0}}),i&&jsx(S.ExpandTrigger,{onClick:i,"aria-label":"Expandir",title:"Expandir",onMouseEnter:x=>x.currentTarget.style.opacity="1",onMouseLeave:x=>x.currentTarget.style.opacity="0.55",style:{position:"absolute",top:a==="inline"?"50%":"6px",right:"4px",transform:a==="inline"?"translateY(-50%)":void 0,display:"flex",alignItems:"center",justifyContent:"center",width:"20px",height:"20px",padding:0,lineHeight:0,border:"none",borderRadius:"4px",background:y.input,color:y.mutedFg,cursor:"pointer",opacity:.55},children:s??Me})]})})}var Ie="1.3.0";export{Pe as CSS_VARS,S as ExpressionField,Q as ExpressionFieldEditor,Z as ExpressionFieldExpandTrigger,J as ExpressionFieldRoot,Ae as ExpressionInput,y as V,D as useExpressionField,q as useFieldContext,A as useLanguageService,Ie as version};
+import*as n from'react';import {Compartment,Prec,EditorState}from'@codemirror/state';import {EditorView,keymap,placeholder}from'@codemirror/view';import {insertNewlineAndIndent,history,historyKeymap,defaultKeymap}from'@codemirror/commands';import {completionStatus,acceptCompletion}from'@codemirror/autocomplete';import {externalChange,languageService,singleLine,tokenAction,gotoDefinition,codeEditing,gutters}from'@tslite/codemirror';import {tsliteTokenStyles,createHostService}from'@tslite/editor';import {whole,mustache}from'@tslite/language-service';import {jsx,jsxs}from'react/jsx-runtime';var xe={mustache:mustache,whole:whole},ye=t=>typeof t=="function"?t:xe[t];function N(t){let{world:o,service:s,segmenter:a="mustache",mode:m="expression",type:i,optional:d,profile:u,guards:c}=t,f=n.useMemo(()=>{if(s||!o)return null;let y={world:o,...i!==void 0?{type:i}:{},...d?{optional:d}:{}},R={...u?{profile:u}:{},...c?{guards:c}:{}};return m==="template"?createHostService({...y,...R,mode:m}):createHostService({...y,...R,segmenter:ye(a),mode:m})},[s,o,a,m,i,d,u,c]);return n.useEffect(()=>f?()=>f.dispose():void 0,[f]),s??f}var Pe=EditorView.theme({".cm-scroller":{overflowX:"auto",overflowY:"hidden"},".cm-content":{padding:"6px 8px"},".cm-line":{padding:"0"},"&.cm-focused":{outline:"none"}}),ne=6,Me=EditorView.theme({".cm-scroller":{overflowY:"auto"},".cm-content":{padding:`${ne}px 8px`},".cm-line":{padding:"0"},"&.cm-focused":{outline:"none"}}),Ae=(t,o)=>`${o*t.defaultLineHeight+2*ne}px`,De=EditorView.theme({"&":{height:"100%"},".cm-scroller":{overflowY:"auto"},".cm-content":{padding:"8px"},"&.cm-focused":{outline:"none"}}),Ie=t=>t.replace(/\r?\n/g," "),S=(t,o)=>o==="inline"?Ie(t):t,Ve=(t,o)=>{if(t===false)return [];let s=o==="block"?{}:{tab:false,indentOnInput:false};return codeEditing(typeof t=="object"?{...s,...t}:s)},_e=t=>t?gutters(typeof t=="object"?t:{}):[];function B(t){let{value:o,onChange:s,onCommit:a,onFinish:m,layout:i="inline",maxLines:d,wrap:u=i!=="inline",editing:c,gutters:f,readOnly:y=false,placeholder:R,features:W,tooltipParent:A,onTokenAction:$,isTokenActionable:z,definition:D,extensions:le}=t,F=N(t),I=n.useRef(null),v=n.useRef(null),[X,q]=n.useState(null),[de,pe]=n.useState(false),h=n.useRef({value:o,layout:i,onChange:s,onCommit:a,onFinish:m,onTokenAction:$,isTokenActionable:z});h.current={value:o,layout:i,onChange:s,onCommit:a,onFinish:m,onTokenAction:$,isTokenActionable:z};let O=n.useCallback(e=>{let{value:r,layout:l}=h.current;return e.state.doc.toString()!==S(r,l)},[]),V=n.useCallback((e,r)=>{let l=O(e);l&&h.current.onCommit?.(e.state.doc.toString()),h.current.onFinish?.({via:r,dirty:l});},[O]),_=n.useCallback(e=>{let{onFinish:r,value:l,layout:p}=h.current;if(!r||completionStatus(e.state)==="active")return  false;let L=O(e);if(L){let T=S(l,p);e.dispatch({changes:{from:0,to:e.state.doc.length,insert:T},selection:{anchor:T.length},annotations:externalChange.of(true)});}return r({via:"escape",dirty:L}),true},[O]),g=n.useRef({service:new Compartment,layout:new Compartment,editable:new Compartment,actions:new Compartment}).current,U=n.useCallback(e=>e?languageService(e,{theme:tsliteTokenStyles,...A!==null?{tooltipParent:A??(typeof document<"u"?document.body:void 0)}:{},...W}):[],[W,A]),J=n.useCallback(e=>completionStatus(e.state)==="active"?acceptCompletion(e)||true:(V(e,"enter"),true),[V]),Y=n.useCallback((e,r,l,p)=>[e==="block"?[...r?[EditorView.lineWrapping]:[],De]:e==="grow"?[...r?[EditorView.lineWrapping]:[],Me,Prec.highest(keymap.of([{key:"Enter",run:J},{key:"Shift-Enter",run:insertNewlineAndIndent},{key:"Escape",run:_}]))]:[singleLine,Pe,Prec.highest(keymap.of([{key:"Escape",run:_}]))],Ve(l,e),_e(p)],[J,_]),G=n.useCallback(()=>{let e=[];return h.current.onTokenAction&&e.push(tokenAction({actionable:r=>h.current.isTokenActionable?.(r)??true,onAction:r=>h.current.onTokenAction?.(r)})),D&&F?.definitionAt&&e.push(gotoDefinition(D)),e},[D,F]);n.useEffect(()=>{if(!I.current)return;let e=new EditorView({parent:I.current,state:EditorState.create({doc:S(o,i),extensions:[history(),g.service.of(U(F)),g.layout.of(Y(i,u,c,f)),g.editable.of(EditorView.editable.of(!y)),g.actions.of(G()),...R?[placeholder(R)]:[],keymap.of([...historyKeymap,...defaultKeymap]),EditorView.updateListener.of(r=>{if(r.focusChanged&&pe(r.view.hasFocus),!r.docChanged)return;r.transactions.some(p=>p.annotation(externalChange))||h.current.onChange?.(r.state.doc.toString());}),EditorView.contentAttributes.of({"aria-label":R??"expression"}),EditorView.domEventHandlers({blur:(r,l)=>{let p=r.relatedTarget;return p instanceof Element&&(l.dom.contains(p)||p.closest(".cm-tooltip"))||V(l,"blur"),false}}),...le??[]]})});return v.current=e,q(e),()=>{e.destroy(),v.current=null,q(null);}},[]),n.useEffect(()=>{v.current?.dispatch({effects:g.service.reconfigure(U(F))});},[F,U,g]),n.useEffect(()=>{v.current?.dispatch({effects:g.layout.reconfigure(Y(i,u,c,f))});},[i,u,c,f,Y,g]),n.useEffect(()=>{v.current?.dispatch({effects:g.editable.reconfigure(EditorView.editable.of(!y))});},[y,g]),n.useEffect(()=>{let e=v.current;e&&(e.scrollDOM.style.maxHeight=i==="grow"&&d!==void 0&&d>0?Ae(e,d):"");},[i,d,X]),n.useEffect(()=>{v.current?.dispatch({effects:g.actions.reconfigure(G())});},[G,g]);let Q=n.useRef({value:o,layout:i});n.useEffect(()=>{let e=v.current;if(!e)return;let r=Q.current;Q.current={value:o,layout:i};let l=e.state.doc.toString(),p=o!==r.value||l===S(o,r.layout)?S(o,i):S(l,i);if(p===l)return;let{anchor:L,head:T}=e.state.selection.main,Z=fe=>Math.min(fe,p.length);e.dispatch({changes:{from:0,to:e.state.doc.length,insert:p},selection:{anchor:Z(L),head:Z(T)},annotations:externalChange.of(true)});},[o,i]);let ue=n.useCallback(()=>v.current?.focus(),[]);return {ref:I,view:X,focused:de,service:F,focus:ue}}var w=class extends Error{constructor(o,s){super(s),this.name="ExpressionFieldError",this.code=o;}};var re=n.createContext(null);function ie(){let t=n.useContext(re);if(!t)throw new w("outside-root","useFieldContext must be used inside <ExpressionField.Root>");return t}var Ue=["value","onChange","onCommit","onFinish","layout","maxLines","wrap","editing","gutters","readOnly","placeholder","features","tooltipParent","onTokenAction","isTokenActionable","definition","extensions","world","service","segmenter","mode","type","optional","profile","guards"];var se=n.forwardRef(function(o,s){let{children:a,...m}=o,i={},d={};for(let[c,f]of Object.entries(m))(Ue.includes(c)?i:d)[c]=f;let u=B(i);return jsx(re.Provider,{value:u,children:jsx("div",{ref:s,...d,children:typeof a=="function"?a(u):a})})}),ae=n.forwardRef(function(o,s){let a=ie();return jsx("div",{ref:a.ref,...o})}),ce=n.forwardRef(function({children:o,...s},a){return jsx("button",{ref:a,type:"button",...s,children:o})}),C={Root:se,Editor:ae,ExpandTrigger:ce};var E={fg:"var(--foreground, #cccccc)",mutedFg:"var(--muted-foreground, #8b8b8b)",border:"var(--border, #2b2b2b)",ring:"var(--ring, #0078d4)",input:"var(--input, transparent)",destructive:"var(--destructive, #f14c4c)",font:"var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace)"},Ye=["--foreground","--muted-foreground","--border","--ring","--input","--destructive","--font-mono","--muted","--popover","--popover-foreground","--primary","--primary-foreground","--secondary","--accent"];var Ge=jsx("svg",{width:"14",height:"14",viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round",strokeLinejoin:"round","aria-hidden":"true",children:jsx("path",{d:"M15 3h6v6M9 21H3v-6M21 3l-7 7M3 21l7-7"})});function Ne({invalid:t,className:o,style:s,onExpand:a,expandIcon:m,multiline:i,layout:d,...u}){let c=d??(i?"block":"inline");return jsx(C.Root,{...u,layout:c,className:o,children:f=>jsxs("div",{style:{position:"relative",border:`1px solid ${t?E.destructive:f.focused?E.ring:E.border}`,borderRadius:"6px",backgroundColor:E.input,color:E.fg,fontFamily:E.font,fontSize:"13px",overflow:"hidden",...c==="block"?{height:"100%",display:"flex",flexDirection:"column"}:{},...s},children:[jsx(C.Editor,{style:c==="block"?{flex:1,minHeight:0}:c==="grow"?{paddingRight:a?"28px":void 0}:{paddingRight:a?"24px":void 0}}),a&&jsx(C.ExpandTrigger,{onClick:a,"aria-label":"Expandir",title:"Expandir",onMouseEnter:y=>y.currentTarget.style.opacity="1",onMouseLeave:y=>y.currentTarget.style.opacity="0.55",style:{position:"absolute",top:c==="inline"?"50%":"6px",right:"4px",transform:c==="inline"?"translateY(-50%)":void 0,display:"flex",alignItems:"center",justifyContent:"center",width:"20px",height:"20px",padding:0,lineHeight:0,border:"none",borderRadius:"4px",background:E.input,color:E.mutedFg,cursor:"pointer",opacity:.55},children:m??Ge})]})})}var je="1.5.0";export{Ye as CSS_VARS,C as ExpressionField,ae as ExpressionFieldEditor,w as ExpressionFieldError,ce as ExpressionFieldExpandTrigger,se as ExpressionFieldRoot,Ne as ExpressionInput,E as V,B as useExpressionField,ie as useFieldContext,N as useLanguageService,je as version};

package/dist/{useExpressionField-RmyW3D9R.d.cts → useExpressionField-Dsh6-SIB.d.cts}

@@ -3,7 +3,7 @@ import { Extension } from '@codemirror/state';
 import { EditorView } from '@codemirror/view';
 import { CodeEditingOptions, GuttersOptions, LanguageServiceOptions as LanguageServiceOptions$1, TokenActionTarget, GotoDefinitionOptions } from '@tslite/codemirror';
 import { Segmenter, LanguageService, Token } from '@tslite/language-service';
-import { HostServiceOptions } from '@tslite/editor';
+import { HostServiceOptions, HostServiceCodeOptions } from '@tslite/editor';
 
 /**
  * Onde, no texto, mora o código.
@@ -16,14 +16,16 @@ type SegmenterOption = "mustache" | "whole" | Segmenter;
 /** O que define o cérebro do campo. */
 interface LanguageServiceOptions {
     /**
-     * O ambiente de tipos — o shape dos dados no escopo das expressões.
+     * O mundo em que o campo se tipa (`createWorld` do `@tslite/editor`): a lib da
+     * cópia do tsc, o `.d.ts` do `std` e as declarações do host. Os campos de uma
+     * tela dividem o mesmo mundo, e cada um é um arquivo virtual dele.
      *
-     * **Memoize-o.** Um objeto novo a cada render reconstrói o serviço e joga
-     * fora o cache de análise. `useMemo` no seu lado resolve.
+     * **Crie-o uma vez** (fora do render, ou num `useMemo`). Um mundo novo a cada
+     * render reconstrói o serviço e reparseia a lib.
      */
-    readonly env?: HostServiceOptions["env"];
+    readonly world?: HostServiceOptions["world"];
     /**
-     * Um serviço pronto, no lugar do `env`. Tem precedência — e é o caminho para
+     * Um serviço pronto, no lugar do `world`. Tem precedência — e é o caminho para
      * trocar o cérebro por outro (outra linguagem, outra implementação).
      */
     readonly service?: LanguageService;
@@ -53,19 +55,12 @@ interface LanguageServiceOptions {
      */
     readonly mode?: "expression" | "program" | "template";
     /**
-     * Capability — **desinstala** features da Linguagem.
-     *
-     * Sem ela o campo só tipa, e uma atribuição (`{{ user.name = "ok" }}`) passa:
-     * `=` existe na Linguagem completa. Não há padrão implícito aqui, porque qual
-     * profile cabe num campo é decisão de produto.
+     * O tipo que o valor do campo tem de ter, como o texto de um tipo
+     * (`"boolean"`, `"Address"`): o campo acusa, enquanto se digita, o valor que
+     * não cabe nele. Vale para a expressão e para o template; um programa não tem
+     * valor. Sem ele, o campo aceita qualquer tipo.
      */
-    readonly profile?: HostServiceOptions["profile"];
-    /** Limites estruturais (anti-DoS). */
-    readonly limits?: HostServiceOptions["limits"];
-    /** Bindings nunca lidos. Ligado por padrão (é API de editor). */
-    readonly unused?: HostServiceOptions["unused"];
-    /** O formatador (`formatExpression` do `@tslite/format`). Sem ele, não formata. */
-    readonly format?: HostServiceOptions["format"];
+    readonly type?: HostServiceOptions["type"];
     /**
      * O campo aceita ficar vazio: o texto vazio, ou só com espaços, é a ausência do
      * valor, e não o erro de "falta a expressão". Padrão: `false`. As sugestões no
@@ -73,10 +68,33 @@ interface LanguageServiceOptions {
      * (`createHostService({ optional })`).
      */
     readonly optional?: HostServiceOptions["optional"];
+    /**
+     * O perfil de capability do campo (o `@tslite/capability`): o que o campo pode
+     * escrever. O que ele recusa sai nos diagnósticos, enquanto se digita, sobre o
+     * texto que parseia (a E32 do `@tslite/editor`), com o veredito do executor e o da
+     * camada de controle. Sem padrão: sem ele, nada se poda (R18).
+     *
+     * **Crie-o uma vez**, como o `world`: um perfil novo a cada render reconstrói o
+     * serviço. No `mode: "template"`, ele julga o que o template desaçucara (o `map`
+     * de um `{% for %}`), como o executor, e a violação pousa na diretiva (a E34 do
+     * `@tslite/editor`). Com `service`, o perfil é de quem montou o serviço.
+     */
+    readonly profile?: HostServiceCodeOptions["profile"];
+    /**
+     * As regras a mais da camada de controle do `@tslite/behavior` (as de forma, as da
+     * aplicação), nos diagnósticos como as do perfil. Valem as mesmas regras do
+     * `profile`: crie-as uma vez.
+     */
+    readonly guards?: HostServiceCodeOptions["guards"];
 }
 /**
- * O `LanguageService` do campo. `null` quando não há `env` nem `service` — o
+ * O `LanguageService` do campo. `null` quando não há `world` nem `service` — o
  * editor continua editando texto, só sem inteligência.
+ *
+ * O serviço que o hook monta põe os arquivos virtuais do campo no mundo; quando
+ * ele é trocado (uma opção mudou) ou o campo desmonta, o hook os tira (o
+ * `dispose`, E28 do `@tslite/editor`). O `service` passado é de quem o montou, e
+ * o hook não o solta.
  */
 declare function useLanguageService(options: LanguageServiceOptions): LanguageService | null;
 
@@ -113,6 +131,20 @@ interface UseExpressionFieldOptions extends LanguageServiceOptions {
      * não é o autor terminando, e não commita.
      */
     readonly onCommit?: (text: string) => void;
+    /**
+     * O GESTO com que o autor terminou: o `Enter` que termina (layout `"grow"`), o
+     * `Escape` que cancela (layouts `"inline"` e `"grow"`) ou o foco que sai. Dispara
+     * também quando nada mudou, com `dirty` dizendo se havia rascunho diferente do
+     * `value` naquele instante (R19).
+     *
+     * No `Enter` e no blur, ele vem depois do `onCommit` (quando há o que commitar):
+     * quem recusa o texto no `onCommit` já recusou quando o gesto chega. O `Escape`
+     * volta o rascunho ao `value`, sem `onChange` nem `onCommit`, e avisa. A tecla
+     * que a lista de sugestões consome (o `Enter` que aceita, o `Escape` que fecha)
+     * não é o autor terminando, e não dispara. Sem esta função, o `Escape` não é do
+     * campo.
+     */
+    readonly onFinish?: (finish: FieldFinish) => void;
     /** Como o campo se apresenta. Padrão: `"inline"`. */
     readonly layout?: FieldLayout;
     /**
@@ -193,6 +225,13 @@ interface UseExpressionFieldOptions extends LanguageServiceOptions {
     /** Extensões extras do CodeMirror — a escotilha de fuga. */
     readonly extensions?: readonly Extension[];
 }
+/** Como o autor terminou a edição do campo (R19). */
+interface FieldFinish {
+    /** O gesto: o `Enter` que termina, o `Escape` que cancela, ou o foco que sai. */
+    readonly via: "enter" | "escape" | "blur";
+    /** Havia rascunho diferente do `value` quando o autor terminou. */
+    readonly dirty: boolean;
+}
 /** O que o hook devolve. */
 interface ExpressionFieldHandle {
     /** Ponha num elemento vazio: é onde o editor monta. */
@@ -208,4 +247,4 @@ interface ExpressionFieldHandle {
 }
 declare function useExpressionField(options: UseExpressionFieldOptions): ExpressionFieldHandle;
 
-export { type ExpressionFieldHandle as E, type FieldLayout as F, type LanguageServiceOptions as L, type SegmenterOption as S, type UseExpressionFieldOptions as U, useLanguageService as a, useExpressionField as u };
+export { type ExpressionFieldHandle as E, type FieldLayout as F, type LanguageServiceOptions as L, type SegmenterOption as S, type UseExpressionFieldOptions as U, type FieldFinish as a, useLanguageService as b, useExpressionField as u };

package/dist/{useExpressionField-RmyW3D9R.d.ts → useExpressionField-Dsh6-SIB.d.ts}

@@ -3,7 +3,7 @@ import { Extension } from '@codemirror/state';
 import { EditorView } from '@codemirror/view';
 import { CodeEditingOptions, GuttersOptions, LanguageServiceOptions as LanguageServiceOptions$1, TokenActionTarget, GotoDefinitionOptions } from '@tslite/codemirror';
 import { Segmenter, LanguageService, Token } from '@tslite/language-service';
-import { HostServiceOptions } from '@tslite/editor';
+import { HostServiceOptions, HostServiceCodeOptions } from '@tslite/editor';
 
 /**
  * Onde, no texto, mora o código.
@@ -16,14 +16,16 @@ type SegmenterOption = "mustache" | "whole" | Segmenter;
 /** O que define o cérebro do campo. */
 interface LanguageServiceOptions {
     /**
-     * O ambiente de tipos — o shape dos dados no escopo das expressões.
+     * O mundo em que o campo se tipa (`createWorld` do `@tslite/editor`): a lib da
+     * cópia do tsc, o `.d.ts` do `std` e as declarações do host. Os campos de uma
+     * tela dividem o mesmo mundo, e cada um é um arquivo virtual dele.
      *
-     * **Memoize-o.** Um objeto novo a cada render reconstrói o serviço e joga
-     * fora o cache de análise. `useMemo` no seu lado resolve.
+     * **Crie-o uma vez** (fora do render, ou num `useMemo`). Um mundo novo a cada
+     * render reconstrói o serviço e reparseia a lib.
      */
-    readonly env?: HostServiceOptions["env"];
+    readonly world?: HostServiceOptions["world"];
     /**
-     * Um serviço pronto, no lugar do `env`. Tem precedência — e é o caminho para
+     * Um serviço pronto, no lugar do `world`. Tem precedência — e é o caminho para
      * trocar o cérebro por outro (outra linguagem, outra implementação).
      */
     readonly service?: LanguageService;
@@ -53,19 +55,12 @@ interface LanguageServiceOptions {
      */
     readonly mode?: "expression" | "program" | "template";
     /**
-     * Capability — **desinstala** features da Linguagem.
-     *
-     * Sem ela o campo só tipa, e uma atribuição (`{{ user.name = "ok" }}`) passa:
-     * `=` existe na Linguagem completa. Não há padrão implícito aqui, porque qual
-     * profile cabe num campo é decisão de produto.
+     * O tipo que o valor do campo tem de ter, como o texto de um tipo
+     * (`"boolean"`, `"Address"`): o campo acusa, enquanto se digita, o valor que
+     * não cabe nele. Vale para a expressão e para o template; um programa não tem
+     * valor. Sem ele, o campo aceita qualquer tipo.
      */
-    readonly profile?: HostServiceOptions["profile"];
-    /** Limites estruturais (anti-DoS). */
-    readonly limits?: HostServiceOptions["limits"];
-    /** Bindings nunca lidos. Ligado por padrão (é API de editor). */
-    readonly unused?: HostServiceOptions["unused"];
-    /** O formatador (`formatExpression` do `@tslite/format`). Sem ele, não formata. */
-    readonly format?: HostServiceOptions["format"];
+    readonly type?: HostServiceOptions["type"];
     /**
      * O campo aceita ficar vazio: o texto vazio, ou só com espaços, é a ausência do
      * valor, e não o erro de "falta a expressão". Padrão: `false`. As sugestões no
@@ -73,10 +68,33 @@ interface LanguageServiceOptions {
      * (`createHostService({ optional })`).
      */
     readonly optional?: HostServiceOptions["optional"];
+    /**
+     * O perfil de capability do campo (o `@tslite/capability`): o que o campo pode
+     * escrever. O que ele recusa sai nos diagnósticos, enquanto se digita, sobre o
+     * texto que parseia (a E32 do `@tslite/editor`), com o veredito do executor e o da
+     * camada de controle. Sem padrão: sem ele, nada se poda (R18).
+     *
+     * **Crie-o uma vez**, como o `world`: um perfil novo a cada render reconstrói o
+     * serviço. No `mode: "template"`, ele julga o que o template desaçucara (o `map`
+     * de um `{% for %}`), como o executor, e a violação pousa na diretiva (a E34 do
+     * `@tslite/editor`). Com `service`, o perfil é de quem montou o serviço.
+     */
+    readonly profile?: HostServiceCodeOptions["profile"];
+    /**
+     * As regras a mais da camada de controle do `@tslite/behavior` (as de forma, as da
+     * aplicação), nos diagnósticos como as do perfil. Valem as mesmas regras do
+     * `profile`: crie-as uma vez.
+     */
+    readonly guards?: HostServiceCodeOptions["guards"];
 }
 /**
- * O `LanguageService` do campo. `null` quando não há `env` nem `service` — o
+ * O `LanguageService` do campo. `null` quando não há `world` nem `service` — o
  * editor continua editando texto, só sem inteligência.
+ *
+ * O serviço que o hook monta põe os arquivos virtuais do campo no mundo; quando
+ * ele é trocado (uma opção mudou) ou o campo desmonta, o hook os tira (o
+ * `dispose`, E28 do `@tslite/editor`). O `service` passado é de quem o montou, e
+ * o hook não o solta.
  */
 declare function useLanguageService(options: LanguageServiceOptions): LanguageService | null;
 
@@ -113,6 +131,20 @@ interface UseExpressionFieldOptions extends LanguageServiceOptions {
      * não é o autor terminando, e não commita.
      */
     readonly onCommit?: (text: string) => void;
+    /**
+     * O GESTO com que o autor terminou: o `Enter` que termina (layout `"grow"`), o
+     * `Escape` que cancela (layouts `"inline"` e `"grow"`) ou o foco que sai. Dispara
+     * também quando nada mudou, com `dirty` dizendo se havia rascunho diferente do
+     * `value` naquele instante (R19).
+     *
+     * No `Enter` e no blur, ele vem depois do `onCommit` (quando há o que commitar):
+     * quem recusa o texto no `onCommit` já recusou quando o gesto chega. O `Escape`
+     * volta o rascunho ao `value`, sem `onChange` nem `onCommit`, e avisa. A tecla
+     * que a lista de sugestões consome (o `Enter` que aceita, o `Escape` que fecha)
+     * não é o autor terminando, e não dispara. Sem esta função, o `Escape` não é do
+     * campo.
+     */
+    readonly onFinish?: (finish: FieldFinish) => void;
     /** Como o campo se apresenta. Padrão: `"inline"`. */
     readonly layout?: FieldLayout;
     /**
@@ -193,6 +225,13 @@ interface UseExpressionFieldOptions extends LanguageServiceOptions {
     /** Extensões extras do CodeMirror — a escotilha de fuga. */
     readonly extensions?: readonly Extension[];
 }
+/** Como o autor terminou a edição do campo (R19). */
+interface FieldFinish {
+    /** O gesto: o `Enter` que termina, o `Escape` que cancela, ou o foco que sai. */
+    readonly via: "enter" | "escape" | "blur";
+    /** Havia rascunho diferente do `value` quando o autor terminou. */
+    readonly dirty: boolean;
+}
 /** O que o hook devolve. */
 interface ExpressionFieldHandle {
     /** Ponha num elemento vazio: é onde o editor monta. */
@@ -208,4 +247,4 @@ interface ExpressionFieldHandle {
 }
 declare function useExpressionField(options: UseExpressionFieldOptions): ExpressionFieldHandle;
 
-export { type ExpressionFieldHandle as E, type FieldLayout as F, type LanguageServiceOptions as L, type SegmenterOption as S, type UseExpressionFieldOptions as U, useLanguageService as a, useExpressionField as u };
+export { type ExpressionFieldHandle as E, type FieldLayout as F, type LanguageServiceOptions as L, type SegmenterOption as S, type UseExpressionFieldOptions as U, type FieldFinish as a, useLanguageService as b, useExpressionField as u };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tslite/react",
-  "version": "1.3.0",
-  "description": "React bindings for TSLite — a headless expression field (CodeMirror 6) with type-aware highlighting, completion, diagnostics and quick-fixes, driven by the TSLite checker.",
+  "version": "1.5.0",
+  "description": "React bindings for TSLite — a headless expression field (CodeMirror 6) with type-aware highlighting, completion, diagnostics and quick-fixes, driven by the TypeScript language service ported to TSLite.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -48,8 +48,7 @@
   },
   "dependencies": {
     "@tslite/codemirror": "^1.3.0",
-    "@tslite/editor": "^1.4.1",
-    "@tslite/format": "^1.4.0",
+    "@tslite/editor": "^1.7.0",
     "@tslite/language-service": "^1.2.0"
   },
   "peerDependencies": {
@@ -61,8 +60,7 @@
     "@codemirror/state": "^6.0.0",
     "@codemirror/view": "^6.37.0",
     "react": ">=18",
-    "react-dom": ">=18",
-    "@tslite/checker": "^1.8.0"
+    "react-dom": ">=18"
   },
   "devDependencies": {
     "@codemirror/autocomplete": "^6.20.3",
@@ -77,7 +75,8 @@
     "@types/react-dom": "^18.3.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
-    "@tslite/checker": "1.8.0"
+    "@tslite/checker": "1.13.0",
+    "@tslite/std": "1.4.0"
   },
   "peerDependenciesMeta": {
     "@codemirror/search": {