@valyrianjs/terminal 0.1.2 → 0.2.0

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-export type { TerminalBoxProps, TerminalButtonPressEventPayload, TerminalButtonProps, TerminalChangeEventPayload, TerminalCommand, TerminalCommandContext, TerminalCommandId, TerminalCommandScope, InputInteractionState, TerminalClipboardAdapter, TerminalCaptureEventPayload, TerminalDirectiveProps, TerminalElementNode, TerminalEditorCancelEventPayload, TerminalEditorChangeEventPayload, TerminalEditorProps, TerminalEditorSubmitEventPayload, TerminalFrame, TerminalHitbox, TerminalInputChangeEventPayload, TerminalInputProps, TerminalInputSubmitEventPayload, TerminalKeyBinding, TerminalKeyBindingCondition, TerminalKeymapOptions, TerminalListPointerEventPayload, TerminalListChangeEventPayload, TerminalListProps, TerminalListPressEventPayload, TerminalLayoutProps, TerminalLogViewEntry, TerminalLogViewProps, TerminalMountOptions, TerminalMouseEventType, TerminalNode, TerminalOverlayProps, TerminalOutputStream, TerminalPaneProps, TerminalPointerCoordinates, TerminalPointerCaptureProps, TerminalPressEventPayload, TerminalPointerSource, TerminalRowPointerEventPayload, TerminalRowPointerEventPayloadBase, TerminalRowProps, TerminalScreenProps, TerminalScrollPointerEventPayload, TerminalScrollViewProps, TerminalSemanticStyleKind, TerminalSession, TerminalSize, TerminalSplitBreakpoint, TerminalSplitProps, TerminalSplitSize, TerminalStyleSpan, TerminalStyleToken, TerminalStyleDefinition, TerminalStyleProps, TerminalStyleReference, TerminalStyleTree, TerminalStyleValue, TerminalStateStyles, TerminalVisualState, TerminalColor, TerminalSpacing, TerminalBorder, TerminalBorderStyle, TerminalTableProps, TerminalTdProps, TerminalTheme, TerminalTextProps, TerminalValueEventPayloadBase, TerminalFocusableProps, TerminalEventPayloadBase, TerminalFocusScopeProps, TerminalFixedProps, TerminalViewProps, TerminalTextNode } from "./types.js";
+export type { TerminalBoxProps, TerminalButtonPressEventPayload, TerminalButtonProps, TerminalChangeEventPayload, TerminalCommand, TerminalCommandContext, TerminalCommandId, TerminalCommandScope, InputInteractionState, TerminalClipboardAdapter, TerminalCaptureEventPayload, TerminalDirectiveProps, TerminalElementNode, TerminalEditorCancelEventPayload, TerminalEditorChangeEventPayload, TerminalEditorProps, TerminalEditorSubmitEventPayload, TerminalFrame, TerminalHitbox, TerminalInputChangeEventPayload, TerminalInputContextPressEventPayload, TerminalInputProps, TerminalInputSubmitEventPayload, TerminalKeyBinding, TerminalKeyBindingCondition, TerminalKeymapOptions, TerminalListPointerEventPayload, TerminalListChangeEventPayload, TerminalListProps, TerminalListPressEventPayload, TerminalLayoutProps, TerminalLogViewEntry, TerminalLogViewProps, TerminalMountOptions, TerminalMouseEventType, TerminalNode, TerminalOverlayProps, TerminalOutputStream, TerminalPaneProps, TerminalPointerCoordinates, TerminalPointerCaptureProps, TerminalPressEventPayload, TerminalPointerSource, TerminalRowPointerEventPayload, TerminalRowPointerEventPayloadBase, TerminalRowProps, TerminalScreenProps, TerminalScrollPointerEventPayload, TerminalScrollContextPressEventPayload, TerminalScrollViewProps, TerminalSemanticStyleKind, TerminalSession, TerminalSize, TerminalSplitBreakpoint, TerminalSplitProps, TerminalSplitSize, TerminalStyleSpan, TerminalStyleToken, TerminalStyleDefinition, TerminalStyleProps, TerminalStyleReference, TerminalStyleTree, TerminalStyleValue, TerminalStateStyles, TerminalVisualState, TerminalColor, TerminalSpacing, TerminalBorder, TerminalBorderStyle, TerminalTableProps, TerminalTdProps, TerminalTheme, TerminalTextProps, TerminalValueEventPayloadBase, TerminalFocusableProps, TerminalEventPayloadBase, TerminalFocusScopeProps, TerminalFixedProps, TerminalViewProps, TerminalTextNode } from "./types.js";
 export { Box, Button, Editor, Fixed, FocusScope, Input, List, LogView, Overlay, Pane, Row, Screen, ScrollView, Split, Table, Td, Text, View } from "./primitives.js";
 export { createResolvedTerminalKeymap, createTerminalKeyBindings, defaultTerminalKeyBindings, resolveTerminalKeyBinding, validateTerminalKeyBindings } from "./keymap.js";
 export { defaultTerminalTheme, highContrastTerminalTheme, mergeTerminalTheme, resolveTerminalStyle, resolveTerminalStyleToken } from "./theme.js";
 export { renderTerminal } from "./render.js";
