@ibgib/web-gib 0.0.59 → 0.0.60

package/dist/util/device-helper.mjs

@@ -0,0 +1,90 @@
+/**
+ * @module util/device-helper
+ *
+ * Pure utility functions for generating clean, friendly, auto-generated device names/tags.
+ */
+/**
+ * Generates a friendly, URL-safe, kebab-cased default device tag.
+ * (e.g., `chrome-win-a1b2`, `mobile-safari-ios-3c4d`, `tablet-android-e5f6`).
+ *
+ * Pure function: Uses global browser objects (`navigator`, `window`) only as fallbacks
+ * when explicit options are omitted, enabling deterministic unit testing.
+ *
+ * @param opts Optional mock options for deterministic unit testing.
+ */
+export function generateDefaultDeviceTag(opts) {
+    const ua = (opts?.userAgent ?? (typeof navigator !== 'undefined' ? navigator.userAgent : '') ?? '').toLowerCase();
+    const uaData = opts?.userAgentData ?? (typeof navigator !== 'undefined' ? navigator.userAgentData : undefined);
+    const touchPoints = opts?.maxTouchPoints ?? (typeof navigator !== 'undefined' ? navigator.maxTouchPoints : 0) ?? 0;
+    const width = opts?.screenWidth ?? (typeof window !== 'undefined' ? window.innerWidth : 1024) ?? 1024;
+    // 1. Detect Form Factor (Mobile, Tablet, Desktop)
+    let formFactor = '';
+    const isMobileUaData = uaData?.mobile;
+    const isMobileUa = /mobile|iphone|ipod|android.*mobile|windows phone/i.test(ua);
+    const isTabletUa = /ipad|tablet|(android(?!.*mobile))/i.test(ua) || (touchPoints > 1 && /macintosh/i.test(ua) && width <= 1366);
+    if (isTabletUa) {
+        formFactor = 'tablet';
+    }
+    else if (isMobileUaData || isMobileUa) {
+        formFactor = 'mobile';
+    }
+    // 2. Detect OS / Platform
+    let platform = '';
+    const uaPlatform = (uaData?.platform || '').toLowerCase();
+    if (uaPlatform.includes('win') || ua.includes('windows')) {
+        platform = 'win';
+    }
+    else if (uaPlatform.includes('ios') || ua.includes('iphone') || ua.includes('ipad') || ua.includes('ipod')) {
+        platform = 'ios';
+    }
+    else if (uaPlatform.includes('mac') || ua.includes('macintosh') || ua.includes('mac os')) {
+        platform = 'mac';
+    }
+    else if (uaPlatform.includes('android') || ua.includes('android')) {
+        platform = 'android';
+    }
+    else if (uaPlatform.includes('linux') || ua.includes('linux')) {
+        platform = 'linux';
+    }
+    // 3. Detect Browser
+    let browser = '';
+    if (ua.includes('edg/') || ua.includes('edge/')) {
+        browser = 'edge';
+    }
+    else if (ua.includes('chrome/') || ua.includes('crios/')) {
+        browser = 'chrome';
+    }
+    else if (ua.includes('firefox/') || ua.includes('fxios/')) {
+        browser = 'firefox';
+    }
+    else if (ua.includes('safari/') && !ua.includes('chrome/') && !ua.includes('crios/')) {
+        browser = 'safari';
+    }
+    // 4. Generate or use provided 4-character random suffix
+    let suffix = opts?.randomSuffix;
+    if (!suffix) {
+        const chars = '0123456789abcdef';
+        suffix = '';
+        for (let i = 0; i < 4; i++) {
+            suffix += chars.charAt(Math.floor(Math.random() * chars.length));
+        }
+    }
+    suffix = suffix.toLowerCase().replace(/[^a-z0-9]/g, '').slice(0, 8);
+    // 5. Assemble Tokens
+    const tokens = [];
+    if (formFactor) {
+        tokens.push(formFactor);
+    }
+    if (browser) {
+        tokens.push(browser);
+    }
+    if (platform) {
+        tokens.push(platform);
+    }
+    if (tokens.length === 0) {
+        tokens.push('device');
+    }
+    tokens.push(suffix);
+    return tokens.join('-');
+}
+//# sourceMappingURL=device-helper.mjs.map

