@astryxdesign/native 0.7.4-canary.720bb10 → 0.7.5-canary.04434e7

package/dist/logic/connectBridge.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @file logic/connectBridge.ts
+ * @input A logic core and the native host's two calls in
+ * @output The two calls the host makes: read the snapshot, dispatch an action
+ * @position Carries a logic core across a JavaScript engine boundary as JSON
+ *   strings, the one form every engine bridge passes cheaply
+ */
+import type { LogicAction, LogicCore, LogicNode } from './createLogicCore.js';
+/** Bumped when the bridge's calls or their JSON change meaning. */
+export declare const BRIDGE_VERSION = 1;
+/** What the native host offers the core. */
+export interface BridgeHost {
+    /**
+     * The core is running and speaks this bridge version. Called while
+     * `connectBridge` runs, before it returns the bridge: read and dispatch
+     * through the returned bridge, not from inside this call.
+     */
+    connected(bridgeVersion: number): void;
+    /** The tree changed; here it is as JSON. */
+    changed(snapshotJSON: string): void;
+}
+export interface Bridge {
+    getSnapshot(): string;
+    /** An action as the host's JSON, such as Swift's `AstryxAction.json`. */
+    dispatch(actionJSON: string): void;
+    disconnect(): void;
+}
+export declare function connectBridge<State, Node extends LogicNode, Action extends LogicAction>(core: LogicCore<State, Node, Action>, host: BridgeHost): Bridge;
+//# sourceMappingURL=connectBridge.d.ts.map

package/dist/logic/connectBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectBridge.d.ts","sourceRoot":"","sources":["../../src/logic/connectBridge.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAC,MAAM,sBAAsB,CAAC;AAE5E,mEAAmE;AACnE,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,4CAA4C;IAC5C,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,IAAI,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,IAAI,IAAI,CAAC;CACpB;AAeD,wBAAgB,aAAa,CAC3B,KAAK,EACL,IAAI,SAAS,SAAS,EACtB,MAAM,SAAS,WAAW,EAC1B,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAiBhE"}

package/dist/logic/connectBridge.js

@@ -0,0 +1,32 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+//
+// Follows the bridge of EJ Campbell's astryx-swift spike
+// (github.com/ejc3/astryx-swift, MIT).
+/** Bumped when the bridge's calls or their JSON change meaning. */
+export const BRIDGE_VERSION = 1;
+function isAction(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const action = value;
+    return (typeof action.key === 'string' &&
+        typeof action.component === 'string' &&
+        typeof action.event === 'string' &&
+        Array.isArray(action.args));
+}
+export function connectBridge(core, host) {
+    const unsubscribe = core.subscribe(() => host.changed(JSON.stringify(core.getSnapshot())));
+    host.connected(BRIDGE_VERSION);
+    return {
+        getSnapshot: () => JSON.stringify(core.getSnapshot()),
+        dispatch(actionJSON) {
+            const action = JSON.parse(actionJSON);
+            if (!isAction(action)) {
+                throw new Error(`Not an Astryx action: ${actionJSON}`);
+            }
+            // The host sends only actions for callbacks the tree listed in `events`.
+            core.dispatch(action);
+        },
+        disconnect: unsubscribe,
+    };
+}

