smapiot · FlorianRappl · Jun 12, 2023 · May 31, 2023 · Jun 10, 2023 · Jun 10, 2023
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Piral Changelog
 
+## 1.0.0 (tbd)
+
+- First LTS release
+- Removed `piral-native` framework package
+- Removed `piral-ssr-utils` utils package
+- Removed `piral-systemjs-utils` utils package
+- Removed `piral-pwa` plugin package
+
 ## 0.15.13 (May 31, 2023)
 
 - Fixed `pilet publish --fresh` with schema defined by the "pilet.json"

diff --git a/SECURITY.md b/SECURITY.md
@@ -4,8 +4,14 @@
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 1.0.x   | :white_check_mark: |
-| < 1.0   | :x:                |
+| 1.x     | :white_check_mark: |
+| 0.x     | :x:                |
+
+## LTS Lifetime
+
+| Version | End of Life |
+| ------- | ----------- |
+| 1.x     | 2025/07/01  |
 
 ## Reporting a Vulnerability
 

diff --git a/docs/commands/add-piral-instance-pilet.md b/docs/commands/add-piral-instance-pilet.md
@@ -0,0 +1,88 @@
+# `pilet add-piral-instance`
+
+Adds another Piral instance to the available apps hosting the current pilet.
+
+## Syntax
+
+From the command line:
+
+```sh
+pilet add-piral-instance <app> [source]
+```
+
+Alternative:
+
+```sh
+pb add-piral-instance-pilet <app> [source]
+```
+
+## Aliases
+
+Instead of `add-piral-instance-pilet` you can also use:
+
+- `add-shell-pilet`
+- `install-shell-pilet`
+- `add-app-pilet`
+- `with-app-pilet`
+
+## Positionals
+
+### `app`
+
+Sets the name of the Piral instance to be added.
+
+
+- Type: `string`
+- Default: `undefined`
+
+### `source`
+
+Sets the source pilet path where the Piral instance should be added.
+
+
+- Type: `string`
+- Default: `.`
+
+## Flags
+
+### `--log-level`
+
+Sets the log level to use (1-5).
+
+
+- Type: `number`
+- Default: `3`
+
+### `--npm-client`
+
+Sets the npm client to be used for adding the Piral instance.
+
+
+- Type: `string`
+- Choices: `"npm"`, `"pnpm"`, `"pnp"`, `"yarn"`, `"lerna"`, `"rush"`
+- Default: `undefined`
+
+### `--selected`
+
+Defines if the provided Piral instance should be selected initially.
+
+
+- Type: `boolean`
+- Default: `false`
+
+### `--no-selected`
+
+Opposite of:
+Defines if the provided Piral instance should be selected initially.
+
+
+- Type: `boolean`
+- Default: `true`
+
+### `--base`
+
+Sets the base directory. By default the current directory is used.
+
+
+- Type: `string`
+- Default: `process.cwd()`
diff --git a/docs/commands/build-pilet.md b/docs/commands/build-pilet.md
@@ -28,7 +28,7 @@ Instead of `build-pilet` you can also use:
 
 ### `source`
 
-Sets the source index.tsx file for collecting all the information.
+Sets the source pilet path for collecting all the information.
 
 
 - Type: `string`
@@ -85,6 +85,23 @@ Creates source maps for the bundles.
 - Type: `boolean`
 - Default: `false`
 
+### `--watch`
+
+Continuously re-builds while watching the source files.
+
+
+- Type: `boolean`
+- Default: `false`
+
+### `--no-watch`
+
+Opposite of:
+Continuously re-builds while watching the source files.
+
+
+- Type: `boolean`
+- Default: `true`
+
 ### `--fresh`
 
 Performs a fresh build by removing the target directory first.
@@ -177,7 +194,7 @@ Sets the schema to be used when bundling the pilets.
 
 - Type: `string`
 - Choices: `"v0"`, `"v1"`, `"v2"`, `"none"`
-- Default: `"v2"`
+- Default: `undefined`
 
 ### `--bundler`
 

diff --git a/docs/commands/build-piral.md b/docs/commands/build-piral.md
@@ -28,7 +28,7 @@ Instead of `build-piral` you can also use:
 
 ### `source`
 
-Sets the source root directory or index.html file for collecting all the information.
+Sets the source Piral instance path for collecting all the information.
 
 
 - Type: `string`
@@ -111,6 +111,23 @@ Create associated source maps for the bundles.
 - Type: `boolean`
 - Default: `false`
 
+### `--watch`
+
+Continuously re-builds while watching the source files.
+
+
+- Type: `boolean`
+- Default: `false`
+
+### `--no-watch`
+
+Opposite of:
+Continuously re-builds while watching the source files.
+
+
+- Type: `boolean`
+- Default: `true`
+
 ### `--subdir`
 
 Places the build's output in an appropriate subdirectory (e.g., "emulator"). Ignored for "--all".

diff --git a/docs/commands/debug-pilet.md b/docs/commands/debug-pilet.md
@@ -110,6 +110,14 @@ Activates Hot Module Reloading (HMR).
 - Type: `boolean`
 - Default: `false`
 
+### `--krasrc`
+
+Sets a config file for overwriting the default kras options.
+
+
+- Type: `string`
+- Default: `undefined`
+
 ### `--optimize-modules`
 
 Also includes the node modules for target transpilation.
@@ -134,7 +142,7 @@ Sets the schema to be used when bundling the pilets.
 
 - Type: `string`
 - Choices: `"v0"`, `"v1"`, `"v2"`, `"none"`
-- Default: `"v2"`
+- Default: `undefined`
 
 ### `--bundler`
 

