diff --git a/public/og/wiring-table-on-the-slots.png b/public/og/wiring-table-on-the-slots.png new file mode 100644 index 00000000..3e3ec87a Binary files /dev/null and b/public/og/wiring-table-on-the-slots.png differ diff --git a/social/facebook/wiring-table-on-the-slots/README.md b/social/facebook/wiring-table-on-the-slots/README.md new file mode 100644 index 00000000..85dc2af2 --- /dev/null +++ b/social/facebook/wiring-table-on-the-slots/README.md @@ -0,0 +1,130 @@ +# LinkedIn Square Post (1200x1200) + +Standard LinkedIn feed post at 1:1 square aspect ratio. Works well as a scroll-stopping image in the LinkedIn feed. + +## Usage + +```bash +brand-gen init social/linkedin-post my-post +cd my-post +# edit content.md +brand-gen build # -> index.html +brand-gen image # -> my-post.png (2400x2400 at 2x DPR) +``` + +## Directives + +All templates use one of four post types. Each uses the same directive pattern: + +### Quote + +```markdown +::::post{type=quote theme=dark logo=top-left} + +:::quote{author="Filip Sajdak" role="Founder & CEO, ScudoAI"} + +Sovereign AI is not a feature you bolt on later. It is the architecture. + +::: + +:::: +``` + +### Stat + +```markdown +::::post{type=stat theme=light accent=brand} + +:::stat{value="USD 80B" label="Worldwide sovereign cloud spend" context="Europe is the fastest-growing region at 83% YoY." source="Gartner, Feb 2026"} +::: + +:::: +``` + +### Announcement + +```markdown +::::post{type=announcement theme=light} + +:::announcement{kind="launch" date="April 2026"} + +# ScudoAI joins NVIDIA Inception + +We are thrilled to join the NVIDIA Inception program to accelerate sovereign AI deployment across European regulated industries. + +::: + +:::: +``` + +### Insight + +```markdown +::::post{type=insight theme=dark} + +:::insight{citation="EU AI Act full enforcement: 2 August 2026"} + +# The AI compliance deadline most companies are missing + +Full EU AI Act enforcement for high-risk AI systems begins in 2 August 2026. Most regulated enterprises are not ready for the documentation and audit requirements. Teams running cloud AI will face the hardest transition. + +::: + +:::: +``` + +## Attributes reference + +### `::::post` attributes + +- `type` - quote | stat | announcement | insight (required) +- `theme` - dark | light (default light) +- `accent` - brand | amber | nv (optional colored gradient background) +- `logo` - top-left | top-right | bottom-left | bottom-right (default bottom-right) + +### `:::quote` attributes + +- `author` - attribution name (appears below the quote) +- `role` - attribution role/title (appears under the author) + +### `:::stat` attributes + +- `value` - the big number (e.g. "USD 80B", "3/4", "Hours to minutes") +- `label` - short label under the value +- `context` - 1-2 sentences providing context +- `source` - small citation + +### `:::announcement` attributes + +- `kind` - launch | milestone | event | hire | partnership +- `date` - free-form date string + +### `:::insight` attributes + +- `citation` - small footer citation (e.g. regulation reference) + +## Character limits + +- **Quote body**: ~120 characters for maximum readability at thumbnail size +- **Stat label**: ~40 characters +- **Stat context**: ~200 characters +- **Announcement headline**: ~80 characters +- **Announcement body**: ~250 characters +- **Insight hook**: ~100 characters +- **Insight body**: ~300 characters + +Posts that exceed these limits will still render but typography may shrink or content may clip. + +## Media + +Add a `media/` directory to the project and reference local files: + +```markdown +:::background{image="nvidia-thor.jpg" overlay="dark"} +::: + +:::image{src="product-screenshot.png" alt="ScudoAI compliance dashboard" position="top"} +::: +``` + +Paths are relative to the project's `media/` directory. diff --git a/social/facebook/wiring-table-on-the-slots/assets/brand-kit.json b/social/facebook/wiring-table-on-the-slots/assets/brand-kit.json new file mode 100644 index 00000000..2cb70930 --- /dev/null +++ b/social/facebook/wiring-table-on-the-slots/assets/brand-kit.json @@ -0,0 +1,11 @@ +{ + "template": "social/linkedin-post", + "bundleSource": "scudoai-social.css", + "brandKitVersion": "0.1.0", + "vendoredAt": "2026-11-17T20:38:45.307Z", + "files": [ + "scudoai.css", + "layout.css", + "logo-symbol.svg" + ] +} diff --git a/social/facebook/wiring-table-on-the-slots/assets/layout.css b/social/facebook/wiring-table-on-the-slots/assets/layout.css new file mode 100644 index 00000000..e69de29b diff --git a/social/facebook/wiring-table-on-the-slots/assets/logo-symbol.svg b/social/facebook/wiring-table-on-the-slots/assets/logo-symbol.svg new file mode 100644 index 00000000..1fc44966 --- /dev/null +++ b/social/facebook/wiring-table-on-the-slots/assets/logo-symbol.svg @@ -0,0 +1,22 @@ + diff --git a/social/facebook/wiring-table-on-the-slots/assets/scudoai.css b/social/facebook/wiring-table-on-the-slots/assets/scudoai.css new file mode 100644 index 00000000..612b5a12 --- /dev/null +++ b/social/facebook/wiring-table-on-the-slots/assets/scudoai.css @@ -0,0 +1,343 @@ +/* ============================================================ + * wro.cpp social card -- standalone stylesheet + * + * Self-contained styling for brand-gen's `social/linkedin-post` + * output. Replaces (does NOT extend) the scudoai-social.css that + * brand-gen ships with -- the design language here is the + * wro.cpp 'Editorial Magnet' look used by src/styles/global.css, + * not the scudoai blue-indigo deck aesthetic. + * + * Source of truth for tokens: src/styles/global.css:12-30 in the + * wrocpp.github.io repo. + * + * Brand-gen markup we style: + *
+ *
(decorative, hidden) + *
(decorative, hidden) + *
+ *

...

+ *

...

