@triniwiz/nativescript-masonkit 1.0.0-beta.7 → 1.0.0-beta.71

package/common.d.ts

@@ -1,84 +1,120 @@
-import { AddChildFromBuilder, CssProperty, CustomLayoutView, ShorthandProperty, Style, View as NSView, ViewBase as NSViewBase, Property, CoreTypes } from '@nativescript/core';
-import { AlignContent, AlignSelf, Display, Gap, GridAutoFlow, Length, LengthAuto, Overflow, Position, AlignItems, BoxSizing, VerticalAlign } from '.';
-export declare const native_: unique symbol;
-export declare const style_: unique symbol;
-export declare const isTextChild_: unique symbol;
-export declare const isText_: unique symbol;
-export declare const isMasonView_: unique symbol;
-export declare const text_: unique symbol;
-export declare const isPlaceholder_: unique symbol;
+import { AddChildFromBuilder, CustomLayoutView, View as NSView, ViewBase as NSViewBase, Property, CoreTypes } from '@nativescript/core';
+import { Display, Gap, GridAutoFlow, JustifyItems, JustifySelf, Length, LengthAuto, Overflow, Position, BoxSizing, VerticalAlign, FlexDirection, Float, Clear } from '.';
+import { Style } from './style';
+import { isMasonView_, isTextChild_, isText_, native_, pseudoStyles_ } from './symbols';
+import { TextNode } from './text-node';
 export interface MasonChild extends ViewBase {
 }