package/dist/util/device-helper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-helper.mjs","sourceRoot":"","sources":["../../src/util/device-helper.mts"],"names":[],"mappings":"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"}

package/dist/util/device-helper.respec.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=device-helper.respec.d.mts.map

package/dist/util/device-helper.respec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-helper.respec.d.mts","sourceRoot":"","sources":["../../src/util/device-helper.respec.mts"],"names":[],"mappings":""}

package/dist/util/device-helper.respec.mjs

@@ -0,0 +1,83 @@
+import { respecfully, iReckon, ifWe // DO NOT REMOVE ifWeMight or ifWe even if no longer used. We constantly change these when focusing tests
+ } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+const maam = `[${import.meta.url}]`, sir = maam;
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { generateDefaultDeviceTag } from './device-helper.mjs';
+await respecfully(sir, 'device-helper', async () => {
+    await ifWe(sir, 'generate clean tag for Desktop Windows Chrome', async () => {
+        const lc = `[generate clean tag for Desktop Windows Chrome]`;
+        try {
+            const tag = generateDefaultDeviceTag({
+                userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                userAgentData: { platform: 'Windows', mobile: false },
+                randomSuffix: 'a1b2'
+            });
+            iReckon(sir, tag).asTo('tag value').isGonnaBe('chrome-win-a1b2');
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+    });
+    await ifWe(sir, 'generate clean tag for Mobile iOS Safari (iPhone)', async () => {
+        const lc = `[generate clean tag for Mobile iOS Safari (iPhone)]`;
+        try {
+            const tag = generateDefaultDeviceTag({
+                userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1',
+                userAgentData: { platform: 'iOS', mobile: true },
+                randomSuffix: '3c4d'
+            });
+            iReckon(sir, tag).asTo('tag value').isGonnaBe('mobile-safari-ios-3c4d');
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+    });
+    await ifWe(sir, 'generate clean tag for Android Chrome Phone', async () => {
+        const lc = `[generate clean tag for Android Chrome Phone]`;
+        try {
+            const tag = generateDefaultDeviceTag({
+                userAgent: 'Mozilla/5.0 (Linux; Android 13; Pixel 7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36',
+                userAgentData: { platform: 'Android', mobile: true },
+                randomSuffix: '9e8f'
+            });
+            iReckon(sir, tag).asTo('tag value').isGonnaBe('mobile-chrome-android-9e8f');
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+    });
+    await ifWe(sir, 'generate clean tag for iPad / Tablet', async () => {
+        const lc = `[generate clean tag for iPad / Tablet]`;
+        try {
+            const tag = generateDefaultDeviceTag({
+                userAgent: 'Mozilla/5.0 (iPad; CPU OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1',
+                maxTouchPoints: 5,
+                screenWidth: 1024,
+                randomSuffix: '7a8b'
+            });
+            iReckon(sir, tag).asTo('tag value').isGonnaBe('tablet-safari-ios-7a8b');
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+    });
+    await ifWe(sir, 'generate fallback tag with random 4-char suffix when no hints are present', async () => {
+        const lc = `[generate fallback tag with random 4-char suffix]`;
+        try {
+            const tag = generateDefaultDeviceTag({
+                userAgent: '',
+                randomSuffix: '1234'
+            });
+            iReckon(sir, tag).asTo('tag value').isGonnaBe('device-1234');
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+    });
+});
+//# sourceMappingURL=device-helper.respec.mjs.map

package/dist/util/device-helper.respec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-helper.respec.mjs","sourceRoot":"","sources":["../../src/util/device-helper.respec.mts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/web-gib",
-  "version": "0.0.59",
+  "version": "0.0.60",
   "description": "Framework for creating agentic ibGib web apps. Contains plumbing for ibgib components, agentic framework (currently only Gemini implemented), web-based IndexedDB storage substrate, and more.",
   "funding": {
     "type": "individual",
@@ -29,10 +29,10 @@
   "license": "ISC",
   "dependencies": {
     "@google/genai": "^1.33.0",
-    "@ibgib/core-gib": "^0.1.73",
+    "@ibgib/core-gib": "^0.1.74",
     "@ibgib/encrypt-gib": "^0.3.1",
     "@ibgib/helper-gib": "^0.0.37",
-    "@ibgib/ts-gib": "^0.5.33"
+    "@ibgib/ts-gib": "^0.5.34"
   },
   "engines": {
     "node": ">=19.0.0"

package/src/AUTO-GENERATED-version.mts

@@ -11,4 +11,4 @@
 /**
  * this is the version of this package, auto-updated in the build process
  */
-export const AUTO_GENERATED_VERSION = '0.0.59';
+export const AUTO_GENERATED_VERSION = '0.0.60';

package/src/identity/custodian-delegate-helper.mts

@@ -6,6 +6,8 @@
  */
 
 import { getUUID, hash, HashAlgorithm, extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { storageGet, storagePut } from "../storage/storage-helpers.web.mjs";
+import { getGlobalDbName, getGlobalStoreName } from "../helpers.web.mjs";
 
 const LOCAL_STORAGE_PREFIX = 'ibgib_custodian_delegate_secret_';
 
@@ -27,20 +29,43 @@ export async function deriveLocalCustodianDelegateSecret({
         }
 
         const key = `${LOCAL_STORAGE_PREFIX}${primaryTjpAddr}`;
-        const existingSecret = localStorage.getItem(key);
+
+        const dbName = getGlobalDbName();
+        const storeName = getGlobalStoreName();
+
+        // debugger; // what are the dbName and storeName?
+
+
+        const existingSecret = await storageGet({ dbName, storeName, key });
         if (existingSecret) {
             return existingSecret;
         }
 
         // Generate high-entropy 512-bit SHA hash secret from fresh UUIDs
-        const rawEntropy = `${await getUUID()}-${await getUUID()}-${await getUUID()}-${Date.now()}`;
+        const rawEntropy = await getUUID(32);
         const newSecret = await hash({
             s: rawEntropy,
             algorithm: HashAlgorithm.sha_512
         });
+        await storagePut({ dbName, storeName, key, value: newSecret });
 
-        localStorage.setItem(key, newSecret);
         return newSecret;
+
+
+        // const existingSecret = localStorage.getItem(key);
+        // if (existingSecret) {
+        //     return existingSecret;
+        // }
+
+        // // Generate high-entropy 512-bit SHA hash secret from fresh UUIDs
+        // const rawEntropy = `${await getUUID()}-${await getUUID()}-${await getUUID()}-${Date.now()}`;
+        // const newSecret = await hash({
+        //     s: rawEntropy,
+        //     algorithm: HashAlgorithm.sha_512
+        // });
+
+        // localStorage.setItem(key, newSecret);
+        // return newSecret;
     } catch (error) {
         console.error(`${lc} ${extractErrorMsg(error)}`);
         throw error;

package/src/identity/identity-constants.mts

@@ -65,8 +65,8 @@ export const IDENTITY_POOL_ID_APP_EPOCH = 'identity-app-epoch';
 
 // ===========================================================================
 // KDF SALTS
-// Used to derive tier-specific MasterSecrets from a root passphrase.
-// Different salt per tier ensures independent secrets even with same passphrase.
+// Used to derive tier-specific MasterSecrets from a root password.
+// Different salt per tier ensures independent secrets even with same password.
 // ===========================================================================
 
 export const IDENTITY_KDF_SALT_META = 'ibgib-identity-meta-v1';

package/src/identity/identity-types.mts

@@ -221,17 +221,17 @@ export interface IIdentityService {
 // ===========================================================================
 
 /**
- * Inputs for deriving a tier-specific MasterSecret from a root passphrase.
+ * Inputs for deriving a tier-specific MasterSecret from a root password.
  *
  * Each tier uses a different salt to ensure independent MasterSecrets
- * even when the same passphrase is used for all tiers.
+ * even when the same password is used for all tiers.
  *
  * @see docs/identity/KEYSTONES.md for per-tier salt conventions
  * @see identity-helpers.mts for derivation functions
  */
 export interface MasterSecretDerivationContext {
-    /** The root passphrase (sovereign path) or server secret (custodial path). */
-    passphrase: string;
+    /** The root password (sovereign path) or server secret (custodial path). */
+    password: string;
 
     /**
      * Tier-specific salt (e.g., `IDENTITY_KDF_SALT_META`, `IDENTITY_KDF_SALT_LOCAL`).

package/src/ui/component/identity/add-device/add-device.css

@@ -5,22 +5,75 @@
 }
 
 .component-container {
-    padding: 1.5rem;
+    padding: 1.75rem;
     background: var(--ibgib-bg-surface, #1e1e2e);
     color: var(--ibgib-text-primary, #cdd6f4);
     border-radius: 12px;
     box-shadow: 0 4px 20px rgba(0, 0, 0, 0.3);
 }
 
+.hidden {
+    display: none !important;
+}
+
+.sso-options {
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+}
+
+.sso-btn {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 0.75rem;
+    padding: 0.8rem 1.25rem;
+    border: 1px solid rgba(255, 255, 255, 0.15);
+    border-radius: 8px;
+    background: #181825;
+    color: #cdd6f4;
+    font-size: 0.95rem;
+    font-weight: 600;
+    cursor: pointer;
+    transition: transform 0.15s ease, background 0.15s ease, border-color 0.15s ease;
+}
+
+.sso-btn:hover {
+    transform: translateY(-1px);
+    background: #313244;
+    border-color: #89b4fa;
+}
+
+.divider {
+    display: flex;
+    align-items: center;
+    text-align: center;
+    margin: 0.75rem 0;
+    color: #a6adc8;
+    font-size: 0.75rem;
+    font-weight: 700;
+    letter-spacing: 1px;
+}
+
+.divider::before, .divider::after {
+    content: '';
+    flex: 1;
+    border-bottom: 1px solid rgba(255, 255, 255, 0.1);
+}
+
+.divider span {
+    padding: 0 0.75rem;
+}
+
 .input-group {
-    margin-bottom: 1.2rem;
+    margin-bottom: 1rem;
     display: flex;
     flex-direction: column;
     gap: 0.4rem;
 }
 
 .input-group label {
-    font-size: 0.95rem;
+    font-size: 0.92rem;
     font-weight: 500;
     color: var(--ibgib-text-secondary, #a6adc8);
 }
@@ -50,7 +103,7 @@
 }
 
 .action-row {
-    margin-top: 1.5rem;
+    margin-top: 1rem;
 }
 
 .action-btn {
@@ -58,7 +111,7 @@
     padding: 0.85rem 1.5rem;
     border: none;
     border-radius: 8px;
-    background: linear-gradient(135deg, #50fa7b, #40c767);
+    background: linear-gradient(135deg, #89b4fa, #74c7ec);
     color: #11111b;
     font-size: 1rem;
     font-weight: 600;
@@ -75,6 +128,12 @@
     transform: translateY(0);
 }
 
+.action-btn:disabled {
+    opacity: 0.6;
+    cursor: not-allowed;
+    transform: none;
+}
+
 .status-area {
     margin-top: 1.2rem;
     padding: 1rem;
@@ -100,34 +159,51 @@
     color: #a6e3a1;
 }
 
-.hidden {
-    display: none !important;
-}
-
-.collapsed {
-    display: none !important;
+.status-msg {
+    margin: 0;
+    line-height: 1.4;
+    word-break: break-word;
 }
 
 .result-area {
     margin-top: 1.5rem;
-    padding: 1.2rem;
-    border-radius: 8px;
-    background: rgba(166, 227, 161, 0.1);
+    padding: 1.25rem;
+    background: rgba(166, 227, 161, 0.08);
     border: 1px solid #a6e3a1;
+    border-radius: 8px;
+}
+
+.result-area.collapsed {
+    display: none;
 }
 
 .result-area h3 {
     margin-top: 0;
+    margin-bottom: 0.5rem;
     color: #a6e3a1;
+    font-size: 1.15rem;
+}
+
+.address-label {
+    margin-bottom: 0.25rem;
+    font-size: 0.85rem;
+    color: var(--ibgib-text-secondary, #a6adc8);
 }
 
 .keystone-addr {
     display: block;
-    word-break: break-all;
-    padding: 0.6rem;
+    padding: 0.5rem 0.75rem;
     background: #11111b;
     border-radius: 6px;
     font-family: monospace;
     font-size: 0.85rem;
-    color: #89b4fa;
+    color: #f9e2af;
+    word-break: break-all;
+    margin-bottom: 0.75rem;
+}
+
+.warning {
+    margin: 0;
+    font-size: 0.85rem;
+    color: #a6adc8;
 }

package/src/ui/component/identity/add-device/add-device.html

@@ -1,37 +1,111 @@
 <div id="container" class="component-container">
-    <h2 id="title">Sign In New Device</h2>
+    <h2 id="title">Sign In to Device</h2>
     <div class="content">
-        <p>Sign in on this device to add it to an existing account.</p>
+        <p id="subtitle" style="margin-bottom: 1.25rem; font-size: 0.95rem; color: #a6adc8;">
+            Sign in on this device to link and synchronize your identity.
+        </p>
 
-        <div class="input-group">
-            <label for="input-identifier">Email</label>
-            <input type="text" id="input-identifier" placeholder="Enter registered email..." class="text-input">
-        </div>
+        <!-- ----------------------------------------------------------------- -->
+        <!-- Surface 1: Main Sign In Entry Surface                             -->
+        <!-- ----------------------------------------------------------------- -->
+        <div id="surface-entry">
+            <div class="sso-options"
+                style="display: flex; flex-direction: column; gap: 0.6rem; margin-bottom: 1.25rem;">
+                <button id="btn-google-sso" class="sso-btn google-btn">
+                    <svg width="18" height="18" viewBox="0 0 24 24">
+                        <path fill="#4285F4"
+                            d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z" />
+                        <path fill="#34A853"
+                            d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z" />
+                        <path fill="#FBBC05"
+                            d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.06H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.94l2.85-2.22.81-.63z" />
+                        <path fill="#EA4335"
+                            d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.06l3.66 2.84c.87-2.6 3.3-4.52 6.16-4.52z" />
+                    </svg>
+                    Continue with Google
+                </button>
+                <button id="btn-github-sso" class="sso-btn github-btn">
+                    <svg width="18" height="18" viewBox="0 0 24 24" fill="currentColor">
+                        <path
+                            d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
+                    </svg>
+                    Continue with GitHub
+                </button>
+            </div>
 
-        <div class="input-group">
-            <label for="input-device-tag">Device Name</label>
-            <input type="text" id="input-device-tag" placeholder="e.g. laptop, phone, living-room..."
-                class="text-input">
-        </div>
+            <div class="divider">
+                <span>OR SIGN IN WITH EMAIL</span>
+            </div>
 
-        <div class="input-group">
-            <label for="input-passphrase">Master Passphrase</label>
-            <input type="password" id="input-passphrase" placeholder="Enter your master passphrase..."
-                class="secret-input">
+            <div class="input-group">
+                <label for="input-identifier">Email</label>
+                <input type="email" id="input-identifier" placeholder="Enter your registered email..."
+                    class="text-input">
+            </div>
+
+            <div class="action-row" style="margin-top: 0.75rem;">
+                <button id="btn-continue-email" class="action-btn">Continue with Email</button>
+            </div>
         </div>
 
-        <div class="checkbox-group" style="margin-bottom: 1.5rem; display: flex; align-items: center; gap: 0.5rem;">
-            <input type="checkbox" id="checkbox-make-active" checked
-                style="cursor: pointer; width: 1rem; height: 1rem;">
-            <label for="checkbox-make-active" style="cursor: pointer; font-size: 0.9rem; user-select: none;">Set as
-                active device on this browser</label>
+        <!-- ----------------------------------------------------------------- -->
+        <!-- Surface 2 (Conditional): 6-Digit Email OTP Verification           -->
+        <!-- ----------------------------------------------------------------- -->
+        <div id="section-code-verification" class="input-group hidden"
+            style="margin-top: 1.25rem; padding: 1rem; border: 1px dashed #89b4fa; border-radius: 8px; background: rgba(137, 180, 250, 0.05);">
+            <label for="input-code" style="font-weight: bold; color: #89b4fa;">✉️ Enter 6-Digit Email Verification
+                Code</label>
+            <p style="font-size: 0.82rem; color: #a6adc8; margin-top: 0.25rem; margin-bottom: 0.75rem;">Check your email
+                for your 6-digit verification code:</p>
+            <div style="display: flex; gap: 0.5rem; flex-wrap: wrap; align-items: center;">
+                <input type="text" id="input-code" maxlength="6" placeholder="123456" class="text-input"
+                    style="font-family: monospace; font-size: 1.2rem; letter-spacing: 4px; text-align: center; max-width: 160px;">
+                <button id="btn-verify-code" class="action-btn" style="white-space: nowrap; width: auto;">Verify
+                    Code</button>
+            </div>
         </div>
 
-        <div class="action-row">
-            <button id="btn-add-device" class="action-btn">Sign In</button>
+        <!-- ----------------------------------------------------------------- -->
+        <!-- Surface 3 (Conditional): Sovereign Primary Password Entry        -->
+        <!-- ----------------------------------------------------------------- -->
+        <div id="section-sovereign-password" class="input-group hidden"
+            style="margin-top: 1.25rem; padding: 1rem; border: 1px dashed #f59e0b; border-radius: 8px; background: rgba(245, 158, 11, 0.05);">
+            <label for="input-password" style="font-weight: bold; color: #f59e0b;">🔐 Primary Password
+                Required</label>
+            <p style="font-size: 0.82rem; color: #a6adc8; margin-top: 0.25rem; margin-bottom: 0.75rem;">This sovereign
+                identity requires your master password to authorize this device:</p>
+            <div class="input-group">
+                <input type="password" id="input-password" placeholder="Enter your master password..."
+                    class="secret-input text-input">
+            </div>
+            <div class="action-row" style="margin-top: 0.5rem;">
+                <button id="btn-authorize-password" class="action-btn">Authorize & Pair Device</button>
+            </div>
         </div>
 
-        <div class="switch-workflow" style="margin-top: 1.2rem; text-align: center; font-size: 0.9rem; color: #a6adc8;">
+        <!-- ----------------------------------------------------------------- -->
+        <!-- Advanced Settings (Collapsible Device Tag & Active Toggle)        -->
+        <!-- ----------------------------------------------------------------- -->
+        <details id="details-device-options"
+            style="margin-top: 1.25rem; font-size: 0.85rem; color: #a6adc8; cursor: pointer;">
+            <summary style="user-select: none; font-weight: 500;">⚙️ Advanced Device Options</summary>
+            <div style="padding-top: 0.75rem;">
+                <div class="input-group" style="margin-bottom: 0.75rem;">
+                    <label for="input-device-tag" style="font-size: 0.82rem;">Device Name / Tag</label>
+                    <input type="text" id="input-device-tag" placeholder="e.g. laptop, phone, living-room..."
+                        class="text-input" style="font-size: 0.88rem; padding: 0.55rem 0.8rem;">
+                </div>
+                <div class="checkbox-group" style="display: flex; align-items: center; gap: 0.5rem;">
+                    <input type="checkbox" id="checkbox-make-active" checked
+                        style="cursor: pointer; width: 0.95rem; height: 0.95rem;">
+                    <label for="checkbox-make-active"
+                        style="cursor: pointer; font-size: 0.82rem; user-select: none;">Set as active identity on this
+                        browser</label>
+                </div>
+            </div>
+        </details>
+
+        <div class="switch-workflow" style="margin-top: 1.5rem; text-align: center; font-size: 0.9rem; color: #a6adc8;">
             Need a new identity? <button id="btn-switch-create-account" class="link-btn"
                 style="background: none; border: none; color: #89b4fa; font-weight: 600; cursor: pointer; text-decoration: underline; padding: 0; font-size: 0.9rem;">Create
                 Account</button>