typed-factorio 1.8.0 → 1.8.1

package/.yarn/unplugged/open-npm-8.4.0-df63cfe537/node_modules/open/index.d.ts

@@ -0,0 +1,153 @@
+import {ChildProcess} from 'child_process';
+
+declare namespace open {
+	interface Options {
+		/**
+		Wait for the opened app to exit before fulfilling the promise. If `false` it's fulfilled immediately when opening the app.
+
+		Note that it waits for the app to exit, not just for the window to close.
+
+		On Windows, you have to explicitly specify an app for it to be able to wait.
+
+		@default false
+		*/
+		readonly wait?: boolean;
+
+		/**
+		__macOS only__
+
+		Do not bring the app to the foreground.
+
+		@default false
+		*/
+		readonly background?: boolean;
+
+		/**
+		__macOS only__
+
+		Open a new instance of the app even it's already running.
+
+		A new instance is always opened on other platforms.
+
+		@default false
+		*/
+		readonly newInstance?: boolean;
+
+		/**
+		Specify the `name` of the app to open the `target` with, and optionally, app `arguments`. `app` can be an array of apps to try to open and `name` can be an array of app names to try. If each app fails, the last error will be thrown.
+
+		The app name is platform dependent. Don't hard code it in reusable modules. For example, Chrome is `google chrome` on macOS, `google-chrome` on Linux and `chrome` on Windows. If possible, use [`open.apps`](#openapps) which auto-detects the correct binary to use.
+
+		You may also pass in the app's full path. For example on WSL, this can be `/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe` for the Windows installation of Chrome.
+
+		The app `arguments` are app dependent. Check the app's documentation for what arguments it accepts.
+		*/
+		readonly app?: App | readonly App[];
+
+		/**
+		Allow the opened app to exit with nonzero exit code when the `wait` option is `true`.
+
+		We do not recommend setting this option. The convention for success is exit code zero.
+
+		@default false
+		*/
+		readonly allowNonzeroExitCode?: boolean;
+	}
+
+	interface OpenAppOptions extends Omit<Options, 'app'> {
+		/**
+		Arguments passed to the app.
+
+		These arguments are app dependent. Check the app's documentation for what arguments it accepts.
+		*/
+		readonly arguments?: readonly string[];
+	}
+
+	type AppName =
+		| 'chrome'
+		| 'firefox'
+		| 'edge';
+
+	type App = {
+		name: string | readonly string[];
+		arguments?: readonly string[];
+	};
+}
+
+// eslint-disable-next-line no-redeclare
+declare const open: {
+	/**
+	Open stuff like URLs, files, executables. Cross-platform.
+
+	Uses the command `open` on macOS, `start` on Windows and `xdg-open` on other platforms.
+
+	There is a caveat for [double-quotes on Windows](https://github.com/sindresorhus/open#double-quotes-on-windows) where all double-quotes are stripped from the `target`.
+
+	@param target - The thing you want to open. Can be a URL, file, or executable. Opens in the default app for the file type. For example, URLs open in your default browser.
+	@returns The [spawned child process](https://nodejs.org/api/child_process.html#child_process_class_childprocess). You would normally not need to use this for anything, but it can be useful if you'd like to attach custom event listeners or perform other operations directly on the spawned process.
+
+	@example
+	```
+	import open = require('open');
+
+	// Opens the image in the default image viewer
+	await open('unicorn.png', {wait: true});
+	console.log('The image viewer app closed');
+
+	// Opens the url in the default browser
+	await open('https://sindresorhus.com');
+
+	// Opens the URL in a specified browser.
+	await open('https://sindresorhus.com', {app: {name: 'firefox'}});
+
+	// Specify app arguments.
+	await open('https://sindresorhus.com', {app: {name: 'google chrome', arguments: ['--incognito']}});
+	```
+	*/
+	(
+		target: string,
+		options?: open.Options
+	): Promise<ChildProcess>;
+
+	/**
+	An object containing auto-detected binary names for common apps. Useful to work around cross-platform differences.
+
+	@example
+	```
+	import open = require('open');
+
+	await open('https://google.com', {
+		app: {
+			name: open.apps.chrome
+		}
+	});
+	```
+	*/
+	apps: Record<open.AppName, string | readonly string[]>;
+
+	/**
+	Open an app. Cross-platform.
+
+	Uses the command `open` on macOS, `start` on Windows and `xdg-open` on other platforms.
+
+	@param name - The app you want to open. Can be either builtin supported `open.apps` names or other name supported in platform.
+	@returns The [spawned child process](https://nodejs.org/api/child_process.html#child_process_class_childprocess). You would normally not need to use this for anything, but it can be useful if you'd like to attach custom event listeners or perform other operations directly on the spawned process.
+
+	@example
+	```
+	const {apps, openApp} = require('open');
+
+	// Open Firefox
+	await openApp(apps.firefox);
+
+	// Open Chrome incognito mode
+	await openApp(apps.chrome, {arguments: ['--incognito']});
+
+	// Open Xcode
+	await openApp('xcode');
+	```
+	*/
+	openApp: (name: open.App['name'], options?: open.OpenAppOptions) => Promise<ChildProcess>;
+};
+
+export = open;

