stylegallery 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (346) hide show
  1. package/AGENTS.md +156 -0
  2. package/CATALOG.md +69 -0
  3. package/DOMAINS.md +65 -0
  4. package/GOVERNANCE.md +222 -0
  5. package/GUIDE.md +59 -0
  6. package/README.md +313 -0
  7. package/consumer-reference/adapters/style-dictionary.config.mjs +36 -0
  8. package/consumer-reference/agent-native/README.md +157 -0
  9. package/consumer-reference/agent-native/registry.json +640 -0
  10. package/consumer-reference/agent-native/schema/agent-native.schema.json +848 -0
  11. package/consumer-reference/agent-native/schema/epistemic.schema.json +14 -0
  12. package/consumer-reference/agent-native/schema/execution.schema.json +12 -0
  13. package/consumer-reference/agent-native/schema/identity.schema.json +10 -0
  14. package/consumer-reference/agent-native/schema/learning.schema.json +12 -0
  15. package/consumer-reference/agent-native/schema/manifest.schema.json +6 -0
  16. package/consumer-reference/agent-native/schema/operation.schema.json +12 -0
  17. package/consumer-reference/agent-native/schema/protocol-binding.schema.json +9 -0
  18. package/consumer-reference/agent-native/schema/retrieval.schema.json +10 -0
  19. package/consumer-reference/baselines/calibration.json +260 -0
  20. package/consumer-reference/baselines/manifest.json +21 -0
  21. package/consumer-reference/contract.md +83 -0
  22. package/consumer-reference/fixtures/consumer-conformance/e2e-fixture.mjs +282 -0
  23. package/consumer-reference/fixtures/consumer-conformance/manifest.json +102 -0
  24. package/consumer-reference/fixtures/consumer-conformance/runtime-proof.mjs +32 -0
  25. package/consumer-reference/fixtures/consumer-conformance/valid-migration-result.json +18 -0
  26. package/consumer-reference/fixtures/consumer-conformance/valid-migration.json +142 -0
  27. package/consumer-reference/fixtures/invalid-stable-ended-support.json +19 -0
  28. package/consumer-reference/fixtures/promotion/invalid-blocking-evidence.json +26 -0
  29. package/consumer-reference/fixtures/promotion/invalid-count-only.json +29 -0
  30. package/consumer-reference/fixtures/promotion/invalid-missing-owner-migration.json +25 -0
  31. package/consumer-reference/fixtures/promotion/invalid-normative-bypass-no-regression.json +25 -0
  32. package/consumer-reference/fixtures/promotion/invalid-related-counted-independent.json +45 -0
  33. package/consumer-reference/fixtures/promotion/invalid-stable-ended-support.json +26 -0
  34. package/consumer-reference/fixtures/promotion/manifest.json +15 -0
  35. package/consumer-reference/fixtures/promotion/valid-deferred-example.json +67 -0
  36. package/consumer-reference/fixtures/promotion/valid-normative-bypass.json +67 -0
  37. package/consumer-reference/fixtures/token-portability/invalid-cycle.json +7 -0
  38. package/consumer-reference/fixtures/token-portability/invalid-dangling-alias.json +6 -0
  39. package/consumer-reference/fixtures/token-portability/invalid-extends.json +4 -0
  40. package/consumer-reference/fixtures/token-portability/invalid-json-pointer.json +7 -0
  41. package/consumer-reference/fixtures/token-portability/invalid-resolver.json +9 -0
  42. package/consumer-reference/fixtures/token-portability/invalid-type-mismatch.json +10 -0
  43. package/consumer-reference/fixtures/token-portability/invalid-unknown-reserved.json +6 -0
  44. package/consumer-reference/fixtures/token-portability/invalid-untested-type.json +6 -0
  45. package/consumer-reference/fixtures/token-portability/valid-border.json +14 -0
  46. package/consumer-reference/fixtures/token-portability/valid-reference.json +32 -0
  47. package/consumer-reference/fixtures/token-portability/valid-whole-alias.json +7 -0
  48. package/consumer-reference/fixtures/valid-deprecated.json +21 -0
  49. package/consumer-reference/fixtures/valid-experimental.json +19 -0
  50. package/consumer-reference/generated/manifest.json +40 -0
  51. package/consumer-reference/generated/tokens.css +12 -0
  52. package/consumer-reference/index.md +32 -0
  53. package/consumer-reference/policies/shared-experimental.json +37 -0
  54. package/consumer-reference/schema/ax-evidence.schema.json +30 -0
  55. package/consumer-reference/schema/baseline-manifest.schema.json +55 -0
  56. package/consumer-reference/schema/calibration-record.schema.json +190 -0
  57. package/consumer-reference/schema/capture-session.schema.json +161 -0
  58. package/consumer-reference/schema/component-state.schema.json +150 -0
  59. package/consumer-reference/schema/consumer-conformance-record.schema.json +365 -0
  60. package/consumer-reference/schema/dom-evidence.schema.json +38 -0
  61. package/consumer-reference/schema/evidence-record.schema.json +81 -0
  62. package/consumer-reference/schema/fixture-manifest.schema.json +32 -0
  63. package/consumer-reference/schema/item.schema.json +188 -0
  64. package/consumer-reference/schema/page-evidence-manifest.schema.json +216 -0
  65. package/consumer-reference/schema/page-evidence-session.schema.json +119 -0
  66. package/consumer-reference/schema/portable-tokens.schema.json +104 -0
  67. package/consumer-reference/schema/promotion-rfc.schema.json +219 -0
  68. package/consumer-reference/schema/runtime-evidence-manifest.schema.json +33 -0
  69. package/consumer-reference/schema/visual-evidence.schema.json +31 -0
  70. package/design-engineering/consumer-migration-readiness.md +124 -0
  71. package/design-engineering/index.md +28 -0
  72. package/design-engineering/interface-craft.md +107 -0
  73. package/design-engineering/reference-profiles/external-adaptation/index.md +12 -0
  74. package/design-engineering/reference-profiles/governed-local/editorial/components/button.component.json +125 -0
  75. package/design-engineering/reference-profiles/governed-local/editorial/evidence/button.evidence.json +3504 -0
  76. package/design-engineering/reference-profiles/governed-local/editorial/fixtures/button.fixture.json +65 -0
  77. package/design-engineering/reference-profiles/governed-local/editorial/generated/evidence-coverage.md +23 -0
  78. package/design-engineering/reference-profiles/governed-local/editorial/generated/keyboard-matrix.md +19 -0
  79. package/design-engineering/reference-profiles/governed-local/editorial/generated/state-matrix.md +21 -0
  80. package/design-engineering/reference-profiles/governed-local/editorial/local-foundations.json +12 -0
  81. package/design-engineering/reference-profiles/governed-local/editorial/profile.json +43 -0
  82. package/design-engineering/reference-profiles/governed-local/editorial/states/button.states.json +195 -0
  83. package/design-engineering/reference-profiles/governed-local/editorial/tokens.dtcg.json +17 -0
  84. package/design-engineering/reference-profiles/governed-local/index.md +26 -0
  85. package/design-engineering/reference-profiles/governed-local/terminal/components/button.component.json +125 -0
  86. package/design-engineering/reference-profiles/governed-local/terminal/evidence/button.evidence.json +3504 -0
  87. package/design-engineering/reference-profiles/governed-local/terminal/fixtures/button.fixture.json +65 -0
  88. package/design-engineering/reference-profiles/governed-local/terminal/generated/evidence-coverage.md +23 -0
  89. package/design-engineering/reference-profiles/governed-local/terminal/generated/keyboard-matrix.md +19 -0
  90. package/design-engineering/reference-profiles/governed-local/terminal/generated/state-matrix.md +21 -0
  91. package/design-engineering/reference-profiles/governed-local/terminal/local-foundations.json +12 -0
  92. package/design-engineering/reference-profiles/governed-local/terminal/profile.json +43 -0
  93. package/design-engineering/reference-profiles/governed-local/terminal/states/button.states.json +195 -0
  94. package/design-engineering/reference-profiles/governed-local/terminal/tokens.dtcg.json +17 -0
  95. package/design-engineering/reference-profiles/index.md +19 -0
  96. package/game-ui/classification.md +82 -0
  97. package/game-ui/index.md +35 -0
  98. package/game-ui/reference-record.md +62 -0
  99. package/game-ui/screen-hierarchy.md +107 -0
  100. package/game-ui/unity/architecture.md +166 -0
  101. package/game-ui/unity/cli-loop.md +84 -0
  102. package/game-ui/unity/data/unity-technologies-public-repositories.json +26654 -0
  103. package/game-ui/unity/org-wiki.md +146 -0
  104. package/game-ui/unity/repository-map.md +102 -0
  105. package/game-ui/unity/ui-systems.md +85 -0
  106. package/guides/decision-tree.md +149 -0
  107. package/guides/documentation-mode-taxonomy.md +157 -0
  108. package/guides/layout-brief.md +220 -0
  109. package/guides/vocabulary.md +148 -0
  110. package/guides/webpage-generation-workflow.md +185 -0
  111. package/index.md +36 -0
  112. package/layout/index.md +26 -0
  113. package/motion/index.md +24 -0
  114. package/motion/practice-reference.md +145 -0
  115. package/motion/review-workflow.md +86 -0
  116. package/motion/vocabulary.md +82 -0
  117. package/package.json +78 -0
  118. package/patterns/centering/center.md +87 -0
  119. package/patterns/centering/index.md +6 -0
  120. package/patterns/centering/super-center.md +89 -0
  121. package/patterns/containment/box.md +87 -0
  122. package/patterns/containment/clamped-card.md +86 -0
  123. package/patterns/containment/content-limiter.md +87 -0
  124. package/patterns/containment/fluid-styles.md +86 -0
  125. package/patterns/containment/index.md +8 -0
  126. package/patterns/grid-repetition/card-grid.md +88 -0
  127. package/patterns/grid-repetition/columns.md +87 -0
  128. package/patterns/grid-repetition/dense-grid.md +88 -0
  129. package/patterns/grid-repetition/grid-wrapper.md +89 -0
  130. package/patterns/grid-repetition/index.md +12 -0
  131. package/patterns/grid-repetition/masonry-approx.md +87 -0
  132. package/patterns/grid-repetition/page-grid.md +90 -0
  133. package/patterns/grid-repetition/ram-grid.md +88 -0
  134. package/patterns/grid-repetition/twelve-span-grid.md +92 -0
  135. package/patterns/in-line-grouping/badge-list.md +94 -0
  136. package/patterns/in-line-grouping/breadcrumb.md +89 -0
  137. package/patterns/in-line-grouping/cluster.md +89 -0
  138. package/patterns/in-line-grouping/deconstructed-pancake.md +92 -0
  139. package/patterns/in-line-grouping/index.md +13 -0
  140. package/patterns/in-line-grouping/pagination.md +89 -0
  141. package/patterns/in-line-grouping/reel.md +90 -0
  142. package/patterns/in-line-grouping/split-nav.md +97 -0
  143. package/patterns/in-line-grouping/tab-strip.md +88 -0
  144. package/patterns/in-line-grouping/wrap-row.md +89 -0
  145. package/patterns/index.md +13 -0
  146. package/patterns/media-fit/frame.md +95 -0
  147. package/patterns/media-fit/icon-frame.md +87 -0
  148. package/patterns/media-fit/index.md +6 -0
  149. package/patterns/overlay-exception/imposter.md +95 -0
  150. package/patterns/overlay-exception/index.md +6 -0
  151. package/patterns/overlay-exception/overlay-stack.md +89 -0
  152. package/patterns/split-sidebar/index.md +12 -0
  153. package/patterns/split-sidebar/list-detail.md +95 -0
  154. package/patterns/split-sidebar/main-with-rail.md +95 -0
  155. package/patterns/split-sidebar/media-object.md +102 -0
  156. package/patterns/split-sidebar/sidebar.md +101 -0
  157. package/patterns/split-sidebar/split-screen.md +92 -0
  158. package/patterns/split-sidebar/sticky-aside.md +97 -0
  159. package/patterns/split-sidebar/supporting-pane.md +95 -0
  160. package/patterns/split-sidebar/switcher.md +93 -0
  161. package/patterns/stacking/feed.md +88 -0
  162. package/patterns/stacking/index.md +8 -0
  163. package/patterns/stacking/line-up.md +95 -0
  164. package/patterns/stacking/stack.md +87 -0
  165. package/patterns/stacking/step-nav.md +88 -0
  166. package/patterns/viewport-shell/cover.md +90 -0
  167. package/patterns/viewport-shell/fixed-sidenav-shell.md +97 -0
  168. package/patterns/viewport-shell/holy-grail.md +112 -0
  169. package/patterns/viewport-shell/index.md +11 -0
  170. package/patterns/viewport-shell/panel-layout.md +95 -0
  171. package/patterns/viewport-shell/scroll-body-shell.md +93 -0
  172. package/patterns/viewport-shell/sticky-footer.md +92 -0
  173. package/patterns/viewport-shell/sticky-header.md +86 -0
  174. package/platform-guides/apple-interaction.md +89 -0
  175. package/platform-guides/index.md +26 -0
  176. package/quality/claim-records/index.md +3 -0
  177. package/quality/claim-records/samples.md +92 -0
  178. package/quality/claim-records/stylegallery-multidomain-scope.md +42 -0
  179. package/quality/claims.md +77 -0
  180. package/quality/evidence/accessibility.md +58 -0
  181. package/quality/evidence/consumer-migration.md +42 -0
  182. package/quality/evidence/design-rationale.md +34 -0
  183. package/quality/evidence/executable-evidence.md +79 -0
  184. package/quality/evidence/families.md +56 -0
  185. package/quality/evidence/hci-evaluation.md +36 -0
  186. package/quality/evidence/index.md +16 -0
  187. package/quality/evidence/pattern-contract-audit.md +96 -0
  188. package/quality/evidence/search-metadata-polyhierarchy.md +86 -0
  189. package/quality/evidence/sources.md +43 -0
  190. package/quality/evidence/tokens.md +33 -0
  191. package/quality/evidence/visual-qa.md +41 -0
  192. package/quality/gates/accessibility-evidence.md +60 -0
  193. package/quality/gates/consumer-migration-evidence.md +53 -0
  194. package/quality/gates/design-claim.md +56 -0
  195. package/quality/gates/harmony-evaluation.md +78 -0
  196. package/quality/gates/index.md +13 -0
  197. package/quality/gates/layout.md +52 -0
  198. package/quality/gates/rationale.md +53 -0
  199. package/quality/gates/visual-evidence.md +47 -0
  200. package/quality/index.md +55 -0
  201. package/quality/principles.md +58 -0
  202. package/recipes/article-page.md +52 -0
  203. package/recipes/command-surface.md +55 -0
  204. package/recipes/dashboard.md +56 -0
  205. package/recipes/form-flow.md +55 -0
  206. package/recipes/homepage.md +89 -0
  207. package/recipes/index.md +13 -0
  208. package/recipes/list-detail.md +55 -0
  209. package/recipes/primitive-to-recipe-matrix.md +83 -0
  210. package/recipes/saas-settings.md +52 -0
  211. package/scripts/agent-native/a2a-projection.mjs +248 -0
  212. package/scripts/agent-native/agui-projection.mjs +178 -0
  213. package/scripts/agent-native/canonical-json.mjs +109 -0
  214. package/scripts/agent-native/cli-adapter.mjs +68 -0
  215. package/scripts/agent-native/events.mjs +113 -0
  216. package/scripts/agent-native/execution.mjs +227 -0
  217. package/scripts/agent-native/fixture.mjs +159 -0
  218. package/scripts/agent-native/identity.mjs +184 -0
  219. package/scripts/agent-native/immutable-store.mjs +102 -0
  220. package/scripts/agent-native/knowledge.mjs +168 -0
  221. package/scripts/agent-native/learning-records.mjs +244 -0
  222. package/scripts/agent-native/learning.mjs +247 -0
  223. package/scripts/agent-native/mcp-adapter.mjs +173 -0
  224. package/scripts/agent-native/queries.mjs +173 -0
  225. package/scripts/agent-native/registry.mjs +154 -0
  226. package/scripts/agent-native/retrieval.mjs +171 -0
  227. package/scripts/agent-native/self-description.mjs +160 -0
  228. package/scripts/artifact-metadata.mjs +20 -0
  229. package/scripts/audit-evidence-freshness.mjs +308 -0
  230. package/scripts/baseline-contract.mjs +189 -0
  231. package/scripts/baseline-schema-parity.mjs +40 -0
  232. package/scripts/build-reference-artifacts.mjs +127 -0
  233. package/scripts/calibration-raw-contract.mjs +172 -0
  234. package/scripts/capture-session-contract.mjs +187 -0
  235. package/scripts/component-state-artifact-fixture.mjs +44 -0
  236. package/scripts/component-state-contract.mjs +99 -0
  237. package/scripts/component-state-semantics.mjs +128 -0
  238. package/scripts/component-state-workflow-contract.mjs +67 -0
  239. package/scripts/component-state-workflow-negative-cases.mjs +64 -0
  240. package/scripts/consumer-conformance-contract.mjs +198 -0
  241. package/scripts/consumer-evidence-governance-contract.mjs +210 -0
  242. package/scripts/consumer-reference-case-runner.mjs +93 -0
  243. package/scripts/consumer-reference-schema.mjs +155 -0
  244. package/scripts/create-component-state-session.mjs +100 -0
  245. package/scripts/create-page-evidence-session.mjs +139 -0
  246. package/scripts/domain-document-boundaries.mjs +40 -0
  247. package/scripts/domain-validation-checks.mjs +141 -0
  248. package/scripts/evidence-artifact-contract.mjs +191 -0
  249. package/scripts/finalize-component-state-evidence.mjs +165 -0
  250. package/scripts/finalize-page-evidence.mjs +197 -0
  251. package/scripts/generate-consumer-reference-evidence.mjs +154 -0
  252. package/scripts/generate-patterns.mjs +218 -0
  253. package/scripts/governance-matrix-contract.mjs +73 -0
  254. package/scripts/governance-matrix-negative-cases.mjs +114 -0
  255. package/scripts/governance-policy-contract.mjs +49 -0
  256. package/scripts/governance-test-fixture.mjs +321 -0
  257. package/scripts/governance-workflow-negative-cases.mjs +241 -0
  258. package/scripts/governed-profile-registry.mjs +125 -0
  259. package/scripts/json-schema-formats.mjs +31 -0
  260. package/scripts/markdown-structure.mjs +45 -0
  261. package/scripts/page-artifact-metadata.mjs +124 -0
  262. package/scripts/page-evidence-contract.mjs +297 -0
  263. package/scripts/page-evidence-fixture.mjs +271 -0
  264. package/scripts/pattern-data.mjs +325 -0
  265. package/scripts/profile-record-contract.mjs +140 -0
  266. package/scripts/promotion-attestation-contract.mjs +91 -0
  267. package/scripts/promotion-boundary-test-contract.mjs +92 -0
  268. package/scripts/promotion-fixture-inventory.mjs +109 -0
  269. package/scripts/promotion-governance-contract.mjs +28 -0
  270. package/scripts/reference-artifact-path-contract.mjs +28 -0
  271. package/scripts/reference-profile-contract.mjs +114 -0
  272. package/scripts/reference-token-contract.mjs +156 -0
  273. package/scripts/run-consumer-page-evidence-ci.mjs +170 -0
  274. package/scripts/sg-mcp.mjs +16 -0
  275. package/scripts/sg.mjs +27 -0
  276. package/scripts/strict-json.mjs +72 -0
  277. package/scripts/summarize-sentinel-calibration.mjs +98 -0
  278. package/scripts/test-agent-adapter-conformance.mjs +250 -0
  279. package/scripts/test-agent-conformance-receipt.mjs +106 -0
  280. package/scripts/test-agent-events.mjs +81 -0
  281. package/scripts/test-agent-execution-effects.mjs +114 -0
  282. package/scripts/test-agent-execution-fixtures.mjs +140 -0
  283. package/scripts/test-agent-execution-kernel.mjs +39 -0
  284. package/scripts/test-agent-execution-learning.mjs +130 -0
  285. package/scripts/test-agent-execution-lifecycle.mjs +143 -0
  286. package/scripts/test-agent-execution-safety.mjs +158 -0
  287. package/scripts/test-agent-execution-views.mjs +117 -0
  288. package/scripts/test-agent-identity-integrity-cases.mjs +160 -0
  289. package/scripts/test-agent-knowledge-kernel.mjs +183 -0
  290. package/scripts/test-agent-learning.mjs +246 -0
  291. package/scripts/test-agent-mcp.mjs +246 -0
  292. package/scripts/test-agent-native-schemas.mjs +215 -0
  293. package/scripts/test-agent-projections.mjs +249 -0
  294. package/scripts/test-agent-registry-mcp-integrity.mjs +215 -0
  295. package/scripts/test-agent-registry-mutations.mjs +110 -0
  296. package/scripts/test-audit-evidence-freshness.mjs +177 -0
  297. package/scripts/test-component-state-sentinel.mjs +35 -0
  298. package/scripts/test-component-state-source-contract.mjs +83 -0
  299. package/scripts/test-consumer-conformance-sentinel.mjs +165 -0
  300. package/scripts/test-consumer-reference-sentinel.mjs +31 -0
  301. package/scripts/test-generate-consumer-reference-evidence.mjs +124 -0
  302. package/scripts/test-json-cli-output.mjs +151 -0
  303. package/scripts/test-json-schema-formats.mjs +40 -0
  304. package/scripts/test-reference-adapters.mjs +199 -0
  305. package/scripts/test-renderer-purity.mjs +34 -0
  306. package/scripts/test-sg-cli.mjs +129 -0
  307. package/scripts/test-summarize-sentinel-calibration.mjs +226 -0
  308. package/scripts/test-validate-baseline-manifest.mjs +234 -0
  309. package/scripts/test-validate-component-state-artifacts.mjs +243 -0
  310. package/scripts/test-validate-component-state.mjs +106 -0
  311. package/scripts/test-validate-consumer-conformance.mjs +427 -0
  312. package/scripts/test-validate-consumer-reference-cli.mjs +69 -0
  313. package/scripts/test-validate-consumer-reference.mjs +263 -0
  314. package/scripts/test-validate-domains.mjs +357 -0
  315. package/scripts/test-validate-governance.mjs +292 -0
  316. package/scripts/test-validate-ia.mjs +262 -0
  317. package/scripts/test-validate-okf.mjs +73 -0
  318. package/scripts/test-validate-page-evidence.mjs +302 -0
  319. package/scripts/test-validate-patterns.mjs +157 -0
  320. package/scripts/test-validate-promotion-rfc.mjs +250 -0
  321. package/scripts/test-validate-reference-profiles.mjs +170 -0
  322. package/scripts/test-validate-unity-org-wiki.mjs +57 -0
  323. package/scripts/test-validate-unity-source-contracts.mjs +67 -0
  324. package/scripts/test-validate-vocabulary.mjs +174 -0
  325. package/scripts/test-validate-webpage-workflow.mjs +293 -0
  326. package/scripts/validate-baseline-manifest.mjs +44 -0
  327. package/scripts/validate-catalog.mjs +65 -0
  328. package/scripts/validate-component-state.mjs +141 -0
  329. package/scripts/validate-consumer-conformance.mjs +477 -0
  330. package/scripts/validate-consumer-reference.mjs +288 -0
  331. package/scripts/validate-domains.mjs +237 -0
  332. package/scripts/validate-governance.mjs +248 -0
  333. package/scripts/validate-ia.mjs +136 -0
  334. package/scripts/validate-links.mjs +66 -0
  335. package/scripts/validate-okf.mjs +104 -0
  336. package/scripts/validate-page-evidence.mjs +191 -0
  337. package/scripts/validate-patterns.mjs +246 -0
  338. package/scripts/validate-promotion-rfc.mjs +224 -0
  339. package/scripts/validate-reference-artifacts.mjs +125 -0
  340. package/scripts/validate-renderer-purity.mjs +56 -0
  341. package/scripts/validate-unity-org-wiki.mjs +146 -0
  342. package/scripts/validate-unity-source-contracts.mjs +107 -0
  343. package/scripts/validate-vocabulary.mjs +115 -0
  344. package/scripts/validate-webpage-workflow.mjs +254 -0
  345. package/scripts/visual-expectation-contract.mjs +20 -0
  346. package/scripts/workflow-action-contract.mjs +163 -0