-export declare const scrollBarWidthProperty: CssProperty<Style, number>;
-export declare const overflowProperty: ShorthandProperty<Style, Overflow>;
-export declare const overflowXProperty: CssProperty<Style, Overflow>;
-export declare const overflowYProperty: CssProperty<Style, Overflow>;
-export declare const paddingLeftProperty: CssProperty<Style, CoreTypes.LengthType>;
-export declare const paddingRightProperty: CssProperty<Style, CoreTypes.LengthType>;
-export declare const paddingTopProperty: CssProperty<Style, CoreTypes.LengthType>;
-export declare const paddingBottomProperty: CssProperty<Style, CoreTypes.LengthType>;
-export declare const rowGapProperty: CssProperty<Style, Length>;
-export declare const columnGapProperty: CssProperty<Style, Length>;
-export declare const gridGapProperty: ShorthandProperty<Style, any>;
-export declare const gapProperty: ShorthandProperty<Style, any>;
-export declare const flexShrinkProperty: CssProperty<Style, number>;
-export declare const displayProperty: CssProperty<Style, Display>;
-export declare const maxWidthProperty: CssProperty<Style, LengthAuto>;
-export declare const maxHeightProperty: CssProperty<Style, LengthAuto>;
-export declare const positionProperty: CssProperty<Style, Position>;
-export declare const leftProperty: CssProperty<Style, LengthAuto>;
-export declare const rightProperty: CssProperty<Style, LengthAuto>;
-export declare const topProperty: CssProperty<Style, LengthAuto>;
-export declare const bottomProperty: CssProperty<Style, LengthAuto>;
-export declare const flexBasisProperty: CssProperty<Style, LengthAuto>;
-export declare const gridRowGapProperty: ShorthandProperty<Style, any>;
-export declare const gridColumnGapProperty: ShorthandProperty<Style, Length>;
-export declare const aspectRatioProperty: CssProperty<Style, number>;
-export declare const alignItemsProperty: CssProperty<Style, AlignItems>;
-export declare const alignSelfProperty: CssProperty<Style, AlignSelf>;
-export declare const alignContentProperty: CssProperty<Style, AlignContent>;
-export declare const justifyItemsProperty: CssProperty<Style, AlignItems>;
-export declare const justifySelfProperty: CssProperty<Style, AlignSelf>;
-export declare const justifyContentProperty: CssProperty<Style, AlignContent>;
-export declare const gridAutoRowsProperty: CssProperty<Style, string>;
-export declare const gridAutoColumnsProperty: CssProperty<Style, string>;
-export declare const gridAutoFlowProperty: CssProperty<Style, GridAutoFlow>;
-export declare const gridAreaProperty: CssProperty<Style, string>;
-export declare const gridColumnStartProperty: CssProperty<Style, string>;
-export declare const gridColumnEndProperty: CssProperty<Style, string>;
-export declare const gridColumnProperty: CssProperty<Style, string>;
-export declare const gridRowStartProperty: CssProperty<Style, string>;
-export declare const gridRowEndProperty: CssProperty<Style, string>;
-export declare const gridRowProperty: CssProperty<Style, string>;
-export declare const gridTemplateAreasProperty: CssProperty<Style, string>;
-export declare const gridTemplateRowsProperty: CssProperty<Style, string>;
-export declare const gridTemplateColumnsProperty: CssProperty<Style, string>;
-export declare const textWrapProperty: CssProperty<Style, "nowrap" | "wrap" | "balance">;
-export declare const textOverFlowProperty: CssProperty<Style, string>;
-export declare const textContentProperty: Property<TextBase, string>;
-export declare const boxSizingProperty: CssProperty<Style, BoxSizing>;
-export declare const verticalAlignProperty: CssProperty<Style, VerticalAlign>;
+export declare const textContentProperty: Property<ViewBase, string>;
+declare module '@nativescript/core/ui/styling/style' {
+    interface Style {
+        filter: string;
+        border: string;
+        boxSizing: BoxSizing;
+        display: Display;
+        position: Position;
+        flexDirection: FlexDirection;
+        flex: string | 'auto' | 'none' | number | 'initial';
+        maxWidth: LengthAuto;
+        maxHeight: LengthAuto;
+        inset: LengthAuto;
+        left: LengthAuto;
+        right: LengthAuto;
+        top: LengthAuto;
+        bottom: LengthAuto;
+        gridGap: Gap;
+        gap: Gap;
+        rowGap: Length;
+        columnGap: Length;
+        aspectRatio: number;
+        flexFlow: string;
+        justifyItems: JustifyItems;
+        justifySelf: JustifySelf;
+        gridAutoRows: string;
+        gridAutoColumns: string;
+        gridAutoFlow: GridAutoFlow;
+        gridRowGap: Gap;
+        gridColumnGap: Gap;
+        gridArea: string;
+        gridColumn: string;
+        gridColumnStart: string;
+        gridColumnEnd: string;
+        gridRow: string;
+        gridRowStart: string;
+        gridRowEnd: string;
+        gridTemplateRows: string;
+        gridTemplateColumns: string;
+        gridTemplateAreas: string;
+        overflow: Overflow | `${Overflow} ${Overflow}`;
+        overflowX: Overflow;
+        overflowY: Overflow;
+        scrollBarWidth: Length;
+        verticalAlign: VerticalAlign;
+        textWrap: 'nowrap' | 'wrap' | 'balance';
+        textOverFlow: 'clip' | 'ellipsis' | `${string}`;
+        float: Float;
+        clear: Clear;
+        cornerShape: string;
+        transform: string;
+    }
+}
 export declare class ViewBase extends CustomLayoutView implements AddChildFromBuilder {
-    readonly android: org.nativescript.mason.masonkit.View;
-    readonly ios: MasonUIView;
-    textWrap: 'nowrap' | 'wrap' | 'balance';
-    overflow: Overflow | `${Overflow} ${Overflow}`;
-    gridGap: Gap;
-    gap: Gap;
-    gridArea: string;
-    gridColumn: string;
-    gridRow: string;
-    inset: LengthAuto;
-    padding: Length;
-    margin: LengthAuto;
-    border: Length;
     _children: (NSView | {
         text?: string;
-    })[];
+    } | TextNode)[];
     [isMasonView_]: boolean;
+    /**
+     * Enable or disable CSS Preflight (web-normalised / Tailwind-like) defaults
+     * for the entire Mason tree.
+     *
+     * When `true` every element starts from a clean, browser-normalised slate:
+     *  - `box-sizing: border-box`
+     *  - `margin: 0`, `padding: 0`, `border-width: 0`
+     *  - `background: transparent`
+     *  - `list-style: none` on `<ul>` / `<ol>`
+     *  - `display: block` on `<img>` (replaced elements)
+     *
+     * This is a **tree-global** flag; it should ideally be set **before** views are
+     * created so that all new nodes inherit the preflight baseline.  Changing it
+     * after views have been created re-seeds the arena defaults but does not
+     * retroactively restyle individually modified nodes.
+     *
+     * @example
+     * ```ts
+     * import { ViewBase } from '@triniwiz/nativescript-masonkit';
+     * ViewBase.preflight = true; // enable at app startup
+     * ```
+     */
+    static get preflight(): boolean;
+    static set preflight(value: boolean);
     [isTextChild_]: boolean;
     [isText_]: boolean;
+    [pseudoStyles_]: {
+        active?: Style;
+        focus?: Style;
+        blur?: Style;
+        hover?: Style;
+        disabled?: Style;
+    };
     constructor();