+export type { TerminalRenderContext } from "./render.js";
 export { mountTerminal } from "./session.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,+BAA+B,EAC/B,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EACnB,gCAAgC,EAChC,gCAAgC,EAChC,mBAAmB,EACnB,gCAAgC,EAChC,aAAa,EACb,cAAc,EACd,+BAA+B,EAC/B,kBAAkB,EAClB,+BAA+B,EAC/B,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,+BAA+B,EAC/B,8BAA8B,EAC9B,iBAAiB,EACjB,6BAA6B,EAC7B,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,8BAA8B,EAC9B,kCAAkC,EAClC,gBAAgB,EAChB,mBAAmB,EACnB,iCAAiC,EACjC,uBAAuB,EACvB,yBAAyB,EACzB,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,6BAA6B,EAC7B,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrK,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAClJ,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,+BAA+B,EAC/B,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EACnB,gCAAgC,EAChC,gCAAgC,EAChC,mBAAmB,EACnB,gCAAgC,EAChC,aAAa,EACb,cAAc,EACd,+BAA+B,EAC/B,qCAAqC,EACrC,kBAAkB,EAClB,+BAA+B,EAC/B,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,+BAA+B,EAC/B,8BAA8B,EAC9B,iBAAiB,EACjB,6BAA6B,EAC7B,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,8BAA8B,EAC9B,kCAAkC,EAClC,gBAAgB,EAChB,mBAAmB,EACnB,iCAAiC,EACjC,sCAAsC,EACtC,uBAAuB,EACvB,yBAAyB,EACzB,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,6BAA6B,EAC7B,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrK,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAClJ,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiFA,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrK,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAClJ,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmFA,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrK,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAClJ,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/primitives.d.ts

@@ -1,5 +1,10 @@
-import type { AnyProps, TerminalBoxProps, TerminalButtonProps, TerminalEditorProps, TerminalFocusScopeProps, TerminalFixedProps, TerminalInputProps, TerminalListProps, TerminalLogViewProps, TerminalOverlayProps, TerminalPaneProps, TerminalRowProps, TerminalScreenProps, TerminalScrollViewProps, TerminalSplitProps, TerminalTableProps, TerminalTdProps, TerminalTextProps, TerminalViewProps } from "./types.js";
-type TerminalPrimitiveComponent<P> = (props: P | AnyProps, children: any[]) => any;
+import type { TerminalBoxProps, TerminalButtonProps, TerminalEditorProps, TerminalFocusScopeProps, TerminalFixedProps, TerminalInputProps, TerminalListProps, TerminalLogViewProps, TerminalOverlayProps, TerminalPaneProps, TerminalRowProps, TerminalScreenProps, TerminalScrollViewProps, TerminalSplitProps, TerminalTableProps, TerminalTdProps, TerminalTextProps, TerminalViewProps } from "./types.js";
+type TerminalPrimitiveComponentProps<P> = P & {
+    children?: any;
+    key?: any;
+};
+type TerminalPrimitiveComponent<P> = (props: TerminalPrimitiveComponentProps<P>, children: any[]) => any;
+type TerminalListComponent = <T>(props: TerminalPrimitiveComponentProps<TerminalListProps<T>>, children: any[]) => any;
 export declare const Screen: TerminalPrimitiveComponent<TerminalScreenProps>;
 export declare const Box: TerminalPrimitiveComponent<TerminalBoxProps>;
 export declare const View: TerminalPrimitiveComponent<TerminalViewProps>;
