@astryxdesign/native 0.0.0-bootstrap.1 → 0.7.4-canary.720bb10

package/dist/contract/rules.js

@@ -0,0 +1,87 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file contract/rules.ts
+ * @input A component contract
+ * @output Naming and portability issues under AST-082 FR4 and FR8
+ * @position Run by the generator before it writes any binding; an error stops
+ *   generation
+ */
+import { NATIVE_PLATFORMS } from '../platforms.js';
+import { KOTLIN_KEYWORDS, RECLAIMED, SWIFT_KEYWORDS, TOOLKIT_NAMES, } from './names.js';
+/** Why a core prop name is not allowed, or null when it is. */
+export function coreNameProblem(name) {
+    if (SWIFT_KEYWORDS.has(name)) {
+        return `"${name}" is a Swift keyword`;
+    }
+    if (KOTLIN_KEYWORDS.has(name)) {
+        return `"${name}" is a Kotlin keyword`;
+    }
+    if (RECLAIMED.has(name)) {
+        return null;
+    }
+    for (const [toolkit, names] of Object.entries(TOOLKIT_NAMES)) {
+        if (names.has(name)) {
+            return `"${name}" already means something else in ${toolkit}`;
+        }
+    }
+    return null;
+}
+function namedTypesIn(type, into) {
+    if (type.kind === 'named') {
+        into.add(type.name);
+    }
+    else if (type.kind === 'array') {
+        namedTypesIn(type.of, into);
+    }
+    else if (type.kind === 'fn') {
+        type.args.forEach(arg => namedTypesIn(arg, into));
+    }
+    else if (type.kind === 'record') {
+        Object.values(type.fields).forEach(field => namedTypesIn(field.type, into));
+    }
+    return into;
+}
+export function checkContract(contract) {
+    const issues = [];
+    const add = (level, rule, message) => issues.push({ level, rule, message: `${contract.name}: ${message}` });
+    const referenced = new Set();
+    const collect = (props) => Object.values(props).forEach(spec => namedTypesIn(spec.type, referenced));
+    for (const name of Object.keys(contract.core)) {
+        const problem = coreNameProblem(name);
+        if (problem) {
+            add('error', SWIFT_KEYWORDS.has(name) || KOTLIN_KEYWORDS.has(name)
+                ? 'name-keyword'
+                : 'name-toolkit', `core prop ${problem}`);
+        }
+    }
+    collect(contract.core);
+    const seen = new Map();
+    for (const platform of NATIVE_PLATFORMS) {
+        const props = contract.platforms[platform] ?? {};
+        collect(props);
+        for (const [name, spec] of Object.entries(props)) {
+            if (name in contract.core) {
+                add('error', 'platform-shadows-core', `${platform} prop "${name}" reuses a core prop name`);
+            }
+            if (SWIFT_KEYWORDS.has(name) || KOTLIN_KEYWORDS.has(name)) {
+                add('error', 'name-keyword', `${platform} prop "${name}" is a Swift or Kotlin keyword`);
+            }
+            const type = JSON.stringify(spec.type);
+            const earlier = seen.get(name);
+            if (earlier && earlier.type !== type) {
+                add('warning', 'same-name-different-meaning', `"${name}" has different values on ${earlier.platform} and ${platform}; ` +
+                    'allowed in platform-scoped types, never in a merged type');
+            }
+            if (!earlier) {
+                seen.set(name, { platform, type });
+            }
+        }
+    }
+    Object.values(contract.types).forEach(collect);
+    for (const name of referenced) {
+        if (!(name in contract.types)) {
+            add('error', 'unknown-type', `type "${name}" has no definition`);
+        }
+    }
+    return issues;
+}