@@ -0,0 +1,88 @@
1
+ ---
2
+ type: Layout Pattern
3
+ name: card-grid
4
+ title: card-grid
5
+ category: Grid / Repetition
6
+ description: Align repeating cards in rows and columns.
7
+ primary_spatial_problem: Align repeating cards in rows and columns.
8
+ secondary_spatial_problems: none
9
+ layout_axis: both
10
+ content_shape: mixed
11
+ responsiveness: fluid
12
+ constraints: Uses only local class hooks and explicit layout constraints.
13
+ scroll_ownership: No internal scroll container.
14
+ source_lineage: https://developer.mozilla.org/en-US/docs/Web/CSS/How_to/Layout_cookbook
15
+ lifecycle: generated
16
+ generated_from: scripts/generate-patterns.mjs, scripts/pattern-data.mjs
17
+ ---
18
+
19
+ <!-- Generated from `scripts/generate-patterns.mjs` and `scripts/pattern-data.mjs`. Do not hand-edit generated catalog or pattern docs; edit the source files and regenerate. -->
20
+
21
+ # card-grid
22
+
23
+ ## When To Use
24
+
25
+ Use this pattern when you need to align repeating cards in rows and columns.
26
+
27
+ ## HTML
28
+
29
+ ```html
30
+ <section class="card_grid" aria-label="Project cards">
31
+ <article>Design audit</article>
32
+ <article>Analytics migration</article>
33
+ <article>Onboarding rewrite</article>
34
+ </section>
35
+ ```
36
+
37
+ ## CSS
38
+
39
+ ```css
40
+ .card_grid {
41
+ display: grid;
42
+ gap: 1rem;
43
+ grid-template-columns: repeat(auto-fit, minmax(min(18rem, 100%), 1fr));
44
+ }
45
+ ```
46
+
47
+ ## Core Properties
48
+
49
+ - `display`, `gap`, `grid-template-columns` define the spatial behavior for this pattern.
50
+
51
+ ## Properties That Break The Layout If Removed
52
+
53
+ - Removing `display`, `gap`, `grid-template-columns` changes the pattern from its documented layout responsibility back toward ordinary flow or an unsafe fixed arrangement.
54
+
55
+ ## Constraints And Change Points
56
+
57
+ - fluid responsiveness is part of the contract; change sizing values only when the new minimum, maximum, or wrap point is documented with the pattern.
58
+ - Keep the HTML class hooks and CSS selectors in one-to-one agreement.
59
+
60
+ ## Scroll Ownership
61
+
62
+ No internal scroll container.
63
+
64
+ ## Accessibility And Source Order Notes
65
+
66
+ - Semantic role expectation: Preserve the HTML sample's landmark, list, navigation, form, figure, or article roles; layout classes must not replace semantic elements.
67
+ - DOM order expectation: Keep semantic elements, DOM order, reading order, and focus order independent from the visual placement created by the layout classes.
68
+ - Focus risk: Any interactive descendants follow DOM order; do not use this pattern to create a visual order that keyboard focus cannot follow.
69
+ - Scroll expectation: No internal scroll container.
70
+ - Cognitive risk: Low: the pattern should preserve ordinary reading flow when semantic order is already correct.
71
+
72
+ ## Browser And Fallback Notes
73
+
74
+ The CSS uses modern grid, flex, intrinsic sizing, logical properties, or positioning. If a target browser cannot support a property, fall back to ordinary block flow before adding decorative or script-driven layout behavior.
75
+
76
+ ## Composition Notes
77
+
78
+ Use `card_grid` as the stable pattern root and compose additional layout behavior outside that root unless the child class is part of the documented relationship.
79
+
80
+ ## Anti-patterns
81
+
82
+ - Do not add color, border, shadow, typography, or animation rules to reusable pattern CSS.
83
+ - Do not use this pattern to repair unclear HTML structure; make the DOM roles legible first.
84
+
85
+ ## IA Navigation
86
+
87
+ Parent: [Grid / Repetition patterns](index.md) in [Pattern Categories](../index.md).
88
+ Next: [Layout Recipes](../../recipes/index.md) for screen-level composition, or return to the [Layout Pattern Catalog](../../CATALOG.md) when choosing another primitive.
@@ -0,0 +1,87 @@
1
+ ---
2
+ type: Layout Pattern
3
+ name: columns
4
+ title: columns
5
+ category: Grid / Repetition
6
+ description: Flow long content into balanced text columns.
7
+ primary_spatial_problem: Flow long content into balanced text columns.
8
+ secondary_spatial_problems: none
9
+ layout_axis: inline
10
+ content_shape: mixed
11
+ responsiveness: fluid
12
+ constraints: Uses only local class hooks and explicit layout constraints.
13
+ scroll_ownership: No internal scroll container.
14
+ source_lineage: https://developer.mozilla.org/en-US/docs/Web/CSS/How_to/Layout_cookbook
15
+ lifecycle: generated
16
+ generated_from: scripts/generate-patterns.mjs, scripts/pattern-data.mjs
17
+ ---
18
+
19
+ <!-- Generated from `scripts/generate-patterns.mjs` and `scripts/pattern-data.mjs`. Do not hand-edit generated catalog or pattern docs; edit the source files and regenerate. -->
20
+
21
+ # columns
22
+
23
+ ## When To Use
24
+
25
+ Use this pattern when you need to flow long content into balanced text columns.
26
+
27
+ ## HTML
28
+
29
+ ```html
30
+ <article class="columns" aria-labelledby="columns-heading">
31
+ <h2 id="columns-heading">Release notes</h2>
32
+ <p>Several short updates can flow into balanced columns when there is room.</p>
33
+ <p>When the container narrows, the same content returns to a single column.</p>
34
+ </article>
35
+ ```
36
+
37
+ ## CSS
38
+
39
+ ```css
40
+ .columns {
41
+ column-gap: 2rem;
42
+ columns: 18rem;
43
+ }
44
+ ```
45
+
46
+ ## Core Properties
47
+
48
+ - `column-gap`, `columns` define the spatial behavior for this pattern.
49
+
50
+ ## Properties That Break The Layout If Removed
51
+
52
+ - Removing `column-gap`, `columns` changes the pattern from its documented layout responsibility back toward ordinary flow or an unsafe fixed arrangement.
53
+
54
+ ## Constraints And Change Points
55
+
56
+ - fluid responsiveness is part of the contract; change sizing values only when the new minimum, maximum, or wrap point is documented with the pattern.
57
+ - Keep the HTML class hooks and CSS selectors in one-to-one agreement.
58
+
59
+ ## Scroll Ownership
60
+
61
+ No internal scroll container.
62
+
63
+ ## Accessibility And Source Order Notes
64
+
65
+ - Semantic role expectation: Preserve the HTML sample's landmark, list, navigation, form, figure, or article roles; layout classes must not replace semantic elements.
66
+ - DOM order expectation: Keep semantic elements, DOM order, reading order, and focus order independent from the visual placement created by the layout classes.
67
+ - Focus risk: Any interactive descendants follow DOM order; do not use this pattern to create a visual order that keyboard focus cannot follow.
68
+ - Scroll expectation: No internal scroll container.
69
+ - Cognitive risk: Low: the pattern should preserve ordinary reading flow when semantic order is already correct.
70
+
71
+ ## Browser And Fallback Notes
72
+
73
+ The CSS uses modern grid, flex, intrinsic sizing, logical properties, or positioning. If a target browser cannot support a property, fall back to ordinary block flow before adding decorative or script-driven layout behavior.
74
+
75
+ ## Composition Notes
76
+
77
+ Use `columns` as the stable pattern root and compose additional layout behavior outside that root unless the child class is part of the documented relationship.
78
+
79
+ ## Anti-patterns
80
+
81
+ - Do not add color, border, shadow, typography, or animation rules to reusable pattern CSS.
82
+ - Do not use this pattern to repair unclear HTML structure; make the DOM roles legible first.
83
+
84
+ ## IA Navigation
85
+
86
+ Parent: [Grid / Repetition patterns](index.md) in [Pattern Categories](../index.md).
87
+ Next: [Layout Recipes](../../recipes/index.md) for screen-level composition, or return to the [Layout Pattern Catalog](../../CATALOG.md) when choosing another primitive.
@@ -0,0 +1,88 @@
1
+ ---
2
+ type: Layout Pattern
3
+ name: dense-grid
4
+ title: dense-grid
5
+ category: Grid / Repetition
6
+ description: Fill a compact grid with repeated small items.
7
+ primary_spatial_problem: Fill a compact grid with repeated small items.
8
+ secondary_spatial_problems: none
9
+ layout_axis: both
10
+ content_shape: mixed
11
+ responsiveness: fluid
12
+ constraints: Uses only local class hooks and explicit layout constraints.
13
+ scroll_ownership: No internal scroll container.
14
+ source_lineage: https://developer.mozilla.org/en-US/docs/Learn_web_development/Core/CSS_layout/Grids
15
+ lifecycle: generated
16
+ generated_from: scripts/generate-patterns.mjs, scripts/pattern-data.mjs
17
+ ---
18
+
19
+ <!-- Generated from `scripts/generate-patterns.mjs` and `scripts/pattern-data.mjs`. Do not hand-edit generated catalog or pattern docs; edit the source files and regenerate. -->
20
+
21
+ # dense-grid
22
+
23
+ ## When To Use
24
+
25
+ Use this pattern when you need to fill a compact grid with repeated small items.
26
+
27
+ ## HTML
28
+
29
+ ```html
30
+ <section class="dense_grid" aria-label="Keyboard shortcuts">
31
+ <kbd>Cmd K</kbd>
32
+ <kbd>Cmd Shift P</kbd>
33
+ <kbd>Esc</kbd>
34
+ </section>
35
+ ```
36
+
37
+ ## CSS
38
+
39
+ ```css
40
+ .dense_grid {
41
+ display: grid;
42
+ gap: 0.5rem;
43
+ grid-template-columns: repeat(auto-fill, minmax(8rem, 1fr));
44
+ }
45
+ ```
46
+
47
+ ## Core Properties
48
+
49
+ - `display`, `gap`, `grid-template-columns` define the spatial behavior for this pattern.
50
+
51
+ ## Properties That Break The Layout If Removed
52
+
53
+ - Removing `display`, `gap`, `grid-template-columns` changes the pattern from its documented layout responsibility back toward ordinary flow or an unsafe fixed arrangement.
54
+
55
+ ## Constraints And Change Points
56
+
57
+ - fluid responsiveness is part of the contract; change sizing values only when the new minimum, maximum, or wrap point is documented with the pattern.
58
+ - Keep the HTML class hooks and CSS selectors in one-to-one agreement.
59
+
60
+ ## Scroll Ownership
61
+
62
+ No internal scroll container.
63
+
64
+ ## Accessibility And Source Order Notes
65
+
66
+ - Semantic role expectation: Preserve the HTML sample's landmark, list, navigation, form, figure, or article roles; layout classes must not replace semantic elements.
67
+ - DOM order expectation: Keep semantic elements, DOM order, reading order, and focus order independent from the visual placement created by the layout classes.
68
+ - Focus risk: Any interactive descendants follow DOM order; do not use this pattern to create a visual order that keyboard focus cannot follow.
69
+ - Scroll expectation: No internal scroll container.
70
+ - Cognitive risk: Low: the pattern should preserve ordinary reading flow when semantic order is already correct.
71
+
72
+ ## Browser And Fallback Notes
73
+
74
+ The CSS uses modern grid, flex, intrinsic sizing, logical properties, or positioning. If a target browser cannot support a property, fall back to ordinary block flow before adding decorative or script-driven layout behavior.
75
+
76
+ ## Composition Notes
77
+
78
+ Use `dense_grid` as the stable pattern root and compose additional layout behavior outside that root unless the child class is part of the documented relationship.
79
+
80
+ ## Anti-patterns
81
+
82
+ - Do not add color, border, shadow, typography, or animation rules to reusable pattern CSS.
83
+ - Do not use this pattern to repair unclear HTML structure; make the DOM roles legible first.
84
+
85
+ ## IA Navigation
86
+
87
+ Parent: [Grid / Repetition patterns](index.md) in [Pattern Categories](../index.md).
88
+ Next: [Layout Recipes](../../recipes/index.md) for screen-level composition, or return to the [Layout Pattern Catalog](../../CATALOG.md) when choosing another primitive.
@@ -0,0 +1,89 @@
1
+ ---
2
+ type: Layout Pattern
3
+ name: grid-wrapper
4
+ title: grid-wrapper
5
+ category: Grid / Repetition
6
+ description: Center grid tracks while allowing full-width breakout tracks.
7
+ primary_spatial_problem: Center grid tracks while allowing full-width breakout tracks.
8
+ secondary_spatial_problems: none
9
+ layout_axis: inline
10
+ content_shape: mixed
11
+ responsiveness: fluid
12
+ constraints: Uses only local class hooks and explicit layout constraints.
13
+ scroll_ownership: No internal scroll container.
14
+ source_lineage: https://developer.mozilla.org/en-US/docs/Web/CSS/How_to/Layout_cookbook
15
+ lifecycle: generated
16
+ generated_from: scripts/generate-patterns.mjs, scripts/pattern-data.mjs
17
+ ---
18
+
19
+ <!-- Generated from `scripts/generate-patterns.mjs` and `scripts/pattern-data.mjs`. Do not hand-edit generated catalog or pattern docs; edit the source files and regenerate. -->
20
+
21
+ # grid-wrapper
22
+
23
+ ## When To Use
24
+
25
+ Use this pattern when you need to center grid tracks while allowing full-width breakout tracks.
26
+
27
+ ## HTML
28
+
29
+ ```html
30
+ <section class="grid_wrapper" aria-label="Marketing page">
31
+ <main class="grid_wrapper_main">Centered campaign copy</main>
32
+ </section>
33
+ ```
34
+
35
+ ## CSS
36
+
37
+ ```css
38
+ .grid_wrapper {
39
+ display: grid;
40
+ grid-template-columns: 1fr minmax(0, 64rem) 1fr;
41
+ }
42
+
43
+ .grid_wrapper_main {
44
+ grid-column: 2;
45
+ }
46
+ ```
47
+
48
+ ## Core Properties
49
+
50
+ - `display`, `grid-template-columns`, `grid-column` define the spatial behavior for this pattern.
51
+
52
+ ## Properties That Break The Layout If Removed
53
+
54
+ - Removing `display`, `grid-template-columns`, `grid-column` changes the pattern from its documented layout responsibility back toward ordinary flow or an unsafe fixed arrangement.
55
+
56
+ ## Constraints And Change Points
57
+
58
+ - fluid responsiveness is part of the contract; change sizing values only when the new minimum, maximum, or wrap point is documented with the pattern.
59
+ - Keep the HTML class hooks and CSS selectors in one-to-one agreement.
60
+
61
+ ## Scroll Ownership
62
+
63
+ No internal scroll container.
64
+
65
+ ## Accessibility And Source Order Notes
66
+
67
+ - Semantic role expectation: Preserve the HTML sample's landmark, list, navigation, form, figure, or article roles; layout classes must not replace semantic elements.
68
+ - DOM order expectation: Keep semantic elements, DOM order, reading order, and focus order independent from the visual placement created by the layout classes.
69
+ - Focus risk: Any interactive descendants follow DOM order; do not use this pattern to create a visual order that keyboard focus cannot follow.
70
+ - Scroll expectation: No internal scroll container.
71
+ - Cognitive risk: Low: the pattern should preserve ordinary reading flow when semantic order is already correct.
72
+
73
+ ## Browser And Fallback Notes
74
+
75
+ The CSS uses modern grid, flex, intrinsic sizing, logical properties, or positioning. If a target browser cannot support a property, fall back to ordinary block flow before adding decorative or script-driven layout behavior.
76
+
77
+ ## Composition Notes
78
+
79
+ Use `grid_wrapper` as the stable pattern root and compose additional layout behavior outside that root unless the child class is part of the documented relationship.
80
+
81
+ ## Anti-patterns
82
+
83
+ - Do not add color, border, shadow, typography, or animation rules to reusable pattern CSS.
84
+ - Do not use this pattern to repair unclear HTML structure; make the DOM roles legible first.
85
+
86
+ ## IA Navigation
87
+
88
+ Parent: [Grid / Repetition patterns](index.md) in [Pattern Categories](../index.md).
89
+ Next: [Layout Recipes](../../recipes/index.md) for screen-level composition, or return to the [Layout Pattern Catalog](../../CATALOG.md) when choosing another primitive.
@@ -0,0 +1,12 @@
1
+ # Grid / Repetition
2
+
3
+ <!-- Generated from `scripts/generate-patterns.mjs` and `scripts/pattern-data.mjs`. Do not hand-edit generated catalog or pattern docs; edit the source files and regenerate. -->
4
+
5
+ - [ram-grid](ram-grid.md) - Repeat items into as many useful columns as space allows.
6
+ - [card-grid](card-grid.md) - Align repeating cards in rows and columns.
7
+ - [twelve-span-grid](twelve-span-grid.md) - Provide a twelve-column placement scaffold.
8
+ - [page-grid](page-grid.md) - Align page content to margins, gutters, and a central track.
9
+ - [grid-wrapper](grid-wrapper.md) - Center grid tracks while allowing full-width breakout tracks.
10
+ - [columns](columns.md) - Flow long content into balanced text columns.
11
+ - [dense-grid](dense-grid.md) - Fill a compact grid with repeated small items.
12
+ - [masonry-approx](masonry-approx.md) - Approximate staggered content with columns when exact row alignment is not needed.
@@ -0,0 +1,87 @@
1
+ ---
2
+ type: Layout Pattern
3
+ name: masonry-approx
4
+ title: masonry-approx
5
+ category: Grid / Repetition
6
+ description: Approximate staggered content with columns when exact row alignment is not needed.
7
+ primary_spatial_problem: Approximate staggered content with columns when exact row alignment is not needed.
8
+ secondary_spatial_problems: none
9
+ layout_axis: block
10
+ content_shape: mixed
11
+ responsiveness: fluid
12
+ constraints: Uses only local class hooks and explicit layout constraints.
13
+ scroll_ownership: No internal scroll container.
14
+ source_lineage: https://developer.mozilla.org/en-US/docs/Web/CSS/How_to/Layout_cookbook
15
+ lifecycle: generated
16
+ generated_from: scripts/generate-patterns.mjs, scripts/pattern-data.mjs
17
+ ---
18
+
19
+ <!-- Generated from `scripts/generate-patterns.mjs` and `scripts/pattern-data.mjs`. Do not hand-edit generated catalog or pattern docs; edit the source files and regenerate. -->
20
+
21
+ # masonry-approx
22
+
23
+ ## When To Use
24
+
25
+ Use this pattern when you need to approximate staggered content with columns when exact row alignment is not needed.
26
+
27
+ ## HTML
28
+
29
+ ```html
30
+ <section class="masonry_approx" aria-label="Research notes">
31
+ <article>Interview excerpt with a longer observation.</article>
32
+ <article>Short survey result.</article>
33
+ <article>Workshop synthesis note.</article>
34
+ </section>
35
+ ```
36
+
37
+ ## CSS
38
+
39
+ ```css
40
+ .masonry_approx {
41
+ column-gap: 1rem;
42
+ column-width: 14rem;
43
+ }
44
+ ```
45
+
46
+ ## Core Properties
47
+
48
+ - `column-gap`, `column-width` define the spatial behavior for this pattern.
49
+
50
+ ## Properties That Break The Layout If Removed
51
+
52
+ - Removing `column-gap`, `column-width` changes the pattern from its documented layout responsibility back toward ordinary flow or an unsafe fixed arrangement.
53
+
54
+ ## Constraints And Change Points
55
+
56
+ - fluid responsiveness is part of the contract; change sizing values only when the new minimum, maximum, or wrap point is documented with the pattern.
57
+ - Keep the HTML class hooks and CSS selectors in one-to-one agreement.
58
+
59
+ ## Scroll Ownership
60
+
61
+ No internal scroll container.
62
+
63
+ ## Accessibility And Source Order Notes
64
+
65
+ - Semantic role expectation: Preserve the HTML sample's landmark, list, navigation, form, figure, or article roles; layout classes must not replace semantic elements.
66
+ - DOM order expectation: Keep semantic elements, DOM order, reading order, and focus order independent from the visual placement created by the layout classes.
67
+ - Focus risk: Any interactive descendants follow DOM order; do not use this pattern to create a visual order that keyboard focus cannot follow.
68
+ - Scroll expectation: No internal scroll container.
69
+ - Cognitive risk: Low: the pattern should preserve ordinary reading flow when semantic order is already correct.
70
+
71
+ ## Browser And Fallback Notes
72
+
73
+ The CSS uses modern grid, flex, intrinsic sizing, logical properties, or positioning. If a target browser cannot support a property, fall back to ordinary block flow before adding decorative or script-driven layout behavior.
74
+
75
+ ## Composition Notes
76
+
77
+ Use `masonry_approx` as the stable pattern root and compose additional layout behavior outside that root unless the child class is part of the documented relationship.
78
+
79
+ ## Anti-patterns
80
+
81
+ - Do not add color, border, shadow, typography, or animation rules to reusable pattern CSS.
82
+ - Do not use this pattern to repair unclear HTML structure; make the DOM roles legible first.
83
+
84
+ ## IA Navigation
85
+
86
+ Parent: [Grid / Repetition patterns](index.md) in [Pattern Categories](../index.md).
87
+ Next: [Layout Recipes](../../recipes/index.md) for screen-level composition, or return to the [Layout Pattern Catalog](../../CATALOG.md) when choosing another primitive.
@@ -0,0 +1,90 @@
1
+ ---
2
+ type: Layout Pattern
3
+ name: page-grid
4
+ title: page-grid
5
+ category: Grid / Repetition
6
+ description: Align page content to margins, gutters, and a central track.
7
+ primary_spatial_problem: Align page content to margins, gutters, and a central track.
8
+ secondary_spatial_problems: none
9
+ layout_axis: inline
10
+ content_shape: mixed
11
+ responsiveness: fluid
12
+ constraints: Uses only local class hooks and explicit layout constraints.
13
+ scroll_ownership: No internal scroll container.
14
+ source_lineage: https://carbondesignsystem.com/elements/2x-grid/overview/
15
+ lifecycle: generated
16
+ generated_from: scripts/generate-patterns.mjs, scripts/pattern-data.mjs
17
+ ---
18
+
19
+ <!-- Generated from `scripts/generate-patterns.mjs` and `scripts/pattern-data.mjs`. Do not hand-edit generated catalog or pattern docs; edit the source files and regenerate. -->
20
+
21
+ # page-grid
22
+
23
+ ## When To Use
24
+
25
+ Use this pattern when you need to align page content to margins, gutters, and a central track.
26
+
27
+ ## HTML
28
+
29
+ ```html
30
+ <section class="page_grid" aria-label="Article page">
31
+ <main class="page_grid_content">Centered article track with fluid outer gutters</main>
32
+ </section>
33
+ ```
34
+
35
+ ## CSS
36
+
37
+ ```css
38
+ .page_grid {
39
+ display: grid;
40
+ gap: 1rem;
41
+ grid-template-columns: minmax(1rem, 1fr) minmax(0, 72rem) minmax(1rem, 1fr);
42
+ }
43
+
44
+ .page_grid_content {
45
+ grid-column: 2;
46
+ }
47
+ ```
48
+
49
+ ## Core Properties
50
+
51
+ - `display`, `gap`, `grid-template-columns`, `grid-column` define the spatial behavior for this pattern.
52
+
53
+ ## Properties That Break The Layout If Removed
54
+
55
+ - Removing `display`, `gap`, `grid-template-columns`, `grid-column` changes the pattern from its documented layout responsibility back toward ordinary flow or an unsafe fixed arrangement.
56
+
57
+ ## Constraints And Change Points
58
+
59
+ - fluid responsiveness is part of the contract; change sizing values only when the new minimum, maximum, or wrap point is documented with the pattern.
60
+ - Keep the HTML class hooks and CSS selectors in one-to-one agreement.
61
+
62
+ ## Scroll Ownership
63
+
64
+ No internal scroll container.
65
+
66
+ ## Accessibility And Source Order Notes
67
+
68
+ - Semantic role expectation: Preserve the HTML sample's landmark, list, navigation, form, figure, or article roles; layout classes must not replace semantic elements.
69
+ - DOM order expectation: Keep semantic elements, DOM order, reading order, and focus order independent from the visual placement created by the layout classes.
70
+ - Focus risk: Any interactive descendants follow DOM order; do not use this pattern to create a visual order that keyboard focus cannot follow.
71
+ - Scroll expectation: No internal scroll container.
72
+ - Cognitive risk: Low: the pattern should preserve ordinary reading flow when semantic order is already correct.
73
+
74
+ ## Browser And Fallback Notes
75
+
76
+ The CSS uses modern grid, flex, intrinsic sizing, logical properties, or positioning. If a target browser cannot support a property, fall back to ordinary block flow before adding decorative or script-driven layout behavior.
77
+
78
+ ## Composition Notes
79
+
80
+ Use `page_grid` as the stable pattern root and compose additional layout behavior outside that root unless the child class is part of the documented relationship.
81
+
82
+ ## Anti-patterns
83
+
84
+ - Do not add color, border, shadow, typography, or animation rules to reusable pattern CSS.
85
+ - Do not use this pattern to repair unclear HTML structure; make the DOM roles legible first.
86
+
87
+ ## IA Navigation
88
+
89
+ Parent: [Grid / Repetition patterns](index.md) in [Pattern Categories](../index.md).
90
+ Next: [Layout Recipes](../../recipes/index.md) for screen-level composition, or return to the [Layout Pattern Catalog](../../CATALOG.md) when choosing another primitive.
@@ -0,0 +1,88 @@
1
+ ---
2
+ type: Layout Pattern
3
+ name: ram-grid
4
+ title: ram-grid
5
+ category: Grid / Repetition
6
+ description: Repeat items into as many useful columns as space allows.
7
+ primary_spatial_problem: Repeat items into as many useful columns as space allows.
8
+ secondary_spatial_problems: none
9
+ layout_axis: both
10
+ content_shape: mixed
11
+ responsiveness: fluid
12
+ constraints: Uses only local class hooks and explicit layout constraints.
13
+ scroll_ownership: No internal scroll container.
14
+ source_lineage: https://web.dev/articles/one-line-layouts
15
+ lifecycle: generated
16
+ generated_from: scripts/generate-patterns.mjs, scripts/pattern-data.mjs
17
+ ---
18
+
19
+ <!-- Generated from `scripts/generate-patterns.mjs` and `scripts/pattern-data.mjs`. Do not hand-edit generated catalog or pattern docs; edit the source files and regenerate. -->
20
+
21
+ # ram-grid
22
+
23
+ ## When To Use
24
+
25
+ Use this pattern when you need to repeat items into as many useful columns as space allows.
26
+
27
+ ## HTML
28
+
29
+ ```html
30
+ <section class="ram_grid" aria-label="Photo albums">
31
+ <article>Spring launch album</article>
32
+ <article>Customer meetup album</article>
33
+ <article>Workshop album</article>
34
+ </section>
35
+ ```
36
+
37
+ ## CSS
38
+
39
+ ```css
40
+ .ram_grid {
41
+ display: grid;
42
+ gap: 1rem;
43
+ grid-template-columns: repeat(auto-fit, minmax(min(16rem, 100%), 1fr));
44
+ }
45
+ ```
46
+
47
+ ## Core Properties
48
+
49
+ - `display`, `gap`, `grid-template-columns` define the spatial behavior for this pattern.
50
+
51
+ ## Properties That Break The Layout If Removed
52
+
53
+ - Removing `display`, `gap`, `grid-template-columns` changes the pattern from its documented layout responsibility back toward ordinary flow or an unsafe fixed arrangement.
54
+
55
+ ## Constraints And Change Points
56
+
57
+ - fluid responsiveness is part of the contract; change sizing values only when the new minimum, maximum, or wrap point is documented with the pattern.
58
+ - Keep the HTML class hooks and CSS selectors in one-to-one agreement.
59
+
60
+ ## Scroll Ownership
61
+
62
+ No internal scroll container.
63
+
64
+ ## Accessibility And Source Order Notes
65
+
66
+ - Semantic role expectation: Preserve the HTML sample's landmark, list, navigation, form, figure, or article roles; layout classes must not replace semantic elements.
67
+ - DOM order expectation: Keep semantic elements, DOM order, reading order, and focus order independent from the visual placement created by the layout classes.
68
+ - Focus risk: Any interactive descendants follow DOM order; do not use this pattern to create a visual order that keyboard focus cannot follow.
69
+ - Scroll expectation: No internal scroll container.
70
+ - Cognitive risk: Low: the pattern should preserve ordinary reading flow when semantic order is already correct.
71
+
72
+ ## Browser And Fallback Notes
73
+
74
+ The CSS uses modern grid, flex, intrinsic sizing, logical properties, or positioning. If a target browser cannot support a property, fall back to ordinary block flow before adding decorative or script-driven layout behavior.
75
+
76
+ ## Composition Notes
77
+
78
+ Use `ram_grid` as the stable pattern root and compose additional layout behavior outside that root unless the child class is part of the documented relationship.
79
+
80
+ ## Anti-patterns
81
+
82
+ - Do not add color, border, shadow, typography, or animation rules to reusable pattern CSS.
83
+ - Do not use this pattern to repair unclear HTML structure; make the DOM roles legible first.
84
+
85
+ ## IA Navigation
86
+
87
+ Parent: [Grid / Repetition patterns](index.md) in [Pattern Categories](../index.md).
88
+ Next: [Layout Recipes](../../recipes/index.md) for screen-level composition, or return to the [Layout Pattern Catalog](../../CATALOG.md) when choosing another primitive.