@@ -14,7 +19,7 @@ export declare const Editor: TerminalPrimitiveComponent<TerminalEditorProps>;
 export declare const Button: TerminalPrimitiveComponent<TerminalButtonProps>;
 export declare const ScrollView: TerminalPrimitiveComponent<TerminalScrollViewProps>;
 export declare const LogView: TerminalPrimitiveComponent<TerminalLogViewProps>;
-export declare const List: TerminalPrimitiveComponent<TerminalListProps<any>>;
+export declare const List: TerminalListComponent;
 export declare const Table: TerminalPrimitiveComponent<TerminalTableProps>;
 export declare const Row: TerminalPrimitiveComponent<TerminalRowProps>;
 export declare const Td: TerminalPrimitiveComponent<TerminalTdProps>;

package/dist/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EAEjB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,KAAK,0BAA0B,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AASnF,eAAO,MAAM,MAAM,iDAAoD,CAAC;AACxE,eAAO,MAAM,GAAG,8CAA8C,CAAC;AAC/D,eAAO,MAAM,IAAI,+CAAgD,CAAC;AAClE,eAAO,MAAM,IAAI,+CAAgD,CAAC;AAClE,eAAO,MAAM,KAAK,gDAAkD,CAAC;AACrE,eAAO,MAAM,KAAK,gDAAkD,CAAC;AACrE,eAAO,MAAM,OAAO,kDAAsD,CAAC;AAC3E,eAAO,MAAM,UAAU,qDAA6D,CAAC;AACrF,eAAO,MAAM,IAAI,+CAAgD,CAAC;AAClE,eAAO,MAAM,KAAK,gDAAkD,CAAC;AACrE,eAAO,MAAM,MAAM,iDAAoD,CAAC;AACxE,eAAO,MAAM,MAAM,iDAAoD,CAAC;AACxE,eAAO,MAAM,UAAU,qDAAwD,CAAC;AAChF,eAAO,MAAM,OAAO,kDAAuD,CAAC;AAC5E,eAAO,MAAM,IAAI,oDAAqD,CAAC;AACvE,eAAO,MAAM,KAAK,gDAAkD,CAAC;AACrE,eAAO,MAAM,GAAG,8CAA8C,CAAC;AAC/D,eAAO,MAAM,EAAE,6CAA4C,CAAC"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EAEjB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,KAAK,+BAA+B,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,GAAG,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAA;CAAE,CAAC;AAE5E,KAAK,0BAA0B,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,+BAA+B,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAEzG,KAAK,qBAAqB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,+BAA+B,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AASvH,eAAO,MAAM,MAAM,iDAAoD,CAAC;AACxE,eAAO,MAAM,GAAG,8CAA8C,CAAC;AAC/D,eAAO,MAAM,IAAI,+CAAgD,CAAC;AAClE,eAAO,MAAM,IAAI,+CAAgD,CAAC;AAClE,eAAO,MAAM,KAAK,gDAAkD,CAAC;AACrE,eAAO,MAAM,KAAK,gDAAkD,CAAC;AACrE,eAAO,MAAM,OAAO,kDAAsD,CAAC;AAC3E,eAAO,MAAM,UAAU,qDAA6D,CAAC;AACrF,eAAO,MAAM,IAAI,+CAAgD,CAAC;AAClE,eAAO,MAAM,KAAK,gDAAkD,CAAC;AACrE,eAAO,MAAM,MAAM,iDAAoD,CAAC;AACxE,eAAO,MAAM,MAAM,iDAAoD,CAAC;AACxE,eAAO,MAAM,UAAU,qDAAwD,CAAC;AAChF,eAAO,MAAM,OAAO,kDAAuD,CAAC;AAC5E,eAAO,MAAM,IAAI,EAAiC,qBAAqB,CAAC;AACxE,eAAO,MAAM,KAAK,gDAAkD,CAAC;AACrE,eAAO,MAAM,GAAG,8CAA8C,CAAC;AAC/D,eAAO,MAAM,EAAE,6CAA4C,CAAC"}