package/dist/contract/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @file contract/types.ts
+ * @input None (pure type definitions)
+ * @output The contract model: portable prop types, prop specs, and component contracts
+ * @position Foundation of the contract generator; parseDocType produces these,
+ *   generators consume them
+ */
+import type { NativePlatform } from '../platforms.js';
+/** A prop type every supported platform language can express (AST-082 FR4). */
+export type PropType = {
+    kind: 'string';
+} | {
+    kind: 'number';
+} | {
+    kind: 'boolean';
+} | {
+    kind: 'enum';
+    values: readonly string[];
+} | {
+    kind: 'array';
+    of: PropType;
+} | {
+    kind: 'record';
+    fields: Readonly<Record<string, PropSpec>>;
+} | {
+    kind: 'fn';
+    args: readonly PropType[];
+} | {
+    kind: 'named';
+    name: string;
+};
+export interface PropSpec {
+    readonly type: PropType;
+    readonly optional?: boolean;
+    readonly doc?: string;
+}
+export type PropMap = Readonly<Record<string, PropSpec>>;
+/** The part of a component its base props attach to (AST-082 FR7). */
+export type BaseTarget = 'root' | 'trigger' | 'control' | 'container';
+/** A web prop left out of the core contract, with the reason. */
+export interface WebOnlyProp {
+    readonly name: string;
+    readonly reason: string;
+}
+export interface ComponentContract {
+    readonly name: string;
+    readonly baseTarget: BaseTarget;
+    /** Named record types the contract references, such as an option shape. */
+    readonly types: Readonly<Record<string, PropMap>>;
+    /** Shared on every platform that offers the component. */
+    readonly core: PropMap;
+    /** Added per native platform; never removes or renames a core prop. */
+    readonly platforms: Readonly<Partial<Record<NativePlatform, PropMap>>>;
+    /** Core-doc props that stay in the web contract. */
+    readonly webOnly: readonly WebOnlyProp[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/contract/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/contract/types.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAEpD,+EAA+E;AAC/E,MAAM,MAAM,QAAQ,GAChB;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAC,GAChB;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAC,GAChB;IAAC,IAAI,EAAE,SAAS,CAAA;CAAC,GACjB;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAC,GACzC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAC,GAC7B;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;CAAC,GAC5D;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAC,GACvC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAC;AAElC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEzD,sEAAsE;AACtE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAEtE,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACvE,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;CAC1C"}

package/dist/contract/types.js

@@ -0,0 +1,2 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+export {};

package/dist/icons/defaults.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file icons/defaults.ts
+ * @input None
+ * @output Shared icon names and each native platform's default system symbol
+ * @position Native icon defaults (AST-082 FR17, DEC-10). An icon the app or
+ *   theme defines replaces these
+ */
+import type { PlatformIcon } from '../theme/defineNativeTheme.js';
+/**
+ * Astryx's built-in icon names. Until core's portable entry carries them,
+ * a test keeps this list equal to core's `IconName` union.
+ */
+export declare const BUILTIN_ICON_NAMES: readonly ["close", "chevronDown", "chevronLeft", "chevronRight", "chevronsLeft", "chevronsRight", "check", "success", "error", "warning", "info", "calendar", "clock", "externalLink", "menu", "moreHorizontal", "search", "upload", "arrowUp", "arrowDown", "arrowsUpDown", "funnel", "eyeSlash", "viewColumns", "copy", "checkDouble", "wrench", "stop", "microphone"];
+export type BuiltinIconName = (typeof BUILTIN_ICON_NAMES)[number];
+/**
+ * Default icons per native platform. Windows has no map yet, so it is not a
+ * supported platform for icons (FR17).
+ */
+export declare const NATIVE_ICON_DEFAULTS: {
+    readonly ios: Record<"close" | "chevronDown" | "chevronLeft" | "chevronRight" | "chevronsLeft" | "chevronsRight" | "check" | "success" | "error" | "warning" | "info" | "calendar" | "clock" | "externalLink" | "menu" | "moreHorizontal" | "search" | "upload" | "arrowUp" | "arrowDown" | "arrowsUpDown" | "funnel" | "eyeSlash" | "viewColumns" | "copy" | "checkDouble" | "wrench" | "stop" | "microphone", PlatformIcon>;
+    readonly macos: Record<"close" | "chevronDown" | "chevronLeft" | "chevronRight" | "chevronsLeft" | "chevronsRight" | "check" | "success" | "error" | "warning" | "info" | "calendar" | "clock" | "externalLink" | "menu" | "moreHorizontal" | "search" | "upload" | "arrowUp" | "arrowDown" | "arrowsUpDown" | "funnel" | "eyeSlash" | "viewColumns" | "copy" | "checkDouble" | "wrench" | "stop" | "microphone", PlatformIcon>;
+    readonly android: Record<"close" | "chevronDown" | "chevronLeft" | "chevronRight" | "chevronsLeft" | "chevronsRight" | "check" | "success" | "error" | "warning" | "info" | "calendar" | "clock" | "externalLink" | "menu" | "moreHorizontal" | "search" | "upload" | "arrowUp" | "arrowDown" | "arrowsUpDown" | "funnel" | "eyeSlash" | "viewColumns" | "copy" | "checkDouble" | "wrench" | "stop" | "microphone", PlatformIcon>;
+};
+export declare const SF_SYMBOL_NAMES: Readonly<Record<BuiltinIconName, string>>;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/icons/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/icons/defaults.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,+BAA+B,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,0WA8BrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AA4ElE;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAC1D,CAAC"}

package/dist/icons/defaults.js

@@ -0,0 +1,111 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * Astryx's built-in icon names. Until core's portable entry carries them,
+ * a test keeps this list equal to core's `IconName` union.
+ */
+export const BUILTIN_ICON_NAMES = [
+    'close',
+    'chevronDown',
+    'chevronLeft',
+    'chevronRight',
+    'chevronsLeft',
+    'chevronsRight',
+    'check',
+    'success',
+    'error',
+    'warning',
+    'info',
+    'calendar',
+    'clock',
+    'externalLink',
+    'menu',
+    'moreHorizontal',
+    'search',
+    'upload',
+    'arrowUp',
+    'arrowDown',
+    'arrowsUpDown',
+    'funnel',
+    'eyeSlash',
+    'viewColumns',
+    'copy',
+    'checkDouble',
+    'wrench',
+    'stop',
+    'microphone',
+];
+/** SF Symbols, shared by iOS and macOS. */
+const SF_SYMBOLS = {
+    close: 'xmark',
+    chevronDown: 'chevron.down',
+    chevronLeft: 'chevron.left',
+    chevronRight: 'chevron.right',
+    chevronsLeft: 'chevron.left.2',
+    chevronsRight: 'chevron.right.2',
+    check: 'checkmark',
+    success: 'checkmark.circle.fill',
+    error: 'exclamationmark.circle.fill',
+    warning: 'exclamationmark.triangle.fill',
+    info: 'info.circle.fill',
+    calendar: 'calendar',
+    clock: 'clock',
+    externalLink: 'arrow.up.right.square',
+    menu: 'line.3.horizontal',
+    moreHorizontal: 'ellipsis',
+    search: 'magnifyingglass',
+    upload: 'square.and.arrow.up',
+    arrowUp: 'arrow.up',
+    arrowDown: 'arrow.down',
+    arrowsUpDown: 'arrow.up.arrow.down',
+    funnel: 'line.3.horizontal.decrease',
+    eyeSlash: 'eye.slash',
+    viewColumns: 'rectangle.split.3x1',
+    copy: 'doc.on.doc',
+    checkDouble: 'checkmark.message',
+    wrench: 'wrench.adjustable',
+    stop: 'stop.fill',
+    microphone: 'mic',
+};
+/** Material Symbols names for Android. */
+const MATERIAL_SYMBOLS = {
+    close: 'close',
+    chevronDown: 'expand_more',
+    chevronLeft: 'chevron_left',
+    chevronRight: 'chevron_right',
+    chevronsLeft: 'keyboard_double_arrow_left',
+    chevronsRight: 'keyboard_double_arrow_right',
+    check: 'check',
+    success: 'check_circle',
+    error: 'error',
+    warning: 'warning',
+    info: 'info',
+    calendar: 'calendar_today',
+    clock: 'schedule',
+    externalLink: 'open_in_new',
+    menu: 'menu',
+    moreHorizontal: 'more_horiz',
+    search: 'search',
+    upload: 'upload',
+    arrowUp: 'arrow_upward',
+    arrowDown: 'arrow_downward',
+    arrowsUpDown: 'swap_vert',
+    funnel: 'filter_alt',
+    eyeSlash: 'visibility_off',
+    viewColumns: 'view_column',
+    copy: 'content_copy',
+    checkDouble: 'done_all',
+    wrench: 'build',
+    stop: 'stop',
+    microphone: 'mic',
+};
+const mapIcons = (names, make) => Object.fromEntries(BUILTIN_ICON_NAMES.map(name => [name, make(names[name])]));
+/**
+ * Default icons per native platform. Windows has no map yet, so it is not a
+ * supported platform for icons (FR17).
+ */
+export const NATIVE_ICON_DEFAULTS = {
+    ios: mapIcons(SF_SYMBOLS, systemName => ({ systemName })),
+    macos: mapIcons(SF_SYMBOLS, systemName => ({ systemName })),
+    android: mapIcons(MATERIAL_SYMBOLS, materialSymbol => ({ materialSymbol })),
+};
+export const SF_SYMBOL_NAMES = SF_SYMBOLS;

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file index.ts
+ * @input None
+ * @output The run-time API of @astryxdesign/native: platforms, native theme
+ *   configuration, and native icon defaults
+ * @position Package root. Experimental and canary-only (AST-082 FR15); component
+ *   types live at `@astryxdesign/native/components`
+ */
+export { NATIVE_PLATFORMS, SHARED_CONDITION, isNativePlatform, } from './platforms.js';
+export type { NativePlatform } from './platforms.js';
+export { compareVersions, defineNativeTheme, resolveNativeTheme, } from './theme/defineNativeTheme.js';
+export type { DefineNativeThemeOptions, DurableMaterial, NativeTheme, NativeThemeConfig, PlatformEntry, PlatformIcon, PlatformVocabulary, PortableThemeLike, ResolvedNativeTheme, } from './theme/defineNativeTheme.js';
+export { BUILTIN_ICON_NAMES, NATIVE_ICON_DEFAULTS } from './icons/defaults.js';
+export type { BuiltinIconName } from './icons/defaults.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAC;AACnD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,wBAAwB,EACxB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAC,kBAAkB,EAAE,oBAAoB,EAAC,MAAM,qBAAqB,CAAC;AAC7E,YAAY,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file index.ts
+ * @input None
+ * @output The run-time API of @astryxdesign/native: platforms, native theme
+ *   configuration, and native icon defaults
+ * @position Package root. Experimental and canary-only (AST-082 FR15); component
+ *   types live at `@astryxdesign/native/components`
+ */
+export { NATIVE_PLATFORMS, SHARED_CONDITION, isNativePlatform, } from './platforms.js';
+export { compareVersions, defineNativeTheme, resolveNativeTheme, } from './theme/defineNativeTheme.js';
+export { BUILTIN_ICON_NAMES, NATIVE_ICON_DEFAULTS } from './icons/defaults.js';

package/dist/platforms.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file platforms.ts
+ * @input None
+ * @output The native platform names shared by contracts, types, themes, and icons
+ * @position Foundation; every other module keys platform data by these names
+ */
+/** Native platforms, in the order AST-082 lists them. */
+export declare const NATIVE_PLATFORMS: readonly ["ios", "android", "macos", "windows"];
+export type NativePlatform = (typeof NATIVE_PLATFORMS)[number];
+/** Type-resolution condition that exposes only core contracts (AST-082 FR6). */
+export declare const SHARED_CONDITION = "shared";
+export declare function isNativePlatform(value: string): value is NativePlatform;
+//# sourceMappingURL=platforms.d.ts.map

package/dist/platforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.d.ts","sourceRoot":"","sources":["../src/platforms.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,iDAAkD,CAAC;AAEhF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE"}

package/dist/platforms.js

@@ -0,0 +1,14 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file platforms.ts
+ * @input None
+ * @output The native platform names shared by contracts, types, themes, and icons
+ * @position Foundation; every other module keys platform data by these names
+ */
+/** Native platforms, in the order AST-082 lists them. */
+export const NATIVE_PLATFORMS = ['ios', 'android', 'macos', 'windows'];
+/** Type-resolution condition that exposes only core contracts (AST-082 FR6). */
+export const SHARED_CONDITION = 'shared';
+export function isNativePlatform(value) {
+    return NATIVE_PLATFORMS.includes(value);
+}

package/dist/theme/defineNativeTheme.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @file theme/defineNativeTheme.ts
+ * @input A defined theme (its portable part) and native theme configuration
+ * @output A native theme, and its resolution for one platform and OS version
+ * @position Native theme configuration (AST-082 FR10, FR18). Builds on the
+ *   defined theme without changing it and never sets tokens
+ */
+import { type NativePlatform } from '../platforms.js';
+/**
+ * The portable part of a defined theme (AST-082 FR18). A core `DefinedTheme`
+ * satisfies it structurally, so native never imports core to accept one.
+ */
+export interface PortableThemeLike {
+    readonly name: string;
+    readonly tokens: Readonly<Record<string, string>>;
+    readonly localTokens?: Readonly<Record<string, string>>;
+}
+/** Durable outcomes a person sees; no platform feature names (DEC-5). */
+export type DurableMaterial = 'opaque' | 'translucent';
+export interface PlatformVocabulary {
+    ios: {
+        material: DurableMaterial | 'liquidGlass';
+    };
+    macos: {
+        material: DurableMaterial | 'liquidGlass';
+    };
+    android: {
+        material: DurableMaterial;
+    };
+    windows: {
+        material: DurableMaterial | 'mica' | 'acrylic';
+    };
+}
+/** Platform icon reference, as data (AST-082 FR17). */
+export type PlatformIcon = {
+    readonly systemName: string;
+} | {
+    readonly materialSymbol: string;
+};
+export type PlatformEntry<P extends NativePlatform> = Partial<PlatformVocabulary[P]> & {
+    readonly minVersion?: string;
+    readonly maxVersion?: string;
+    /** Overrides for this platform's theme targets, keyed by target. */
+    readonly components?: Readonly<Record<string, Readonly<Record<string, string | number>>>>;
+    readonly icons?: Readonly<Record<string, PlatformIcon>>;
+};
+export interface NativeThemeConfig {
+    readonly material?: DurableMaterial;
+    readonly platforms?: {
+        readonly [P in NativePlatform]?: ReadonlyArray<PlatformEntry<P>>;
+    };
+}
+export interface NativeTheme {
+    readonly theme: PortableThemeLike;
+    readonly config: NativeThemeConfig;
+}
+export interface DefineNativeThemeOptions {
+    /** Native theme to extend: durable members merge, platform entry lists replace. */
+    readonly extends?: NativeTheme;
+    /** Receives each report; defaults to console.warn outside production. */
+    readonly onReport?: (message: string) => void;
+}
+export declare function compareVersions(a: string, b: string): number;
+export declare function defineNativeTheme(theme: PortableThemeLike, config: NativeThemeConfig, options?: DefineNativeThemeOptions): NativeTheme;
+export interface ResolvedNativeTheme {
+    readonly material?: string;
+    readonly components: Readonly<Record<string, Readonly<Record<string, string | number>>>>;
+    readonly icons: Readonly<Record<string, PlatformIcon>>;
+}
+/** Applies durable intent, then each matching platform entry in order. */
+export declare function resolveNativeTheme(nativeTheme: NativeTheme, target: {
+    readonly platform: NativePlatform;
+    readonly osVersion: string;
+}): ResolvedNativeTheme;
+//# sourceMappingURL=defineNativeTheme.d.ts.map

package/dist/theme/defineNativeTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineNativeTheme.d.ts","sourceRoot":"","sources":["../../src/theme/defineNativeTheme.ts"],"names":[],"mappings":"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"}

package/dist/theme/defineNativeTheme.js

@@ -0,0 +1,126 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file theme/defineNativeTheme.ts
+ * @input A defined theme (its portable part) and native theme configuration
+ * @output A native theme, and its resolution for one platform and OS version
+ * @position Native theme configuration (AST-082 FR10, FR18). Builds on the
+ *   defined theme without changing it and never sets tokens
+ */
+import { NATIVE_PLATFORMS } from '../platforms.js';
+/** Platform terms that exist only from a given OS version. */
+const FEATURE_FLOORS = {
+    ios: { liquidGlass: '26' },
+    macos: { liquidGlass: '26' },
+    windows: { mica: '11' },
+};
+/** Web-only parts of a defined theme that have no native meaning (FR18). */
+const WEB_PARTS = [
+    'components',
+    'icons',
+    'indicators',
+    '__onDark',
+    '__onLight',
+    '__adaptations',
+];
+export function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0) {
+            return diff;
+        }
+    }
+    return 0;
+}
+function hasContent(value) {
+    if (value == null) {
+        return false;
+    }
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    if (typeof value === 'object') {
+        return Object.keys(value).length > 0;
+    }
+    return true;
+}
+function validate(config) {
+    const errors = [];
+    for (const platform of NATIVE_PLATFORMS) {
+        for (const entry of config.platforms?.[platform] ?? []) {
+            const material = entry.material;
+            const floor = material ? FEATURE_FLOORS[platform]?.[material] : undefined;
+            if (floor &&
+                (entry.minVersion == null ||
+                    compareVersions(entry.minVersion, floor) < 0)) {
+                errors.push(`${platform} material "${material}" exists only from ${platform} ${floor}; ` +
+                    `scope its entry with minVersion: '${floor}' or later`);
+            }
+            if (entry.minVersion &&
+                entry.maxVersion &&
+                compareVersions(entry.minVersion, entry.maxVersion) > 0) {
+                errors.push(`${platform} entry has minVersion above maxVersion`);
+            }
+        }
+    }
+    return errors;
+}
+export function defineNativeTheme(theme, config, options = {}) {
+    const merged = options.extends
+        ? {
+            ...options.extends.config,
+            ...config,
+            platforms: { ...options.extends.config.platforms, ...config.platforms },
+        }
+        : config;
+    const errors = validate(merged);
+    if (errors.length > 0) {
+        throw new Error(`defineNativeTheme(${theme.name}): ${errors.join('; ')}`);
+    }
+    const report = options.onReport ??
+        ((message) => {
+            const env = typeof process === 'undefined' ? undefined : process.env?.NODE_ENV;
+            if (env !== 'production') {
+                console.warn(message);
+            }
+        });
+    const received = theme;
+    for (const part of WEB_PARTS) {
+        if (hasContent(received[part])) {
+            report(`defineNativeTheme(${theme.name}): "${part.replace(/^__/, '')}" is web-only and has ` +
+                'no native meaning; use native platform entries instead');
+        }
+    }
+    const portable = {
+        name: theme.name,
+        tokens: theme.tokens,
+        ...(theme.localTokens ? { localTokens: theme.localTokens } : {}),
+    };
+    return { theme: portable, config: merged };
+}
+/** Applies durable intent, then each matching platform entry in order. */
+export function resolveNativeTheme(nativeTheme, target) {
+    let resolved = {
+        ...(nativeTheme.config.material
+            ? { material: nativeTheme.config.material }
+            : {}),
+        components: {},
+        icons: {},
+    };
+    const entries = (nativeTheme.config.platforms?.[target.platform] ??
+        []);
+    for (const entry of entries) {
+        if (entry.minVersion &&
+            compareVersions(target.osVersion, entry.minVersion) < 0) {
+            continue;
+        }
+        if (entry.maxVersion &&
+            compareVersions(target.osVersion, entry.maxVersion) > 0) {
+            continue;
+        }
+        const { minVersion: _min, maxVersion: _max, ...members } = entry;
+        resolved = { ...resolved, ...members };
+    }
+    return resolved;
+}

