@putdotio/taizn 1.1.0 → 1.3.0

package/README.md

@@ -31,6 +31,7 @@ Create `taizn.json` in the app directory, keep `.taizn/` ignored, then run:
 pnpm exec taizn check
 pnpm exec taizn package
 pnpm exec taizn install
+pnpm exec taizn run
 ```
 
 Project files:
@@ -38,6 +39,7 @@ Project files:
 - `taizn.json`: app build, widget, signing, and variant config
 - `.taizn/.env`: optional local secrets read by Node
 - `.taizn/certificates/`: optional local author/distributor certs for `taizn profile`
+- `.taizn/remote.json`: optional paired Samsung TV remote token
 - `.taizn/build/`: generated package staging and output
 
 ## Commands
@@ -47,6 +49,11 @@ taizn check
 taizn profile
 taizn package
 taizn install
+taizn run
+taizn tv info
+taizn tv pair
+taizn tv press KEY_ENTER
+taizn tv press --delay-ms 250 KEY_HOME KEY_DOWN KEY_ENTER
 taizn --version
 ```
 
@@ -55,6 +62,11 @@ targets without requiring `taizn.json`. `profile` imports
 `.taizn/certificates/author.p12` and
 `.taizn/certificates/distributor.p12` into a Tizen security profile.
 `package` builds and signs a `.wgt`. `install` packages and sideloads it.
+`run` launches the configured variant application on the target. `tv` commands use
+Samsung's websocket remote-control API to inspect a TV,
+pair for a remote token, and send remote-control key presses. See
+[Samsung TV Remote](./docs/TV_REMOTE.md) for pairing, environment, and limits.
+`tv press` accepts one key or a sequence of keys.
 
 ## Environment
 
@@ -68,8 +80,20 @@ TAIZN_VARIANT=development
 TAIZN_TARGET=<tv-ip>:26101
 TAIZN_TIZEN_CLI=~/tizen-studio/tools/ide/bin/tizen
 TAIZN_SDB=~/tizen-studio/tools/sdb
+TAIZN_TV_HOST=<tv-ip>
+TAIZN_TV_INFO_PORT=8001
+TAIZN_TV_NAME=taizn
+TAIZN_TV_PORT=8002
+TAIZN_TV_PROTOCOL=wss
+TAIZN_TV_TIMEOUT_MS=30000
+TAIZN_TV_TOKEN=<paired-remote-token>
 ```
 
+`taizn tv` uses `TAIZN_TV_HOST`, or the host part of `TAIZN_TARGET` when no TV
+host is set. `TAIZN_TV_INFO_PORT` controls the HTTP metadata endpoint; the
+remote-control websocket still uses `TAIZN_TV_PORT`. `taizn tv pair` writes the
+paired remote token to `.taizn/remote.json`; keep `.taizn/` ignored.
+
 ## Config
 
 ```json
@@ -85,6 +109,7 @@ TAIZN_SDB=~/tizen-studio/tools/sdb
   },
   "widget": {
     "configXml": "platforms/tizen/config.xml",
+    "excludeFiles": ["js/main.js.map", "css/main.css.map"],
     "indexHtml": "platforms/tizen/index.html",
     "injectWebapis": true,
     "rewriteAssetUrls": false,
@@ -99,24 +124,35 @@ TAIZN_SDB=~/tizen-studio/tools/sdb
       "production": {
         "applicationId": "Example.app",
         "bundleName": "example",
+        "excludeFiles": ["js/main.js.LICENSE.txt"],
         "icon": "platforms/tizen/icon.png",
+        "indexHtml": "platforms/tizen/hosted.html",
+        "injectWebapis": true,
         "name": "Example",
-        "packageId": "Example"
+        "packageId": "Example",
+        "rewriteAssetUrls": false
       }
     }
   }
 }
 ```
 
+Variant `indexHtml`, `injectWebapis`, and `rewriteAssetUrls` values override
+the top-level `widget` values. Variant `excludeFiles` values are added to
+top-level `widget.excludeFiles`. Use them when development packages should
+bundle local app assets but production packages should load hosted asset URLs.
+
 ## Docs
 
 - [Contributing](./CONTRIBUTING.md)
 - [Distribution](./docs/DISTRIBUTION.md)
+- [Samsung TV Remote](./docs/TV_REMOTE.md)
 - [Security](./SECURITY.md)
 
 ## Repo Internals
 
 - [Agent guide](./AGENTS.md)
+- Effect source for local API research lives in ignored `.repos/effect`; dependency installs bootstrap it outside CI.
 
 ## Contributing