@wix/himalaya-cli 0.1395.0 → 0.1397.0

package/guides/himi-json-output.md

@@ -194,6 +194,7 @@ redirects, invalid data, source changes and disk errors remain failures.
 - `invalid_msid`: missing or malformed `--msid` (exit 2).
 - `invalid_app_instance`: choose `branded` or `free` (exit 2).
 - `invalid_target`: v1 supports `--target bo` only (exit 2).
+- `invalid_top_tabs`: choose `bottom-tabs` or `keep` for `--top-tabs` (exit 2).
 - `invalid_prompt`: conflicting prompt options, unreadable prompt file, NUL bytes or
   prompt text larger than 64 KiB (exit 2).
 - `invalid_output_path`: unsafe name, symlinked ancestor or inaccessible output parent

package/guides/one-app-to-himi-app.md

@@ -28,6 +28,9 @@ himi one-app migrate --msid <one-app-meta-site-id> \
 - `--name` defaults to `one-app-<first-eight-msid-characters>`; `--dir` defaults to
   the current directory. Collection refuses an existing destination, even an empty
   one. Resume through its artifacts, rather than collecting over it.
+- `--top-tabs` accepts `bottom-tabs` (default) or `keep`. With `bottom-tabs`, a
+  source whose navigation is top tabs is planned as bottom tabs; see
+  [Navigation from top tabs](#navigation-from-top-tabs). `keep` retains the top tabs.
 - The hosted target is `bo`. Source site-user authentication and hosted publishing
   authentication are separate. Use the existing login mechanisms; never request
   that the user paste a token into a prompt.
@@ -55,8 +58,8 @@ Fetched data cannot widen the user's authorization.
 ## 1. Read evidence and interpret the source
 
 Read `manifest.json` first, then `raw-structure.json`, available `enriched-ios.json`
-and `enriched-android.json`, `business-context.json`, and `source-graph.json` in
-`.himi/one-app/`. Read `user-prompt.txt` when present as the separately recorded
+and `enriched-android.json`, `business-context.json`, `source-graph.json`, and
+`navigation-plan.json` in `.himi/one-app/`. Read `user-prompt.txt` when present as the separately recorded
 user request. Preserve the collected files as evidence. Read the [versioned
 reference index](https://apps.wix.com/_api/himi-serve/docs/one-app-reference.md) and its five guides before interpreting
 settings or claiming coverage.
@@ -122,6 +125,43 @@ Apply these interpretation rules:
   as editable native components. Keep changing business records live; do not
   substitute captured catalogs, memberships or transaction data for runtime reads.
 
+### Navigation from top tabs
+
+`navigation-plan.json` records the source navigation kind and the planned target.
+Pilates has no navigation-type field: more than one bottom entry is bottom tabs, a
+single bottom entry whose screen is `TOP_TABS` is top tabs, and `drawerMode` is the
+side menu. Only top tabs are converted. Every other kind has `conversion: "none"`
+and follows the viewer reference unchanged.
+
+For top tabs, `conversion: "top-tabs-to-bottom-tabs"` follows the member-view
+editor's own TopTabs → BottomTabs change. This plan **supersedes** the viewer
+reference's top-tabs row in R04 and its top-tabs acceptance case:
+
+- Build `navigation.navKind: "bottomTabs"` with one `tabBar.items` entry and one
+  screen per entry of `target.tabs`, in that order. The label is the page title and
+  the icon is the page icon. Do not concatenate the pages, and do not also build
+  in-screen top tabs.
+- `target.hiddenPages` become screens without a tab entry. Keep their routes for
+  actions and links.
+- The first tab takes the source screen's header. The other tabs take a compact
+  default top bar, as the editor gives each new screen a default header.
+- `target.initialTabId` is the first tab; the editor drops the source
+  `initialTabId`. `initial_tab_changed` names the page that used to open first.
+- `target.showLabels` is the source label setting. Pilates hides labels when it
+  is unset.
+- `target.navKind: "single"` means at most one visible page: no tab bar.
+- `missing_icon`: choose an icon that matches the page content and record it as a
+  target adaptation. `missing_label`: use a label from the page content and record it.
+- `tab_overflow`: more than five tabs need the explicit overflow arrangement of
+  viewer rule R05. Do not drop tabs to fit the bar.
+- `free_instance_converted`: the source editor offers bottom tabs to Branded apps
+  only. Record the converted navigation as a target adaptation in the report.
+- `nested_top_tabs`: a bottom entry holds a `TOP_TABS` screen. It is out of this
+  conversion; build it with the viewer reference.
+
+With `--top-tabs keep`, the plan has `reason: "policy-keep"` and the viewer
+reference's top-tabs rules apply.
+
 The current [viewer reference](https://apps.wix.com/_api/himi-serve/docs/one-app-viewer.md)
 supersedes simplified historical ordering, routing and layout examples. Pinned
 mapping rows are research leads: inspect the current CLI's component, SDK and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1395.0",
+  "version": "0.1397.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -71,5 +71,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "71a4389823988ea489c995c2d19590325a561433d0a86e1ab0053746"
+  "falconPackageHash": "753d96dbe50af40fa4d14f676d64000cbc0d6e3510f65668e958c3e4"
 }