package/dist/types/android.d.ts

@@ -0,0 +1,8 @@
+// Generated by @astryxdesign/native. Do not edit.
+import type {SelectorCoreProps} from './core.js';
+export type {AstryxSharedBaseProps, SelectorOption, SelectorCoreProps} from './core.js';
+/** Selector props: core contract plus the android contract. */
+export interface SelectorProps extends SelectorCoreProps {
+  menuStyle?: 'dropdown' | 'bottomSheet';
+}
+export declare function Selector(props: SelectorProps): unknown;

package/dist/types/core.d.ts

@@ -0,0 +1,35 @@
+// Generated by @astryxdesign/native. Do not edit.
+/** Base props shared by every platform (AST-082 FR7). */
+export interface AstryxSharedBaseProps {
+  id?: string;
+  isHidden?: boolean;
+}
+export interface SelectorOption {
+  value: string;
+  label?: string;
+  disabled?: boolean;
+}
+/** Core contract. Base props attach to the trigger. */
+export interface SelectorCoreProps extends AstryxSharedBaseProps {
+  label: string;
+  options: ReadonlyArray<SelectorOption>;
+  value?: string;
+  onChange?: (arg0: string) => void;
+  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;
+}

package/dist/types/ios.d.ts

@@ -0,0 +1,8 @@
+// Generated by @astryxdesign/native. Do not edit.
+import type {SelectorCoreProps} from './core.js';
+export type {AstryxSharedBaseProps, SelectorOption, SelectorCoreProps} from './core.js';
+/** Selector props: core contract plus the ios contract. */
+export interface SelectorProps extends SelectorCoreProps {
+  menuStyle?: 'popUp' | 'pullDown';
+}
+export declare function Selector(props: SelectorProps): unknown;

