@await-widget/runtime 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Await Widget contributors
+
+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

@@ -0,0 +1,54 @@
+# Await Widget Types
+
+TypeScript declarations for Await widgets.
+
+This package replaces the local `paths` setup used by widget templates. It provides:
+
+- the `await` module for components such as `Text`, `Image`, `VStack`, and `Button`
+- the `await/jsx-runtime` module for `jsxImportSource`
+- global Await bridge APIs such as `Await`, `AwaitStore`, and `AwaitNetwork`
+- the Await JSX constraints, including no native HTML intrinsic elements
+
+## Install
+
+```sh
+npm install -D @await-widget/runtime
+```
+
+## tsconfig
+
+```json
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "await",
+    "types": ["@await-widget/runtime"]
+  }
+}
+```
+
+After that, widget source can keep importing components from `await`:
+
+```tsx
+import { Text, VStack } from "await";
+
+function widget() {
+  return (
+    <VStack>
+      <Text value="Hello, Await" />
+    </VStack>
+  );
+}
+
+Await.define({
+  widget,
+});
+```
+
+## Why `types` Is Still Needed
+
+Ordinary npm packages are not automatically loaded as global type packages. TypeScript only auto-loads packages under `node_modules/@types/*`, unless the project restricts `compilerOptions.types`.
+
+This package keeps the real module name as `await` while publishing under `@await-widget/runtime`, so projects should add `"types": ["@await-widget/runtime"]`.
+
+If this is later published as a true `@types/await` package, the global declarations can be auto-loaded in projects that do not override `compilerOptions.types`. `jsxImportSource` still has to be configured as `await`.

package/ambient.d.ts

