create-portfoliable 1.0.3

package/src/header-visibility.contract.js

@@ -0,0 +1,31 @@
+// File: src/header-visibility.contract.js
+// Purpose: Provide shared visibility resolution helpers for header state contracts.
+// Author: Lio Schimanko
+
+// MARK: CONTRACT RESOLUTION HELPERS
+// Shared visibility helpers used by AppShell and unit tests.
+
+// Resolves a visibility attribute using contract-first precedence with fallback and default values.
+export function resolveHeaderVisibilityAttributeValue(contractValue, fallbackValue, defaultValue = undefined) {
+  if (contractValue !== null && typeof contractValue !== 'undefined') {
+    return contractValue;
+  }
+
+  if (fallbackValue !== null && typeof fallbackValue !== 'undefined') {
+    return fallbackValue;
+  }
+
+  return defaultValue;
+}
+
+// Enables required header controls for return-only mode and returns null for standard mode.
+export function resolveReturnOnlyVisibilityOverrides(isReturnOnlyEnabled) {
+  if (!isReturnOnlyEnabled) {
+    return null;
+  }
+
+  return {
+    showNavigationRegion: true,
+    showLanguageMenu: true,
+  };
+}

package/src/header-visibility.contract.test.js

@@ -0,0 +1,41 @@
+// File: src/header-visibility.contract.test.js
+// Purpose: Validate precedence and return-only semantics for header visibility helpers.
+// Author: Lio Schimanko
+
+// MARK: IMPORTS
+import { describe, expect, it } from 'vitest';
+
+import {
+  resolveHeaderVisibilityAttributeValue,
+  resolveReturnOnlyVisibilityOverrides,
+} from './header-visibility.contract.js';
+
+// MARK: CONTRACT TESTS
+// Verifies precedence and override semantics for header visibility contract helpers.
+describe('header visibility contract', () => {
+  // Contract values should always win over fallback values.
+  it('prefers explicit contract values over fallback values', () => {
+    expect(resolveHeaderVisibilityAttributeValue('false', 'true')).toBe('false');
+    expect(resolveHeaderVisibilityAttributeValue('true', 'false')).toBe('true');
+  });
+
+  // Fallback should be used when contract value is intentionally missing.
+  it('uses fallback when contract is unset', () => {
+    expect(resolveHeaderVisibilityAttributeValue(null, 'false')).toBe('false');
+    expect(resolveHeaderVisibilityAttributeValue(undefined, 'true')).toBe('true');
+  });
+
+  // Defaults should only be consulted when both previous tiers are absent.
+  it('uses default when both contract and fallback are unset', () => {
+    expect(resolveHeaderVisibilityAttributeValue(undefined, undefined, 'true')).toBe('true');
+  });
+
+  // Return-only mode injects explicit overrides to keep required controls visible.
+  it('only forces visibility overrides in return-only mode', () => {
+    expect(resolveReturnOnlyVisibilityOverrides(false)).toBeNull();
+    expect(resolveReturnOnlyVisibilityOverrides(true)).toEqual({
+      showNavigationRegion: true,
+      showLanguageMenu: true,
+    });
+  });
+});

package/src/main.js

@@ -0,0 +1,12 @@
+// File: src/main.js
+// Purpose: Boot the Portfoliable application shell in the browser.
+// Author: Lio Schimanko
+
+// MARK: RUNTIME ENTRY IMPORTS
+import '../templates/configs/i18n/i18n.config.js';
+import './App.js';
+import './style.css';
+
+// MARK: APP MOUNT
+// Mount the custom element that renders the runtime shell.
+document.getElementById('app').innerHTML = `<app-shell></app-shell>`;