package/dist/types/macos.d.ts

@@ -0,0 +1,8 @@
+// Generated by @astryxdesign/native. Do not edit.
+import type {SelectorCoreProps} from './core.js';
+export type {AstryxSharedBaseProps, SelectorOption, SelectorCoreProps} from './core.js';
+/** Selector props: core contract plus the macos contract. */
+export interface SelectorProps extends SelectorCoreProps {
+  menuStyle?: 'popUp' | 'pullDown';
+}
+export declare function Selector(props: SelectorProps): unknown;

package/dist/types/shared.d.ts

@@ -0,0 +1,6 @@
+// Generated by @astryxdesign/native. Do not edit.
+import type {SelectorCoreProps} from './core.js';
+export type {AstryxSharedBaseProps, SelectorOption, SelectorCoreProps} from './core.js';
+/** Selector props: core contract only. */
+export interface SelectorProps extends SelectorCoreProps {}
+export declare function Selector(props: SelectorProps): unknown;

package/dist/types/windows.d.ts

@@ -0,0 +1,6 @@
+// Generated by @astryxdesign/native. Do not edit.
+import type {SelectorCoreProps} from './core.js';
+export type {AstryxSharedBaseProps, SelectorOption, SelectorCoreProps} from './core.js';
+/** Selector props: core contract plus the windows contract. */
+export interface SelectorProps extends SelectorCoreProps {}
+export declare function Selector(props: SelectorProps): unknown;