@await-widget/runtime 0.0.30 → 0.0.32

package/bin/await-widget.js

@@ -6,6 +6,7 @@ import http from 'node:http';
 import os from 'node:os';
 import path from 'node:path';
 import process from 'node:process';
+import readline from 'node:readline';
 
 const defaultPort = 4343;
 const maxBodyBytes = 100 * 1024 * 1024;
@@ -16,6 +17,7 @@ const crcTable = makeCrcTable();
 const bridgeInfoDirectory = '.await';
 const bridgeInfoFileName = 'bridge.json';
 const singleWidgetPath = '.';
+const widgetDirectoryError = 'Run await-widget from a package root or first-level widget folder whose package.json includes @await-widget/runtime.';
 
 function main() {
 	const options = parseArgs(process.argv.slice(2));
@@ -128,10 +130,10 @@ function parseAppArgs(args) {
 	};
 }
 
-function startWorkspaceServer(options) {
+async function startWorkspaceServer(options) {
 	let roots;
 	try {
-		roots = resolveWidgetServerRoots(process.cwd());
+		roots = await resolveWidgetServerRoots(process.cwd());
 	} catch (error) {
 		console.error(error.message);
 		process.exit(1);
@@ -394,22 +396,81 @@ function findPackageRoot(start) {
 	}
 }
 
-function resolveWidgetServerRoots(start) {
+async function resolveWidgetServerRoots(start) {
 	const widgetRoot = path.resolve(start);
 	const packageRoot = findPackageRoot(widgetRoot);
 	if (
 		!packageRoot
-		|| packageRoot === widgetRoot
-		|| path.dirname(widgetRoot) !== packageRoot
-		|| !isValidTopLevelName(path.basename(widgetRoot))
 		|| !hasRuntimeDependency(packageRoot)
 	) {
-		throw new Error('Run await-widget from a first-level widget folder inside a package whose package.json includes @await-widget/runtime.');
+		throw new Error(widgetDirectoryError);
+	}
+
+	if (packageRoot === widgetRoot) {
+		return {packageRoot, widgetRoot: await selectWidgetRoot(packageRoot)};
+	}
+
+	if (path.dirname(widgetRoot) !== packageRoot || !isValidTopLevelName(path.basename(widgetRoot))) {
+		throw new Error(widgetDirectoryError);
 	}
 
 	return {packageRoot, widgetRoot};
 }
 
+function selectWidgetRoot(packageRoot) {
+	const options = [
+		{name: `${path.basename(packageRoot)} (root)`, path: packageRoot},
+		...fs.readdirSync(packageRoot, {withFileTypes: true})
+			.filter(entry => entry.isDirectory() && isValidTopLevelName(entry.name))
+			.sort((left, right) => left.name.localeCompare(right.name))
+			.map(entry => ({name: entry.name, path: path.join(packageRoot, entry.name)})),
+	];
+	let selected = 0;
+	let rendered = false;
+	readline.emitKeypressEvents(process.stdin);
+	process.stdin.setRawMode(true);
+	process.stdin.resume();
+	console.log('Select a directory to connect:');
+
+	const render = () => {
+		if (rendered) {
+			readline.moveCursor(process.stdout, 0, -options.length);
+			readline.clearScreenDown(process.stdout);
+		}
+
+		process.stdout.write(`${options.map((option, index) => `${index === selected ? '❯' : ' '} ${option.name}`).join('\n')}\n`);
+		rendered = true;
+	};
+	render();
+
+	return new Promise(resolve => {
+		const cleanup = () => {
+			process.stdin.off('keypress', onKeypress);
+			process.stdin.setRawMode(false);
+			process.stdin.pause();
+		};
+		const onKeypress = (_character, key) => {
+			if (key.name === 'up' || key.name === 'down') {
+				selected = (selected + (key.name === 'up' ? options.length - 1 : 1)) % options.length;
+				render();
+				return;
+			}
+
+			if (key.name === 'return' || key.name === 'enter') {
+				cleanup();
+				resolve(options[selected].path);
+				return;
+			}
+
+			if (key.ctrl && key.name === 'c') {
+				cleanup();
+				process.exit(130);
+			}
+		};
+		process.stdin.on('keypress', onKeypress);
+	});
+}
+
 function hasRuntimeDependency(packageRoot) {
 	const manifest = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
 	return Boolean(manifest.dependencies?.['@await-widget/runtime'] ?? manifest.devDependencies?.['@await-widget/runtime']);
@@ -948,11 +1009,12 @@ function printHelp() {
   await-widget [--port ${defaultPort}]
   await-widget app <command> [options]
 
-Start the Await computer connection from a first-level widget folder under a
-package whose package.json includes @await-widget/runtime.
+Start the Await computer connection from a package root or first-level widget
+folder whose package.json includes @await-widget/runtime. Starting from the
+package root opens a directory selector.
 
 What it does:
-  - Serves the current widget folder to Await for live sync.
+  - Serves the selected widget folder to Await for live sync.
   - Prints a URL to paste into Await's Connect Computer sheet.
   - Writes .await/bridge.json in the package root for app commands.
   - Sends one-shot JSON app commands with await-widget app <command>.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@await-widget/runtime",
-	"version": "0.0.30",
+	"version": "0.0.32",
 	"description": "TypeScript declarations for Await widgets.",
 	"license": "MIT",
 	"author": "Maundy",

package/types/await.d.ts

@@ -213,6 +213,20 @@ declare module 'await' {
 				children?: never;
 			},
 	): NativeView;
+	export function XFlip(
+		props: AxisFlipValue &
+			ID &
+			Mods & {
+				children?: never;
+			},
+	): NativeView;
+	export function YFlip(
+		props: AxisFlipValue &
+			ID &
+			Mods & {
+				children?: never;
+			},
+	): NativeView;
 	export function HFlip(
 		props: FlipValue &
 			ID &

package/types/bridge.d.ts

@@ -132,6 +132,7 @@ type AwaitDefineConfig<T extends Record<string, unknown>, Intents> = {
 		context: TimelineContext,
 	) => Timeline<T> | Promise<Timeline<T>>;
 	widgetFamilies?: WidgetFamily[];
+	autoAccented?: boolean;
 	widgetIntents?: {
 		[IntentKey in keyof Intents]: Intents[IntentKey] extends (
 			...args: infer IntentArguments
@@ -165,6 +166,7 @@ export declare const AwaitEnv: {
 	readonly tag: number;
 	readonly host: 'app' | 'widget';
 	readonly version: string;
+	readonly appVersion: string;
 	test(...args: unknown[]): unknown;
 };
 type AwaitGlobal = typeof Await;

package/types/model.d.ts

@@ -4,6 +4,12 @@ type ColorScheme = 'light' | 'dark';
 
 type RenderingMode = 'fullColor' | 'accented' | 'vibrant';
 
+type Accented =
+	| 'fullColor'
+	| 'accented'
+	| 'accentedDesaturated'
+	| 'desaturated';
+
 type Update = Date | 'end' | 'rapid' | 'never';
 
 type WidgetFamily =
@@ -71,6 +77,7 @@ type AwaitWeatherConfig = {
 	longitude?: number;
 	hourlyLimit?: number;
 	dailyLimit?: number;
+	start?: Date;
 };
 
 type AwaitWeatherCurrent = {

package/types/prop.d.ts

@@ -114,8 +114,10 @@ type ImageValue = {
 	resizable?: Resizable;
 	/** The level of quality for rendering an image that requires interpolation, such as a scaled image. */
 	interpolation?: Interpolation;
-	/** A type that indicates how images are rendered */
+	/** The mode that indicates how images are rendered */
 	style?: TemplateRenderingMode;
+	/** The mode that indicates how images are rendered on widget accented mode */
+	accented?: Accented;
 };
 
 type IconValue = {
@@ -160,12 +162,15 @@ type ClockSecondValue = {
 	size: Size;
 };
 
-type FlipValue = {
+type AxisFlipValue = {
 	index: number;
-	delta: number;
 	curr: NativeView;
 	prev: NativeView;
 	perspective?: number;
+};
+
+type FlipValue = AxisFlipValue & {
+	delta: number;
 	shadowOpacity?: number;
 	leadingHidden?: boolean;
 	trailingHidden?: boolean;