@hubpav/hwio-brand 0.1.0

package/README.md

@@ -0,0 +1,7 @@
+# @hubpav/hwio-brand
+
+HARDWARIO brand source of truth: `src/brand.json` holds the palette, theme roles (DaisyUI
+slots), shape tokens, fonts, layout presets, the sites registry and the footer-strip rules.
+`npm run build` generates `dist/tokens.json`, `dist/vars.css` (plain `--hwio-*` custom
+properties), `dist/docusaurus.css` (`--ifm-*` mapping), `dist/fonts/*.css` with the woff2
+files, and `dist/sites.js` (registry + `hwioFooterSites()`). Zero runtime dependencies.

package/dist/docusaurus.css

@@ -0,0 +1,29 @@
+/* Generated from brand.json by @hubpav/hwio-brand: Infima variables for the Docusaurus sites. */
+:root {
+  --ifm-color-primary: #e30427;
+  --ifm-color-primary-dark: #cc0423;
+  --ifm-color-primary-darker: #c10321;
+  --ifm-color-primary-darkest: #aa031d;
+  --ifm-color-primary-light: #e61d3d;
+  --ifm-color-primary-lighter: #e72a47;
+  --ifm-color-primary-lightest: #eb4f68;
+  --ifm-color-secondary: #016ad4;
+  --ifm-font-family-base: 'Inter', 'Inter Fallback', ui-sans-serif, system-ui, sans-serif;
+  --ifm-font-color-base: #252532;
+  --ifm-background-color: #ffffff;
+  --ifm-code-font-size: 95%;
+  --hwio-color-ink: #252532;
+  --hwio-color-muted: #5c5f70;
+}
+[data-theme='dark'] {
+  --ifm-color-primary: #f43f5e;
+  --ifm-color-primary-dark: #dc3955;
+  --ifm-color-primary-darker: #cf3650;
+  --ifm-color-primary-darkest: #b72f47;
+  --ifm-color-primary-light: #f5526e;
+  --ifm-color-primary-lighter: #f65c76;
+  --ifm-color-primary-lightest: #f7798e;
+  --ifm-background-color: #0f0f14;
+  --ifm-background-surface-color: #1a1a22;
+  --ifm-font-color-base: #e7e7ee;
+}

package/dist/fonts/inter.css