package/dist/logic/createLogicCore.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @file logic/createLogicCore.ts
+ * @input A screen's initial state, a view of the state as a node tree, and a
+ *   reducer of actions
+ * @output A logic core: the current tree, a dispatcher, and change listeners
+ * @position Arm C of the native experiment (AST-082 FR12): component logic in
+ *   TypeScript, run by a JavaScript engine inside a native app, decides every
+ *   word, value, and state; native views draw the tree and send actions back.
+ *   Uses ECMAScript built-ins only, so it runs in Hermes, Node, and browsers
+ */
+/** The least a node has: the component it names and its identity in the tree. */
+export interface LogicNode {
+    readonly component: string;
+    readonly key: string;
+}
+/** The least an action has: the node, its component, the callback, and its arguments. */
+export interface LogicAction {
+    readonly key: string;
+    readonly component: string;
+    readonly event: string;
+    readonly args: readonly unknown[];
+}
+export interface LogicCoreOptions<State, Node extends LogicNode, Action extends LogicAction> {
+    readonly initial: State;
+    /** The whole screen for a state. Pure: the same state gives the same tree. */
+    readonly view: (state: State) => Node;
+    /** The next state after an action. Returns the same state when nothing changes. */
+    readonly reduce: (state: State, action: Action) => State;
+}
+export interface LogicCore<State, Node extends LogicNode, Action extends LogicAction> {
+    getState(): State;
+    /** The tree for the current state, built once per change. */
+    getSnapshot(): Node;
+    dispatch(action: Action): void;
+    /** Called after every change; returns the unsubscribe. */
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * Creates a logic core. Pass the platform's `AstryxNode` and `AstryxAction`
+ * types from `@astryxdesign/native/components` so a tree and an action are
+ * checked against that platform's contracts.
+ */
+export declare function createLogicCore<State, Node extends LogicNode, Action extends LogicAction>(options: LogicCoreOptions<State, Node, Action>): LogicCore<State, Node, Action>;
+//# sourceMappingURL=createLogicCore.d.ts.map

package/dist/logic/createLogicCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createLogicCore.d.ts","sourceRoot":"","sources":["../../src/logic/createLogicCore.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AAEH,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,yFAAyF;AACzF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB,CAC/B,KAAK,EACL,IAAI,SAAS,SAAS,EACtB,MAAM,SAAS,WAAW;IAE1B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACtC,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC;CAC1D;AAED,MAAM,WAAW,SAAS,CACxB,KAAK,EACL,IAAI,SAAS,SAAS,EACtB,MAAM,SAAS,WAAW;IAE1B,QAAQ,IAAI,KAAK,CAAC;IAClB,6DAA6D;IAC7D,WAAW,IAAI,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EACL,IAAI,SAAS,SAAS,EACtB,MAAM,SAAS,WAAW,EAE1B,OAAO,EAAE,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,GAC7C,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CA4BhC"}

package/dist/logic/createLogicCore.js

@@ -0,0 +1,40 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+//
+// The shape of this runtime (one state, a snapshot per change, a bridge of two
+// calls in and two out) follows EJ Campbell's astryx-swift spike
+// (github.com/ejc3/astryx-swift, MIT), whose core runs in Hermes and drives
+// SwiftUI views.
+/**
+ * Creates a logic core. Pass the platform's `AstryxNode` and `AstryxAction`
+ * types from `@astryxdesign/native/components` so a tree and an action are
+ * checked against that platform's contracts.
+ */
+export function createLogicCore(options) {
+    let state = options.initial;
+    let snapshot = null;
+    const listeners = new Set();
+    return {
+        getState: () => state,
+        getSnapshot() {
+            snapshot ??= options.view(state);
+            return snapshot;
+        },
+        dispatch(action) {
+            const next = options.reduce(state, action);
+            if (Object.is(next, state)) {
+                return;
+            }
+            state = next;
+            snapshot = null;
+            for (const listener of [...listeners]) {
+                listener();
+            }
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}

package/dist/logic/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file logic/index.ts
+ * @input None
+ * @output The logic core runtime (`@astryxdesign/native/logic`)
+ * @position Arm C entry. Portable: ECMAScript built-ins only, no Node or DOM
+ *   APIs, no clock and no randomness of its own
+ */
+export { createLogicCore } from './createLogicCore.js';
+export type { LogicAction, LogicCore, LogicCoreOptions, LogicNode, } from './createLogicCore.js';
+export { BRIDGE_VERSION, connectBridge } from './connectBridge.js';
+export type { Bridge, BridgeHost } from './connectBridge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/logic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logic/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAAC,eAAe,EAAC,MAAM,sBAAsB,CAAC;AACrD,YAAY,EACV,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAC,cAAc,EAAE,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjE,YAAY,EAAC,MAAM,EAAE,UAAU,EAAC,MAAM,oBAAoB,CAAC"}

package/dist/logic/index.js

@@ -0,0 +1,10 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file logic/index.ts
+ * @input None
+ * @output The logic core runtime (`@astryxdesign/native/logic`)
+ * @position Arm C entry. Portable: ECMAScript built-ins only, no Node or DOM
+ *   APIs, no clock and no randomness of its own
+ */
+export { createLogicCore } from './createLogicCore.js';
+export { BRIDGE_VERSION, connectBridge } from './connectBridge.js';

package/dist/types/android.d.ts

@@ -1,8 +1,142 @@
 // Generated by @astryxdesign/native. Do not edit.
-import type {SelectorCoreProps} from './core.js';
-export type {AstryxSharedBaseProps, SelectorOption, SelectorCoreProps} from './core.js';
+import type {AstryxSharedBaseProps, SelectorOption, BadgeCoreProps, ButtonCoreProps, CardCoreProps, DividerCoreProps, HeadingCoreProps, HStackCoreProps, ProgressBarCoreProps, SelectorCoreProps, SwitchCoreProps, TextCoreProps, TextInputCoreProps, VStackCoreProps} from './core.js';
+export type {AstryxSharedBaseProps, AstryxContentNode, BadgeCoreProps, ButtonCoreProps, CardCoreProps, DividerCoreProps, HeadingCoreProps, HStackCoreProps, ProgressBarCoreProps, SelectorOption, SelectorCoreProps, SwitchCoreProps, TextCoreProps, TextInputCoreProps, VStackCoreProps} from './core.js';
+/** Badge props: core contract plus the android contract. */
+export interface BadgeProps extends BadgeCoreProps {}
+export declare function Badge(props: BadgeProps): unknown;
+/** Button props: core contract plus the android contract. */
+export interface ButtonProps extends ButtonCoreProps {}
+export declare function Button(props: ButtonProps): unknown;
+/** Card props: core contract plus the android contract. */
+export interface CardProps extends CardCoreProps {}
+export declare function Card(props: CardProps): unknown;
+/** Divider props: core contract plus the android contract. */
+export interface DividerProps extends DividerCoreProps {}
+export declare function Divider(props: DividerProps): unknown;
+/** Heading props: core contract plus the android contract. */
+export interface HeadingProps extends HeadingCoreProps {}
+export declare function Heading(props: HeadingProps): unknown;
+/** HStack props: core contract plus the android contract. */
+export interface HStackProps extends HStackCoreProps {}
+export declare function HStack(props: HStackProps): unknown;
+/** ProgressBar props: core contract plus the android contract. */
+export interface ProgressBarProps extends ProgressBarCoreProps {}
+export declare function ProgressBar(props: ProgressBarProps): unknown;
 /** Selector props: core contract plus the android contract. */
 export interface SelectorProps extends SelectorCoreProps {
   menuStyle?: 'dropdown' | 'bottomSheet';
 }
 export declare function Selector(props: SelectorProps): unknown;
+/** Switch props: core contract plus the android contract. */
+export interface SwitchProps extends SwitchCoreProps {}
+export declare function Switch(props: SwitchProps): unknown;
+/** Text props: core contract plus the android contract. */
+export interface TextProps extends TextCoreProps {}
+export declare function Text(props: TextProps): unknown;
+/** TextInput props: core contract plus the android contract. */
+export interface TextInputProps extends TextInputCoreProps {}
+export declare function TextInput(props: TextInputProps): unknown;
+/** VStack props: core contract plus the android contract. */
+export interface VStackProps extends VStackCoreProps {}
+export declare function VStack(props: VStackProps): unknown;
+/** Badge as JSON from a TypeScript core. */
+export interface BadgeNode {
+  component: 'Badge';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {variant?: 'neutral' | 'info' | 'success' | 'warning' | 'error' | 'blue' | 'cyan' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'teal' | 'yellow'; label: string;};
+}
+/** Button as JSON from a TypeScript core. */
+export interface ButtonNode {
+  component: 'Button';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {label: string; variant?: 'primary' | 'secondary' | 'ghost' | 'destructive'; size?: 'sm' | 'md' | 'lg'; elevation?: 'none' | 'low' | 'med' | 'high'; isLoading?: boolean; isInterruptible?: boolean; isDisabled?: boolean; tooltip?: string; href?: string;};
+  /** The callbacks the core listens to. */
+  events?: ReadonlyArray<'onClick'>;
+}
+/** Card as JSON from a TypeScript core. */
+export interface CardNode {
+  component: 'Card';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {children?: ReadonlyArray<AstryxNode>; padding?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; variant?: 'default' | 'transparent' | 'muted' | 'blue' | 'cyan' | 'gray' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'teal' | 'yellow'; elevation?: 'none' | 'low' | 'med' | 'high';};
+}
+/** Divider as JSON from a TypeScript core. */
+export interface DividerNode {
+  component: 'Divider';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {orientation?: 'horizontal' | 'vertical'; label?: string; variant?: 'subtle' | 'strong'; isFullBleed?: boolean;};
+}
+/** Heading as JSON from a TypeScript core. */
+export interface HeadingNode {
+  component: 'Heading';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {level: 1 | 2 | 3 | 4 | 5 | 6; type?: 'display-1' | 'display-2' | 'display-3'; weight?: 'normal' | 'medium' | 'semibold' | 'bold'; children: string; accessibilityLevel?: 1 | 2 | 3 | 4 | 5 | 6; color?: 'primary' | 'secondary' | 'disabled' | 'placeholder' | 'accent' | 'inherit'; maxLines?: number; justify?: 'start' | 'center' | 'end'; hasStrikethrough?: boolean;};
+}
+/** HStack as JSON from a TypeScript core. */
+export interface HStackNode {
+  component: 'HStack';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {gap?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; padding?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingInline?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingInlineStart?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingInlineEnd?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingBlock?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingBlockStart?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingBlockEnd?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; isScrollable?: boolean; hAlign?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly'; vAlign?: 'start' | 'center' | 'end' | 'stretch'; justify?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly'; align?: 'start' | 'center' | 'end' | 'stretch'; wrap?: 'nowrap' | 'wrap' | 'wrap-reverse'; children?: ReadonlyArray<AstryxNode>;};
+}
+/** ProgressBar as JSON from a TypeScript core. */
+export interface ProgressBarNode {
+  component: 'ProgressBar';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {label: string; value?: number; max?: number; isLabelHidden?: boolean; hasValueLabel?: boolean; variant?: 'accent' | 'success' | 'warning' | 'error' | 'neutral'; isIndeterminate?: boolean; marks?: ReadonlyArray<{value: number; label: string;}>; isDisabled?: boolean;};
+}
+/** Selector as JSON from a TypeScript core. */
+export interface SelectorNode {
+  component: 'Selector';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {label: string; options: ReadonlyArray<SelectorOption>; value?: string; hasClear?: boolean; hasSearch?: boolean; searchPlaceholder?: string; placeholder?: string; size?: 'sm' | 'md' | 'lg'; variant?: 'input' | 'secondary' | 'ghost'; isDisabled?: boolean; isReadOnly?: boolean; disabledMessage?: string; isLabelHidden?: boolean; description?: string; isOptional?: boolean; isRequired?: boolean; status?: {type: 'error' | 'warning' | 'success'; message?: string;}; statusVariant?: 'attached' | 'detached' | 'tooltip'; indicatorPosition?: 'start' | 'end'; isLoading?: boolean; menuStyle?: 'dropdown' | 'bottomSheet';};
+  /** The callbacks the core listens to. */
+  events?: ReadonlyArray<'onChange'>;
+}
+/** Switch as JSON from a TypeScript core. */
+export interface SwitchNode {
+  component: 'Switch';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {label: string; value: boolean; isLoading?: boolean; isLabelHidden?: boolean; description?: string; isDisabled?: boolean; size?: 'sm' | 'md'; disabledMessage?: string; isOptional?: boolean; isRequired?: boolean; status?: {type: 'warning' | 'error' | 'success'; message?: string;}; labelTooltip?: string; labelPosition?: 'start' | 'end'; labelSpacing?: 'hug' | 'spread';};
+  /** The callbacks the core listens to. */
+  events?: ReadonlyArray<'onChange'>;
+}
+/** Text as JSON from a TypeScript core. */
+export interface TextNode {
+  component: 'Text';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {type?: 'body' | 'large' | 'label' | 'supporting' | 'code' | 'display-1' | 'display-2' | 'display-3' | 'inherit'; children: string; size?: '4xs' | '3xs' | '2xs' | 'xsm' | 'sm' | 'base' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl'; color?: 'primary' | 'secondary' | 'disabled' | 'placeholder' | 'accent' | 'inherit'; weight?: 'normal' | 'medium' | 'semibold' | 'bold'; maxLines?: number; justify?: 'start' | 'center' | 'end'; hasStrikethrough?: boolean; hasTabularNumbers?: boolean;};
+}
+/** TextInput as JSON from a TypeScript core. */
+export interface TextInputNode {
+  component: 'TextInput';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {type?: 'text' | 'password' | 'email'; label: string; value: string; size?: 'sm' | 'md' | 'lg'; isLabelHidden?: boolean; description?: string; isOptional?: boolean; isRequired?: boolean; isDisabled?: boolean; isReadOnly?: boolean; disabledMessage?: string; isLoading?: boolean; placeholder?: string; labelTooltip?: string; status?: {type: 'error' | 'warning' | 'success'; message?: string;}; statusVariant?: 'attached' | 'detached' | 'tooltip'; hasClear?: boolean; hasAutoFocus?: boolean;};
+  /** The callbacks the core listens to. */
+  events?: ReadonlyArray<'onChange' | 'onEnter'>;
+}
+/** VStack as JSON from a TypeScript core. */
+export interface VStackNode {
+  component: 'VStack';
+  key: string;
+  base?: AstryxSharedBaseProps;
+  props: {gap?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; padding?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingInline?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingInlineStart?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingInlineEnd?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingBlock?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingBlockStart?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; paddingBlockEnd?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10; isScrollable?: boolean; hAlign?: 'start' | 'center' | 'end' | 'stretch'; vAlign?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly'; justify?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly'; align?: 'start' | 'center' | 'end' | 'stretch'; wrap?: 'nowrap' | 'wrap' | 'wrap-reverse'; children?: ReadonlyArray<AstryxNode>;};
+}
+/** Any Astryx component a TypeScript core can send. */
+export type AstryxNode = BadgeNode | ButtonNode | CardNode | DividerNode | HeadingNode | HStackNode | ProgressBarNode | SelectorNode | SwitchNode | TextNode | TextInputNode | VStackNode;
+/** A callback a native view called, sent back to the core. */
+export type AstryxAction =
+  | {key: string; component: 'Button'; event: 'onClick'; args: []}
+  | {key: string; component: 'Selector'; event: 'onChange'; args: [string]}
+  | {key: string; component: 'Switch'; event: 'onChange'; args: [boolean]}
+  | {key: string; component: 'TextInput'; event: 'onChange'; args: [string]}
+  | {key: string; component: 'TextInput'; event: 'onEnter'; args: []};

package/dist/types/core.d.ts

@@ -4,11 +4,90 @@ export interface AstryxSharedBaseProps {
   id?: string;
   isHidden?: boolean;
 }
+/** One child Astryx component in a content slot (AST-082 FR4). */
+export interface AstryxContentNode {
+  readonly component: string;
+  readonly key: string;
+}
 export interface SelectorOption {
   value: string;
   label?: string;
   disabled?: boolean;
 }
+/** Core contract. Base props attach to the root. */
+export interface BadgeCoreProps extends AstryxSharedBaseProps {
+  variant?: 'neutral' | 'info' | 'success' | 'warning' | 'error' | 'blue' | 'cyan' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'teal' | 'yellow';
+  label: string;
+}
+/** Core contract. Base props attach to the root. */
+export interface ButtonCoreProps extends AstryxSharedBaseProps {
+  label: string;
+  variant?: 'primary' | 'secondary' | 'ghost' | 'destructive';
+  size?: 'sm' | 'md' | 'lg';
+  elevation?: 'none' | 'low' | 'med' | 'high';
+  isLoading?: boolean;
+  isInterruptible?: boolean;
+  isDisabled?: boolean;
+  tooltip?: string;
+  onClick?: () => void;
+  href?: string;
+}
+/** Core contract. Base props attach to the container. */
+export interface CardCoreProps extends AstryxSharedBaseProps {
+  children?: ReadonlyArray<AstryxContentNode>;
+  padding?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  variant?: 'default' | 'transparent' | 'muted' | 'blue' | 'cyan' | 'gray' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'teal' | 'yellow';
+  elevation?: 'none' | 'low' | 'med' | 'high';
+}
+/** Core contract. Base props attach to the root. */
+export interface DividerCoreProps extends AstryxSharedBaseProps {
+  orientation?: 'horizontal' | 'vertical';
+  label?: string;
+  variant?: 'subtle' | 'strong';
+  isFullBleed?: boolean;
+}
+/** Core contract. Base props attach to the root. */
+export interface HeadingCoreProps extends AstryxSharedBaseProps {
+  level: 1 | 2 | 3 | 4 | 5 | 6;
+  type?: 'display-1' | 'display-2' | 'display-3';
+  weight?: 'normal' | 'medium' | 'semibold' | 'bold';
+  children: string;
+  accessibilityLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+  color?: 'primary' | 'secondary' | 'disabled' | 'placeholder' | 'accent' | 'inherit';
+  maxLines?: number;
+  justify?: 'start' | 'center' | 'end';
+  hasStrikethrough?: boolean;
+}
+/** Core contract. Base props attach to the container. */
+export interface HStackCoreProps extends AstryxSharedBaseProps {
+  gap?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  padding?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingInline?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingInlineStart?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingInlineEnd?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingBlock?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingBlockStart?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingBlockEnd?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  isScrollable?: boolean;
+  hAlign?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+  vAlign?: 'start' | 'center' | 'end' | 'stretch';
+  justify?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+  align?: 'start' | 'center' | 'end' | 'stretch';
+  wrap?: 'nowrap' | 'wrap' | 'wrap-reverse';
+  children?: ReadonlyArray<AstryxContentNode>;
+}
+/** Core contract. Base props attach to the root. */
+export interface ProgressBarCoreProps extends AstryxSharedBaseProps {
+  label: string;
+  value?: number;
+  max?: number;
+  isLabelHidden?: boolean;
+  hasValueLabel?: boolean;
+  variant?: 'accent' | 'success' | 'warning' | 'error' | 'neutral';
+  isIndeterminate?: boolean;
+  marks?: ReadonlyArray<{value: number; label: string;}>;
+  isDisabled?: boolean;
+}
 /** Core contract. Base props attach to the trigger. */
 export interface SelectorCoreProps extends AstryxSharedBaseProps {
   label: string;
@@ -33,3 +112,74 @@ export interface SelectorCoreProps extends AstryxSharedBaseProps {
   indicatorPosition?: 'start' | 'end';
   isLoading?: boolean;
 }
+/** Core contract. Base props attach to the root. */
+export interface SwitchCoreProps extends AstryxSharedBaseProps {
+  label: string;
+  value: boolean;
+  onChange?: (arg0: boolean) => void;
+  isLoading?: boolean;
+  isLabelHidden?: boolean;
+  description?: string;
+  isDisabled?: boolean;
+  size?: 'sm' | 'md';
+  disabledMessage?: string;
+  isOptional?: boolean;
+  isRequired?: boolean;
+  status?: {type: 'warning' | 'error' | 'success'; message?: string;};
+  labelTooltip?: string;
+  labelPosition?: 'start' | 'end';
+  labelSpacing?: 'hug' | 'spread';
+}
+/** Core contract. Base props attach to the root. */
+export interface TextCoreProps extends AstryxSharedBaseProps {
+  type?: 'body' | 'large' | 'label' | 'supporting' | 'code' | 'display-1' | 'display-2' | 'display-3' | 'inherit';
+  children: string;
+  size?: '4xs' | '3xs' | '2xs' | 'xsm' | 'sm' | 'base' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl';
+  color?: 'primary' | 'secondary' | 'disabled' | 'placeholder' | 'accent' | 'inherit';
+  weight?: 'normal' | 'medium' | 'semibold' | 'bold';
+  maxLines?: number;
+  justify?: 'start' | 'center' | 'end';
+  hasStrikethrough?: boolean;
+  hasTabularNumbers?: boolean;
+}
+/** Core contract. Base props attach to the control. */
+export interface TextInputCoreProps extends AstryxSharedBaseProps {
+  type?: 'text' | 'password' | 'email';
+  label: string;
+  value: string;
+  onChange?: (arg0: string) => void;
+  size?: 'sm' | 'md' | 'lg';
+  isLabelHidden?: boolean;
+  description?: string;
+  isOptional?: boolean;
+  isRequired?: boolean;
+  onEnter?: () => void;
+  isDisabled?: boolean;
+  isReadOnly?: boolean;
+  disabledMessage?: string;
+  isLoading?: boolean;
+  placeholder?: string;
+  labelTooltip?: string;
+  status?: {type: 'error' | 'warning' | 'success'; message?: string;};
+  statusVariant?: 'attached' | 'detached' | 'tooltip';
+  hasClear?: boolean;
+  hasAutoFocus?: boolean;
+}
+/** Core contract. Base props attach to the container. */
+export interface VStackCoreProps extends AstryxSharedBaseProps {
+  gap?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  padding?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingInline?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingInlineStart?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingInlineEnd?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingBlock?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingBlockStart?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  paddingBlockEnd?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10;
+  isScrollable?: boolean;
+  hAlign?: 'start' | 'center' | 'end' | 'stretch';
+  vAlign?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+  justify?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+  align?: 'start' | 'center' | 'end' | 'stretch';
+  wrap?: 'nowrap' | 'wrap' | 'wrap-reverse';
+  children?: ReadonlyArray<AstryxContentNode>;
+}