@@ -0,0 +1,203 @@
+/// <reference path="./types/global.d.ts" />
+/// <reference path="./types/prop.d.ts" />
+/// <reference path="./types/jsx.d.ts" />
+/// <reference path="./runtime/bridge.d.ts" />
+
+declare module "await" {
+  export const Fragment: ({
+    children,
+  }: {
+    children: NativeView;
+  }) => NativeView;
+  export const jsx: (
+    create: (props: Props) => NativeView,
+    props: Props,
+  ) => NativeView;
+  export function VStack(
+    props: VStackValue &
+      ID &
+      Mods & {
+        children?: NativeView;
+      },
+  ): NativeView;
+  export function HStack(
+    props: HStackValue &
+      ID &
+      Mods & {
+        children?: NativeView;
+      },
+  ): NativeView;
+  export function ZStack(
+    props: ZStackValue &
+      ID &
+      Mods & {
+        children?: NativeView;
+      },
+  ): NativeView;
+  export function Link(
+    props: LinkValue &
+      ID &
+      Mods & {
+        children?: NativeView;
+      },
+  ): NativeView;
+  export function Button(
+    props: ButtonValue &
+      ID &
+      Mods & {
+        children?: NativeView;
+      },
+  ): NativeView;
+  export function Color(
+    props: ColorValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Text(
+    props: TextValue &
+      ID &
+      Mods & {
+        children?: NativeView;
+      },
+  ): NativeView;
+  export function Time(
+    props: TimeValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Image(
+    props: ImageValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Icon(
+    props: IconValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Svg(
+    props: SvgValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function RoundedRectangle(
+    props: RoundedRectangleValue &
+      ShapeValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function UnevenRoundedRectangle(
+    props: UnevenRoundedRectangleValue &
+      ShapeValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Rectangle(
+    props: ShapeValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Sector(
+    props: SectorValue &
+      ShapeValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Ellipse(
+    props: ShapeValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Circle(
+    props: ShapeValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Polygon(
+    props: PolygonValue &
+      ShapeValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Diamond(
+    props: ShapeValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Capsule(
+    props: CapsuleValue &
+      ShapeValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Spacer(
+    props: SpacerValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Group(
+    props: ID &
+      Mods & {
+        children?: NativeView;
+      },
+  ): NativeView;
+  export function Modifier(
+    props: ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function EmptyView(
+    props: ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function FullButton(
+    props: ButtonValue &
+      ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+  export function Stamp(
+    props: ID &
+      Mods & {
+        children?: never;
+      },
+  ): NativeView;
+}
+
+declare module "await\/jsx-runtime" {
+  export { Fragment, jsx, jsx as jsxs } from "await";
+}

package/global.d.ts

@@ -0,0 +1 @@
+/// <reference path="./index.d.ts" />

package/index.d.ts

@@ -0,0 +1,7 @@
+/// <reference path="./types/global.d.ts" />
+/// <reference path="./types/prop.d.ts" />
+/// <reference path="./types/jsx.d.ts" />
+/// <reference path="./runtime/bridge.d.ts" />
+/// <reference path="./ambient.d.ts" />
+
+export * from "./runtime/await.js";

package/jsx-runtime.d.ts

@@ -0,0 +1 @@
+export { Fragment, jsx, jsx as jsxs } from "./runtime/await.js";

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@await-widget/runtime",
+  "version": "0.0.1",
+  "description": "TypeScript declarations for Await widgets.",
+  "license": "MIT",
+  "author": "LitoMore",
+  "type": "module",
+  "files": [
+    "runtime",
+    "types",
+    "ambient.d.ts",
+    "index.d.ts",
+    "global.d.ts",
+    "jsx-runtime.d.ts"
+  ],
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts"
+    },
+    "./global": {
+      "types": "./global.d.ts"
+    },
+    "./jsx-runtime": {
+      "types": "./jsx-runtime.d.ts"
+    },
+    "./runtime/await": {
+      "types": "./runtime/await.d.ts"
+    },
+    "./runtime/bridge": {
+      "types": "./runtime/bridge.d.ts"
+    },
+    "./types/global": {
+      "types": "./types/global.d.ts"
+    },
+    "./types/prop": {
+      "types": "./types/prop.d.ts"
+    },
+    "./types/jsx": {
+      "types": "./types/jsx.d.ts"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "global": [
+        "global.d.ts"
+      ],
+      "jsx-runtime": [
+        "jsx-runtime.d.ts"
+      ],
+      "*": [
+        "index.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "test": "tsc --noEmit -p test/tsconfig.json",
+    "pack:dry": "npm --cache .npm-cache pack --dry-run"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.2"
+  }
+}

package/runtime/await.d.ts

@@ -0,0 +1,192 @@
+export declare const Fragment: ({
+  children,
+}: {
+  children: NativeView;
+}) => NativeView;
+export declare const jsx: (
+  create: (props: Props) => NativeView,
+  props: Props,
+) => NativeView;
+export declare function VStack(
+  props: VStackValue &
+    ID &
+    Mods & {
+      children?: NativeView;
+    },
+): NativeView;
+export declare function HStack(
+  props: HStackValue &
+    ID &
+    Mods & {
+      children?: NativeView;
+    },
+): NativeView;
+export declare function ZStack(
+  props: ZStackValue &
+    ID &
+    Mods & {
+      children?: NativeView;
+    },
+): NativeView;
+export declare function Link(
+  props: LinkValue &
+    ID &
+    Mods & {
+      children?: NativeView;
+    },
+): NativeView;
+export declare function Button(
+  props: ButtonValue &
+    ID &
+    Mods & {
+      children?: NativeView;
+    },
+): NativeView;
+export declare function Color(
+  props: ColorValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Text(
+  props: TextValue &
+    ID &
+    Mods & {
+      children?: NativeView;
+    },
+): NativeView;
+export declare function Time(
+  props: TimeValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Image(
+  props: ImageValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Icon(
+  props: IconValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Svg(
+  props: SvgValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function RoundedRectangle(
+  props: RoundedRectangleValue &
+    ShapeValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function UnevenRoundedRectangle(
+  props: UnevenRoundedRectangleValue &
+    ShapeValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Rectangle(
+  props: ShapeValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Sector(
+  props: SectorValue &
+    ShapeValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Ellipse(
+  props: ShapeValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Circle(
+  props: ShapeValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Polygon(
+  props: PolygonValue &
+    ShapeValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Diamond(
+  props: ShapeValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Capsule(
+  props: CapsuleValue &
+    ShapeValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Spacer(
+  props: SpacerValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Group(
+  props: ID &
+    Mods & {
+      children?: NativeView;
+    },
+): NativeView;
+export declare function Modifier(
+  props: ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function EmptyView(
+  props: ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function FullButton(
+  props: ButtonValue &
+    ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;
+export declare function Stamp(
+  props: ID &
+    Mods & {
+      children?: never;
+    },
+): NativeView;