+ *
...
+ *
+ *
+ * + * ScudoAI (hidden; replaced via ::after) + *
+ *
+ * + * Other card types (card-quote, card-stat, card-announcement) + * get analogous rules at the bottom. + * ============================================================ */ + +@import url('https://fonts.googleapis.com/css2?family=Quicksand:wght@400;500;600;700&family=Source+Serif+4:ital,opsz,wght@0,8..60,400;0,8..60,600;1,8..60,400&family=JetBrains+Mono:wght@400;500;700&display=swap'); + +:root { + --paper: #FCFAF5; + --paper-2: #F3EFE6; + --paper-3: #E8E1D0; + --ink: #1B1B1D; + --ink-muted:#55555A; + --ink-faint:#8A8A90; + --rule: #D7D2C4; + --orange: #EA541E; + --orange-2: #D6481A; + --blue: #3EB5E9; + --blue-deep:#2E8FB8; + + --font-display: 'Quicksand', system-ui, -apple-system, sans-serif; + --font-body: 'Source Serif 4', Georgia, serif; + --font-mono: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, monospace; +} + +html, body { + margin: 0; + padding: 0; + background: var(--paper); + color: var(--ink); + -webkit-font-smoothing: antialiased; + -moz-osx-font-smoothing: grayscale; + font-family: var(--font-body); + font-size: 18px; + line-height: 1.6; +} + +/* Hide brand-gen decorative noise -- the wro.cpp aesthetic is calm + * and editorial, not a dark deck with glow + grid backgrounds. */ +.grid-bg, .glow { display: none !important; } + +/* ---------------- Card frame (1200x1200) ---------------- */ +.card { + position: relative; + width: 1200px; + height: 1200px; + background: var(--paper); + /* Faint warm radial wash, mirrors body { background-image } in + * src/styles/global.css:44-49 -- gives the paper texture without + * looking flat. */ + background-image: + radial-gradient(900px 700px at 80% -10%, rgba(234, 84, 30, 0.06), transparent 60%), + radial-gradient(800px 600px at -10% 110%, rgba(62, 181, 233, 0.05), transparent 60%); + overflow: hidden; + box-sizing: border-box; + padding: 130px 110px 130px 110px; + display: flex; + flex-direction: column; + /* Faint inner border gives the card a printed-page feel. */ + border-bottom: 6px solid var(--orange); +} + +/* Override: theme=dark cards still use paper. We keep the editorial + * light look across the board so the wro.cpp brand stays consistent. + * If the user really wants a dark variant later, this is the hook. */ +.card.dark { background: var(--paper) !important; color: var(--ink) !important; } +.card.dark h1, .card.dark h2, .card.dark p, +.card.dark blockquote { color: var(--ink) !important; } + +/* ---------------- INSIGHT card ---------------- */ +.card-insight { + justify-content: center; + padding-top: 200px; /* reserve space for logo watermark (top:90px + 64px + safety) */ +} +.card-insight .insight-content { + display: flex; + flex-direction: column; + gap: 60px; + max-width: 980px; +} +.card-insight h1 { + font-family: var(--font-display); + font-weight: 700; + font-size: 92pt; + line-height: 1.02; + letter-spacing: -0.025em; + color: var(--ink); + margin: 0; +} +.card-insight h1.title-long { + font-size: 72pt; + line-height: 1.06; + letter-spacing: -0.02em; + max-height: 420px; +} +.card-insight h1.title-xlong { + font-size: 56pt; + line-height: 1.10; + letter-spacing: -0.015em; + max-height: 440px; +} +/* Auto-accent: ++ in C++/C++26 turns orange, sentence-final period + * (when wrapped in ) turns blue. The skill writes + * the heading with these spans for the wro.cpp signature look. */ +.card-insight h1 .accent { color: var(--orange); } +.card-insight h1 .dot { color: var(--blue-deep); } +.card-insight p { + font-family: var(--font-body); + font-size: 30pt; + line-height: 1.5; + color: var(--ink-muted); + margin: 0; + max-width: 920px; +} +.card-insight .insight-citation { + font-family: var(--font-mono); + font-size: 18pt; + letter-spacing: 0.04em; + color: var(--ink-faint); + margin-top: 40px; + padding-top: 30px; + border-top: 1px solid var(--rule); + text-transform: lowercase; +} +.card-insight .insight-citation::before { + content: '// '; + color: var(--orange); + font-weight: 700; +} + +/* ---------------- QUOTE card ---------------- */ +.card-quote { justify-content: center; padding: 140px 110px; } +.card-quote .quote-content { display: flex; flex-direction: column; align-items: flex-start; } +.card-quote .quote-mark { + font-family: var(--font-display); + font-weight: 700; + font-size: 200pt; + line-height: 0.8; + color: var(--orange); + opacity: 0.20; + /* In-flow above the text (not floated in the corner) with a negative + * bottom margin so the mark nearly touches the first quote line. */ + margin: 0 0 -0.62em; +} +.card-quote .quote-body { + font-family: var(--font-display); + font-weight: 600; + font-size: 64pt; + line-height: 1.15; + letter-spacing: -0.02em; + color: var(--ink); + max-width: 980px; + margin: 0; +} +.card-quote .quote-attribution { + margin-top: 50px; + font-family: var(--font-mono); + font-size: 18pt; + color: var(--ink-muted); +} +.card-quote .quote-attribution::before { content: '-- '; color: var(--orange); } +/* author and role are adjacent spans with no separator in the markup; + * add one so they do not run together ("wro.cppC++26 ..."). */ +.card-quote .quote-attribution .role::before { content: ' / '; color: var(--ink-faint); } + +/* ---------------- STAT card ---------------- */ +.card-stat { justify-content: center; } +/* Value and label sit side by side (label wraps to stacked lines whose + * combined height roughly matches the value); context + source span the + * full width underneath. */ +.card-stat .stat-content { + display: grid; + grid-template-columns: auto 1fr; + grid-template-areas: + "value label" + "context context" + "source source"; + column-gap: 64px; + align-items: center; +} +.card-stat .stat-value { + grid-area: value; + font-family: var(--font-display); + font-weight: 700; + font-size: 240pt; + line-height: 0.82; + letter-spacing: -0.04em; + color: var(--orange); + margin: 0; +} +.card-stat .stat-label { + grid-area: label; + font-family: var(--font-display); + font-weight: 700; + font-size: 90pt; + line-height: 1.0; + letter-spacing: -0.02em; + color: var(--ink); + /* min-content forces a per-word wrap, so "codegen steps" stacks into + * two lines next to the value instead of running on one long line. */ + width: min-content; + margin: 0; +} +.card-stat .stat-context { + grid-area: context; + font-family: var(--font-body); + font-size: 26pt; + line-height: 1.45; + color: var(--ink-muted); + margin: 56px 0 0; + max-width: 880px; +} +.card-stat .stat-source { + grid-area: source; + margin-top: 44px; + font-family: var(--font-mono); + font-size: 18pt; + color: var(--ink-faint); +} +.card-stat .stat-source::before { content: '// '; color: var(--orange); } + +/* ---------------- ANNOUNCEMENT card ---------------- */ +.card-announcement { justify-content: center; } +.card-announcement .announcement-meta { + font-family: var(--font-mono); + font-size: 20pt; + text-transform: uppercase; + letter-spacing: 0.08em; + color: var(--orange); + margin-bottom: 30px; +} +.card-announcement .announcement-content h1, +.card-announcement .announcement-content h2 { + font-family: var(--font-display); + font-weight: 700; + font-size: 78pt; + line-height: 1.05; + letter-spacing: -0.02em; + color: var(--ink); + margin: 0; +} +.card-announcement .announcement-content p { + font-family: var(--font-body); + font-size: 28pt; + line-height: 1.5; + color: var(--ink-muted); + margin: 40px 0 0; + max-width: 900px; +} + +/* ---------------- LOGO WATERMARK ---------------- */ +/* brand-gen hard-codes "ScudoAI" in .logo-wordmark; we hide it and + * draw "wro.cpp" via ::after on the watermark. The orange ".cpp" mirrors + * the brand-mark in the site header. */ +.logo-watermark { + position: absolute; + display: flex; + align-items: center; + gap: 18px; + height: 64px; + z-index: 10; + color: var(--ink); +} +.logo-watermark.top-left { top: 90px; left: 110px; } +.logo-watermark.top-right { top: 90px; right: 110px; } +.logo-watermark.bottom-left { bottom: 60px; left: 110px; } +.logo-watermark.bottom-right { bottom: 60px; right: 110px; } +.logo-watermark svg { + width: 64px; + height: 64px; + flex-shrink: 0; + /* Magnet logo PNG already has transparent paper-tone background; + * no rounded box needed -- it sits on the paper card directly. */ +} +.logo-wordmark { + font-size: 0 !important; + line-height: 0 !important; + /* Hide the upstream "ScudoAI" text node entirely. */ +} +.logo-watermark::after { + content: 'wro.cpp'; + font-family: var(--font-display); + font-weight: 700; + font-size: 28pt; + letter-spacing: -0.025em; + color: var(--ink); + line-height: 1; + /* The .cpp portion is given orange via a ::first-line trick below + * isn't reliable for inline -- so the SKILL writes the wordmark + * with explicit spans when it owns the markup. For this default + * rendering, the whole wordmark is ink and the orange comes through + * the bottom border + eyebrow. */ +} +.logo-watermark.top-right::after, +.logo-watermark.bottom-right::after { order: -1; margin-right: 18px; } + +/* ---------------- AI DISCLOSURE BADGE ---------------- */ +/* A small, honest "AI-GENERATED" label so the disclosure rides with the + * card image on social. Bottom-right corner (logo is top-left, citation is + * center-bottom, so this corner is free). Injected into index.html by + * inject.sh. See the /ai policy page. */ +.ai-badge { + position: absolute; + bottom: 74px; /* clears the 6px orange accent bar; sits in the bottom padding band */ + right: 110px; /* matches the card side padding / logo inset */ + z-index: 10; + font-family: var(--font-mono); + font-size: 14pt; + font-weight: 500; + letter-spacing: 0.10em; + text-transform: uppercase; + color: var(--ink-faint); +} + +/* ---------------- Defensive overrides ---------------- */ +/* Anything brand-gen might have set inline using its tokens. */ +* { box-sizing: border-box; } diff --git a/social/facebook/wiring-table-on-the-slots/caption.md b/social/facebook/wiring-table-on-the-slots/caption.md new file mode 100644 index 00000000..cb492996 --- /dev/null +++ b/social/facebook/wiring-table-on-the-slots/caption.md @@ -0,0 +1,16 @@ +# Reading a signal-to-slot wiring table from annotations on the slots + +## Body +Leonardo Rossi's LinkedIn post lists a class's signal-to-slot connections once, as a tuple of member pointers. Can the list sit on the slots instead? On GCC 16.2 it can: 3 annotations replace a tuple of 3 pairs, and a static_assert checks the table. The tuple is shorter, 17 lines against 59, and works with Qt today. My signal type is not Qt. + +https://wrocpp.github.io/posts/wiring-table-on-the-slots/ + +## Hashtags +#cpp #cpp26 #reflection #wrocpp + +## Alt-text +wro.cpp card with the magnet logo. Headline reads "Put the wiring table on the slots" with a subtitle about three annotations replacing a tuple of three pairs, a static_assert on the table, and a signal type that is not Qt. Citation footer: wro.cpp, 2026-12-24. + +## Suggested post time +Thursday 2026-12-24, 08:00 UTC +Reason: the morning slot on the publication day; the second post of a pair, after the one of 23 December. diff --git a/social/facebook/wiring-table-on-the-slots/config.yaml b/social/facebook/wiring-table-on-the-slots/config.yaml new file mode 100644 index 00000000..3b148eae --- /dev/null +++ b/social/facebook/wiring-table-on-the-slots/config.yaml @@ -0,0 +1,12 @@ +template: social/linkedin-post + +size: + width: 1200 + height: 1200 + dpr: 2 + +project: + name: "wiring-table-on-the-slots" + author: "Filip Sajdak, Founder & CEO" + email: "office@scudoai.com" + date: "2026-12-24" diff --git a/social/facebook/wiring-table-on-the-slots/content.md b/social/facebook/wiring-table-on-the-slots/content.md new file mode 100644 index 00000000..b069c84c --- /dev/null +++ b/social/facebook/wiring-table-on-the-slots/content.md @@ -0,0 +1,12 @@ +--- +template: social/linkedin-post +--- + +::::post{type=insight theme=dark logo=top-left} + +:::insight{citation="wro.cpp -- 2026-12-24"} +# Put the wiring table on the slots +Three annotations replace a tuple of three pairs on GCC 16.2, and a static_assert checks the table. The tuple stays shorter. The signal type is not Qt. +::: + +:::: diff --git a/social/facebook/wiring-table-on-the-slots/image.png b/social/facebook/wiring-table-on-the-slots/image.png new file mode 100644 index 00000000..59334032 Binary files /dev/null and b/social/facebook/wiring-table-on-the-slots/image.png differ diff --git a/social/facebook/wiring-table-on-the-slots/index.html b/social/facebook/wiring-table-on-the-slots/index.html new file mode 100644 index 00000000..ae237a09 --- /dev/null +++ b/social/facebook/wiring-table-on-the-slots/index.html @@ -0,0 +1,28 @@ + + + + + + wiring-table-on-the-slots + + + + + + + + + + +

Put the wiring table on the slots

Three annotations replace a tuple of three pairs on GCC 16.2, and a static_assert checks the table. The tuple stays shorter. The signal type is not Qt.

wro.cpp -- 2026-12-24
ScudoAI
AI-generated
+ + \ No newline at end of file diff --git a/social/facebook/wiring-table-on-the-slots/media/.gitkeep b/social/facebook/wiring-table-on-the-slots/media/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/social/facebook/wiring-table-on-the-slots/media/README.md b/social/facebook/wiring-table-on-the-slots/media/README.md new file mode 100644 index 00000000..bb81c7fa --- /dev/null +++ b/social/facebook/wiring-table-on-the-slots/media/README.md @@ -0,0 +1,9 @@ +# Media directory + +Drop images here (PNG, JPG, SVG) for use in your post. + +Reference them in your content.md with: + + :::image{src="screenshot.png" alt="Alt text" position="top"} + +The renderer resolves paths relative to this media/ directory. diff --git a/social/linkedin/wiring-table-on-the-slots/README.md b/social/linkedin/wiring-table-on-the-slots/README.md new file mode 100644 index 00000000..85dc2af2 --- /dev/null +++ b/social/linkedin/wiring-table-on-the-slots/README.md @@ -0,0 +1,130 @@ +# LinkedIn Square Post (1200x1200) + +Standard LinkedIn feed post at 1:1 square aspect ratio. Works well as a scroll-stopping image in the LinkedIn feed. + +## Usage + +```bash +brand-gen init social/linkedin-post my-post +cd my-post +# edit content.md +brand-gen build # -> index.html +brand-gen image # -> my-post.png (2400x2400 at 2x DPR) +``` + +## Directives + +All templates use one of four post types. Each uses the same directive pattern: + +### Quote + +```markdown +::::post{type=quote theme=dark logo=top-left} + +:::quote{author="Filip Sajdak" role="Founder & CEO, ScudoAI"} + +Sovereign AI is not a feature you bolt on later. It is the architecture. + +::: + +:::: +``` + +### Stat + +```markdown +::::post{type=stat theme=light accent=brand} + +:::stat{value="USD 80B" label="Worldwide sovereign cloud spend" context="Europe is the fastest-growing region at 83% YoY." source="Gartner, Feb 2026"} +::: + +:::: +``` + +### Announcement + +```markdown +::::post{type=announcement theme=light} + +:::announcement{kind="launch" date="April 2026"} + +# ScudoAI joins NVIDIA Inception + +We are thrilled to join the NVIDIA Inception program to accelerate sovereign AI deployment across European regulated industries. + +::: + +:::: +``` + +### Insight + +```markdown +::::post{type=insight theme=dark} + +:::insight{citation="EU AI Act full enforcement: 2 August 2026"} + +# The AI compliance deadline most companies are missing + +Full EU AI Act enforcement for high-risk AI systems begins in 2 August 2026. Most regulated enterprises are not ready for the documentation and audit requirements. Teams running cloud AI will face the hardest transition. + +::: + +:::: +``` + +## Attributes reference + +### `::::post` attributes + +- `type` - quote | stat | announcement | insight (required) +- `theme` - dark | light (default light) +- `accent` - brand | amber | nv (optional colored gradient background) +- `logo` - top-left | top-right | bottom-left | bottom-right (default bottom-right) + +### `:::quote` attributes + +- `author` - attribution name (appears below the quote) +- `role` - attribution role/title (appears under the author) + +### `:::stat` attributes + +- `value` - the big number (e.g. "USD 80B", "3/4", "Hours to minutes") +- `label` - short label under the value +- `context` - 1-2 sentences providing context +- `source` - small citation + +### `:::announcement` attributes + +- `kind` - launch | milestone | event | hire | partnership +- `date` - free-form date string + +### `:::insight` attributes + +- `citation` - small footer citation (e.g. regulation reference) + +## Character limits + +- **Quote body**: ~120 characters for maximum readability at thumbnail size +- **Stat label**: ~40 characters +- **Stat context**: ~200 characters +- **Announcement headline**: ~80 characters +- **Announcement body**: ~250 characters +- **Insight hook**: ~100 characters +- **Insight body**: ~300 characters + +Posts that exceed these limits will still render but typography may shrink or content may clip. + +## Media + +Add a `media/` directory to the project and reference local files: + +```markdown +:::background{image="nvidia-thor.jpg" overlay="dark"} +::: + +:::image{src="product-screenshot.png" alt="ScudoAI compliance dashboard" position="top"} +::: +``` + +Paths are relative to the project's `media/` directory. diff --git a/social/linkedin/wiring-table-on-the-slots/assets/brand-kit.json b/social/linkedin/wiring-table-on-the-slots/assets/brand-kit.json new file mode 100644 index 00000000..eb504c0d --- /dev/null +++ b/social/linkedin/wiring-table-on-the-slots/assets/brand-kit.json @@ -0,0 +1,11 @@ +{ + "template": "social/linkedin-post", + "bundleSource": "scudoai-social.css", + "brandKitVersion": "0.1.0", + "vendoredAt": "2026-11-17T20:38:45.218Z", + "files": [ + "scudoai.css", + "layout.css", + "logo-symbol.svg" + ] +} diff --git a/social/linkedin/wiring-table-on-the-slots/assets/layout.css b/social/linkedin/wiring-table-on-the-slots/assets/layout.css new file mode 100644 index 00000000..e69de29b diff --git a/social/linkedin/wiring-table-on-the-slots/assets/logo-symbol.svg b/social/linkedin/wiring-table-on-the-slots/assets/logo-symbol.svg new file mode 100644 index 00000000..1fc44966 --- /dev/null +++ b/social/linkedin/wiring-table-on-the-slots/assets/logo-symbol.svg @@ -0,0 +1,22 @@ + diff --git a/social/linkedin/wiring-table-on-the-slots/assets/scudoai.css b/social/linkedin/wiring-table-on-the-slots/assets/scudoai.css new file mode 100644 index 00000000..612b5a12 --- /dev/null +++ b/social/linkedin/wiring-table-on-the-slots/assets/scudoai.css @@ -0,0 +1,343 @@ +/* ============================================================ + * wro.cpp social card -- standalone stylesheet + * + * Self-contained styling for brand-gen's `social/linkedin-post` + * output. Replaces (does NOT extend) the scudoai-social.css that + * brand-gen ships with -- the design language here is the + * wro.cpp 'Editorial Magnet' look used by src/styles/global.css, + * not the scudoai blue-indigo deck aesthetic. + * + * Source of truth for tokens: src/styles/global.css:12-30 in the + * wrocpp.github.io repo. + * + * Brand-gen markup we style: + *
+ *
(decorative, hidden) + *
(decorative, hidden) + *
+ *

...

+ *

...

+ *
...
+ *
+ *
+ * + * ScudoAI (hidden; replaced via ::after) + *
+ *
+ * + * Other card types (card-quote, card-stat, card-announcement) + * get analogous rules at the bottom. + * ============================================================ */ + +@import url('https://fonts.googleapis.com/css2?family=Quicksand:wght@400;500;600;700&family=Source+Serif+4:ital,opsz,wght@0,8..60,400;0,8..60,600;1,8..60,400&family=JetBrains+Mono:wght@400;500;700&display=swap'); + +:root { + --paper: #FCFAF5; + --paper-2: #F3EFE6; + --paper-3: #E8E1D0; + --ink: #1B1B1D; + --ink-muted:#55555A; + --ink-faint:#8A8A90; + --rule: #D7D2C4; + --orange: #EA541E; + --orange-2: #D6481A; + --blue: #3EB5E9; + --blue-deep:#2E8FB8; + + --font-display: 'Quicksand', system-ui, -apple-system, sans-serif; + --font-body: 'Source Serif 4', Georgia, serif; + --font-mono: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, monospace; +} + +html, body { + margin: 0; + padding: 0; + background: var(--paper); + color: var(--ink); + -webkit-font-smoothing: antialiased; + -moz-osx-font-smoothing: grayscale; + font-family: var(--font-body); + font-size: 18px; + line-height: 1.6; +} + +/* Hide brand-gen decorative noise -- the wro.cpp aesthetic is calm + * and editorial, not a dark deck with glow + grid backgrounds. */ +.grid-bg, .glow { display: none !important; } + +/* ---------------- Card frame (1200x1200) ---------------- */ +.card { + position: relative; + width: 1200px; + height: 1200px; + background: var(--paper); + /* Faint warm radial wash, mirrors body { background-image } in + * src/styles/global.css:44-49 -- gives the paper texture without + * looking flat. */ + background-image: + radial-gradient(900px 700px at 80% -10%, rgba(234, 84, 30, 0.06), transparent 60%), + radial-gradient(800px 600px at -10% 110%, rgba(62, 181, 233, 0.05), transparent 60%); + overflow: hidden; + box-sizing: border-box; + padding: 130px 110px 130px 110px; + display: flex; + flex-direction: column; + /* Faint inner border gives the card a printed-page feel. */ + border-bottom: 6px solid var(--orange); +} + +/* Override: theme=dark cards still use paper. We keep the editorial + * light look across the board so the wro.cpp brand stays consistent. + * If the user really wants a dark variant later, this is the hook. */ +.card.dark { background: var(--paper) !important; color: var(--ink) !important; } +.card.dark h1, .card.dark h2, .card.dark p, +.card.dark blockquote { color: var(--ink) !important; } + +/* ---------------- INSIGHT card ---------------- */ +.card-insight { + justify-content: center; + padding-top: 200px; /* reserve space for logo watermark (top:90px + 64px + safety) */ +} +.card-insight .insight-content { + display: flex; + flex-direction: column; + gap: 60px; + max-width: 980px; +} +.card-insight h1 { + font-family: var(--font-display); + font-weight: 700; + font-size: 92pt; + line-height: 1.02; + letter-spacing: -0.025em; + color: var(--ink); + margin: 0; +} +.card-insight h1.title-long { + font-size: 72pt; + line-height: 1.06; + letter-spacing: -0.02em; + max-height: 420px; +} +.card-insight h1.title-xlong { + font-size: 56pt; + line-height: 1.10; + letter-spacing: -0.015em; + max-height: 440px; +} +/* Auto-accent: ++ in C++/C++26 turns orange, sentence-final period + * (when wrapped in ) turns blue. The skill writes + * the heading with these spans for the wro.cpp signature look. */ +.card-insight h1 .accent { color: var(--orange); } +.card-insight h1 .dot { color: var(--blue-deep); } +.card-insight p { + font-family: var(--font-body); + font-size: 30pt; + line-height: 1.5; + color: var(--ink-muted); + margin: 0; + max-width: 920px; +} +.card-insight .insight-citation { + font-family: var(--font-mono); + font-size: 18pt; + letter-spacing: 0.04em; + color: var(--ink-faint); + margin-top: 40px; + padding-top: 30px; + border-top: 1px solid var(--rule); + text-transform: lowercase; +} +.card-insight .insight-citation::before { + content: '// '; + color: var(--orange); + font-weight: 700; +} + +/* ---------------- QUOTE card ---------------- */ +.card-quote { justify-content: center; padding: 140px 110px; } +.card-quote .quote-content { display: flex; flex-direction: column; align-items: flex-start; } +.card-quote .quote-mark { + font-family: var(--font-display); + font-weight: 700; + font-size: 200pt; + line-height: 0.8; + color: var(--orange); + opacity: 0.20; + /* In-flow above the text (not floated in the corner) with a negative + * bottom margin so the mark nearly touches the first quote line. */ + margin: 0 0 -0.62em; +} +.card-quote .quote-body { + font-family: var(--font-display); + font-weight: 600; + font-size: 64pt; + line-height: 1.15; + letter-spacing: -0.02em; + color: var(--ink); + max-width: 980px; + margin: 0; +} +.card-quote .quote-attribution { + margin-top: 50px; + font-family: var(--font-mono); + font-size: 18pt; + color: var(--ink-muted); +} +.card-quote .quote-attribution::before { content: '-- '; color: var(--orange); } +/* author and role are adjacent spans with no separator in the markup; + * add one so they do not run together ("wro.cppC++26 ..."). */ +.card-quote .quote-attribution .role::before { content: ' / '; color: var(--ink-faint); } + +/* ---------------- STAT card ---------------- */ +.card-stat { justify-content: center; } +/* Value and label sit side by side (label wraps to stacked lines whose + * combined height roughly matches the value); context + source span the + * full width underneath. */ +.card-stat .stat-content { + display: grid; + grid-template-columns: auto 1fr; + grid-template-areas: + "value label" + "context context" + "source source"; + column-gap: 64px; + align-items: center; +} +.card-stat .stat-value { + grid-area: value; + font-family: var(--font-display); + font-weight: 700; + font-size: 240pt; + line-height: 0.82; + letter-spacing: -0.04em; + color: var(--orange); + margin: 0; +} +.card-stat .stat-label { + grid-area: label; + font-family: var(--font-display); + font-weight: 700; + font-size: 90pt; + line-height: 1.0; + letter-spacing: -0.02em; + color: var(--ink); + /* min-content forces a per-word wrap, so "codegen steps" stacks into + * two lines next to the value instead of running on one long line. */ + width: min-content; + margin: 0; +} +.card-stat .stat-context { + grid-area: context; + font-family: var(--font-body); + font-size: 26pt; + line-height: 1.45; + color: var(--ink-muted); + margin: 56px 0 0; + max-width: 880px; +} +.card-stat .stat-source { + grid-area: source; + margin-top: 44px; + font-family: var(--font-mono); + font-size: 18pt; + color: var(--ink-faint); +} +.card-stat .stat-source::before { content: '// '; color: var(--orange); } + +/* ---------------- ANNOUNCEMENT card ---------------- */ +.card-announcement { justify-content: center; } +.card-announcement .announcement-meta { + font-family: var(--font-mono); + font-size: 20pt; + text-transform: uppercase; + letter-spacing: 0.08em; + color: var(--orange); + margin-bottom: 30px; +} +.card-announcement .announcement-content h1, +.card-announcement .announcement-content h2 { + font-family: var(--font-display); + font-weight: 700; + font-size: 78pt; + line-height: 1.05; + letter-spacing: -0.02em; + color: var(--ink); + margin: 0; +} +.card-announcement .announcement-content p { + font-family: var(--font-body); + font-size: 28pt; + line-height: 1.5; + color: var(--ink-muted); + margin: 40px 0 0; + max-width: 900px; +} + +/* ---------------- LOGO WATERMARK ---------------- */ +/* brand-gen hard-codes "ScudoAI" in .logo-wordmark; we hide it and + * draw "wro.cpp" via ::after on the watermark. The orange ".cpp" mirrors + * the brand-mark in the site header. */ +.logo-watermark { + position: absolute; + display: flex; + align-items: center; + gap: 18px; + height: 64px; + z-index: 10; + color: var(--ink); +} +.logo-watermark.top-left { top: 90px; left: 110px; } +.logo-watermark.top-right { top: 90px; right: 110px; } +.logo-watermark.bottom-left { bottom: 60px; left: 110px; } +.logo-watermark.bottom-right { bottom: 60px; right: 110px; } +.logo-watermark svg { + width: 64px; + height: 64px; + flex-shrink: 0; + /* Magnet logo PNG already has transparent paper-tone background; + * no rounded box needed -- it sits on the paper card directly. */ +} +.logo-wordmark { + font-size: 0 !important; + line-height: 0 !important; + /* Hide the upstream "ScudoAI" text node entirely. */ +} +.logo-watermark::after { + content: 'wro.cpp'; + font-family: var(--font-display); + font-weight: 700; + font-size: 28pt; + letter-spacing: -0.025em; + color: var(--ink); + line-height: 1; + /* The .cpp portion is given orange via a ::first-line trick below + * isn't reliable for inline -- so the SKILL writes the wordmark + * with explicit spans when it owns the markup. For this default + * rendering, the whole wordmark is ink and the orange comes through + * the bottom border + eyebrow. */ +} +.logo-watermark.top-right::after, +.logo-watermark.bottom-right::after { order: -1; margin-right: 18px; } + +/* ---------------- AI DISCLOSURE BADGE ---------------- */ +/* A small, honest "AI-GENERATED" label so the disclosure rides with the + * card image on social. Bottom-right corner (logo is top-left, citation is + * center-bottom, so this corner is free). Injected into index.html by + * inject.sh. See the /ai policy page. */ +.ai-badge { + position: absolute; + bottom: 74px; /* clears the 6px orange accent bar; sits in the bottom padding band */ + right: 110px; /* matches the card side padding / logo inset */ + z-index: 10; + font-family: var(--font-mono); + font-size: 14pt; + font-weight: 500; + letter-spacing: 0.10em; + text-transform: uppercase; + color: var(--ink-faint); +} + +/* ---------------- Defensive overrides ---------------- */ +/* Anything brand-gen might have set inline using its tokens. */ +* { box-sizing: border-box; } diff --git a/social/linkedin/wiring-table-on-the-slots/caption.md b/social/linkedin/wiring-table-on-the-slots/caption.md new file mode 100644 index 00000000..3f2f54bd --- /dev/null +++ b/social/linkedin/wiring-table-on-the-slots/caption.md @@ -0,0 +1,20 @@ +# Reading a signal-to-slot wiring table from annotations on the slots + +## Body +Leonardo Rossi wrote a LinkedIn post on a clean way to wire signals to slots: a class lists its connections once, as a tuple of pairs of member pointers, and one function connects or disconnects all of them. I asked whether the list can sit on the slots instead. + +On GCC 16.2 it can. Three annotations on the slots replace the tuple of three pairs, reflection collects them into a table, and template for connects or disconnects each edge. A static_assert over the table catches a slot with other argument types than the signal, an annotation that names something that is not a signal of Step, and a repeated edge. The same source also built on GCC trunk and on the Bloomberg clang fork. + +The tuple is not the loser. It is 17 lines against 59 for the reusable annotated part, it needs no checks because the member pointers are typed, and it works in C++17 with Qt today. The signal type in my example is a small one of my own: this is not Qt, and I did not run Qt's connect. An annotation is also checked only when something walks it. + +https://wrocpp.github.io/posts/wiring-table-on-the-slots/ + +## Hashtags +#cpp #cpp26 #reflection #annotations #qt #signals #wrocpp + +## Alt-text +wro.cpp card with the magnet logo. Headline reads "Put the wiring table on the slots" with a subtitle about three annotations replacing a tuple of three pairs, a static_assert on the table, and a signal type that is not Qt. Citation footer: wro.cpp, 2026-12-24. + +## Suggested post time +Thursday 2026-12-24, 08:00 UTC +Reason: the morning slot on the publication day; the second post of a pair on a LinkedIn post about fold expressions and signal wiring, after the one of 23 December. diff --git a/social/linkedin/wiring-table-on-the-slots/config.yaml b/social/linkedin/wiring-table-on-the-slots/config.yaml new file mode 100644 index 00000000..3b148eae --- /dev/null +++ b/social/linkedin/wiring-table-on-the-slots/config.yaml @@ -0,0 +1,12 @@ +template: social/linkedin-post + +size: + width: 1200 + height: 1200 + dpr: 2 + +project: + name: "wiring-table-on-the-slots" + author: "Filip Sajdak, Founder & CEO" + email: "office@scudoai.com" + date: "2026-12-24" diff --git a/social/linkedin/wiring-table-on-the-slots/content.md b/social/linkedin/wiring-table-on-the-slots/content.md new file mode 100644 index 00000000..b069c84c --- /dev/null +++ b/social/linkedin/wiring-table-on-the-slots/content.md @@ -0,0 +1,12 @@ +--- +template: social/linkedin-post +--- + +::::post{type=insight theme=dark logo=top-left} + +:::insight{citation="wro.cpp -- 2026-12-24"} +# Put the wiring table on the slots +Three annotations replace a tuple of three pairs on GCC 16.2, and a static_assert checks the table. The tuple stays shorter. The signal type is not Qt. +::: + +:::: diff --git a/social/linkedin/wiring-table-on-the-slots/image.png b/social/linkedin/wiring-table-on-the-slots/image.png new file mode 100644 index 00000000..3e3ec87a Binary files /dev/null and b/social/linkedin/wiring-table-on-the-slots/image.png differ diff --git a/social/linkedin/wiring-table-on-the-slots/index.html b/social/linkedin/wiring-table-on-the-slots/index.html new file mode 100644 index 00000000..ae237a09 --- /dev/null +++ b/social/linkedin/wiring-table-on-the-slots/index.html @@ -0,0 +1,28 @@ + + + + + + wiring-table-on-the-slots + + + + + + + + + + +

Put the wiring table on the slots

Three annotations replace a tuple of three pairs on GCC 16.2, and a static_assert checks the table. The tuple stays shorter. The signal type is not Qt.

wro.cpp -- 2026-12-24
ScudoAI
AI-generated
+ + \ No newline at end of file diff --git a/social/linkedin/wiring-table-on-the-slots/media/.gitkeep b/social/linkedin/wiring-table-on-the-slots/media/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/social/linkedin/wiring-table-on-the-slots/media/README.md b/social/linkedin/wiring-table-on-the-slots/media/README.md new file mode 100644 index 00000000..bb81c7fa --- /dev/null +++ b/social/linkedin/wiring-table-on-the-slots/media/README.md @@ -0,0 +1,9 @@ +# Media directory + +Drop images here (PNG, JPG, SVG) for use in your post. + +Reference them in your content.md with: + + :::image{src="screenshot.png" alt="Alt text" position="top"} + +The renderer resolves paths relative to this media/ directory. diff --git a/src/content/posts/2026-12-24-wiring-table-on-the-slots.mdx b/src/content/posts/2026-12-24-wiring-table-on-the-slots.mdx new file mode 100644 index 00000000..52bfed23 --- /dev/null +++ b/src/content/posts/2026-12-24-wiring-table-on-the-slots.mdx @@ -0,0 +1,113 @@ +--- +title: "Reading a signal-to-slot wiring table from annotations on the slots" +slug: "wiring-table-on-the-slots" +pubDate: 2026-12-24 +author: filip-sajdak +language: en +kind: flagship +audience: working-cpp +tags: [cpp, cpp26, reflection, annotations, signals, qt, gcc] +summary: "A class can list its signal-to-slot connections once, as a tuple of member pointers, or as annotations on the slots that reflection reads back. On GCC 16.2 a table of 3 connections is built, checked by static_assert and connected and disconnected, with one source that also builds on GCC trunk and the Bloomberg clang fork. The tuple is 17 lines and needs no checks. This is not Qt." +draft: false +relatedPosts: [annotations, template-for-expansion-statements, qt-metaobject-from-reflection, annotate-a-class-get-a-generator] +--- + +import GodboltEmbed from '../../components/GodboltEmbed.astro'; +import PostLink from '../../components/PostLink.astro'; + +Leonardo Rossi {/* LINK: Leonardo Rossi LinkedIn post, URL from the user */} wrote a LinkedIn post on wiring signals to slots in a Qt code base. The class lists its connections once, and one function connects or disconnects all of them. Can the list sit on the slots themselves? On GCC 16.2 it can: 3 annotations replace a tuple of 3 pairs. A `static_assert` over the generated table adds a check the tuple does not need. The signal type is a small one of my own. This is not Qt, and I did not run Qt's `connect`. + +## In short + +- The outside design keeps a `static constexpr auto wiring()` that returns a tuple of pairs of member pointers. A `toggleWiring` walks it with `std::apply` and a comma fold. In my file that is 17 lines, and it works in C++17. +- The alternative puts `[[=on{^^Step::failed}]]` on each slot. Reflection collects the annotated slots into a table of edges, and `template for` connects or disconnects each one. +- The reusable part of the annotated form is 59 lines, 24 of them checks. A new slot costs one line in the tuple and no extra line with annotations. +- The checks catch a slot with other argument types than the signal, a name that is not a signal of `Step`, and a repeated edge. One signal on two slots is two connections. +- One source ran on GCC 16.2, GCC trunk and the Bloomberg clang fork. An annotation is checked only when something walks it. + +## The tuple version, credited and kept + +The outside post lists the connections once, as pairs of a signal and a slot. A `toggleWiring` function applies one function to every pair. Here is my version of it, over the signal type of the example: + +```cpp +static constexpr auto wiring() { + return std::make_tuple(std::pair{&Step::failed, &ProcedureTuple::onStepFailed}, + std::pair{&Step::timedOut, &ProcedureTuple::onStepTimedOut}, + std::pair{&Step::succeeded, &ProcedureTuple::onStepSucceeded}); +} +``` + +One table serves two directions, because the same list connects and disconnects. Every pointer is typed, so a slot with the wrong arguments or a misspelled name is an error where the pair is written. It needs no library beyond C++17, and it works with Qt today. Nothing below makes it wrong. + +The cost sits in the maintenance. The slot and its row are two places. Rename a slot and the compiler finds the row. Add a slot and nothing tells you to add one. + +## The same table, on the slots + +With reflection the row moves onto the function it describes: + +```cpp +struct Procedure { + [[=on{^^Step::failed}]] void onStepFailed(int) { ++failures; } + [[=on{^^Step::timedOut}]] void onStepTimedOut(int) { ++timeouts; } + [[=on{^^Step::succeeded}]] void onStepSucceeded() { ++successes; } + void helper() {} // no annotation: not wired +}; +``` + +The annotation type `on` holds one reflection value. A consteval function walks the members of the class and collects an edge for each annotation of type `on`. The annotations post introduces the feature, and the `template for` post the loop used below. A slot can carry several annotations, and each one is an edge. + +```cpp +template +void toggleWiring(Step& step, Owner& owner) { + static_assert(table_is_valid(), "a wiring annotation names something that is not a signal of Step, ..."); + template for (constexpr Edge edge : table_of) { + if constexpr (Enable) step.[:edge.signal:].connect(&owner, &[:edge.slot:]); + else step.[:edge.signal:].disconnect(&owner, &[:edge.slot:]); + } +} +``` + +The signals in the file are data members of type `Signal`, a vector of connections that I wrote for the example. Qt's signals are member functions, so a real version splices a member function pointer instead. The program fires every signal before the connect, after it and after the disconnect: + +```text +before connect: tuple=0 annotated=0 +after connect: tuple=1/1/1 annotated=1/1/1 fanout=3 +after disconnect: connections=0 tuple=1/1/1 annotated=1/1/1 fanout=3 +``` + +Nothing is called before the connect and nothing after the disconnect. Both forms run in the same program, 2026-11-17, `-std=c++26 -freflection -Wall -Wextra`, with no warnings. + + + +## What each form costs + +| | tuple | annotations | +|---|---|---| +| lines for the table and its toggle | 17 | 59, once per project | +| lines that check the table | 0, the types do it | 24 | +| extra lines per slot | 1 | 0 | +| a wrong slot signature | error where the pair is written | `static_assert` at the first toggle | +| a slot that is never listed | silent | silent, if it has no annotation | + +The annotated form is longer, and most of the length is the checks that the typed tuple gets for free. It pays when a class has many slots, or when the table must be read by other code. The same annotations can drive a generator, a logger or a test, as in the generator post. + +## What the compiler says about the mistakes + +Three small consteval functions do the checks. The annotation must name a non-static data member of `Step`, the slot must take exactly the signal's argument types, and no edge may repeat. I broke `Procedure` five ways and compiled each on GCC 16.2 and the fork. + +- Three mistakes give the assertion message. A slot may take `double` for an `int` signal. An annotation may name the type `Step`, or a member of another class. GCC prints `error: static assertion failed: a wiring annotation names something that is not a signal of Step, repeats an edge, ...`, and the fork prints the same text. The message does not say which slot. +- Without the check, the `double` slot gives this on GCC 16.2: `no matching function for call to 'wiring::Signal::connect(wiring::Procedure*, void (wiring::Procedure::*)(double))'`. It names the types and not the annotation. +- A typo such as `^^Step::failled` is an ordinary lookup error at once: `'wiring::Step::failled' has not been declared`. +- The same edge twice on one slot fails the size assertion (`the comparison reduces to '(4 == 3)'`) and the validity check. + +One signal on two slots is not an error. The `Fanout` class in the file has `failed` on two slots, and the table has 3 edges, asserted. That is two connections, as in the tuple. + +## One source on two implementations + +The fork has no `std::meta::annotations_of_with_type`, and GCC 16.2 does. A loop over `annotations_of` works on both. It compares the annotation's type, with `remove_const` applied, to `^^on`. Without the `remove_const`, GCC 16.2 found no annotations and the table had size 0, while the fork found them. I did not print the type, so the `const` is my inference. The built file, with the options `-std=c++26 -freflection-latest -stdlib=libc++` on the fork, printed the same four lines. + +## Limits + +An annotation is checked only when something walks it. A program with `[[=on{^^Step}]]` and no walk compiled and ran on both compilers. The `static_assert` runs at the first `toggleWiring`, so a class that is never toggled is never checked. The example puts a `static_assert` on the table right after each class. + +The file wires one class in one translation unit. A slot in a base class, a signal in another class than `Step`, compile time and Qt's `connect` were not tried. For a real `QMetaObject` built by reflection, see a QMetaObject that stock Qt accepts. The examples are in [the examples repository](https://github.com/wrocpp/cpp26-reflection-examples/tree/5d48fde/posts/134-wiring-table-by-reflection). The post before this one, on folds, pack indexing and `template for`, covers the other half of the outside post.