@@ -0,0 +1,25 @@
+/* Generated from brand.json. Owner ruling R3 (2026-09-05): font-display block; the pre-paint gate (HWioFontGate) keeps text invisible until the face decodes. Files live at /fonts/ in every site. */
+@font-face {
+  font-family: 'Inter';
+  font-style: normal;
+  font-weight: 100 900;
+  font-display: block;
+  src: url('/fonts/inter-latin.woff2') format('woff2-variations');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+@font-face {
+  font-family: 'Inter';
+  font-style: normal;
+  font-weight: 100 900;
+  font-display: block;
+  src: url('/fonts/inter-latin-ext.woff2') format('woff2-variations');
+  unicode-range: U+0100-02AF, U+0304, U+0308, U+0329, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+@font-face {
+  font-family: 'Inter Fallback';
+  src: local('Arial');
+  size-adjust: 107.40%;
+  ascent-override: 90.20%;
+  descent-override: 22.48%;
+  line-gap-override: 0%;
+}

package/dist/fonts/poppins.css

@@ -0,0 +1,54 @@
+/* Generated from brand.json. Owner ruling R3 (2026-09-05): font-display block; the pre-paint gate (HWioFontGate) keeps text invisible until the face decodes. Files live at /fonts/ in every site. */
+@font-face {
+  font-family: 'Poppins';
+  font-style: normal;
+  font-weight: 400;
+  font-display: block;
+  src: url('/fonts/poppins-400-latin.woff2') format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+@font-face {
+  font-family: 'Poppins';
+  font-style: normal;
+  font-weight: 400;
+  font-display: block;
+  src: url('/fonts/poppins-400-latin-ext.woff2') format('woff2');
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+@font-face {
+  font-family: 'Poppins';
+  font-style: normal;
+  font-weight: 600;
+  font-display: block;
+  src: url('/fonts/poppins-600-latin.woff2') format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+@font-face {
+  font-family: 'Poppins';
+  font-style: normal;
+  font-weight: 600;
+  font-display: block;
+  src: url('/fonts/poppins-600-latin-ext.woff2') format('woff2');
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+@font-face {
+  font-family: 'Poppins';
+  font-style: normal;
+  font-weight: 700;
+  font-display: block;
+  src: url('/fonts/poppins-700-latin.woff2') format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+@font-face {
+  font-family: 'Poppins';
+  font-style: normal;
+  font-weight: 700;
+  font-display: block;
+  src: url('/fonts/poppins-700-latin-ext.woff2') format('woff2');
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+@font-face {
+  font-family: 'Poppins Fallback';
+  src: local('Arial');
+  size-adjust: 112%;
+}

package/dist/sites-data.js

@@ -0,0 +1,5 @@
+// Generated from brand.json.
+export const sites = [{"key":"www","label":"HARDWARIO.com","url":"https://www.hardwario.com","locales":["en","cs","de","sk","pl"],"defaultLocale":"en","theme":"hwio","layout":"hub","strip":{"show":true,"omit":[]},"gtm":"GTM-WGV5D8TM"},{"key":"docs","label":"Docs","url":"https://docs.hardwario.com","locales":["en","cs"],"defaultLocale":"en","theme":"hwio","layout":"hub","strip":{"show":true,"omit":[]},"gtm":null},{"key":"engineering","label":"HARDWARIO Engineering","url":"https://hardwario.engineering","locales":["en","cs","de","sk","pl"],"defaultLocale":"en","theme":"hwio","layout":"landing","strip":{"show":false,"omit":[]},"gtm":"GTM-TD83PT2D"},{"key":"studio","label":"HARDWARIO Studio","url":"https://hardwario.studio","locales":["en","cs","de","sk","pl"],"defaultLocale":"en","theme":"hwio","layout":"landing","strip":{"show":true,"omit":[]},"gtm":"GTM-PCNXBGDF"},{"key":"academy","label":"HARDWARIO Academy","url":"https://hardwario.academy","locales":["en","cs","de","sk","pl"],"defaultLocale":"en","theme":"hwio","layout":"landing","strip":{"show":true,"omit":["docs","stem"]},"gtm":"GTM-P723ZJGL"},{"key":"stem","label":"HARDWARIO STEM","url":"https://stem.hardwario.com","locales":["en","cs"],"defaultLocale":"en","theme":"hwio","layout":"hub","strip":{"show":true,"omit":[]},"gtm":null},{"key":"energy","label":"energeticky.report","url":"https://energeticky.report","locales":["cs","en"],"defaultLocale":"cs","theme":"hwio","layout":"landing","strip":{"show":false,"omit":[]},"gtm":null},{"key":"facility","label":"facility.report","url":"https://facility.report","locales":["en","cs"],"defaultLocale":"en","theme":"hwio","layout":"landing","strip":{"show":false,"omit":[]},"gtm":null},{"key":"factory","label":"factory.report","url":"https://factory.report","locales":["en","cs"],"defaultLocale":"en","theme":"hwio","layout":"landing","strip":{"show":false,"omit":[]},"gtm":null},{"key":"forestry","label":"forestry.report","url":"https://forestry.report","locales":["en","cs"],"defaultLocale":"en","theme":"hwio-forestry","layout":"landing","strip":{"show":false,"omit":[]},"gtm":null},{"key":"enerooo","label":"ENEROOO","url":"https://www.enerooo.cz","locales":["cs"],"defaultLocale":"cs","theme":"er3o","layout":"hub","strip":{"show":false,"omit":[]},"gtm":null}];
+export const footerSites = {"order":["www","docs","engineering","studio","academy","stem"],"labels":{"www":"HARDWARIO.com","docs":"Docs","engineering":"Engineering","studio":"Studio","academy":"Academy","stem":"STEM"}};
+export const social = {"linkedin":"https://www.linkedin.com/company/13187032","x":{"cs":"https://x.com/hardwario_cz","default":"https://x.com/hardwario_en"},"instagram":"https://www.instagram.com/hardwario/","youtube":"https://www.youtube.com/c/hardwario","github":"https://github.com/hardwario","forum":"https://forum.hardwario.com"};
+export const branches = [{"name":"HARDWARIO a.s.","country":"cz","mapUrl":"https://maps.app.goo.gl/uwNsT2fuUmTaoXc48"},{"name":"HARDWARIO LLC","country":"us","mapUrl":"https://maps.app.goo.gl/YyUsBivFKc6yYVTr8"},{"name":"HARDWARIO LTD","country":"uk","mapUrl":"https://maps.app.goo.gl/BPVS4T61Ao1h5HVJ9"}];

package/dist/sites.d.ts

@@ -0,0 +1,21 @@
+export interface HWioSite {
+  key: string;
+  label: string;
+  url: string;
+  locales: string[];
+  defaultLocale: string;
+  theme: string;
+  layout: 'hub' | 'landing';
+  strip: { show: boolean; omit: string[] };
+  gtm: string | null;
+}
+export interface HWioFooterSite { key: string; label: string; href: string }
+export const sites: HWioSite[];
+export const footerSites: { order: string[]; labels: Record<string, string> };
+export const social: Record<string, string | Record<string, string>>;
+export const branches: { name: string; country: string; mapUrl: string }[];
+export function hwioSite(key: string): HWioSite;
+export function hwioSiteUrl(key: string, locale: string): string;
+export function hwioFooterSites(input: { self: string; locale: string }): HWioFooterSite[];
+export function hwioFooterSitesHtml(input: { self: string; locale: string; label: string }): string;
+export function hwioSocialX(locale: string): string;

package/dist/sites.js

@@ -0,0 +1,43 @@
+// Sites registry and the cross-site footer strip rules (owner rulings in website-admin
+// AGENTS.md: fixed order, self omitted, engineering carries no strip, academy omits Docs
+// and STEM until the TOWER docs migrate, .report pages and enerooo carry none).
+import { sites, footerSites, social, branches } from './sites-data.js';
+
+export { sites, footerSites, social, branches };
+
+export function hwioSite(key) {
+  const site = sites.find((s) => s.key === key);
+  if (!site) throw new Error(`unknown site key: ${key}`);
+  return site;
+}
+
+/** Localised URL of a family site for a given locale (root for its default locale, /<lang>/ otherwise). */
+export function hwioSiteUrl(key, locale) {
+  const site = hwioSite(key);
+  const lang = site.locales.includes(locale) ? locale : site.defaultLocale;
+  return lang === site.defaultLocale ? `${site.url}/` : `${site.url}/${lang}/`;
+}
+
+/** The footer strip entries a site should render, or an empty array when it carries none. */
+export function hwioFooterSites({ self, locale }) {
+  const site = hwioSite(self);
+  if (!site.strip.show) return [];
+  return footerSites.order
+    .filter((key) => key !== self && !site.strip.omit.includes(key))
+    .map((key) => ({ key, label: footerSites.labels[key], href: hwioSiteUrl(key, locale) }));
+}
+
+/** Docusaurus footers take an HTML string; this renders the same strip for them. */
+export function hwioFooterSitesHtml({ self, locale, label }) {
+  const items = hwioFooterSites({ self, locale });
+  if (!items.length) return '';
+  const links = items
+    .map((s) => `<a href="${s.href}" target="_blank" rel="noopener noreferrer">${s.label}</a>`)
+    .join('<span aria-hidden="true"> · </span>');
+  return `<nav aria-label="${label}"><span class="footer-sites-label">${label}:</span> ${links}</nav>`;
+}
+
+/** X (Twitter) account by locale: CS → hardwario_cz, everything else → hardwario_en. */
+export function hwioSocialX(locale) {
+  return social.x[locale] ?? social.x.default;
+}