package/dist/primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAC;AA2BhC,SAAS,SAAS,CAA0B,GAAyB;IACnE,OAAO,SAAS,iBAAiB,CAAC,KAAmB,EAAE,QAAe;QACpE,MAAM,SAAS,GAAG,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAyB,CAAC;QAC9D,OAAO,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAsB,iBAAiB,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,GAAG,GAAG,SAAS,CAAmB,cAAc,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAoB,eAAe,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAoB,eAAe,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAqB,gBAAgB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAqB,gBAAgB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAuB,kBAAkB,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAA0B,sBAAsB,CAAC,CAAC;AACrF,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAoB,eAAe,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAqB,gBAAgB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAsB,iBAAiB,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAsB,iBAAiB,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAA0B,iBAAiB,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAuB,mBAAmB,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAyB,eAAe,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAqB,gBAAgB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,GAAG,GAAG,SAAS,CAAmB,cAAc,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,CAAkB,aAAa,CAAC,CAAC"}
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAC;AA8BhC,SAAS,SAAS,CAAI,GAAyB;IAC7C,OAAO,SAAS,iBAAiB,CAAC,KAA4D,EAAE,QAAe;QAC7G,MAAM,SAAS,GAAG,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAyB,CAAC;QAC9D,OAAO,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAsB,iBAAiB,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,GAAG,GAAG,SAAS,CAAmB,cAAc,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAoB,eAAe,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAoB,eAAe,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAqB,gBAAgB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAqB,gBAAgB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAuB,kBAAkB,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAA0B,sBAAsB,CAAC,CAAC;AACrF,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAoB,eAAe,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAqB,gBAAgB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAsB,iBAAiB,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAsB,iBAAiB,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAA0B,iBAAiB,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAuB,mBAAmB,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAC,eAAe,CAA0B,CAAC;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAqB,gBAAgB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,GAAG,GAAG,SAAS,CAAmB,cAAc,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,CAAkB,aAAa,CAAC,CAAC"}

package/dist/render.d.ts

@@ -6,5 +6,5 @@ export interface TerminalRenderContext {
 }
 export declare function renderTerminalFrame(node: TerminalNode, context?: TerminalRenderContext): TerminalFrame;
 export declare function renderTerminalNode(node: TerminalNode, context?: TerminalRenderContext): string;
-export declare function renderTerminal(input: any): string;
+export declare function renderTerminal(input: any, context?: TerminalRenderContext): string;
 //# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAiE,aAAa,EAAE,YAAY,EAA2G,aAAa,EAAuB,MAAM,YAAY,CAAC;AAE1Q,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAmjCD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,aAAa,CAKtG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAE9F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAMjD"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAiE,aAAa,EAAE,YAAY,EAA2G,aAAa,EAAuB,MAAM,YAAY,CAAC;AAE1Q,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAmpCD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,aAAa,CAKtG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAE9F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAOlF"}

package/dist/render.js

@@ -5,6 +5,22 @@ import { isFocusable, textContent } from "./tree.js";
 import { renderValyrianTerminal } from "./runtime.js";
 import { plainText } from "./text.js";
 import { resolveTerminalStyle } from "./theme.js";
+function validateRenderContextDimension(name, value) {
+    if (!Number.isInteger(value) || value < 1) {
+        throw new RangeError(`Invalid render context ${name}: expected an integer >= 1`);
+    }
+    return value;
+}
+function validateRenderContext(context) {
+    if (typeof context === "undefined") {
+        return undefined;
+    }
+    return {
+        cols: validateRenderContextDimension("cols", context.cols),
+        rows: validateRenderContextDimension("rows", context.rows),
+        theme: context.theme
+    };
+}
 const VISUAL_STATE_ORDER = [
     "disabled", "readonly", "loading", "empty", "muted", "error", "warning", "success", "invalid", "valid", "placeholder", "selection", "selected", "current", "expanded", "collapsed", "checked", "unchecked", "indeterminate", "editing", "submitted", "dragging", "dropTarget", "capturing", "focus", "hover", "pressed"
 ];
