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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Meta Platforms, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,121 @@
 # @astryxdesign/native
 
-This is a `0.0.0-bootstrap.1` placeholder published only to claim the npm name while configuring npm trusted publishing. Do not install it; it will be superseded by the first real release.
+> **Experimental. Canary only.** This package is published only under the
+> `@canary` dist-tag and is never released as a stable version. Its APIs change
+> without notice. Nothing here is supported for production apps.
+
+`@astryxdesign/native` is where Astryx experiments with native platforms
+(iOS, Android, macOS, Windows) under AST-082 (Native-first surfaces). The
+experiment compares ways of building Astryx components on each platform and
+measures them against the same scorecard, so the decision for each platform
+rests on evidence.
+
+## What is here today
+
+| Part           | Path                              | What it does                                                                                                                                                                                                                                 |
+| -------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Contracts      | `src/contract/`                   | Reads a core component's documentation and splits its props into a portable **core contract** and a **web-only** part, with a reason for each web-only prop. Checks prop names against Swift and Kotlin keywords and platform toolkit names. |
+| Platform types | `@astryxdesign/native/components` | TypeScript props per platform, chosen by type-resolution condition: `ios`, `android`, `macos`, `windows`, or `shared` for the core contract only.                                                                                            |
+| Swift binding  | `apple/`                          | A Swift package with props generated from the same contracts. iOS and macOS props sit behind `#if os(...)`.                                                                                                                                  |
+| Native theme   | `defineNativeTheme`               | Durable theme intent (`material: 'opaque' \| 'translucent'`) plus platform entries scoped by OS version, such as Liquid Glass from iOS 26. Never sets tokens.                                                                                |
+| Icons          | `NATIVE_ICON_DEFAULTS`            | Astryx's built-in icon names mapped to SF Symbols on Apple platforms and Material Symbols on Android.                                                                                                                                        |
+
+Only `Selector` has native additions so far. React Native and Android bindings
+are not built yet; see [the experiment matrix](#experiment-matrix).
+
+```ts
+// tsconfig.json for an iOS app: "customConditions": ["ios"]
+import type {SelectorProps} from '@astryxdesign/native/components';
+
+const props: SelectorProps = {
+  label: 'Shipping',
+  options: [{value: 'standard', label: 'Standard'}],
+  menuStyle: 'pullDown', // iOS-only prop; an Android build rejects it
+};
+```
+
+## Working on it
+
+```sh
+pnpm -F @astryxdesign/native build            # dist/, including platform types
+pnpm -F @astryxdesign/native generate:apple   # regenerate apple/Sources/.../Generated
+pnpm vitest run --project node packages/native
+```
+
+Generated Swift is committed so a Swift package can pin a commit. A test fails
+when it drifts from the contracts.
+
+Boundaries, checked by `pnpm check:package-boundaries`:
+
+- `@astryxdesign/core` never imports this package.
+- This package's source never imports core. It reads core's documentation
+  files as data at build time.
+
+## Experiment matrix
+
+Every arm runs the same subjects on the same devices and is scored against a
+**reference**: the same screens hand-built with the platform toolkit (SwiftUI,
+Jetpack Compose, WinUI).
+
+| Arm                       | How components are built                                                                 | iOS | Android | macOS | Windows |
+| ------------------------- | ---------------------------------------------------------------------------------------- | --- | ------- | ----- | ------- |
+| A. Pure native            | Platform views (SwiftUI, Compose, WinUI) on generated contracts                          | ✓   | ✓       | ✓     | ✓       |
+| B. React Native           | React Native components; desktop through `react-native-macos` and `react-native-windows` | ✓   | ✓       | ✓     | ✓       |
+| C. Shared logic core      | Component logic in TypeScript running in Hermes, driving platform views                  | ✓   | ✓       | ✓     | —       |
+| D. Web on native          | Web React components through a native renderer, such as Expo's experimental fork         | ✓   | ✓       | —     | —       |
+| E. Web in a desktop shell | Astryx's web components unchanged inside Electron                                        | —   | —       | ✓     | ✓       |
+
+Arms D and E are measured but cannot become required runtimes as written:
+arm D depends on a third-party fork and arm E on Electron, a third-party
+runtime (AST-082 FR13). Arm E is the baseline for how far plain web gets on
+desktop.
+
+### Test subjects
+
+Templates come first because their web version is a known reference for
+content and states.
+
+1. **Wave 1:** `checkout-wizard` (forms, stepper, pickers, validation, keyboard),
+   `table-inbox` (long list, row actions, search, compose sheet), `dashboard`
+   (charts, tables, scrolling).
+2. **Wave 2:** `settings`, `kanban-board`, `ai-chat`, `product-detail`.
+3. **Component flows:** Selector, text entry, dialog and sheet, list with row
+   actions.
+
+Each subject has one scripted interaction that every arm replays.
+
+Visual scores come from real screens. Every scripted step is captured as a
+screenshot on the device, every behavior (sheet open and dismiss, navigation
+transitions, gestures, scrolling, press feedback, keyboard) as a short video or
+GIF, and every scenario as a recording, for each arm, the
+reference, and the web version, in light and dark and at the largest text size.
+Reviewers compare captures side by side with arm names hidden, and pixel checks
+read colors and sizes from the captures, never from source.
+
+### Metrics
+
+| Area            | Measure                        | How                                                                                                                                                                                                           | Unit                  |
+| --------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
+| Gate            | Required runtimes              | Dependency manifest against FR13                                                                                                                                                                              | pass/fail             |
+| Gate            | Screen-reader parity           | VoiceOver, TalkBack, Narrator task script                                                                                                                                                                     | pass/fail             |
+| Gate            | Completeness                   | Every subject renders every state                                                                                                                                                                             | pass/fail             |
+| Experience      | Platform feel                  | Blind reviewer rating of captured screens and recordings against the reference, plus a platform-conventions checklist                                                                                         | score, % of checklist |
+| Experience      | Behavior and motion            | Blind reviewer rating of behavior videos against the reference: timing, easing, gesture response, interruptibility                                                                                            | score per behavior    |
+| Experience      | Time to adopt a new OS feature | Days from OS release to shipping it in the arm (for example, Liquid Glass)                                                                                                                                    | days                  |
+| Performance     | Startup to first content       | Release build, cold start, median of runs                                                                                                                                                                     | ms                    |
+| Performance     | Smoothness                     | Dropped frames during the scripted interaction                                                                                                                                                                | % frames              |
+| Performance     | Input latency                  | Touch or key to visible response                                                                                                                                                                              | ms                    |
+| Performance     | Memory and size                | Peak memory during the script; app download size                                                                                                                                                              | MB                    |
+| Maintenance     | Change cost                    | Time to ship one real Astryx change on the arm (a new prop, a new token)                                                                                                                                      | hours                 |
+| Developer speed | Iteration                      | Edit to visible on device                                                                                                                                                                                     | seconds               |
+| Developer speed | Sharing                        | Share of app code reused across platforms                                                                                                                                                                     | % lines               |
+| Design          | Brand preservation             | Blind designer review of whether the brand is recognizable from the web version while the screen still feels native, plus pixel checks on the captures for the theme's color, type, shape, spacing, and icons | score, % token checks |
+| Fidelity        | Match to web                   | Content and states matching the web template                                                                                                                                                                  | % checks              |
+
+### Judging
+
+1. An arm that fails a gate is out for that platform.
+2. The remaining arms are compared per platform, each measure relative to the
+   reference on the same device.
+3. Whether the measures are weighted into one score or ranked side by side is
+   not decided yet.

package/apple/Package.swift

@@ -0,0 +1,18 @@
+// swift-tools-version: 6.0
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+// Experimental Astryx for Apple platforms (AST-082). The contract types under
+// Sources/AstryxNative/Generated are generated by `pnpm generate:apple`; do not
+// edit them by hand.
+
+import PackageDescription
+
+let package = Package(
+  name: "AstryxNative",
+  platforms: [.iOS(.v17), .macOS(.v14)],
+  products: [.library(name: "AstryxNative", targets: ["AstryxNative"])],
+  targets: [
+    .target(name: "AstryxNative", path: "Sources/AstryxNative"),
+    .testTarget(name: "AstryxNativeTests", dependencies: ["AstryxNative"], path: "Tests/AstryxNativeTests"),
+  ]
+)

package/apple/Sources/AstryxNative/Generated/AstryxBase.swift

@@ -0,0 +1,12 @@
+// Generated by @astryxdesign/native. Do not edit.
+public enum AstryxBaseTarget: String, Sendable { case root, trigger, control, container }
+
+/// Base props shared by every platform (AST-082 FR7).
+public struct AstryxBaseProps: Equatable, Sendable {
+  public var id: String?
+  public var isHidden: Bool?
+  public init(id: String? = nil, isHidden: Bool? = nil) {
+    self.id = id
+    self.isHidden = isHidden
+  }
+}

package/apple/Sources/AstryxNative/Generated/Selector.swift

@@ -0,0 +1,159 @@
+// Generated by @astryxdesign/native. Do not edit.
+public struct SelectorOption: Equatable, Sendable {
+  public var value: String
+  public var label: String?
+  public var disabled: Bool?
+  public init(value: String, label: String? = nil, disabled: Bool? = nil) {
+    self.value = value
+    self.label = label
+    self.disabled = disabled
+  }
+}
+public enum SelectorSize: String, CaseIterable, Sendable {
+  case sm = "sm"
+  case md = "md"
+  case lg = "lg"
+}
+public enum SelectorVariant: String, CaseIterable, Sendable {
+  case input = "input"
+  case secondary = "secondary"
+  case ghost = "ghost"
+}
+public enum SelectorStatusType: String, CaseIterable, Sendable {
+  case error = "error"
+  case warning = "warning"
+  case success = "success"
+}
+public struct SelectorStatus: Equatable, Sendable {
+  public var type: SelectorStatusType
+  public var message: String?
+  public init(type: SelectorStatusType, message: String? = nil) {
+    self.type = type
+    self.message = message
+  }
+}
+public enum SelectorStatusVariant: String, CaseIterable, Sendable {
+  case attached = "attached"
+  case detached = "detached"
+  case tooltip = "tooltip"
+}
+public enum SelectorIndicatorPosition: String, CaseIterable, Sendable {
+  case start = "start"
+  case end = "end"
+}
+#if os(iOS)
+public enum SelectorMenuStyle: String, CaseIterable, Sendable {
+  case popUp = "popUp"
+  case pullDown = "pullDown"
+}
+public struct SelectorProps {
+  /// Base props attach to this part on every platform.
+  public static let baseTarget: AstryxBaseTarget = .trigger
+  public var base: AstryxBaseProps
+  public var label: String
+  public var options: [SelectorOption]
+  public var value: String?
+  public var onChange: ((String) -> Void)?
+  public var hasClear: Bool?
+  public var hasSearch: Bool?
+  public var searchPlaceholder: String?
+  public var placeholder: String?
+  public var size: SelectorSize?
+  public var variant: SelectorVariant?
+  public var isDisabled: Bool?
+  public var isReadOnly: Bool?
+  public var disabledMessage: String?
+  public var isLabelHidden: Bool?
+  public var description: String?
+  public var isOptional: Bool?
+  public var isRequired: Bool?
+  public var status: SelectorStatus?
+  public var statusVariant: SelectorStatusVariant?
+  public var indicatorPosition: SelectorIndicatorPosition?
+  public var isLoading: Bool?
+  public var menuStyle: SelectorMenuStyle?
+  public init(label: String, options: [SelectorOption], value: String? = nil, onChange: ((String) -> Void)? = nil, hasClear: Bool? = nil, hasSearch: Bool? = nil, searchPlaceholder: String? = nil, placeholder: String? = nil, size: SelectorSize? = nil, variant: SelectorVariant? = nil, isDisabled: Bool? = nil, isReadOnly: Bool? = nil, disabledMessage: String? = nil, isLabelHidden: Bool? = nil, description: String? = nil, isOptional: Bool? = nil, isRequired: Bool? = nil, status: SelectorStatus? = nil, statusVariant: SelectorStatusVariant? = nil, indicatorPosition: SelectorIndicatorPosition? = nil, isLoading: Bool? = nil, menuStyle: SelectorMenuStyle? = nil, base: AstryxBaseProps = AstryxBaseProps()) {
+    self.label = label
+    self.options = options
+    self.value = value
+    self.onChange = onChange
+    self.hasClear = hasClear
+    self.hasSearch = hasSearch
+    self.searchPlaceholder = searchPlaceholder
+    self.placeholder = placeholder
+    self.size = size
+    self.variant = variant
+    self.isDisabled = isDisabled
+    self.isReadOnly = isReadOnly
+    self.disabledMessage = disabledMessage
+    self.isLabelHidden = isLabelHidden
+    self.description = description
+    self.isOptional = isOptional
+    self.isRequired = isRequired
+    self.status = status
+    self.statusVariant = statusVariant
+    self.indicatorPosition = indicatorPosition
+    self.isLoading = isLoading
+    self.menuStyle = menuStyle
+    self.base = base
+  }
+}
+#endif
+#if os(macOS)
+public enum SelectorMenuStyle: String, CaseIterable, Sendable {
+  case popUp = "popUp"
+  case pullDown = "pullDown"
+}
+public struct SelectorProps {
+  /// Base props attach to this part on every platform.
+  public static let baseTarget: AstryxBaseTarget = .trigger
+  public var base: AstryxBaseProps
+  public var label: String
+  public var options: [SelectorOption]
+  public var value: String?
+  public var onChange: ((String) -> Void)?
+  public var hasClear: Bool?
+  public var hasSearch: Bool?
+  public var searchPlaceholder: String?
+  public var placeholder: String?
+  public var size: SelectorSize?
+  public var variant: SelectorVariant?
+  public var isDisabled: Bool?
+  public var isReadOnly: Bool?
+  public var disabledMessage: String?
+  public var isLabelHidden: Bool?
+  public var description: String?
+  public var isOptional: Bool?
+  public var isRequired: Bool?
+  public var status: SelectorStatus?
+  public var statusVariant: SelectorStatusVariant?
+  public var indicatorPosition: SelectorIndicatorPosition?
+  public var isLoading: Bool?
+  public var menuStyle: SelectorMenuStyle?
+  public init(label: String, options: [SelectorOption], value: String? = nil, onChange: ((String) -> Void)? = nil, hasClear: Bool? = nil, hasSearch: Bool? = nil, searchPlaceholder: String? = nil, placeholder: String? = nil, size: SelectorSize? = nil, variant: SelectorVariant? = nil, isDisabled: Bool? = nil, isReadOnly: Bool? = nil, disabledMessage: String? = nil, isLabelHidden: Bool? = nil, description: String? = nil, isOptional: Bool? = nil, isRequired: Bool? = nil, status: SelectorStatus? = nil, statusVariant: SelectorStatusVariant? = nil, indicatorPosition: SelectorIndicatorPosition? = nil, isLoading: Bool? = nil, menuStyle: SelectorMenuStyle? = nil, base: AstryxBaseProps = AstryxBaseProps()) {
+    self.label = label
+    self.options = options
+    self.value = value
+    self.onChange = onChange
+    self.hasClear = hasClear
+    self.hasSearch = hasSearch
+    self.searchPlaceholder = searchPlaceholder
+    self.placeholder = placeholder
+    self.size = size
+    self.variant = variant
+    self.isDisabled = isDisabled
+    self.isReadOnly = isReadOnly
+    self.disabledMessage = disabledMessage
+    self.isLabelHidden = isLabelHidden
+    self.description = description
+    self.isOptional = isOptional
+    self.isRequired = isRequired
+    self.status = status
+    self.statusVariant = statusVariant
+    self.indicatorPosition = indicatorPosition
+    self.isLoading = isLoading
+    self.menuStyle = menuStyle
+    self.base = base
+  }
+}
+#endif

package/apple/Tests/AstryxNativeTests/SelectorPropsTests.swift

@@ -0,0 +1,17 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+import Testing
+@testable import AstryxNative
+
+@Test func selectorCoreAndPlatformProps() {
+  let props = SelectorProps(
+    label: "Shipping",
+    options: [SelectorOption(value: "std", label: "Standard")],
+    onChange: { _ in },
+    menuStyle: .pullDown,
+    base: AstryxBaseProps(id: "shipping")
+  )
+  #expect(props.label == "Shipping")
+  #expect(props.menuStyle == .pullDown)
+  #expect(SelectorProps.baseTarget == .trigger)
+}

package/dist/components/Selector.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file components/Selector.ts
+ * @input None
+ * @output What @astryxdesign/native adds to the core Selector contract
+ * @position Native additions read by fromComponentDoc together with core's
+ *   Selector documentation
+ */
+import type { NativeAdditions } from '../contract/fromComponentDoc.js';
+export declare const selector: NativeAdditions;
+//# sourceMappingURL=Selector.d.ts.map

package/dist/components/Selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Selector.d.ts","sourceRoot":"","sources":["../../src/components/Selector.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iCAAiC,CAAC;AAErE,eAAO,MAAM,QAAQ,EAAE,eAqCtB,CAAC"}

package/dist/components/Selector.js

@@ -0,0 +1,38 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+export const selector = {
+    name: 'Selector',
+    baseTarget: 'trigger',
+    typeNames: { SelectorOption: 'SelectorOption' },
+    types: {
+        // The portable part of core's option data. Its rich description, icon,
+        // and secondary control are web-only until typed slots exist.
+        SelectorOption: {
+            value: { type: { kind: 'string' } },
+            label: { type: { kind: 'string' }, optional: true },
+            disabled: { type: { kind: 'boolean' }, optional: true },
+        },
+    },
+    webOnly: {
+        presentation: 'web presentation choice; native platforms use their own control (FR11)',
+    },
+    platforms: {
+        ios: {
+            menuStyle: {
+                type: { kind: 'enum', values: ['popUp', 'pullDown'] },
+                optional: true,
+            },
+        },
+        macos: {
+            menuStyle: {
+                type: { kind: 'enum', values: ['popUp', 'pullDown'] },
+                optional: true,
+            },
+        },
+        android: {
+            menuStyle: {
+                type: { kind: 'enum', values: ['dropdown', 'bottomSheet'] },
+                optional: true,
+            },
+        },
+    },
+};

package/dist/components/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file components/index.ts
+ * @input None
+ * @output Every component the native package adds to, by core component name
+ * @position The generator walks this list; each entry pairs with core's
+ *   `<Name>/<Name>.doc.mjs`
+ */
+import type { NativeAdditions } from '../contract/fromComponentDoc.js';
+export declare const NATIVE_COMPONENTS: readonly NativeAdditions[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iCAAiC,CAAC;AAGrE,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAAe,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,3 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+import { selector } from './Selector.js';
+export const NATIVE_COMPONENTS = [selector];

package/dist/contract/fromComponentDoc.d.ts

@@ -0,0 +1,32 @@
+import type { BaseTarget, ComponentContract, PropMap } from './types.js';
+import type { NativePlatform } from '../platforms.js';
+/** The subset of a ComponentDoc this reader needs. */
+export interface ComponentDocLike {
+    readonly name: string;
+    readonly props?: ReadonlyArray<{
+        readonly name: string;
+        readonly type?: unknown;
+        readonly required?: boolean;
+        readonly description?: unknown;
+    }>;
+}
+/** What the native package adds to one core component. */
+export interface NativeAdditions {
+    readonly name: string;
+    readonly baseTarget: BaseTarget;
+    /**
+     * Portable definitions for named types the documentation references. Fields
+     * the web type has that are not portable are left out on purpose.
+     */
+    readonly types?: Readonly<Record<string, PropMap>>;
+    /** Documented types renamed to a native definition, e.g. `SelectorOption[]`. */
+    readonly typeNames?: Readonly<Record<string, string>>;
+    readonly platforms?: Readonly<Partial<Record<NativePlatform, PropMap>>>;
+    /**
+     * Portable-typed props that still belong to the web contract, with the
+     * reason, such as a web presentation heuristic a native platform replaces.
+     */
+    readonly webOnly?: Readonly<Record<string, string>>;
+}
+export declare function fromComponentDoc(doc: ComponentDocLike, additions: NativeAdditions): ComponentContract;
+//# sourceMappingURL=fromComponentDoc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fromComponentDoc.d.ts","sourceRoot":"","sources":["../../src/contract/fromComponentDoc.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,OAAO,EAGR,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAEpD,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;QAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC,CAAC;CACJ;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACxE;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,eAAe,GACzB,iBAAiB,CA0EnB"}

package/dist/contract/fromComponentDoc.js

@@ -0,0 +1,81 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file contract/fromComponentDoc.ts
+ * @input A component's documentation (.doc.mjs) plus the native additions for it
+ * @output A component contract: the portable core, native platform props, and the
+ *   web-only props with reasons
+ * @position Turns core documentation into the contract the generators consume.
+ *   Reads documentation as data at build time; never imports core at run time
+ *   (AST-082 FR16)
+ */
+import { parseDocType } from './parseDocType.js';
+import { coreNameProblem } from './rules.js';
+export function fromComponentDoc(doc, additions) {
+    const core = {};
+    const webOnly = [];
+    const types = additions.types ?? {};
+    for (const prop of doc.props ?? []) {
+        const declaredWebOnly = additions.webOnly?.[prop.name];
+        if (declaredWebOnly) {
+            webOnly.push({ name: prop.name, reason: declaredWebOnly });
+            continue;
+        }
+        if (/(?:Xstyle|XStyle|ClassName|Style)$/.test(prop.name) ||
+            prop.name === 'xstyle') {
+            webOnly.push({ name: prop.name, reason: 'web styling input' });
+            continue;
+        }
+        if (prop.name.startsWith('html') || prop.name.startsWith('aria-')) {
+            webOnly.push({ name: prop.name, reason: 'HTML attribute' });
+            continue;
+        }
+        const parsed = parseDocType(String(prop.type ?? ''));
+        if (!parsed.ok) {
+            webOnly.push({ name: prop.name, reason: parsed.reason });
+            continue;
+        }
+        // A portable type can still carry a name another platform owns.
+        const nameProblem = coreNameProblem(prop.name);
+        if (nameProblem) {
+            webOnly.push({ name: prop.name, reason: nameProblem });
+            continue;
+        }
+        let type = parsed.type;
+        const renamed = (name) => additions.typeNames?.[name] ?? name;
+        if (type.kind === 'named') {
+            type = { kind: 'named', name: renamed(type.name) };
+        }
+        if (type.kind === 'array' && type.of.kind === 'named') {
+            type = { kind: 'array', of: { kind: 'named', name: renamed(type.of.name) } };
+        }
+        if (type.kind === 'named' && !(type.name in types)) {
+            webOnly.push({
+                name: prop.name,
+                reason: `type "${type.name}" has no portable definition yet`,
+            });
+            continue;
+        }
+        if (type.kind === 'array' &&
+            type.of.kind === 'named' &&
+            !(type.of.name in types)) {
+            webOnly.push({
+                name: prop.name,
+                reason: `type "${type.of.name}" has no portable definition yet`,
+            });
+            continue;
+        }
+        core[prop.name] = {
+            type,
+            optional: prop.required !== true,
+            ...(typeof prop.description === 'string' ? { doc: prop.description } : {}),
+        };
+    }
+    return {
+        name: additions.name,
+        baseTarget: additions.baseTarget,
+        types,
+        core,
+        platforms: additions.platforms ?? {},
+        webOnly,
+    };
+}

package/dist/contract/generateSwift.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentContract } from './types.js';
+/** Returns file name to contents, relative to the generated Swift folder. */
+export declare function generateSwift(contracts: readonly ComponentContract[]): Record<string, string>;
+//# sourceMappingURL=generateSwift.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateSwift.d.ts","sourceRoot":"","sources":["../../src/contract/generateSwift.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AAoJrE,6EAA6E;AAC7E,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,iBAAiB,EAAE,GACtC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB"}