+    get innerHTML(): string;
+    set innerHTML(value: string);
+    _pendingEventsRegistration: Array<{
+        arg: string;
+        callback: any;
+        thisArg?: any;
+    }>;
+    _registerNativeEvent(arg: string, callback: any, thisArg?: any): void;
+    _unregisterNativeEvent(arg: string, callback: any, thisArg?: any): void;
+    initNativeView(): void;
+    _setNativeViewFrame(nativeView: any, frame: CGRect): void;
+    addEventListener(arg: string, callback: any, thisArg?: any): void;
+    removeEventListener(arg: string, callback: any, thisArg?: any): void;
+    private _applyPseudoClassStyles;
+    _handler(subscribe: boolean): void;
+    _disableHandler(subscribe: boolean): void;
+    _focusHandler(subscribe: boolean): void;
+    _blurHandler(subscribe: boolean): void;
     forceStyleUpdate(): void;
     get _viewChildren(): NSView[];
     eachLayoutChild(callback: (child: NSView, isLast: boolean) => void): void;
@@ -91,15 +127,54 @@ export declare class ViewBase extends CustomLayoutView implements AddChildFromBu
     getChildIndex(child: NSView): number;
     getChildById(id: string): NSViewBase;
     addChild(child: any): void;
+    insertBefore(child: any, reference: any): void;
+    private _nativeIndexFor;
     insertChild(child: any, atIndex: number): void;
     replaceChild(child: any, atIndex: number): void;
     removeChild(child: any): void;
+    private _nativeRemoveChildNode;
     removeChildren(): void;
-    set text(value: string);
+    set verticalAlign(value: VerticalAlign);
+    get verticalAlign(): VerticalAlign;
+    set flex(value: import("@nativescript/core").Flex);
+    get flex(): import("@nativescript/core").Flex;
+    set textWrap(value: "nowrap" | "wrap" | "balance");
+    get textWrap(): "nowrap" | "wrap" | "balance";
+    set aspectRatio(value: number);
+    get aspectRatio(): number;
+    private _createOrUpdateNativeTextNode;
+    /**
+     * Bind a framework text node directly to its backing native `MasonTextNode`.
+     *
+     * Once mason adopts a text node (any framework — dominative/undom, Vue, React,
+     * Angular) we redefine its `data` accessor so future in-place writes
+     * (`node.data = …`, `node.nodeValue = …`, `node.textContent = …`, all of which
+     * funnel through `data` on a CharacterData node) flow straight through to the
+     * native node and trigger a relayout. The original accessor is still invoked so
+     * the framework's own bookkeeping (undom's `__undom_data`, change callbacks)
+     * stays intact. This is the framework-agnostic counterpart to the structural
+     * reconcile in `textProperty.setNative` — structure is handled there, granular
+     * text edits are handled here, with no per-framework glue.
+     */
+    private _installTextNodeProxy;
+    private _nativeAddChild;
+    private _nativeReplaceChild;
+    private _setOrPushChild;
+    private _updateTextNode;
+    get filter(): string;
+    set filter(value: string);
+    set borderRadius(value: string | number | CoreTypes.LengthDipUnit | CoreTypes.LengthPxUnit);
+    get borderRadius(): string | number | CoreTypes.LengthDipUnit | CoreTypes.LengthPxUnit;
+    set border(value: string);
+    get border(): string;
+    set background(value: string);
+    get background(): string;
     get boxSizing(): BoxSizing;
     set boxSizing(value: BoxSizing);
     get display(): Display;
     set display(value: Display);
+    get overflow(): Overflow | "visible visible" | "visible hidden" | "visible scroll" | "visible clip" | "visible auto" | "hidden visible" | "hidden hidden" | "hidden scroll" | "hidden clip" | "hidden auto" | "scroll visible" | "scroll hidden" | "scroll scroll" | "scroll clip" | "scroll auto" | "clip visible" | "clip hidden" | "clip scroll" | "clip clip" | "clip auto" | "auto visible" | "auto hidden" | "auto scroll" | "auto clip" | "auto auto";
+    set overflow(value: Overflow | "visible visible" | "visible hidden" | "visible scroll" | "visible clip" | "visible auto" | "hidden visible" | "hidden hidden" | "hidden scroll" | "hidden clip" | "hidden auto" | "scroll visible" | "scroll hidden" | "scroll scroll" | "scroll clip" | "scroll auto" | "clip visible" | "clip hidden" | "clip scroll" | "clip clip" | "clip auto" | "auto visible" | "auto hidden" | "auto scroll" | "auto clip" | "auto auto");
     get overflowX(): Overflow;
     set overflowX(value: Overflow);
     get overflowY(): Overflow;