@@ -86,6 +102,18 @@ function mergeStyleDefinitions(base, next) {
 function styleSpan(kind, style) {
     return typeof style === "undefined" ? { kind } : { kind, style };
 }
+const BASE_STYLE_KIND_BY_TAG = {
+    "terminal-button": "button.base",
+    "terminal-input": "input.base",
+    "terminal-editor": "editor.base",
+    "terminal-list": "list.base",
+    "terminal-scroll": "scroll.base",
+    "terminal-log-view": "log.base",
+    "terminal-overlay": "overlay.base"
+};
+function baseStyleKindForNode(node) {
+    return BASE_STYLE_KIND_BY_TAG[node.tag];
+}
 function nodeStates(node) {
     const declared = Array.isArray(node.props.state) ? node.props.state : typeof node.props.state === "string" ? [node.props.state] : [];
     const states = new Set();
@@ -109,7 +137,7 @@ function resolveLayoutStyle(baseKind, node, context) {
     return mergeStyleDefinitions(resolveTerminalStyle(baseKind, context?.theme), resolveTerminalStyle(node.props.style, context?.theme));
 }
 function resolveNodeLayoutStyle(node, context) {
-    return resolveTerminalStyle(node.props.style, context?.theme);
+    return mergeStyleDefinitions(resolveTerminalStyle(baseStyleKindForNode(node), context?.theme), resolveTerminalStyle(node.props.style, context?.theme));
 }
 function decoratedControlFrame(content, style) {
     const padding = normalizeSpacing(style?.padding, "Control padding");
@@ -125,11 +153,18 @@ function fullFrameSpans(kinds, width, height) {
     }
     return spans;
 }
-function resolveNodeStyle(node, context) {
-    let style = resolveTerminalStyle(node.props.style, context?.theme);
-    const spanKinds = typeof node.props.style === "string"
-        ? [styleSpan(node.props.style)]
-        : style ? [styleSpan("#style", style)] : [];
+function resolveNodeStyle(node, context, options = {}) {
+    const baseKind = options.includeBase === false ? undefined : baseStyleKindForNode(node);
+    let style = resolveTerminalStyle(baseKind, context?.theme);
+    const spanKinds = typeof baseKind === "undefined" ? [] : [styleSpan(baseKind)];
+    const explicitStyle = resolveTerminalStyle(node.props.style, context?.theme);
+    if (typeof node.props.style === "string") {
+        spanKinds.push(styleSpan(node.props.style));
+    }
+    else if (explicitStyle) {
+        spanKinds.push(styleSpan("#style", explicitStyle));
+    }
+    style = mergeStyleDefinitions(style, explicitStyle);
     for (const state of nodeStates(node)) {
         const stateStyle = node.props.styles?.[state];
         if (stateStyle) {
@@ -663,17 +698,58 @@ function renderStandaloneFixedFrame(node, context) {
         ? constrainFrame(frame, { height: size })
         : constrainFrame(frame, { width: size });
 }
-function overlayGeometry(node) {
+function overlayMarginValue(value, axisSize, label) {
+    if (typeof value === "number") {
+        if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+            throw new RangeError(`${label} must be a non-negative finite integer or percentage string`);
+        }
+        return value;
+    }
+    if (typeof value === "string") {
+        const match = value.match(/^(\d+(?:\.\d+)?)%$/);
+        if (!match) {
+            throw new RangeError(`${label} must be a non-negative finite integer or percentage string`);
+        }
+        const percent = Number(match[1]);
+        if (!Number.isFinite(percent) || percent < 0) {
+            throw new RangeError(`${label} must be a non-negative finite integer or percentage string`);
+        }
+        return Math.round(axisSize * percent / 100);
+    }
+    throw new RangeError(`${label} must be a non-negative finite integer or percentage string`);
+}
+function overlayMargins(margin, width, height) {
+    if (typeof margin === "number" || typeof margin === "string") {
+        const x = overlayMarginValue(margin, width, "Overlay margin");
+        const y = overlayMarginValue(margin, height, "Overlay margin");
+        return { x, y };
+    }
+    if (margin && typeof margin === "object" && !Array.isArray(margin)) {
+        const axes = margin;
+        return {
+            x: overlayMarginValue(axes.x, width, "Overlay margin x"),
+            y: overlayMarginValue(axes.y, height, "Overlay margin y")
+        };
+    }
+    throw new RangeError("Overlay margin is required");
+}
+function overlayGeometry(node, width, height) {
+    const margin = overlayMargins(node.props.margin, width, height);
+    const overlayWidth = width - margin.x * 2;
+    const overlayHeight = height - margin.y * 2;
+    if (overlayWidth < 1 || overlayHeight < 1) {
+        throw new RangeError("Overlay margin leaves no renderable area");
+    }
     return {
-        x: positiveInteger(node.props.x, "Overlay x"),
-        y: positiveInteger(node.props.y, "Overlay y"),
-        width: positiveInteger(node.props.width, "Overlay width"),
-        height: positiveInteger(node.props.height, "Overlay height")
+        x: margin.x + 1,
+        y: margin.y + 1,
+        width: overlayWidth,
+        height: overlayHeight
     };
 }
-function renderOverlayChildFrame(node, context) {
-    const geometry = overlayGeometry(node);
-    let frame = constrainFrame(renderBodyFrame(node.children, {}, { cols: geometry.width, rows: geometry.height }), { width: geometry.width, height: geometry.height });
+function renderOverlayChildFrame(node, width, height, context) {
+    const geometry = overlayGeometry(node, width, height);
+    let frame = constrainFrame(renderBodyFrame(node.children, {}, { cols: geometry.width, rows: geometry.height, theme: context?.theme }), { width: geometry.width, height: geometry.height });
     frame = addContainerStyleSpans(frame, node, resolveNodeStyle(node, context));
     if (node.props.id && isFocusable(node)) {
         frame = addFocusableHitbox(frame, node);
@@ -682,8 +758,10 @@ function renderOverlayChildFrame(node, context) {
 }
 function applyDirectOverlays(base, overlays, context) {
     let frame = base;
+    const width = Math.max(1, getFrameWidth(base));
+    const height = Math.max(1, getFrameHeight(base));
     for (const overlay of overlays) {
-        const rendered = renderOverlayChildFrame(overlay, context);
+        const rendered = renderOverlayChildFrame(overlay, width, height, context);
         frame = overlayFrame(frame, rendered.frame, rendered.geometry);
     }
     return frame;
@@ -741,8 +819,11 @@ function renderPaneFrame(node, context) {
     }
     return overlays.length ? applyDirectOverlays(frame, overlays, context) : frame;
 }
-function renderStandaloneOverlayFrame(node) {
-    const rendered = renderOverlayChildFrame(node);
+function renderStandaloneOverlayFrame(node, context) {
+    if (!context) {
+        throw new RangeError("Standalone Overlay requires exact render context dimensions");
+    }
+    const rendered = renderOverlayChildFrame(node, context.cols, context.rows, context);
     return rendered.frame;
 }
 function renderLogViewFrame(node, context) {
@@ -882,7 +963,7 @@ function renderElementFrame(node, context) {
         case "terminal-fixed":
             return renderStandaloneFixedFrame(node, context);
         case "terminal-overlay":
-            return renderStandaloneOverlayFrame(node);
+            return renderStandaloneOverlayFrame(node, context);
         case "terminal-log-view":
             return renderLogViewFrame(node, context);
         case "terminal-list": {
@@ -917,7 +998,7 @@ function renderElementFrame(node, context) {
                 }
             }
             const frame = createFrame(decorated.lines, [], decorated.cursor, spans);
-            const styled = addFullFrameSpans(frame, resolveNodeStyle(node, context).spanKinds);
+            const styled = addFullFrameSpans(frame, resolveNodeStyle(node, context, { includeBase: false }).spanKinds);
             if (!node.props.id) {
                 return styled;
             }
@@ -938,7 +1019,7 @@ function renderElementFrame(node, context) {
         case "terminal-text": {
             const value = typeof node.props.value !== "undefined" ? plainText(node.props.value) : plainText(node.children.map(textContent).join(""));
             const frame = createFrame(value.split("\n"));
-            return addFullFrameSpans(frame, resolveNodeStyle(node, context).spanKinds);
+            return addFullFrameSpans(frame, resolveNodeStyle(node, context, { includeBase: false }).spanKinds);
         }
         case "terminal-input": {
             const value = typeof node.props.value !== "undefined" ? node.props.value : node.props.placeholder || "";
@@ -957,7 +1038,7 @@ function renderElementFrame(node, context) {
                 const height = Math.max(1, getFrameHeight(decorated));
                 const hitboxes = node.props.id ? [{ id: node.props.id, tag: node.tag, x1: 1, x2: width, y1: 1, y2: height, textStartX, textLength: stringValue.length }] : [];
                 const spans = fullFrameSpans(["input.base"], width, height);
-                return addFullFrameSpans(createFrame(decorated.lines, hitboxes, decorated.cursor, spans), resolveNodeStyle(node, context).spanKinds);
+                return addFullFrameSpans(createFrame(decorated.lines, hitboxes, decorated.cursor, spans), resolveNodeStyle(node, context, { includeBase: false }).spanKinds);
             }
             const rendered = renderInputLine(stringValue, node.props.__inputState || { cursor: stringValue.length, anchor: stringValue.length }, inputPadding);
             const decorated = addBorder(createFrame([rendered.line], [], rendered.cursor, rendered.spans), inputBorder);
@@ -965,7 +1046,7 @@ function renderElementFrame(node, context) {
             const height = Math.max(1, getFrameHeight(decorated));
             const hitboxes = node.props.id ? [{ id: node.props.id, tag: node.tag, x1: 1, x2: width, y1: 1, y2: height, textStartX, textLength: stringValue.length }] : [];
             const spans = [...fullFrameSpans(["input.base", "input.focus"], width, height), ...decorated.spans];
-            return addFullFrameSpans(createFrame(decorated.lines, hitboxes, decorated.cursor, spans), resolveNodeStyle(node, context).spanKinds);
+            return addFullFrameSpans(createFrame(decorated.lines, hitboxes, decorated.cursor, spans), resolveNodeStyle(node, context, { includeBase: false }).spanKinds);
         }
         case "terminal-editor":
             return addFullFrameSpans(renderEditorFrame(node), resolveNodeStyle(node, context).spanKinds);
@@ -978,7 +1059,7 @@ function renderElementFrame(node, context) {
             const hitboxes = node.props.id ? [{ id: node.props.id, tag: node.tag, x1: 1, x2: width, y1: 1, y2: height }] : [];
             const kinds = ["button.base", ...nodeStates(node).map((state) => `button.${state}`)];
             const spans = fullFrameSpans(kinds, width, height);
-            return addFullFrameSpans(createFrame(decorated.lines, hitboxes, decorated.cursor, spans), resolveNodeStyle(node, context).spanKinds);
+            return addFullFrameSpans(createFrame(decorated.lines, hitboxes, decorated.cursor, spans), resolveNodeStyle(node, context, { includeBase: false }).spanKinds);
         }
         default:
             return mergeVertical(node.children.map((child) => renderTerminalFrame(child, context)));
@@ -993,9 +1074,10 @@ export function renderTerminalFrame(node, context) {
 export function renderTerminalNode(node, context) {
     return renderTerminalFrame(node, context).lines.join("\n");
 }
-export function renderTerminal(input) {
+export function renderTerminal(input, context) {
+    const renderContext = validateRenderContext(context);
     return renderValyrianTerminal(input)
-        .map((node) => renderTerminalNode(node))
+        .map((node) => renderTerminalNode(node, renderContext))
         .filter(Boolean)
         .join("\n")
         .trimEnd();