@picked/svelte 0.0.1-dev.1793772853474 → 0.0.1-dev.1793776638554

package/dist/plugins/devtools/sidebar/nav.d.ts

@@ -2,8 +2,8 @@
 import type { CustomToolIcon } from '../customTools';
 import type { StorageGetter } from '../launcher/launcher';
 /**
- * What a sidebar entry opens: a review tab, a review- or footer-placed custom tool, the Custom Tools
- * tab, or a developer screen.
+ * What a sidebar entry opens: a review tab, a custom tool, the Custom Tools page shown while no tool
+ * sits in that group, or a developer screen.
  */
 export type NavKind = 'review' | 'tool' | 'custom-tools' | 'developer';
 /** One entry of the sidebar: a row, or an icon at its foot. */
@@ -15,9 +15,13 @@ export interface NavItem {
     /** The glyph of an icon at the sidebar's foot. */
     icon?: CustomToolIcon;
 }
-/** The sidebar's entries: the top-level tabs, the Developer group's screens, and the foot's icons. */
+/**
+ * The sidebar's entries: the top-level tabs, the Custom Tools group's tools, the Developer group's
+ * screens, and the foot's icons.
+ */
 export interface NavModel {
     primary: readonly NavItem[];
+    custom: readonly NavItem[];
     developer: readonly NavItem[];
     footer: readonly NavItem[];
 }