package/generated/classes.d.ts

@@ -19496,6 +19496,7 @@ interface LuaRemote {
    * @param args Arguments to pass to the called function.
    * @see {@link https://lua-api.factorio.com/latest/LuaRemote.html#LuaRemote.call Online documentation}
    */
+  call<T extends (...args: any) => any>(_interface: string, _function: string, ...args: Parameters<T>): ReturnType<T>
   call(_interface: string, _function: string, ...args: readonly Any[]): Any | nil
   /**
    * List of all registered interfaces. For each interface name, `remote.interfaces[name]` is a dictionary mapping the interface's registered functions to the value `true`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typed-factorio",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "Featureful typescript definitions for the the Factorio modding lua api.",
   "keywords": [
     "factorio",
@@ -58,4 +58,4 @@
     "typescript-to-lua": "^1.10.0"
   },
   "packageManager": "yarn@3.2.3"
-}
+}

package/Changelog.md

@@ -1,256 +0,0 @@
-# v1.8.0
-
-- Updated to factorio version 1.1.69
-
-# v1.7.4
-
-- Fix advanced types of method returns (nullability, string unions, etc.)
-
-# v1.7.3
-
-- Improve types of "util" lualib module
-- Made compatible with typescript v4.8
-
-# v1.7.1
-
-- Added proper nullablity to members with different read/write types
-- Deduped union types
-
-# v1.7.0
-
-- Updated to factorio version 1.1.67
-
-# v1.6.1
-
-- Fixed write type for `BoundingBox`.
-- Simplified types for BlueprintEntity.
-
-# v1.6.0
-
-- Updated to factorio version 1.1.64
-
-# v1.5.1
-
-- Added old `Read` types as deprecated type aliases of new types; to help with migration.
-
-# v1.5.0
-
-### BREAKING
-
-- Read-only forms of concepts (the most common form used) is now specified with just the name; forms with a `Read` or `Table` suffix have been removed.
-- Write forms are now specified as either a union of table and array forms, or with a `Write` suffix for concepts.
-    - For table-or-array concepts: `MapPositionRead` -> `MapPosition`, `MapPosition` -> `MapPosition | PositionArray`
-    - For table concepts: `ScriptAreaRead` -> `ScriptArea`, `ScriptArea` -> `ScriptAreaWrite`
-- The minimum TSTL version has been increased to v1.6.1 (A bug with documentation comments was fixed in that version).
-
-### Other
-
-- Updated to factorio version 1.1.63.
-- Upgraded to factorio api docs json version 3.
-- The new type `nil` is used instead of `undefined` (they are equivalent).
-- More complete type for `BlueprintEntity`.
-- Fixed missing read-write forms for more concepts.
-- Improved documentation comments (enabled by json docs version 3).
-- Improved documentation comments for variant parameter groups.
-
-# v1.4.0
-
-- Improve doc comments for enum concepts
-- Improve doc comment formatting
-- Improve types of concepts with literal union types
-- Add read-specific types to AutoplaceControl and ComparatorString
-
-# v1.3.2
-
-- Move "notes" comment into the main body of doc comment, instead of in @remarks. This works around #13.
-- Add manually defined overload for LuaControl::teleport().
-
-# v1.3.1
-
-- Use @linkplain instead of @link for web links. This hopefully works around issue #13
-
-# v1.3.0
-
-- Updated to factorio version 1.1.61
-
-# v1.2.0
-
-- Updated to factorio version 1.1.60
-
-# v1.1.0
-
-- Updated to factorio version 1.1.59
-
-# v1.0.0
-
-- This project now has all the features that was originally planned, and can now guarantee reasonable backwards compatibility for future releases.
-- Updated to factorio version 1.1.57
-
-# v0.20.0
-
-- Updated to factorio version 1.1.56
-- This is an **opt-in** feature: Some numeric types which represent indices/number,e.g. player_index, entity_number, are now branded numbers with their own type, e.g. `PlayerIndex` and `EntityNumber`. See the README for more info.
-- Added custom-index-template.d.ts to assist trying out custom changes to types in a project.
-
-# v0.19.0
-
-- Updated to factorio version 1.1.53
-- Updated to json api version 2
-- Improved documentation comments
-
-## Changes
-
-- `Position`, `PositionArray`, and `PositionTable` have been replaced by `MapPosition`, `MapPositionArray`, and `MapPositionTable` respectively. These are now deprecated and may be removed in a future version.
-
-# v0.18.1
-
-- `TechnologyIdentification` now also has a more specific type when read.
-
-# v0.18.0
-
-- `ForceIdentification` and `ItemPrototypeIdentification` now have more specific types when read.
-- Properties which represent a flag concept now have the correct specific type, instead of `string`.
-
-# v0.17.1
-
-- Fixed documentation links for events
-
-# v0.17.0
-
-- Updated to factorio version 1.1.52
-
-# v0.16.0
-
-- `LuaCustomTable` can be iterated on in a for-of loop directly (without using `pairs`). This requires TSTL v1.3.0 or later.
-- TSTL dependency minimum version is now v1.3.0.
-
-# v0.15.0
-
-- Table or array concepts are now declared in table form wherever it is an "read" position.
-    - This works with setter overloading for applicable properties: `player.color.x; player.color = [1, 1, 1]` is now valid!
-    - This also applies to concepts/complex types which contain table_or_array properties.
-- Some concepts now also have a special form where it is known to be in a "read" position, where all table_or_array concepts are declared in table form. These concepts are suffixed with "Read", e.g. `ScriptAreaRead`.
-- Arrays which are known to be in a "write" only form (e.g. method parameters) now are marked readonly. This means you can now pass readonly arrays to these methods.
-- `MapPosition` is now a table or array concept.
-- Classes with subclasses are now declared with all properties, instead of an intersection of subclasses (reversion)
-- Subclass specializations added for some missing classes
-
-# v0.14.1
-
-- LuaStyle: `extra_margin/padding_when_activated` is now for subclass scroll_pane
-
-# v0.14.0
-
-- LuaStyle size, margin/padding setters now have more specific array types. These array types are `SizeArray` and `StyleValuesArray` for size and margin/padding, respectively.
-- `@noSelf` annotation is now only present when necessary.
-- For classes with subclasses:
-    - The original class name (e.g. `LuaItemStack`) still contains attributes of all subclasses (same as before).
-    - There is now a `Base` type (e.g. `BaseItemStack`) which only includes attributes common to all subclasses.
-    - There is a separate type definition for each subclass, e.g. `BlueprintItem`. Note that one instance may still belong to multiple subclasses (the subclasses are not mutually exclusive).
-    - The above two can be optionally used for stricter types.
-
-# v0.13.2
-
-- Fix: resize_to_sprite property should not be on subclass sprite-button
-- Fix: ChooseElemButtonSpec filters should be named elem_filters
-- Switch back to `/latest` api docs link
-    - New version of web api docs is now active
-
-# v0.13.0
-
-- Update to factorio version 1.1.49
-
-# v0.12.0
-
-- Update to factorio version 1.1.48
-
-# v0.11.1
-
-- Localised strings now accept boolean and undefined.
-
-# v0.11.0
-
-- Update to factorio version 1.1.46
-
-# v0.10.0
-
-- LuaGuiElement.style and LuaControl.opened now have different get/set types (more specific get type).
-- The array form of LocalizedString is now readonly.
-
-# v0.9.0
-
-- Update to factorio version 1.1.43
-- The `defines.events `_type_ was renamed to `defines.Events`, to reduce confusion between the namespace/type
-
-# v0.8.0
-
-- All event types now explicitly extend `EventData`
-- Variant parameter groups without additional fields now have their own type, instead of all being grouped into `Other`
-
-# v0.7.3
-
-- Update to factorio version 1.1.42
-    - No api changes, but improvements to descriptions
-
-# v0.7.2
-
-- Fix minor issue for event types
-
-# v0.7.0
-
-- Updated to factorio version 1.1.41 (no changes to lua api)
-- Improved smart types for events
-
-# v0.6.1
-
-- Added type for BlueprintControlBehavior
-
-# v0.6.0
-
-- Updated to factorio version 1.1.40
-- Fixed regression with duplicate strings in string union types
-
-# v0.5.0
-
-- Updated to factorio version 1.1.39
-- Documentation links now point to the new API docs website. More info here: https://forums.factorio.com/viewtopic.php?f=34&t=99797
-
-# v0.4.1
-
-### Changed
-
-- LuaRemote.addInterface now lets remote functions take any arguments.
-
-# v0.4.0
-
-## **BREAKING**
-
-- Only the latest version api is now provided.
-- It is now accessed using `typed-factorio/runtime` instead of `typed-factorio/<version>`
-
-### Added
-
-- Basic types for settings and data stage. See README for more details.
-- Types for "util" and "mod-gui" lualib modules
-
-### Fixed
-
-- LuaGuiElement::add with a literal now give diagnostic if you supply a field that shouldn't be there.
-
-### Internal
-
-- Split generated files into multiple files
-- Improved compilation tests
-
-# v0.3.0
-
-- Added factorio version `1.1.38`
-
-# v0.2.0
-
-- `AnyBasic` now uses type `table` instead of type `Record<any, AnyBasic>`
-- README changes
-
-# v0.1.0
-
-- Initial release