@stnd/launcher 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @stnd/launcher
 
+## 1.3.0
+
+### Minor Changes
+
+- Auto-bumped @stnd/launcher due to modified code.
+
 ## 1.2.0
 
 ### Minor Changes

package/Launcher.svelte

@@ -33,7 +33,14 @@
   // --- PROPS (all optional — the Launcher is fully self-booting) ---
   // Apps wire services via provide/inject (the Standard OS runtime store).
   // Props exist only for backward compat or one-off overrides.
-  let { WelcomeView = null, load = null, hideLogin = false } = $props();
+  let {
+    WelcomeView = null,
+    FooterView = null,
+    footer = null,
+    showFooter = false,
+    load = null,
+    hideLogin = false,
+  } = $props();
 
   // --- STATE (Synced with Engine) ---
   let pState = $state({
@@ -380,6 +387,21 @@
     return null;
   });
 
+  // --- FOOTER RESOLUTION (Optional) ---
+  let ActiveFooterComponent = $derived.by(() => {
+    if (FooterView) return FooterView;
+    if (registryState.views["::footer"]) return registryState.views["::footer"];
+    return inject("launcher:footer", null);
+  });
+
+  let shouldRenderFooter = $derived.by(() => {
+    if (footer || ActiveFooterComponent) return true;
+    const show = showFooter || inject("launcher:showFooter", false);
+    if (!show) return false;
+    if (ActiveViewComponent && show !== "always") return false;
+    return true;
+  });
+
   // Determine view size from registry meta
   let activeViewSize = $derived.by(() => {
     // 1. Dynamic Override
@@ -639,6 +661,57 @@
           <div class="std-launcher-empty">Nothing came up.</div>
         {/if}
       </div>
+
+      <!-- Optional Launcher Footer -->
+      {#if shouldRenderFooter}
+        <footer class="std-launcher-footer">
+          {#if footer}
+            {@render footer({ currentUser, pState, close: launcherClose })}
+          {:else if ActiveFooterComponent}
+            <ActiveFooterComponent {currentUser} {pState} close={launcherClose} />
+          {:else}
+            <!-- Default Navigation Hints & Info -->
+            <div class="std-launcher-footer-left">
+              {#if currentUser && currentUser.isAuthenticated}
+                <div
+                  class="std-launcher-user"
+                  role="button"
+                  tabindex="0"
+                  onclick={() => {
+                    if (registryState.views["::account-settings"]) {
+                      launcherView("::account-settings");
+                    } else if (registryState.views["::settings"]) {
+                      launcherView("::settings");
+                    } else {
+                      launcherView("::my-space");
+                    }
+                  }}
+                  onkeydown={(e) => {
+                    if (e.key === "Enter" || e.key === " ") {
+                      if (registryState.views["::account-settings"]) {
+                        launcherView("::account-settings");
+                      } else if (registryState.views["::settings"]) {
+                        launcherView("::settings");
+                      } else {
+                        launcherView("::my-space");
+                      }
+                    }
+                  }}
+                >
+                  <span class="smaller muted">
+                    {currentUser.name || currentUser.username || currentUser.email}
+                  </span>
+                </div>
+              {/if}
+            </div>
+
+            <div class="std-launcher-hints">
+              <span><kbd>↑</kbd> <kbd>↓</kbd> navigate</span>
+              <span><kbd>esc</kbd> close</span>
+            </div>
+          {/if}
+        </footer>
+      {/if}
     </div>
   </div>
 {/if}
@@ -984,6 +1057,66 @@
     font-size: var(--scale-d2);
   }
 
+  /* Optional Footer */
+  .std-launcher-footer {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: var(--space-d4) var(--space-d2);
+    min-height: 28px;
+    font-size: var(--scale-d2, 0.75rem);
+    color: var(--color-muted);
+    border-top: var(--border);
+    background-color: var(--color-surface-high);
+    box-shadow: var(--shadow-raised);
+    flex-shrink: 0;
+  }
+
+  .std-launcher-footer-left {
+    display: flex;
+    align-items: center;
+    gap: var(--space-d3);
+  }
+
+  .std-launcher-user {
+    display: flex;
+    align-items: center;
+    gap: var(--space-d4);
+    color: var(--color-foreground-muted);
+    padding: var(--space-d5) var(--space-d3);
+    border-radius: var(--radius);
+    transition: all var(--transition-fast);
+    cursor: pointer;
+  }
+
+  .std-launcher-user:hover {
+    background: var(--color-surface-highest);
+    color: var(--color-foreground);
+  }
+
+  .std-launcher-user span {
+    max-width: 150px;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  .std-launcher-hints {
+    display: flex;
+    align-items: center;
+    gap: var(--space-d1);
+    font-size: var(--scale-d2, 0.75rem);
+  }
+
+  .std-launcher-hints kbd {
+    font-family: var(--font-mono, monospace);
+    font-size: var(--scale-d3, 0.7rem);
+    padding: 1px var(--space-d4);
+    border-radius: var(--radius-sm, 3px);
+    background: var(--color-surface-highest);
+    border: var(--border);
+    color: var(--color-foreground);
+  }
 
   /* Mobile: Bottom Sheet */
   @media (max-width: 640px) {

package/README.md

@@ -65,12 +65,15 @@ Import and mount the `<Launcher />` component in your layout:
 
 ### Props
 
-| Prop          | Type                             | Default | Description                               |
-| :------------ | :------------------------------- | :------ | :---------------------------------------- |
-| `load`        | `string \| string[] \| function` | `null`  | Filter specific commands/views to load.   |
-| `userStore`   | `readable`                       | `null`  | Svelte store containing the current user. |
-| `searchNotes` | `function`                       | `null`  | Async function to search app content.     |
-| `WelcomeView` | `Component`                      | `null`  | Custom component for the empty state.     |
+| Prop          | Type                             | Default | Description                                            |
+| :------------ | :------------------------------- | :------ | :----------------------------------------------------- |
+| `load`        | `string \| string[] \| function` | `null`  | Filter specific commands/views to load.                |
+| `userStore`   | `readable`                       | `null`  | Svelte store containing the current user.              |
+| `searchNotes` | `function`                       | `null`  | Async function to search app content.                  |
+| `WelcomeView` | `Component`                      | `null`  | Custom component for the empty state.                  |
+| `FooterView`  | `Component`                      | `null`  | Custom component for the optional launcher footer.     |
+| `footer`      | `Snippet`                        | `null`  | Svelte 5 snippet for custom footer content.            |
+| `showFooter`  | `boolean \| "always"`            | `false` | Enable built-in footer (navigation hints & info).      |
 
 ## Core Concepts
 

package/launcher.ts

@@ -117,11 +117,15 @@ export function configureLauncher(
     searchNotes?: (query: string) => Promise<LauncherResult[]>;
     userStore?: any;
     filter?: (trigger: string, meta: CommandMeta) => boolean;
+    footer?: any;
+    showFooter?: boolean | "always";
   } = {},
 ) {
   // Legacy compat: if callers still pass these, push them into the runtime store
   if (options.searchNotes) provide("search", options.searchNotes);
   if (options.userStore) provide("user", options.userStore);
+  if (options.footer) provide("launcher:footer", options.footer);
+  if (options.showFooter !== undefined) provide("launcher:showFooter", options.showFooter);
   if (options.filter) appFilter = options.filter;
 }
 
@@ -135,6 +139,8 @@ export function initLauncher(
     searchNotes?: (query: string) => Promise<LauncherResult[]>;
     userStore?: any;
     filter?: (trigger: string, meta: CommandMeta) => boolean;
+    footer?: any;
+    showFooter?: boolean | "always";
   } = {},
 ) {
   configureLauncher(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stnd/launcher",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "publishConfig": {
     "access": "public"
   },