diff --git a/docs/commands/debug-piral.md b/docs/commands/debug-piral.md
@@ -28,7 +28,7 @@ Instead of `debug-piral` you can also use:
 
 ### `source`
 
-Sets the source root directory or index.html file for collecting all the information.
+Sets the source Piral instance path for collecting all the information.
 
 
 - Type: `string`
@@ -102,6 +102,14 @@ Activates Hot Module Reloading (HMR).
 - Type: `boolean`
 - Default: `false`
 
+### `--krasrc`
+
+Sets a config file for overwriting the default kras options.
+
+
+- Type: `string`
+- Default: `undefined`
+
 ### `--optimize-modules`
 
 Also includes the node modules for target transpilation.

diff --git a/docs/commands/declaration-piral.md b/docs/commands/declaration-piral.md
@@ -28,7 +28,7 @@ Instead of `declaration-piral` you can also use:
 
 ### `source`
 
-Sets the source root directory or index.html file for collecting all the information.
+Sets the source Piral instance path for collecting all the information.
 
 
 - Type: `string`

diff --git a/docs/commands/new-pilet.md b/docs/commands/new-pilet.md
@@ -34,7 +34,7 @@ Sets the source package (potentially incl. its tag/version) containing a Piral i
 
 
 - Type: `string`
-- Default: `piral`
+- Default: `undefined`
 
 ## Flags
 
@@ -120,7 +120,7 @@ Sets the default bundler to install.
 
 
 - Type: `string`
-- Choices: `"none"`, `"esbuild"`, `"parcel"`, `"parcel2"`, `"rollup"`, `"webpack"`, `"webpack5"`, `"vite"`, `"xbuild"`
+- Choices: `"none"`, `"esbuild"`, `"parcel"`, `"parcel2"`, `"rollup"`, `"rspack"`, `"webpack"`, `"webpack5"`, `"vite"`
10000
, `"xbuild"`
 - Default: `"none"`
 
 ### `--vars`

diff --git a/docs/commands/new-piral.md b/docs/commands/new-piral.md
@@ -50,7 +50,7 @@ Sets the framework/library level to use.
 
 
 - Type: `string`
-- Choices: `"piral-native"`, `"piral"`, `"piral-core"`, `"piral-base"`
+- Choices: `"piral"`, `"piral-core"`, `"piral-base"`
 - Default: `"piral"`
 
 ### `--install`
@@ -92,7 +92,7 @@ Sets the tag or version of the package to install. By default, this uses the ver
 
 - Aliases: `--piral-version`
 - Type: `string`
-- Default: `"0.14.32"`
+- Default: `"0.15.13"`
 
 ### `--force-overwrite`
 
@@ -135,7 +135,7 @@ Sets the default bundler to install.
 
 
 - Type: `string`
-- Choices: `"none"`, `"esbuild"`, `"parcel"`, `"parcel2"`, `"rollup"`, `"webpack"`, `"webpack5"`, `"vite"`, `"xbuild"`
+- Choices: `"none"`, `"esbuild"`, `"parcel"`, `"parcel2"`, `"rollup"`, `"rspack"`, `"webpack"`, `"webpack5"`, `"vite"`, `"xbuild"`
 - Default: `"none"`
 
 ### `--vars`

diff --git a/docs/commands/pack-pilet.md b/docs/commands/pack-pilet.md
@@ -28,7 +28,7 @@ Instead of `pack-pilet` you can also use:
 
 ### `source`
 
-Sets the source package.json file for creating the package.
+Sets the source pilet path for creating the package.
 
 
 - Type: `string`

diff --git a/docs/commands/publish-pilet.md b/docs/commands/publish-pilet.md
@@ -91,7 +91,7 @@ Sets the schema to be used when making a fresh build of the pilet.
 
 - Type: `string`
 - Choices: `"v0"`, `"v1"`, `"v2"`, `"none"`
-- Default: `"v2"`
+- Default: `undefined`
 
 ### `--mode`
 

diff --git a/docs/commands/remove-piral-instance-pilet.md b/docs/commands/remove-piral-instance-pilet.md
@@ -0,0 +1,71 @@
+# `pilet remove-piral-instance`
+
+Removes an existing Piral instance from the available apps hosting the current pilet.
+
+## Syntax
+
+From the command line:
+
+```sh
+pilet remove-piral-instance <app> [source]
+```
+
+Alternative:
+
+```sh
+pb remove-piral-instance-pilet <app> [source]
+```
+
+## Aliases
+
+Instead of `remove-piral-instance-pilet` you can also use:
+
+- `remove-shell-pilet`
+- `uninstall-shell-pilet`
+- `remove-app-pilet`
+- `without-app-pilet`
+
+## Positionals
+
+### `app`
+
+Sets the name of the Piral instance to be removed.
+
+
+- Type: `string`
+- Default: `undefined`
+
+### `source`
+
+Sets the source pilet path where the Piral instance should be removed.
+
+
+- Type: `string`
+- Default: `.`
+
+## Flags
+
+### `--log-level`
+
+Sets the log level to use (1-5).
+
+
+- Type: `number`
+- Default: `3`
+
+### `--npm-client`
+
+Sets the npm client to be used for removing the Piral instance.
+
+
+- Type: `string`
+- Choices: `"npm"`, `"pnpm"`, `"pnp"`, `"yarn"`, `"lerna"`, `"rush"`
+- Default: `undefined`
+
+### `--base`
+
+Sets the base directory. By default the current directory is used.
+
+
+- Type: `string`
+- Default: `process.cwd()`