@@ -25,17 +29,23 @@ export interface NavModel {
 export declare const TAB_STORAGE_KEY = "picked-devtools-tab";
 /** `sessionStorage` key holding `'true'` while the Developer group is open. */
 export declare const DEVELOPER_OPEN_STORAGE_KEY = "picked-devtools-developer-open";
+/** `sessionStorage` key holding `'false'` while the Custom Tools group is folded. */
+export declare const CUSTOM_TOOLS_OPEN_STORAGE_KEY = "picked-devtools-custom-tools-open";
+/** The label of the Custom Tools row and group. */
+export declare const CUSTOM_TOOLS_LABEL = "Custom Tools";
 /** The tab a first open lands on, and where a vanished tab falls back to. */
 export declare const DEFAULT_TAB = "guide";
-/** The id of the Custom Tools tab, which holds every tool placed neither `'review'` nor `'footer'`. */
+/** The id of the Custom Tools row listed while no tool sits in that group; it links the how-to page. */
 export declare const CUSTOM_TOOLS_TAB = "custom-tools";
+/** The id of the row that folds the Custom Tools group. */
+export declare const CUSTOM_TOOLS_GROUP = "custom-tools-group";
 /** The developer screens, in the order the Developer group lists them. */
 export declare const DEVELOPER_SCREENS: readonly {
     id: string;
     label: string;
 }[];
 /**
- * The sidebar id of a review- or footer-placed custom tool.
+ * The sidebar id of a custom tool.
  *
  * @param {string} toolId - The tool's registered id.
  * @returns {string} Its tab id, prefixed so it never collides with a review tab.
@@ -52,13 +62,18 @@ export declare function toolTabId(toolId: string): string;
 export declare function developerTabId(screenId: string): string;
 /** What decides the sidebar's rows. */
 export interface NavInput {
-    /** Whether the workspace publishes a feature, which lists Variations. */
+    /** Whether the workspace publishes a feature, which lists Feature flags. */
     variations: boolean;
     /** The review-placed custom tools, in registration order, each a tab of its own. */
     tools: readonly {
         id: string;
         label: string;
     }[];
+    /** The unplaced custom tools, in registration order, each a row of the Custom Tools group. */
+    customTools: readonly {
+        id: string;
+        label: string;
+    }[];
     /** The footer-placed custom tools, in registration order, each an icon at the sidebar's foot. */
     footerTools: readonly {
         id: string;
@@ -70,8 +85,8 @@ export interface NavInput {
  * Builds the sidebar's entries.
  *
  * @param {NavInput} input - What this session lists.
- * @returns {NavModel} The top-level tabs, the Developer group's screens and the foot's icons.
- * @example buildNav({ variations: true, tools: [], footerTools: [] })
+ * @returns {NavModel} The top-level tabs, the Custom Tools and Developer groups' rows, and the foot's icons.
+ * @example buildNav({ variations: true, tools: [], customTools: [], footerTools: [] })
  */
 export declare function buildNav(input: NavInput): NavModel;
 /**
@@ -83,6 +98,15 @@ export declare function buildNav(input: NavInput): NavModel;
  * @example resolveTab('journey', nav) // 'journey'
  */
 export declare function resolveTab(stored: string | null, nav: NavModel): string;
+/**
+ * Whether a tab sits inside the Custom Tools group.
+ *
+ * @param {string} tab - A tab id.
+ * @param {NavModel} nav - The sidebar's rows.
+ * @returns {boolean} `true` for an unplaced custom tool.
+ * @example isInCustomTools('tool:simulator', nav) // true
+ */
+export declare function isInCustomTools(tab: string, nav: NavModel): boolean;
 /**
  * Whether a tab sits inside the Developer group.
  *

package/dist/plugins/devtools/sidebar/nav.js

@@ -1 +1 @@
-import{TAB_LABELS as e}from"../derive/plain-language/plain-language.js";var t=`picked-devtools-tab`,n=`picked-devtools-developer-open`,r=`guide`,i=`custom-tools`,a=[{id:`project`,label:`Project`},{id:`components`,label:`Components`},{id:`config`,label:`Config`},{id:`content`,label:`Content`},{id:`events`,label:`Events`},{id:`experience-instances`,label:`Experience Instances`},{id:`experiences`,label:`Experiences`},{id:`features`,label:`Features`},{id:`fields`,label:`Fields`},{id:`frameworks`,label:`Frameworks`},{id:`history`,label:`History`},{id:`identity`,label:`Identity`},{id:`predicates`,label:`Predicates`},{id:`responses`,label:`Responses`}];function o(e){return`tool:${e}`}function s(e){return`dev:${e}`}function c(t){let n=[{id:`guide`,label:e.guide,kind:`review`},{id:`session`,label:e.session,kind:`review`},{id:`answers`,label:e.answers,kind:`review`},{id:`journey`,label:e.journey,kind:`review`},{id:`personas`,label:e.personas,kind:`review`}];t.variations&&n.push({id:`variations`,label:e.variations,kind:`review`});let r=t.tools.map(e=>({id:o(e.id),label:e.label,kind:`tool`})),c=a.map(e=>({id:s(e.id),label:e.label,kind:`developer`})),l={id:i,label:`Custom Tools`,kind:`custom-tools`},u=t.footerTools.map(e=>({id:o(e.id),label:e.label,kind:`tool`,icon:e.icon??`wrench`}));return{primary:[...n,...r,l],developer:c,footer:u}}function l(e,t){return e===null?r:[...t.primary,...t.developer,...t.footer].some(t=>t.id===e)?e:r}function u(e,t){return t.developer.some(t=>t.id===e)}function d(e,t,n){let r=Math.max(0,n-1);switch(e){case`ArrowDown`:return Math.min(t+1,r);case`ArrowUp`:return Math.max(t-1,0);case`Home`:return 0;case`End`:return r;default:return null}}function f(e,t){try{return e().getItem(t)}catch{return null}}function p(e,t,n){try{e().setItem(t,n)}catch{}}export{i as CUSTOM_TOOLS_TAB,r as DEFAULT_TAB,n as DEVELOPER_OPEN_STORAGE_KEY,a as DEVELOPER_SCREENS,t as TAB_STORAGE_KEY,c as buildNav,s as developerTabId,u as isInDeveloper,d as nextFocusIndex,f as readStored,l as resolveTab,o as toolTabId,p as writeStored};
+import{TAB_LABELS as e}from"../derive/plain-language/plain-language.js";var t=`picked-devtools-tab`,n=`picked-devtools-developer-open`,r=`picked-devtools-custom-tools-open`,i=`Custom Tools`,a=`guide`,o=`custom-tools`,s=`custom-tools-group`,c=[{id:`project`,label:`Project`},{id:`components`,label:`Components`},{id:`config`,label:`Config`},{id:`content`,label:`Content`},{id:`events`,label:`Events`},{id:`experience-instances`,label:`Experience Instances`},{id:`experiences`,label:`Experiences`},{id:`features`,label:`Feature flags`},{id:`fields`,label:`Fields`},{id:`frameworks`,label:`Frameworks`},{id:`history`,label:`History`},{id:`identity`,label:`Identity`},{id:`predicates`,label:`Predicates`},{id:`responses`,label:`Responses`}];function l(e){return`tool:${e}`}function u(e){return`dev:${e}`}function d(t){let n=[{id:`guide`,label:e.guide,kind:`review`},{id:`session`,label:e.session,kind:`review`},{id:`answers`,label:e.answers,kind:`review`},{id:`journey`,label:e.journey,kind:`review`},{id:`personas`,label:e.personas,kind:`review`}];t.variations&&n.push({id:`variations`,label:e.variations,kind:`review`});let r=e=>({id:l(e.id),label:e.label,kind:`tool`}),a=t.tools.map(r),s=t.customTools.map(r),d=c.map(e=>({id:u(e.id),label:e.label,kind:`developer`})),f=s.length===0?[{id:o,label:i,kind:`custom-tools`}]:[],p=t.footerTools.map(e=>({id:l(e.id),label:e.label,kind:`tool`,icon:e.icon??`wrench`}));return{primary:[...n,...a,...f],custom:s,developer:d,footer:p}}function f(e,t){return e===null?a:[...t.primary,...t.custom,...t.developer,...t.footer].some(t=>t.id===e)?e:a}function p(e,t){return t.custom.some(t=>t.id===e)}function m(e,t){return t.developer.some(t=>t.id===e)}function h(e,t,n){let r=Math.max(0,n-1);switch(e){case`ArrowDown`:return Math.min(t+1,r);case`ArrowUp`:return Math.max(t-1,0);case`Home`:return 0;case`End`:return r;default:return null}}function g(e,t){try{return e().getItem(t)}catch{return null}}function _(e,t,n){try{e().setItem(t,n)}catch{}}export{s as CUSTOM_TOOLS_GROUP,i as CUSTOM_TOOLS_LABEL,r as CUSTOM_TOOLS_OPEN_STORAGE_KEY,o as CUSTOM_TOOLS_TAB,a as DEFAULT_TAB,n as DEVELOPER_OPEN_STORAGE_KEY,c as DEVELOPER_SCREENS,t as TAB_STORAGE_KEY,d as buildNav,u as developerTabId,p as isInCustomTools,m as isInDeveloper,h as nextFocusIndex,g as readStored,f as resolveTab,l as toolTabId,_ as writeStored};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picked/svelte",
-  "version": "0.0.1-dev.1793772853474",
+  "version": "0.0.1-dev.1793776638554",
   "dependencies": {
     "d3": "^7.9.0"
   },
@@ -113,7 +113,7 @@
   "license": "SEE LICENSE IN LICENSE",
   "module": "./dist/index.js",
   "peerDependencies": {
-    "@picked/client": "0.0.1-dev.1793772853474",
+    "@picked/client": "0.0.1-dev.1793776638554",
     "effector": "^23.4.4",
     "svelte": "^5.55.7"
   },