@@ -108,11 +183,27 @@ export declare class ViewBase extends CustomLayoutView implements AddChildFromBu
     set scrollBarWidth(value: Length);
     get position(): Position;
     set position(value: Position);
+    get alignContent(): import("@nativescript/core").AlignContent;
+    set alignContent(value: import("@nativescript/core").AlignContent);
+    get justifyItems(): import(".").AlignItems;
+    set justifyItems(value: import(".").AlignItems);
+    get justifySelf(): import(".").AlignSelf;
+    set justifySelf(value: import(".").AlignSelf);
+    get right(): LengthAuto;
+    set right(value: LengthAuto);
+    get bottom(): LengthAuto;
+    set bottom(value: LengthAuto);
     set maxWidth(value: LengthAuto);
     get maxWidth(): LengthAuto;
     set maxHeight(value: LengthAuto);
     get maxHeight(): LengthAuto;
     _redrawNativeBackground(value: any): void;
+    get padding(): string | number | CoreTypes.LengthDipUnit | CoreTypes.LengthPxUnit;
+    set padding(value: string | number | CoreTypes.LengthDipUnit | CoreTypes.LengthPxUnit);
+    set gap(value: Length);
+    get gap(): Length;
+    set gridGap(value: Length);
+    get gridGap(): Length;
     set rowGap(value: Length);
     get rowGap(): Length;
     set columnGap(value: Length);
@@ -121,10 +212,14 @@ export declare class ViewBase extends CustomLayoutView implements AddChildFromBu
     get gridColumnStart(): string;
     set gridColumnEnd(value: string);
     get gridColumnEnd(): string;
+    get gridColumn(): string;
+    set gridColumn(value: string);
     set gridRowStart(value: string);
     get gridRowStart(): string;
     set gridRowEnd(value: string);
     get gridRowEnd(): string;
+    get gridRow(): string;
+    set gridRow(value: string);
     set gridTemplateRows(value: string);
     get gridTemplateRows(): string;
     set gridTemplateColumns(value: string);
@@ -133,6 +228,18 @@ export declare class ViewBase extends CustomLayoutView implements AddChildFromBu
     get gridAutoColumns(): string;
     set gridAutoRows(value: string);
     get gridAutoRows(): string;
+    set gridAutoFlow(value: GridAutoFlow);
+    get gridAutoFlow(): GridAutoFlow;
+    set gridArea(value: string);
+    get gridArea(): string;
+    set gridTemplateAreas(value: string);
+    get gridTemplateAreas(): string;
+    set flexFlowProperty(value: "row nowrap" | "row wrap" | "row wrap-reverse" | "row-reverse nowrap" | "row-reverse wrap" | "row-reverse wrap-reverse" | "column nowrap" | "column wrap" | "column wrap-reverse" | "column-reverse nowrap" | "column-reverse wrap" | "column-reverse wrap-reverse");
+    get flexFlowProperty(): "row nowrap" | "row wrap" | "row wrap-reverse" | "row-reverse nowrap" | "row-reverse wrap" | "row-reverse wrap-reverse" | "column nowrap" | "column wrap" | "column wrap-reverse" | "column-reverse nowrap" | "column-reverse wrap" | "column-reverse wrap-reverse";
+    set inset(value: LengthAuto);
+    get inset(): LengthAuto;
+    set textOverFlow(value: string);
+    get textOverFlow(): string;
 }
 export declare class TextBase extends ViewBase {
     textContent: string;
@@ -143,3 +250,30 @@ export declare const srcProperty: Property<ImageBase, string>;
 export declare class ImageBase extends ViewBase {
     src: string;
 }
+export declare class Event {
+    [native_]: any;
+    get bubbles(): boolean;
+    get cancelable(): boolean;
+    get isComposing(): any;
+    get timeStamp(): number;
+    get defaultPrevented(): boolean;
+    get propagationStopped(): any;
+    get immediatePropagationStopped(): any;
+    get currentTarget(): any;
+    stopImmediatePropagation(): void;
+    stopPropagation(): void;
+    preventDefault(): void;
+    get type(): string;
+    set type(_: string);
+    get target(): any;
+    set target(_: any);
+    set currentTarget(_: any);
+    set bubbles(_: boolean);
+    set cancelable(_: boolean);
+    set timeStamp(_: number);
+    set defaultPrevented(_: boolean);
+}
+export declare class InputEvent extends Event {
+    get data(): any;
+    get inputType(): any;
+}