@iksnerd/blazon 0.0.0-stage → 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.
- package/LICENSE +21 -0
- package/README.md +264 -2
- package/THIRD-PARTY-NOTICES.md +60 -0
- package/bin/blazon.js +4 -0
- package/dist/builder/site-builder.d.ts +10 -0
- package/dist/builder/site-builder.d.ts.map +1 -0
- package/dist/chunks/site-builder-vpzUWoiA.js +13777 -0
- package/dist/cli/commands/approvals.d.ts +8 -0
- package/dist/cli/commands/approvals.d.ts.map +1 -0
- package/dist/cli/commands/build.d.ts +8 -0
- package/dist/cli/commands/build.d.ts.map +1 -0
- package/dist/cli/commands/check.d.ts +33 -0
- package/dist/cli/commands/check.d.ts.map +1 -0
- package/dist/cli/commands/cwd.d.ts +14 -0
- package/dist/cli/commands/cwd.d.ts.map +1 -0
- package/dist/cli/commands/dev.d.ts +5 -0
- package/dist/cli/commands/dev.d.ts.map +1 -0
- package/dist/cli/commands/doctor.d.ts +34 -0
- package/dist/cli/commands/doctor.d.ts.map +1 -0
- package/dist/cli/commands/drift.d.ts +11 -0
- package/dist/cli/commands/drift.d.ts.map +1 -0
- package/dist/cli/commands/explain.d.ts +5 -0
- package/dist/cli/commands/explain.d.ts.map +1 -0
- package/dist/cli/commands/init.d.ts +46 -0
- package/dist/cli/commands/init.d.ts.map +1 -0
- package/dist/cli/commands/mcp-check.d.ts +57 -0
- package/dist/cli/commands/mcp-check.d.ts.map +1 -0
- package/dist/cli/commands/mcp.d.ts +13 -0
- package/dist/cli/commands/mcp.d.ts.map +1 -0
- package/dist/cli/commands/pin.d.ts +7 -0
- package/dist/cli/commands/pin.d.ts.map +1 -0
- package/dist/cli/commands/plugin.d.ts +32 -0
- package/dist/cli/commands/plugin.d.ts.map +1 -0
- package/dist/cli/commands/preview.d.ts +5 -0
- package/dist/cli/commands/preview.d.ts.map +1 -0
- package/dist/cli/commands/tokens.d.ts +5 -0
- package/dist/cli/commands/tokens.d.ts.map +1 -0
- package/dist/cli/errors.d.ts +53 -0
- package/dist/cli/errors.d.ts.map +1 -0
- package/dist/cli/handlers/brand.d.ts +7 -0
- package/dist/cli/handlers/brand.d.ts.map +1 -0
- package/dist/cli/handlers/can.d.ts +7 -0
- package/dist/cli/handlers/can.d.ts.map +1 -0
- package/dist/cli/handlers/fonts.d.ts +4 -0
- package/dist/cli/handlers/fonts.d.ts.map +1 -0
- package/dist/cli/handlers/get.d.ts +7 -0
- package/dist/cli/handlers/get.d.ts.map +1 -0
- package/dist/cli/handlers/index.d.ts +8 -0
- package/dist/cli/handlers/index.d.ts.map +1 -0
- package/dist/cli/handlers/list.d.ts +7 -0
- package/dist/cli/handlers/list.d.ts.map +1 -0
- package/dist/cli/handlers/logo.d.ts +4 -0
- package/dist/cli/handlers/logo.d.ts.map +1 -0
- package/dist/cli/handlers/rules.d.ts +10 -0
- package/dist/cli/handlers/rules.d.ts.map +1 -0
- package/dist/cli/handlers/types.d.ts +17 -0
- package/dist/cli/handlers/types.d.ts.map +1 -0
- package/dist/cli/help.d.ts +18 -0
- package/dist/cli/help.d.ts.map +1 -0
- package/dist/cli/index.d.ts +2 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +3850 -0
- package/dist/cli/init-flow.d.ts +24 -0
- package/dist/cli/init-flow.d.ts.map +1 -0
- package/dist/cli/init-ui.d.ts +20 -0
- package/dist/cli/init-ui.d.ts.map +1 -0
- package/dist/cli/json.d.ts +18 -0
- package/dist/cli/json.d.ts.map +1 -0
- package/dist/cli/operations.d.ts +11 -0
- package/dist/cli/operations.d.ts.map +1 -0
- package/dist/cli/options.d.ts +8 -0
- package/dist/cli/options.d.ts.map +1 -0
- package/dist/cli/project.d.ts +8 -0
- package/dist/cli/project.d.ts.map +1 -0
- package/dist/cli/read.d.ts +13 -0
- package/dist/cli/read.d.ts.map +1 -0
- package/dist/cli/where.d.ts +10 -0
- package/dist/cli/where.d.ts.map +1 -0
- package/dist/core/assets/categories.d.ts +47 -0
- package/dist/core/assets/categories.d.ts.map +1 -0
- package/dist/core/assets/fields.d.ts +12 -0
- package/dist/core/assets/fields.d.ts.map +1 -0
- package/dist/core/assets/image-size.d.ts +10 -0
- package/dist/core/assets/image-size.d.ts.map +1 -0
- package/dist/core/assets/measure.d.ts +22 -0
- package/dist/core/assets/measure.d.ts.map +1 -0
- package/dist/core/assets/scanner.d.ts +26 -0
- package/dist/core/assets/scanner.d.ts.map +1 -0
- package/dist/core/assets/sidecar.d.ts +22 -0
- package/dist/core/assets/sidecar.d.ts.map +1 -0
- package/dist/core/blazon-pin.d.ts +36 -0
- package/dist/core/blazon-pin.d.ts.map +1 -0
- package/dist/core/brand/export.d.ts +128 -0
- package/dist/core/brand/export.d.ts.map +1 -0
- package/dist/core/brand/schema.d.ts +1000 -0
- package/dist/core/brand/schema.d.ts.map +1 -0
- package/dist/core/brand-theme.d.ts +16 -0
- package/dist/core/brand-theme.d.ts.map +1 -0
- package/dist/core/checker/approvals.d.ts +15 -0
- package/dist/core/checker/approvals.d.ts.map +1 -0
- package/dist/core/checker/cascade.d.ts +8 -0
- package/dist/core/checker/cascade.d.ts.map +1 -0
- package/dist/core/checker/catalogue.d.ts +593 -0
- package/dist/core/checker/catalogue.d.ts.map +1 -0
- package/dist/core/checker/contrast.d.ts +30 -0
- package/dist/core/checker/contrast.d.ts.map +1 -0
- package/dist/core/checker/duplicates.d.ts +3 -0
- package/dist/core/checker/duplicates.d.ts.map +1 -0
- package/dist/core/checker/fixes.d.ts +6 -0
- package/dist/core/checker/fixes.d.ts.map +1 -0
- package/dist/core/checker/font-meta.d.ts +8 -0
- package/dist/core/checker/font-meta.d.ts.map +1 -0
- package/dist/core/checker/index.d.ts +23 -0
- package/dist/core/checker/index.d.ts.map +1 -0
- package/dist/core/checker/location.d.ts +7 -0
- package/dist/core/checker/location.d.ts.map +1 -0
- package/dist/core/checker/logo-rules.d.ts +19 -0
- package/dist/core/checker/logo-rules.d.ts.map +1 -0
- package/dist/core/checker/logo-surfaces.d.ts +7 -0
- package/dist/core/checker/logo-surfaces.d.ts.map +1 -0
- package/dist/core/checker/page-tokens.d.ts +5 -0
- package/dist/core/checker/page-tokens.d.ts.map +1 -0
- package/dist/core/checker/print.d.ts +9 -0
- package/dist/core/checker/print.d.ts.map +1 -0
- package/dist/core/checker/proportion.d.ts +3 -0
- package/dist/core/checker/proportion.d.ts.map +1 -0
- package/dist/core/checker/review.d.ts +40 -0
- package/dist/core/checker/review.d.ts.map +1 -0
- package/dist/core/checker/source.d.ts +4 -0
- package/dist/core/checker/source.d.ts.map +1 -0
- package/dist/core/checker/spdx.d.ts +8 -0
- package/dist/core/checker/spdx.d.ts.map +1 -0
- package/dist/core/checker/tier.d.ts +3 -0
- package/dist/core/checker/tier.d.ts.map +1 -0
- package/dist/core/checker/usage.d.ts +4 -0
- package/dist/core/checker/usage.d.ts.map +1 -0
- package/dist/core/checker/variables.d.ts +8 -0
- package/dist/core/checker/variables.d.ts.map +1 -0
- package/dist/core/colors.d.ts +10 -0
- package/dist/core/colors.d.ts.map +1 -0
- package/dist/core/config/defaults.d.ts +3 -0
- package/dist/core/config/defaults.d.ts.map +1 -0
- package/dist/core/config/index.d.ts +15 -0
- package/dist/core/config/index.d.ts.map +1 -0
- package/dist/core/config/validate.d.ts +21 -0
- package/dist/core/config/validate.d.ts.map +1 -0
- package/dist/core/config/vocabulary.d.ts +10 -0
- package/dist/core/config/vocabulary.d.ts.map +1 -0
- package/dist/core/confine.d.ts +25 -0
- package/dist/core/confine.d.ts.map +1 -0
- package/dist/core/docs/directives.d.ts +152 -0
- package/dist/core/docs/directives.d.ts.map +1 -0
- package/dist/core/docs/parser.d.ts +7 -0
- package/dist/core/docs/parser.d.ts.map +1 -0
- package/dist/core/docs/sections.d.ts +11 -0
- package/dist/core/docs/sections.d.ts.map +1 -0
- package/dist/core/drift/compare.d.ts +30 -0
- package/dist/core/drift/compare.d.ts.map +1 -0
- package/dist/core/drift/read.d.ts +22 -0
- package/dist/core/drift/read.d.ts.map +1 -0
- package/dist/core/email-signature.d.ts +35 -0
- package/dist/core/email-signature.d.ts.map +1 -0
- package/dist/core/emit.d.ts +22 -0
- package/dist/core/emit.d.ts.map +1 -0
- package/dist/core/fonts.d.ts +43 -0
- package/dist/core/fonts.d.ts.map +1 -0
- package/dist/core/icons/icon-sets.d.ts +22 -0
- package/dist/core/icons/icon-sets.d.ts.map +1 -0
- package/dist/core/index.d.ts +9 -0
- package/dist/core/index.d.ts.map +1 -0
- package/dist/core/init/answers.d.ts +45 -0
- package/dist/core/init/answers.d.ts.map +1 -0
- package/dist/core/init/from-site/apply.d.ts +7 -0
- package/dist/core/init/from-site/apply.d.ts.map +1 -0
- package/dist/core/init/from-site/clean-colors.d.ts +21 -0
- package/dist/core/init/from-site/clean-colors.d.ts.map +1 -0
- package/dist/core/init/from-site/colors.d.ts +10 -0
- package/dist/core/init/from-site/colors.d.ts.map +1 -0
- package/dist/core/init/from-site/context.d.ts +24 -0
- package/dist/core/init/from-site/context.d.ts.map +1 -0
- package/dist/core/init/from-site/fonts.d.ts +10 -0
- package/dist/core/init/from-site/fonts.d.ts.map +1 -0
- package/dist/core/init/from-site/html.d.ts +10 -0
- package/dist/core/init/from-site/html.d.ts.map +1 -0
- package/dist/core/init/from-site/index.d.ts +6 -0
- package/dist/core/init/from-site/index.d.ts.map +1 -0
- package/dist/core/init/from-site/inspect.d.ts +4 -0
- package/dist/core/init/from-site/inspect.d.ts.map +1 -0
- package/dist/core/init/from-site/logo.d.ts +20 -0
- package/dist/core/init/from-site/logo.d.ts.map +1 -0
- package/dist/core/init/from-site/sections/colors.d.ts +4 -0
- package/dist/core/init/from-site/sections/colors.d.ts.map +1 -0
- package/dist/core/init/from-site/sections/config.d.ts +10 -0
- package/dist/core/init/from-site/sections/config.d.ts.map +1 -0
- package/dist/core/init/from-site/sections/directives.d.ts +3 -0
- package/dist/core/init/from-site/sections/directives.d.ts.map +1 -0
- package/dist/core/init/from-site/sections/fonts.d.ts +8 -0
- package/dist/core/init/from-site/sections/fonts.d.ts.map +1 -0
- package/dist/core/init/from-site/sections/intro.d.ts +4 -0
- package/dist/core/init/from-site/sections/intro.d.ts.map +1 -0
- package/dist/core/init/from-site/sections/logo.d.ts +9 -0
- package/dist/core/init/from-site/sections/logo.d.ts.map +1 -0
- package/dist/core/init/from-site/sections/placeholder.d.ts +5 -0
- package/dist/core/init/from-site/sections/placeholder.d.ts.map +1 -0
- package/dist/core/init/from-site/tree.d.ts +14 -0
- package/dist/core/init/from-site/tree.d.ts.map +1 -0
- package/dist/core/init/from-site/types.d.ts +37 -0
- package/dist/core/init/from-site/types.d.ts.map +1 -0
- package/dist/core/init/palette.d.ts +34 -0
- package/dist/core/init/palette.d.ts.map +1 -0
- package/dist/core/init/prompts.d.ts +78 -0
- package/dist/core/init/prompts.d.ts.map +1 -0
- package/dist/core/init/shared/google-fonts.d.ts +4 -0
- package/dist/core/init/shared/google-fonts.d.ts.map +1 -0
- package/dist/core/init/shared/hex.d.ts +6 -0
- package/dist/core/init/shared/hex.d.ts.map +1 -0
- package/dist/core/init/shared/svg.d.ts +3 -0
- package/dist/core/init/shared/svg.d.ts.map +1 -0
- package/dist/core/init/vocabulary.d.ts +42 -0
- package/dist/core/init/vocabulary.d.ts.map +1 -0
- package/dist/core/inputs.d.ts +25 -0
- package/dist/core/inputs.d.ts.map +1 -0
- package/dist/core/logo/lockup.d.ts +54 -0
- package/dist/core/logo/lockup.d.ts.map +1 -0
- package/dist/core/logo.d.ts +23 -0
- package/dist/core/logo.d.ts.map +1 -0
- package/dist/core/mcp-config.d.ts +65 -0
- package/dist/core/mcp-config.d.ts.map +1 -0
- package/dist/core/operations/check.d.ts +8 -0
- package/dist/core/operations/check.d.ts.map +1 -0
- package/dist/core/operations/index.d.ts +7 -0
- package/dist/core/operations/index.d.ts.map +1 -0
- package/dist/core/operations/limits.d.ts +6 -0
- package/dist/core/operations/limits.d.ts.map +1 -0
- package/dist/core/operations/list.d.ts +8 -0
- package/dist/core/operations/list.d.ts.map +1 -0
- package/dist/core/operations/project.d.ts +10 -0
- package/dist/core/operations/project.d.ts.map +1 -0
- package/dist/core/operations/types.d.ts +96 -0
- package/dist/core/operations/types.d.ts.map +1 -0
- package/dist/core/operations/validate.d.ts +4 -0
- package/dist/core/operations/validate.d.ts.map +1 -0
- package/dist/core/order.d.ts +9 -0
- package/dist/core/order.d.ts.map +1 -0
- package/dist/core/outputs.d.ts +22 -0
- package/dist/core/outputs.d.ts.map +1 -0
- package/dist/core/package-name.d.ts +3 -0
- package/dist/core/package-name.d.ts.map +1 -0
- package/dist/core/package-root.d.ts +3 -0
- package/dist/core/package-root.d.ts.map +1 -0
- package/dist/core/plugin-name.d.ts +27 -0
- package/dist/core/plugin-name.d.ts.map +1 -0
- package/dist/core/preflight.d.ts +10 -0
- package/dist/core/preflight.d.ts.map +1 -0
- package/dist/core/read/can.d.ts +44 -0
- package/dist/core/read/can.d.ts.map +1 -0
- package/dist/core/read/fonts.d.ts +47 -0
- package/dist/core/read/fonts.d.ts.map +1 -0
- package/dist/core/read/index.d.ts +8 -0
- package/dist/core/read/index.d.ts.map +1 -0
- package/dist/core/read/list.d.ts +28 -0
- package/dist/core/read/list.d.ts.map +1 -0
- package/dist/core/read/logo.d.ts +34 -0
- package/dist/core/read/logo.d.ts.map +1 -0
- package/dist/core/read/lookup.d.ts +9 -0
- package/dist/core/read/lookup.d.ts.map +1 -0
- package/dist/core/read/rules.d.ts +80 -0
- package/dist/core/read/rules.d.ts.map +1 -0
- package/dist/core/read/token.d.ts +46 -0
- package/dist/core/read/token.d.ts.map +1 -0
- package/dist/core/shipped-names.d.ts +9 -0
- package/dist/core/shipped-names.d.ts.map +1 -0
- package/dist/core/starter.d.ts +31 -0
- package/dist/core/starter.d.ts.map +1 -0
- package/dist/core/suggest.d.ts +7 -0
- package/dist/core/suggest.d.ts.map +1 -0
- package/dist/core/tokens/alias.d.ts +18 -0
- package/dist/core/tokens/alias.d.ts.map +1 -0
- package/dist/core/tokens/contexts.d.ts +10 -0
- package/dist/core/tokens/contexts.d.ts.map +1 -0
- package/dist/core/tokens/formatters/css.d.ts +15 -0
- package/dist/core/tokens/formatters/css.d.ts.map +1 -0
- package/dist/core/tokens/formatters/json.d.ts +4 -0
- package/dist/core/tokens/formatters/json.d.ts.map +1 -0
- package/dist/core/tokens/formatters/tailwind.d.ts +37 -0
- package/dist/core/tokens/formatters/tailwind.d.ts.map +1 -0
- package/dist/core/tokens/formatters/ts.d.ts +6 -0
- package/dist/core/tokens/formatters/ts.d.ts.map +1 -0
- package/dist/core/tokens/groups.d.ts +44 -0
- package/dist/core/tokens/groups.d.ts.map +1 -0
- package/dist/core/tokens/key-lines.d.ts +8 -0
- package/dist/core/tokens/key-lines.d.ts.map +1 -0
- package/dist/core/tokens/load.d.ts +12 -0
- package/dist/core/tokens/load.d.ts.map +1 -0
- package/dist/core/tokens/merge.d.ts +17 -0
- package/dist/core/tokens/merge.d.ts.map +1 -0
- package/dist/core/tokens/names.d.ts +5 -0
- package/dist/core/tokens/names.d.ts.map +1 -0
- package/dist/core/tokens/resolve.d.ts +8 -0
- package/dist/core/tokens/resolve.d.ts.map +1 -0
- package/dist/core/tokens/resolver/compile.d.ts +17 -0
- package/dist/core/tokens/resolver/compile.d.ts.map +1 -0
- package/dist/core/tokens/resolver/inputs.d.ts +7 -0
- package/dist/core/tokens/resolver/inputs.d.ts.map +1 -0
- package/dist/core/tokens/resolver/parse.d.ts +34 -0
- package/dist/core/tokens/resolver/parse.d.ts.map +1 -0
- package/dist/core/tokens/resolver/sources.d.ts +17 -0
- package/dist/core/tokens/resolver/sources.d.ts.map +1 -0
- package/dist/core/tokens/shadcn.d.ts +43 -0
- package/dist/core/tokens/shadcn.d.ts.map +1 -0
- package/dist/core/tokens/theme.d.ts +17 -0
- package/dist/core/tokens/theme.d.ts.map +1 -0
- package/dist/core/tokens/values/color.d.ts +2 -0
- package/dist/core/tokens/values/color.d.ts.map +1 -0
- package/dist/core/tokens/values/composite.d.ts +7 -0
- package/dist/core/tokens/values/composite.d.ts.map +1 -0
- package/dist/core/tokens/values/font.d.ts +3 -0
- package/dist/core/tokens/values/font.d.ts.map +1 -0
- package/dist/core/tokens/values/index.d.ts +9 -0
- package/dist/core/tokens/values/index.d.ts.map +1 -0
- package/dist/core/tokens/values/shared.d.ts +5 -0
- package/dist/core/tokens/values/shared.d.ts.map +1 -0
- package/dist/core/tokens/values/simple.d.ts +3 -0
- package/dist/core/tokens/values/simple.d.ts.map +1 -0
- package/dist/core/tokens/values/units.d.ts +3 -0
- package/dist/core/tokens/values/units.d.ts.map +1 -0
- package/dist/core/tokens/walk.d.ts +30 -0
- package/dist/core/tokens/walk.d.ts.map +1 -0
- package/dist/core/version.d.ts +3 -0
- package/dist/core/version.d.ts.map +1 -0
- package/dist/index.d.ts +27 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +40 -0
- package/dist/plugins/host/admit.d.ts +35 -0
- package/dist/plugins/host/admit.d.ts.map +1 -0
- package/dist/plugins/host/call.d.ts +59 -0
- package/dist/plugins/host/call.d.ts.map +1 -0
- package/dist/plugins/host/check.d.ts +54 -0
- package/dist/plugins/host/check.d.ts.map +1 -0
- package/dist/plugins/host/scrub.d.ts +17 -0
- package/dist/plugins/host/scrub.d.ts.map +1 -0
- package/dist/plugins/index.d.ts +14 -0
- package/dist/plugins/index.d.ts.map +1 -0
- package/dist/plugins/pins/interpreter.d.ts +49 -0
- package/dist/plugins/pins/interpreter.d.ts.map +1 -0
- package/dist/plugins/pins/lock.d.ts +47 -0
- package/dist/plugins/pins/lock.d.ts.map +1 -0
- package/dist/plugins/pins/pin.d.ts +65 -0
- package/dist/plugins/pins/pin.d.ts.map +1 -0
- package/dist/plugins/pins/shipped.d.ts +40 -0
- package/dist/plugins/pins/shipped.d.ts.map +1 -0
- package/dist/plugins/roles/breaker.d.ts +18 -0
- package/dist/plugins/roles/breaker.d.ts.map +1 -0
- package/dist/plugins/roles/check-cases.d.ts +4 -0
- package/dist/plugins/roles/check-cases.d.ts.map +1 -0
- package/dist/plugins/roles/dev.d.ts +35 -0
- package/dist/plugins/roles/dev.d.ts.map +1 -0
- package/dist/plugins/roles/fixes.d.ts +24 -0
- package/dist/plugins/roles/fixes.d.ts.map +1 -0
- package/dist/plugins/roles/gate.d.ts +26 -0
- package/dist/plugins/roles/gate.d.ts.map +1 -0
- package/dist/plugins/roles/integrate.d.ts +12 -0
- package/dist/plugins/roles/integrate.d.ts.map +1 -0
- package/dist/plugins/roles/roles.d.ts +69 -0
- package/dist/plugins/roles/roles.d.ts.map +1 -0
- package/dist/plugins/wire/environment.d.ts +9 -0
- package/dist/plugins/wire/environment.d.ts.map +1 -0
- package/dist/plugins/wire/forms.d.ts +13 -0
- package/dist/plugins/wire/forms.d.ts.map +1 -0
- package/dist/plugins/wire/limits.d.ts +11 -0
- package/dist/plugins/wire/limits.d.ts.map +1 -0
- package/dist/plugins/wire/manifest.d.ts +31 -0
- package/dist/plugins/wire/manifest.d.ts.map +1 -0
- package/dist/plugins/wire/profile.d.ts +36 -0
- package/dist/plugins/wire/profile.d.ts.map +1 -0
- package/dist/plugins/wire/text.d.ts +14 -0
- package/dist/plugins/wire/text.d.ts.map +1 -0
- package/dist/server/assets.d.ts +13 -0
- package/dist/server/assets.d.ts.map +1 -0
- package/dist/server/coalesce.d.ts +12 -0
- package/dist/server/coalesce.d.ts.map +1 -0
- package/dist/server/data-script.d.ts +8 -0
- package/dist/server/data-script.d.ts.map +1 -0
- package/dist/server/dev-server.d.ts +34 -0
- package/dist/server/dev-server.d.ts.map +1 -0
- package/dist/server/editor-guard.d.ts +13 -0
- package/dist/server/editor-guard.d.ts.map +1 -0
- package/dist/server/error-reporter.d.ts +11 -0
- package/dist/server/error-reporter.d.ts.map +1 -0
- package/dist/server/icon-sets.d.ts +9 -0
- package/dist/server/icon-sets.d.ts.map +1 -0
- package/dist/server/plugin.d.ts +4 -0
- package/dist/server/plugin.d.ts.map +1 -0
- package/dist/server/preview-guard.d.ts +11 -0
- package/dist/server/preview-guard.d.ts.map +1 -0
- package/dist/types/assets.d.ts +130 -0
- package/dist/types/assets.d.ts.map +1 -0
- package/dist/types/catalog.d.ts +95 -0
- package/dist/types/catalog.d.ts.map +1 -0
- package/dist/types/config.d.ts +97 -0
- package/dist/types/config.d.ts.map +1 -0
- package/dist/types/data.d.ts +38 -0
- package/dist/types/data.d.ts.map +1 -0
- package/dist/types/docs.d.ts +47 -0
- package/dist/types/docs.d.ts.map +1 -0
- package/dist/types/findings.d.ts +18 -0
- package/dist/types/findings.d.ts.map +1 -0
- package/dist/types/index.d.ts +13 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/parsed.d.ts +86 -0
- package/dist/types/parsed.d.ts.map +1 -0
- package/dist/types/theme.d.ts +19 -0
- package/dist/types/theme.d.ts.map +1 -0
- package/dist/types/tokens.d.ts +101 -0
- package/dist/types/tokens.d.ts.map +1 -0
- package/dist/ui/assets/geist-OFL.txt +93 -0
- package/dist/ui/assets/geist-cyrillic-ext-wght-normal-DjL33-gN.woff2 +0 -0
- package/dist/ui/assets/geist-cyrillic-wght-normal-BEAKL7Jp.woff2 +0 -0
- package/dist/ui/assets/geist-latin-ext-wght-normal-DC-KSUi6.woff2 +0 -0
- package/dist/ui/assets/geist-latin-wght-normal-BgDaEnEv.woff2 +0 -0
- package/dist/ui/assets/geist-vietnamese-wght-normal-6IgcOCM7.woff2 +0 -0
- package/dist/ui/assets/index-BdbihVvH.js +77 -0
- package/dist/ui/assets/index-DluSqfla.css +2 -0
- package/dist/ui/index.html +14 -0
- package/package.json +151 -4
- package/plugins/blazon.brand-deck/README.md +38 -0
- package/plugins/blazon.brand-deck/bin/blazon-blazon.brand-deck./360/237/224/214 +2695 -0
- package/plugins/blazon.brand-deck/package.json +3 -0
- package/plugins/blazon.copy/README.md +29 -0
- package/plugins/blazon.copy/bin/blazon-blazon.copy./360/237/224/214 +438 -0
- package/plugins/blazon.copy/package.json +3 -0
- package/plugins/blazon.favicons/README.md +13 -0
- package/plugins/blazon.favicons/bin/blazon-blazon.favicons./360/237/224/214 +8816 -0
- package/plugins/blazon.favicons/package.json +3 -0
- package/plugins/blazon.logo-geometry/README.md +5 -0
- package/plugins/blazon.logo-geometry/bin/blazon-blazon.logo-geometry./360/237/224/214 +1522 -0
- package/plugins/blazon.logo-geometry/package.json +3 -0
- package/plugins/blazon.logo-kit/README.md +5 -0
- package/plugins/blazon.logo-kit/bin/blazon-blazon.logo-kit./360/237/224/214 +617 -0
- package/plugins/blazon.logo-kit/package.json +3 -0
- package/plugins/blazon.office-template/README.md +29 -0
- package/plugins/blazon.office-template/bin/blazon-blazon.office-template./360/237/224/214 +1788 -0
- package/plugins/blazon.office-template/package.json +3 -0
- package/plugins/blazon.platform-tokens/README.md +22 -0
- package/plugins/blazon.platform-tokens/bin/blazon-blazon.platform-tokens./360/237/224/214 +8418 -0
- package/plugins/blazon.platform-tokens/package.json +3 -0
- package/plugins/blazon.press-kit/README.md +17 -0
- package/plugins/blazon.press-kit/bin/blazon-blazon.press-kit./360/237/224/214 +897 -0
- package/plugins/blazon.press-kit/package.json +3 -0
- package/plugins/blazon.print-book/README.md +38 -0
- package/plugins/blazon.print-book/bin/blazon-blazon.print-book./360/237/224/214 +9262 -0
- package/plugins/blazon.print-book/package.json +3 -0
- package/plugins/blazon.social-cards/README.md +5 -0
- package/plugins/blazon.social-cards/bin/blazon-blazon.social-cards./360/237/224/214 +1165 -0
- package/plugins/blazon.social-cards/package.json +3 -0
- package/plugins/shipped.lock +75 -0
- package/template/AGENTS.md +55 -0
- package/template/CLAUDE.md +1 -0
- package/template/assets/backgrounds/aurora.json +5 -0
- package/template/assets/backgrounds/aurora.svg +39 -0
- package/template/assets/construction/blazon-mark.json +9 -0
- package/template/assets/construction/blazon-mark.svg +54 -0
- package/template/assets/icons/arrow-right.json +5 -0
- package/template/assets/icons/arrow-right.svg +1 -0
- package/template/assets/icons/check.json +5 -0
- package/template/assets/icons/check.svg +1 -0
- package/template/assets/icons/download.json +5 -0
- package/template/assets/icons/download.svg +1 -0
- package/template/assets/icons/file.json +5 -0
- package/template/assets/icons/file.svg +1 -0
- package/template/assets/icons/token.json +5 -0
- package/template/assets/icons/token.svg +1 -0
- package/template/assets/icons/warning.json +5 -0
- package/template/assets/icons/warning.svg +1 -0
- package/template/assets/logos/blazon-bone.json +6 -0
- package/template/assets/logos/blazon-bone.svg +1 -0
- package/template/assets/logos/blazon-graphite.json +6 -0
- package/template/assets/logos/blazon-graphite.svg +1 -0
- package/template/assets/logos/blazon-mark.json +6 -0
- package/template/assets/logos/blazon-mark.svg +1 -0
- package/template/blazon.json +104 -0
- package/template/blazon.resolver.json +46 -0
- package/template/docs/01-principles.md +47 -0
- package/template/docs/02-logo.md +43 -0
- package/template/docs/03-color.md +79 -0
- package/template/docs/04-type.md +36 -0
- package/template/docs/05-form.md +80 -0
- package/template/docs/06-layout.md +28 -0
- package/template/docs/07-icons.md +22 -0
- package/template/docs/08-diagrams.md +20 -0
- package/template/docs/09-social.md +21 -0
- package/template/docs/10-applications.md +20 -0
- package/template/docs/11-voice.md +74 -0
- package/template/docs/12-web.md +167 -0
- package/template/fonts/IBMPlexMono-Regular-latin.woff2 +0 -0
- package/template/fonts/IBMPlexMono-SemiBold-latin.woff2 +0 -0
- package/template/fonts/OFL.txt +93 -0
- package/template/tokens/colors.json +257 -0
- package/template/tokens/form.json +199 -0
- package/template/tokens/social.json +26 -0
- package/template/tokens/spacing.json +65 -0
- package/template/tokens/theme/dark.json +121 -0
- package/template/tokens/typography.json +233 -0
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Color
|
|
3
|
+
order: 3
|
|
4
|
+
group: System
|
|
5
|
+
cover: canvas
|
|
6
|
+
description: Three surfaces, three inks and one signal, in a light and a dark theme. The ratio is 70 / 20 / 10.
|
|
7
|
+
section: color
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Materials
|
|
11
|
+
|
|
12
|
+
- **Bone** `#F2F0EB` and **Concrete** `#D9D6CF`: the surfaces of the light theme. **Carbon** `#101113`: the canvas of the dark theme.
|
|
13
|
+
- **Graphite** `#1E1F21` and **Steel** `#54585D`: text, rules and structure in light. Graphite is also the page of the dark theme. **Zinc** `#8C9096`: muted text and the rule in dark. **Carbon** is the shadow of a key in dark.
|
|
14
|
+
- **Signal Orange** `#FF5A1F` and **Hazard Yellow** `#F2C230`: actions and warnings only, in both themes.
|
|
15
|
+
|
|
16
|
+
<!-- blazon:tokens color.base color.ink color.signal -->
|
|
17
|
+
|
|
18
|
+
## Pigments for code
|
|
19
|
+
|
|
20
|
+
Code gets its own colors. **Oxide**, **Verdigris** and **Cobalt** are the pigments of the light theme. **Ember**, **Patina** and **Enamel** are their lighter counterparts for the dark theme. Oxide is rust, the oxide of Signal Orange's iron. Verdigris and Patina are oxidised copper. Cobalt and Enamel are enamel-sign blue.
|
|
21
|
+
|
|
22
|
+
<!-- blazon:tokens color.pigment -->
|
|
23
|
+
|
|
24
|
+
Pigments color code and nothing else. The `color.pigment` group allows only the text role, and they are not part of the 70 / 20 / 10 ratio below. A pigment is never a fill, a rule or an accent. Signal Orange is still never text, and no pigment stands in for it.
|
|
25
|
+
|
|
26
|
+
The `syntax` roles point at them. Keywords take Oxide (Ember in dark), strings Verdigris (Patina), constants and numbers Cobalt (Enamel). Function names, comments and punctuation take inks: Graphite (Bone), Steel (Zinc) and Steel (Zinc).
|
|
27
|
+
|
|
28
|
+
<!-- blazon:tokens syntax -->
|
|
29
|
+
|
|
30
|
+
Every `syntax` token reaches AA on both surfaces in both themes. The lowest are Verdigris on Concrete at 4.70:1 in light and Zinc on Graphite at 5.14:1 in dark.
|
|
31
|
+
|
|
32
|
+
## Two themes
|
|
33
|
+
|
|
34
|
+
Light is the default. The dark theme is a context of the same tokens (`blazon.resolver.json`, modifier `theme`). It changes what the roles point at, and nothing else. A site turns it on with `data-theme="dark"`.
|
|
35
|
+
|
|
36
|
+
| Role | Light | Dark |
|
|
37
|
+
|---|---|---|
|
|
38
|
+
| `surface.background` | Bone | Graphite |
|
|
39
|
+
| `surface.canvas` | Concrete | Carbon |
|
|
40
|
+
| `surface.inverse` | Graphite | Bone |
|
|
41
|
+
| `text.primary` | Graphite | Bone |
|
|
42
|
+
| `text.muted` | Steel | Zinc |
|
|
43
|
+
| `text.inverse` | Bone | Graphite |
|
|
44
|
+
| `text.onSignal` | Graphite | Graphite |
|
|
45
|
+
| `rule.default` | Graphite | Zinc |
|
|
46
|
+
| `rule.quiet` | Steel | Steel |
|
|
47
|
+
| `rule.onSignal` | Graphite | Graphite |
|
|
48
|
+
| `interactive.primary` | Signal Orange | Signal Orange |
|
|
49
|
+
|
|
50
|
+
<!-- blazon:tokens surface text rule interactive -->
|
|
51
|
+
|
|
52
|
+
- The canvas is the deeper surface in both themes: Concrete under Bone, Carbon under Graphite.
|
|
53
|
+
- Labels on Signal Orange stay Graphite in dark. Bone on Signal Orange is 2.74:1.
|
|
54
|
+
- The edge of an orange part is `rule.onSignal`, Graphite in both themes: 5.29:1 on Signal Orange. `rule.default` would not do in dark. Zinc on Signal Orange is 1.03:1, below the 3:1 a part's edge needs.
|
|
55
|
+
- Carbon and Zinc exist for the dark theme. Steel reaches only 2.30:1 on Graphite, too little for muted text or the edge of a control. In dark it is the quiet hairline and nothing that has to be read. No other color of the brand sits below Graphite.
|
|
56
|
+
|
|
57
|
+
## Rules the build checks
|
|
58
|
+
|
|
59
|
+
`blazon check` runs every rule below in both themes. A finding that only the dark theme has is tagged `theme=dark`.
|
|
60
|
+
|
|
61
|
+
- Signal colors deny the text role; `blazon check` fails a text token that aliases them. That holds in dark too, where Signal Orange on Graphite measures 5.29:1. It is still not text.
|
|
62
|
+
- Primary text reaches AAA on both surfaces: 14.48:1 and 11.37:1 in light, 14.48:1 and 16.59:1 in dark.
|
|
63
|
+
- Muted text reaches AA on both surfaces: 6.29:1 and 4.94:1 in light, 5.14:1 and 5.89:1 in dark.
|
|
64
|
+
- Labels on signal colors are Graphite (`text.onSignal`): 5.29:1 on Signal Orange and 9.85:1 on Hazard Yellow, in both themes.
|
|
65
|
+
- Code colors reach AA on both surfaces: every `syntax` token measures 4.70:1 or more in light and 5.14:1 or more in dark.
|
|
66
|
+
- Inverse text reaches AAA on the inverse surface: 14.48:1 in both themes.
|
|
67
|
+
|
|
68
|
+
## One orange, one state
|
|
69
|
+
|
|
70
|
+
Signal Orange has no hover, pressed or disabled shade. Graphite on it is 5.29:1, close to the 4.5:1 that AA asks of `text.onSignal`. A shade dark enough to read as a hover leaves Graphite near 4.2:1, below AA. A control shows its state by moving instead: it travels into its shadow (see the [form page](05-form.md)). A disabled control is not orange at all.
|
|
71
|
+
|
|
72
|
+
## Orange and yellow in dark
|
|
73
|
+
|
|
74
|
+
- Signal Orange is the one signal in dark as in light. It marks the single primary action, the fold of the mark, and small accents such as a rule or a badge. As a part it reaches 5.29:1 on Graphite and 6.06:1 on Carbon. On Bone it reaches only 2.74:1, so a light page never relies on the orange alone to show where a part ends.
|
|
75
|
+
- Hazard Yellow marks a warning and nothing else: 9.85:1 on Graphite and 11.28:1 on Carbon. It is never a decoration, a highlight or a second accent.
|
|
76
|
+
|
|
77
|
+
## Proportion
|
|
78
|
+
|
|
79
|
+
About 70% base surfaces, 20% ink, 10% signal. In dark the surfaces are Graphite and Carbon, so the 70% is dark.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Type
|
|
3
|
+
order: 4
|
|
4
|
+
group: System
|
|
5
|
+
cover: canvas
|
|
6
|
+
description: Big Shoulders Display for headlines, IBM Plex Sans for reading, IBM Plex Mono for labels, values and code.
|
|
7
|
+
section: typography
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Display
|
|
11
|
+
|
|
12
|
+
Big Shoulders Display, heavy and condensed, drawn from Chicago's industrial signage. Headlines only, set tight (`type.display`, `type.h1`, `type.h2`, `type.subhead`).
|
|
13
|
+
|
|
14
|
+
<!-- blazon:tokens font.family -->
|
|
15
|
+
|
|
16
|
+
## Reading
|
|
17
|
+
|
|
18
|
+
IBM Plex Sans for anything longer than a headline (`type.h3`, `type.body`, `type.small`). Plex has an engineering lineage, and it reads that way.
|
|
19
|
+
|
|
20
|
+
## Labels
|
|
21
|
+
|
|
22
|
+
IBM Plex Mono at 12/16px in capitals with wide tracking (`type.label`), for part numbers, token paths and values.
|
|
23
|
+
|
|
24
|
+
## Code
|
|
25
|
+
|
|
26
|
+
IBM Plex Mono at 14/20px, as typed and with no tracking (`type.code`), for commands, file excerpts and code in running text. It is never set in capitals, because a command has to be copied exactly.
|
|
27
|
+
|
|
28
|
+
Function names in code are set in the semibold weight (`font.weight.semibold`, 600) and take the `syntax` colors (see the [color page](03-color.md)).
|
|
29
|
+
|
|
30
|
+
This starter loads Plex Mono from two files in the folder, `fonts/IBMPlexMono-Regular-latin.woff2` and `fonts/IBMPlexMono-SemiBold-latin.woff2`, to show how a brand carries its own font. They are the Latin subsets of IBM Plex Mono Regular and SemiBold from the `@fontsource/ibm-plex-mono` package, under the SIL Open Font License 1.1 (`fonts/OFL.txt`). A brand replaces them with its own licensed files and lists them in `fonts` in `blazon.json`.
|
|
31
|
+
|
|
32
|
+
## Scale
|
|
33
|
+
|
|
34
|
+
Every text style is a token, so the build can check it and the code can use it.
|
|
35
|
+
|
|
36
|
+
<!-- blazon:tokens type -->
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Form and motion
|
|
3
|
+
order: 5
|
|
4
|
+
group: System
|
|
5
|
+
cover: canvas
|
|
6
|
+
description: Square cuts, 2px rules, three hard shadows and keys that seat like a machine part.
|
|
7
|
+
section: motion
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Shape
|
|
11
|
+
|
|
12
|
+
- Panels and covers are cut square (`radius.none`); inputs and buttons get a 2px hairline (`radius.hairline`). There is no corner between the two and none past the hairline.
|
|
13
|
+
- Structure is drawn with a 2px rule (`border.rule`); secondary dividers with a 1px hairline (`border.hairline`). The rule is Graphite in light and Zinc in dark, 5.14:1 on the Graphite page, so a control's edge stays above 3:1. The hairline is Steel in both themes, 2.30:1 on Graphite in dark: it divides and does not bound a control.
|
|
14
|
+
- A part filled with Signal Orange, such as the primary key, has its own edge, `border.onSignal`: a 2px rule in `rule.onSignal`, Graphite in both themes. It reaches 5.29:1 on the orange, where the Zinc rule of dark reaches only 1.03:1.
|
|
15
|
+
|
|
16
|
+
<!-- blazon:tokens radius border -->
|
|
17
|
+
|
|
18
|
+
## Depth
|
|
19
|
+
|
|
20
|
+
Depth is a hard offset, never blurred and never translucent. In light, `shadow.plate` and `shadow.shim` are Graphite; in dark they are Carbon, the darkest color of the brand, and `shadow.recess` is Zinc. There are three:
|
|
21
|
+
|
|
22
|
+
- `shadow.plate`, 4px: a part raised off the panel, like a plate bolted onto it. A key at rest, or a card under the pointer.
|
|
23
|
+
- `shadow.shim`, 2px: a key under the pointer, seated halfway into its plate.
|
|
24
|
+
- `shadow.recess`, 2px inset: a well cut into the panel, such as an input or the rail that holds tabs.
|
|
25
|
+
|
|
26
|
+
No other shadow is used. A raised part is never deeper than `shadow.plate`.
|
|
27
|
+
|
|
28
|
+
### Shadows in dark
|
|
29
|
+
|
|
30
|
+
A shadow is darker than the part it falls on. A Graphite shadow is not there on a Graphite page. A light one, Zinc or Steel, reads as a second edge or a glow, not as depth. So in dark `shadow.plate` and `shadow.shim` are Carbon, the one ink darker than the Graphite page. Each keeps its offset; only its color changes. `shadow.recess` stays Zinc: it is a well cut into the panel, not a raised plate.
|
|
31
|
+
|
|
32
|
+
| Plate color | On the Graphite page |
|
|
33
|
+
|---|---|
|
|
34
|
+
| Graphite, as in light | 1.00:1 |
|
|
35
|
+
| Carbon, darker than the page | 1.15:1 |
|
|
36
|
+
| Steel | 2.30:1 |
|
|
37
|
+
| Zinc | 5.14:1 |
|
|
38
|
+
|
|
39
|
+
- Carbon is the only brand color darker than Graphite. Black would be darker still, but it is not a brand color.
|
|
40
|
+
- The plate is faint by design: it is a dark offset, not an outline. The key's edge (`border.rule`, Zinc in dark) is what marks where the key ends, and the key's travel is still the difference between two offsets.
|
|
41
|
+
- On a Carbon surface, such as the canvas or a code plate's header, the Carbon plate has no contrast (1.00:1). A key there is marked by its edge and its lighter Graphite face, and it still travels the same distances.
|
|
42
|
+
- The primary key stands on the same Carbon plate; its Graphite edge, not an orange shadow, marks where its face ends.
|
|
43
|
+
|
|
44
|
+
<!-- blazon:tokens shadow -->
|
|
45
|
+
|
|
46
|
+
## Spacing
|
|
47
|
+
|
|
48
|
+
A 4px module: 4, 8, 12, 16, 24, 32, 48, 64 (`space.*`).
|
|
49
|
+
|
|
50
|
+
## Motion
|
|
51
|
+
|
|
52
|
+
Fast start, hard stop (`motion.easing.mechanical`): 120ms for toggles and presses, 200ms for panels and menus.
|
|
53
|
+
|
|
54
|
+
<!-- blazon:tokens motion -->
|
|
55
|
+
|
|
56
|
+
## Keys
|
|
57
|
+
|
|
58
|
+
A button or a tab is a key: it stands on `shadow.plate` and travels into it.
|
|
59
|
+
|
|
60
|
+
| State | Shadow | Moved by |
|
|
61
|
+
|---|---|---|
|
|
62
|
+
| At rest | `shadow.plate` | nothing |
|
|
63
|
+
| Under the pointer | `shadow.shim` | the plate's offset less the shim's: 2px right and 2px down |
|
|
64
|
+
| Pressed, or the active tab | none | the plate's whole offset: 4px right and 4px down |
|
|
65
|
+
| Disabled | none | nothing |
|
|
66
|
+
|
|
67
|
+
- The face ends where its shadow was, so the travel is always the difference between two shadow offsets. It has no token of its own. In CSS it is `calc(var(--shadow-plate-offset-x) - var(--shadow-shim-offset-x))` under the pointer and `var(--shadow-plate-offset-x)` pressed, and the same for `y`.
|
|
68
|
+
- Each move takes `motion.duration.snap` with `motion.easing.mechanical`: a press is a toggle, and the key seats like a machine part.
|
|
69
|
+
- The fill, text and edge stay as they are. Signal Orange has no hover or pressed shade (see the [color page](03-color.md)).
|
|
70
|
+
- With reduced motion set, each state is a hard cut: the key changes shadow and position at once.
|
|
71
|
+
|
|
72
|
+
## Animating the mark and icons
|
|
73
|
+
|
|
74
|
+
There are no animation files in this book yet. These rules apply to any animation made from the mark and the icons, and they use only the motion tokens above.
|
|
75
|
+
|
|
76
|
+
- A part appears as a hard cut, not a fade or a blur.
|
|
77
|
+
- Use the motion tokens above as the interface does: `motion.duration.move` for panels and `motion.duration.snap` for toggles and presses, both with `motion.easing.mechanical`.
|
|
78
|
+
- Do not move, scale or recolor the fold while the mark is shown, and do not animate the clear space.
|
|
79
|
+
- Do not fade, blur or grow a shadow. A shadow changes only as a key travels into it, and a panel's shadow appears or disappears with the panel.
|
|
80
|
+
- With reduced motion set, show the finished mark and the icon's end state at once.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Layout
|
|
3
|
+
order: 6
|
|
4
|
+
group: System
|
|
5
|
+
cover: canvas
|
|
6
|
+
section: layout
|
|
7
|
+
description: A 4px module, visible rules and square panels.
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Grid
|
|
11
|
+
|
|
12
|
+
Everything sits on the 4px module (`space.0` to `space.16`: 0, 4, 8, 12, 16, 24, 32, 48, 64). Gaps between parts use 16, 24 or 32. Nothing is placed by eye between those steps.
|
|
13
|
+
|
|
14
|
+
<!-- blazon:tokens space -->
|
|
15
|
+
|
|
16
|
+
## Structure stays visible
|
|
17
|
+
|
|
18
|
+
Panels are divided by a 2px rule (`border.rule`, Graphite in light and Zinc in dark); secondary dividers use the 1px Steel hairline (`border.hairline`). A rule is never replaced by a gap alone.
|
|
19
|
+
|
|
20
|
+
Ticks and measure marks are rules too, and take the rule colors. A long tick is `rule.default` at the width of `border.rule`, and a short tick is `rule.quiet` at the width of `border.hairline`. Long ticks fall every 64px (`space.16`) and short ones every 16px (`space.4`). On an inverse surface every tick is `text.inverse`. A tick is never Signal Orange.
|
|
21
|
+
|
|
22
|
+
Steel is the lightest a tick gets: `blazon can rule.quiet surface.canvas --role ui` reports 4.94:1 against the 3:1 a mark needs. In dark `rule.quiet` is Steel, 2.30:1 on Graphite and 2.64:1 on Carbon. A scale there draws every tick in `rule.default` and tells long from short by width and spacing.
|
|
23
|
+
|
|
24
|
+
## Surfaces
|
|
25
|
+
|
|
26
|
+
Pages sit on Bone (`surface.background`). Panels and canvases sit on Concrete (`surface.canvas`). Inverse areas use Graphite (`surface.inverse`) with Bone text (`text.inverse`).
|
|
27
|
+
|
|
28
|
+
<!-- blazon:tokens surface -->
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Icons
|
|
3
|
+
order: 7
|
|
4
|
+
group: Assets
|
|
5
|
+
cover: canvas
|
|
6
|
+
section: icons
|
|
7
|
+
description: Square cut, drawn with the same 2px rule as the rest of the system.
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Drawing
|
|
11
|
+
|
|
12
|
+
Icons use a 2px stroke in Graphite, the width of `border.rule`, and square corners to match `radius.none`. They are drawn on the 4px module.
|
|
13
|
+
|
|
14
|
+
## Color
|
|
15
|
+
|
|
16
|
+
Graphite on Bone or Concrete, Bone on Graphite. Signal Orange marks the one thing that acts, as it does everywhere else in the system.
|
|
17
|
+
|
|
18
|
+
## Set
|
|
19
|
+
|
|
20
|
+
Six icons for a brand book or a developer tool: check, warning, arrow-right, download, file and token. Each is 24px square, drawn on the 4px module with the 2px Graphite stroke, square caps and square joins, and no fill. The set is a start: replace it with the brand's own, or add to it.
|
|
21
|
+
|
|
22
|
+
<!-- blazon:icons icons -->
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Diagrams
|
|
3
|
+
order: 8
|
|
4
|
+
group: Assets
|
|
5
|
+
cover: canvas
|
|
6
|
+
section: diagrams
|
|
7
|
+
description: Rules, labels and one signal color.
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Lines and boxes
|
|
11
|
+
|
|
12
|
+
Boxes and connectors use the 2px Graphite rule. Secondary relations use the 1px Steel hairline.
|
|
13
|
+
|
|
14
|
+
## Labels
|
|
15
|
+
|
|
16
|
+
Labels are set in IBM Plex Mono at `type.label`. Longer notes use IBM Plex Sans at `type.small`.
|
|
17
|
+
|
|
18
|
+
## Emphasis
|
|
19
|
+
|
|
20
|
+
Signal Orange marks the step or part that acts. At most one thing in a diagram is orange.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Social media
|
|
3
|
+
order: 9
|
|
4
|
+
group: Applications
|
|
5
|
+
cover: accent
|
|
6
|
+
section: social
|
|
7
|
+
description: The mark on Graphite, headlines in Big Shoulders, one orange accent.
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Profile image
|
|
11
|
+
|
|
12
|
+
The Bone mark (`blazon-bone`) on a Graphite square. The mark is not placed on Signal Orange.
|
|
13
|
+
|
|
14
|
+
## Posts
|
|
15
|
+
|
|
16
|
+
Headlines in Big Shoulders Display (`type.h1` or `type.h2`) on Bone or Graphite. Body text in IBM Plex Sans (`type.body`). Signal Orange is used once per image, for the thing the post is about.
|
|
17
|
+
|
|
18
|
+
## Do not
|
|
19
|
+
|
|
20
|
+
- Add shadows or blur: the only shadow is the hard `shadow.plate`.
|
|
21
|
+
- Round the corners of an image or a card.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Applications
|
|
3
|
+
order: 10
|
|
4
|
+
group: Applications
|
|
5
|
+
cover: canvas
|
|
6
|
+
section: applications
|
|
7
|
+
description: "Where the identity is used: the viewer, the printed book, the README."
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## The brand book and its viewer
|
|
11
|
+
|
|
12
|
+
Both are built by blazon from the tokens in this folder: colors, type and the square, ruled shapes come from `tokens/`, not from hand-set styles.
|
|
13
|
+
|
|
14
|
+
## Printed book
|
|
15
|
+
|
|
16
|
+
The print book uses the same tokens at paper size: Graphite text on Bone, 2px rules, no shadows.
|
|
17
|
+
|
|
18
|
+
## README and the terminal
|
|
19
|
+
|
|
20
|
+
The README header uses the Graphite mark on Bone. Terminal output stays plain text; Signal Orange is not used where color is unavailable.
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Voice and tone
|
|
3
|
+
order: 11
|
|
4
|
+
group: Foundations
|
|
5
|
+
cover: canvas
|
|
6
|
+
description: "blazon writes the way it builds: plain, exact and checkable. Say what it does, name the file or the flag, and say proposed when it is not built."
|
|
7
|
+
section: voice
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Voice
|
|
11
|
+
|
|
12
|
+
Four traits, in the order they win an argument. The voice does not change between pages; the tone does (next section).
|
|
13
|
+
|
|
14
|
+
| Trait | It means | It does not mean |
|
|
15
|
+
|---|---|---|
|
|
16
|
+
| Plain | Short sentences, common words, one idea each, active voice. | Casual, jokey or simplified until it is wrong. |
|
|
17
|
+
| Exact | Names the file, the flag, the command or the number, and the number comes from the code. | Hedging with "usually" or "generally" where the code decides. |
|
|
18
|
+
| Direct | The verdict first, then the reason. An error says what is wrong and what to do about it. | Blunt about people. The rule is named, not whoever broke it. |
|
|
19
|
+
| Honest | Says proposed for what is not built and not yet for what is missing. A limit is stated once. | Apologetic, or promising in the present tense. |
|
|
20
|
+
|
|
21
|
+
## Tone by situation
|
|
22
|
+
|
|
23
|
+
| Where | Tone | Example |
|
|
24
|
+
|---|---|---|
|
|
25
|
+
| A finding from `blazon check` | Flat and specific: the rule, then the token. | `<path>: Used as text, but <alias> is not allowed as text` |
|
|
26
|
+
| An error that stops a command | The cause, then the next step. | `outDir and tokensOutDir are the same folder ("dist", "dist"): emptying one would remove the other's files. Put the site in its own folder, such as "dist/site"` |
|
|
27
|
+
| The manual | Instructions in the imperative, one task for each section, the command before the explanation. | `Run blazon check again.` |
|
|
28
|
+
| An RFC | Precise and neutral. Capital MUST and SHOULD only where a rule binds. Proposed for anything not built. | `Only the vocabulary is implemented.` |
|
|
29
|
+
| A README or release note | The verdict first. A fact in place of an adjective. | `blazon check` exits 1 on an error. |
|
|
30
|
+
| A commit message | `type(scope): what changed`, lowercase, in the imperative. | `fix(check): a logo on its own color is reported once` |
|
|
31
|
+
|
|
32
|
+
## Address and register
|
|
33
|
+
|
|
34
|
+
Pick one form for each place and keep it to the end of the page.
|
|
35
|
+
|
|
36
|
+
| Where | Form | Example |
|
|
37
|
+
|---|---|---|
|
|
38
|
+
| The manual and the brand book | The imperative. "You" only where the reader's own file or choice is the subject. | `Run blazon check again.` |
|
|
39
|
+
| An error or a finding | The imperative for the next step, or a statement of the cause. No apology, no "we". | `Put the site in its own folder, such as "dist/site"` |
|
|
40
|
+
| A release note | The imperative for what to change, and blazon as the subject of what changed. | `Fix the block, or remove the field.` |
|
|
41
|
+
|
|
42
|
+
- **blazon is third person.** The text says "blazon checks", never "we check" or "our tool".
|
|
43
|
+
- **Tense.** The present tense for what is built, "proposed" for what is not. No future tense for a feature.
|
|
44
|
+
|
|
45
|
+
## Word choices
|
|
46
|
+
|
|
47
|
+
| Write | Not |
|
|
48
|
+
|---|---|
|
|
49
|
+
| blazon compiles the tokens. | Leverage blazon's powerful engine to unlock your tokens. |
|
|
50
|
+
| `blazon check` fails the build on an error. | Seamlessly catches issues before they become problems. |
|
|
51
|
+
| Proposed: not built yet. | Coming soon. |
|
|
52
|
+
| `blazon tokens` writes `dist/tokens/`. | Effortlessly outputs your design system. |
|
|
53
|
+
| Move the file, or move `tokensOutDir`. | Something went wrong with your configuration. |
|
|
54
|
+
|
|
55
|
+
Hype words (powerful, seamless, robust, effortless) get a number or are cut. A claim that the code does not back is not written.
|
|
56
|
+
|
|
57
|
+
## Names and formatting
|
|
58
|
+
|
|
59
|
+
- **The name.** blazon is lowercase in running text, including at the start of a sentence, as the wordmark is set. A page title or a table heading may capitalize it.
|
|
60
|
+
- **Headings.** Sentence case. The page title in the front matter is the H1, so a page starts at H2 for chapters and H3 for sections. A heading does not end in a period.
|
|
61
|
+
- **Case in messages.** Sentence case. A finding or error message is not set in capitals, apart from a name or an acronym such as `SPDX`.
|
|
62
|
+
- **Bullets.** A bullet is a full sentence or a fragment that ends in a period.
|
|
63
|
+
- **Code.** Files, flags, commands, config keys and token paths go in backticks. A token path is written as the code writes it: `interactive.primary`.
|
|
64
|
+
- **Dates.** Year, month, day: `2026-10-26`.
|
|
65
|
+
- **Punctuation.** No em-dashes. Use a period, a colon or parentheses.
|
|
66
|
+
- **Links.** Relative to the file, and to a heading that exists. The docs tests check every link and anchor.
|
|
67
|
+
|
|
68
|
+
## Before you publish
|
|
69
|
+
|
|
70
|
+
1. Is every command, flag and number in it true today? Check it against the code.
|
|
71
|
+
2. Does the first sentence give the verdict?
|
|
72
|
+
3. Is anything described as built that is only proposed?
|
|
73
|
+
4. Does a word in it ask the reader to take the claim on faith?
|
|
74
|
+
5. Would the sentence still be right after a rename? If it names something that moves, link it instead of copying it.
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Web
|
|
3
|
+
order: 12
|
|
4
|
+
group: Applications
|
|
5
|
+
cover: canvas
|
|
6
|
+
section: applications
|
|
7
|
+
description: "What a website in this brand does where the tokens are silent: type, spacing, surfaces, buttons, inputs, cards, focus, light and dark, logo and copy."
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
A site built in this brand takes every color, size and font from the tokens. This page states the choices the tokens do not make for it. Each rule names the token it uses. Where a value has no token, the page says so.
|
|
11
|
+
|
|
12
|
+
## Type for each role
|
|
13
|
+
|
|
14
|
+
| Page role | Style |
|
|
15
|
+
|---|---|
|
|
16
|
+
| Hero headline | `type.display` |
|
|
17
|
+
| Page title | `type.h1` |
|
|
18
|
+
| Section heading | `type.h2` |
|
|
19
|
+
| Sub-section heading inside a page or chapter | `type.subhead` |
|
|
20
|
+
| Card heading | `type.h3` |
|
|
21
|
+
| Running text | `type.body` |
|
|
22
|
+
| Captions and meta text | `type.small` |
|
|
23
|
+
| Commands, file excerpts and code in running text | `type.code` |
|
|
24
|
+
| Eyebrows, navigation labels, token paths and numbers | `type.label` |
|
|
25
|
+
|
|
26
|
+
The display family (`font.family.display`) sets headlines only. Body text, buttons and form text never use it.
|
|
27
|
+
|
|
28
|
+
<!-- blazon:tokens type -->
|
|
29
|
+
|
|
30
|
+
### Code
|
|
31
|
+
|
|
32
|
+
A code block is `type.code` on `surface.canvas`. Its plain text stays `text.primary`. A token in it takes one `syntax` color:
|
|
33
|
+
|
|
34
|
+
| Kind of token | Token |
|
|
35
|
+
|---|---|
|
|
36
|
+
| Keywords | `syntax.keyword` |
|
|
37
|
+
| Strings | `syntax.string` |
|
|
38
|
+
| Constants and numbers | `syntax.constant` |
|
|
39
|
+
| Function names | `syntax.function`, at `font.weight.semibold` |
|
|
40
|
+
| Comments | `syntax.comment` |
|
|
41
|
+
| Punctuation | `syntax.punctuation` |
|
|
42
|
+
|
|
43
|
+
The mono family has a real semibold, so function names are set in the face and not a synthesized bold. The pigments behind the colors color code and nothing else (see the [color page](03-color.md)). Signal Orange is never code text.
|
|
44
|
+
|
|
45
|
+
### Narrow screens
|
|
46
|
+
|
|
47
|
+
Below 640px, a heading steps down one level: `type.display` becomes `type.h1`, and `type.h1` becomes `type.h2`. `type.h2` stays `type.h2`. Every other role is unchanged. This is a rule the site applies, not a token, and blazon does not check it. The 640px is a layout width with no token (see the next section).
|
|
48
|
+
|
|
49
|
+
## Rhythm and widths
|
|
50
|
+
|
|
51
|
+
<!-- blazon:tokens space -->
|
|
52
|
+
|
|
53
|
+
- Sections are separated by `space.16` above and below.
|
|
54
|
+
- Blocks inside a section are separated by `space.8`.
|
|
55
|
+
- Items in a group are separated by `space.4` or `space.6`.
|
|
56
|
+
- Nothing sits between those steps.
|
|
57
|
+
- Body text runs at most 64 characters to a line.
|
|
58
|
+
- The content column is 1200px wide and centered. On narrow screens it has `space.6` of padding on each side.
|
|
59
|
+
|
|
60
|
+
1200px and 640px are layout widths. They have no token, and blazon does not check them. The site writes each once, in its layout, and nowhere else.
|
|
61
|
+
|
|
62
|
+
## Surfaces
|
|
63
|
+
|
|
64
|
+
<!-- blazon:tokens surface -->
|
|
65
|
+
|
|
66
|
+
- Pages sit on `surface.background`.
|
|
67
|
+
- Alternate bands use `surface.canvas`.
|
|
68
|
+
- A page has at most one inverse band: a full-width section on `surface.inverse` with `text.inverse`. The band is Graphite on a light page and Bone on a dark one. The logo in it is the variant for that surface (see [The logo on the web](#the-logo-on-the-web)).
|
|
69
|
+
- Small parts may be inverse too: a figure tag, the title strip of a panel, the active tab, a status plate. Each is `surface.inverse` with `text.inverse`, set in `type.label`, and no wider than the panel it belongs to. None carries the logo.
|
|
70
|
+
- The primary action color, `interactive.primary`, marks the single primary action and small accents such as the fold, a rule or a badge. It is never a section background and never text. The only text on it is `text.onSignal`.
|
|
71
|
+
|
|
72
|
+
## Buttons
|
|
73
|
+
|
|
74
|
+
<!-- blazon:tokens border radius shadow motion -->
|
|
75
|
+
|
|
76
|
+
A button is set in `type.body` at `font.weight.semibold`. It does not use the display family or `type.label`. It is 48px tall (`space.12`) with `space.6` of horizontal padding.
|
|
77
|
+
|
|
78
|
+
| Kind | Fill | Text | Edge |
|
|
79
|
+
|---|---|---|---|
|
|
80
|
+
| Primary | `interactive.primary` | `text.onSignal` | `border.onSignal`, `radius.hairline` |
|
|
81
|
+
| Secondary | `surface.background` | `text.primary` | `border.rule`, `radius.hairline` |
|
|
82
|
+
| Disabled | `surface.canvas` | `text.muted` | `border.rule`, `radius.hairline`, no shadow |
|
|
83
|
+
|
|
84
|
+
- A button is a key, as the [form page](05-form.md) says. At rest it stands on `shadow.plate`. On hover it moves 2px right and 2px down and its shadow becomes `shadow.shim`. On press it moves the plate's whole offset and has no shadow. Write each distance from the shadow tokens' offsets, never as a number of its own.
|
|
85
|
+
- Each move takes `motion.duration.snap` with `motion.easing.mechanical`: "toggles and presses", and "a machine part seating into place". With reduced motion set, the states change at once.
|
|
86
|
+
- The button's fill, text color and edge do not change on hover or press. Signal Orange has no hover or pressed shade, and an opacity blend over it is not one either.
|
|
87
|
+
- A disabled button has no shadow and does not move.
|
|
88
|
+
- On an inverse band the primary button stays as above. The secondary button inverts: `text.inverse` on `surface.inverse`, with a `text.inverse` rule. In light the Graphite shadow does not show on the Graphite band, so both buttons there look flat. In dark the band is Bone and the Carbon shadow shows strongly on it. Either way they travel the same distances.
|
|
89
|
+
- The primary button's edge is `border.onSignal`, Graphite in both themes. It keeps 5.29:1 on its fill: `blazon can rule.onSignal interactive.primary --role ui` exits 0. `border.rule` would be Zinc in dark, 1.03:1 on Signal Orange. In dark the button's fill reads at 5.29:1 on Graphite and its shadow is Carbon, as for every key.
|
|
90
|
+
- A view has one primary button.
|
|
91
|
+
|
|
92
|
+
## Inputs and tabs
|
|
93
|
+
|
|
94
|
+
An input is a well cut into the panel. It has a `surface.background` fill, `border.rule`, `radius.hairline` and `shadow.recess`, and its text is `type.body` in `text.primary`. Placeholder text is `text.muted`. It is 48px tall (`space.12`), like a button, with `space.4` of horizontal padding.
|
|
95
|
+
|
|
96
|
+
Tabs sit in a rail that is a well too: `surface.canvas` with `shadow.recess`. Each tab is a key. The active tab is pressed: it is `surface.inverse` with `text.inverse` and has no shadow. Tab labels are `type.label`.
|
|
97
|
+
|
|
98
|
+
## Cards
|
|
99
|
+
|
|
100
|
+
A card sits on `surface.background`, or on `surface.canvas` when the page behind it is `surface.background`. It has `border.rule`, `radius.none`, `space.6` of padding and `space.4` between its parts. Its heading is `type.h3` and its text is `type.body`. Hover may add `shadow.plate` as a hard cut; a card does not move. A card has no blur, no gradient and no opacity blend.
|
|
101
|
+
|
|
102
|
+
## Focus
|
|
103
|
+
|
|
104
|
+
Every interactive element shows a 2px solid outline in `text.primary` with a 2px offset. It is not `rule.default`: the dark theme draws its rules in a quieter ink, and focus stays the high-contrast color. On an inverse surface the outline is `text.inverse`. The primary action color is not used for focus, in either theme. A focus indicator needs 3:1, and in light `blazon can interactive.primary surface.background --role ui` reports 2.74:1 and exits 1, while `blazon can text.primary surface.background --role ui` reports 14.48:1 and exits 0. In dark, `text.primary` is Bone: 14.48:1 on Graphite and 16.59:1 on Carbon. `text.inverse` on `surface.inverse` is 14.48:1 in both themes.
|
|
105
|
+
|
|
106
|
+
## Light and dark
|
|
107
|
+
|
|
108
|
+
The brand has a light and a dark theme, with the same token names in both. The [color page](03-color.md) lists them. `theme.css` holds the light values under `:root` and the dark ones in a `[data-theme="dark"]` block. A site that takes every color, rule and shadow from the token variables switches with one attribute and needs no second stylesheet.
|
|
109
|
+
|
|
110
|
+
- A website opens in dark. Printed matter, documents, decks and the brand book open in light, the default.
|
|
111
|
+
- The site picks the theme once, before the first paint, in a short script in the `<head>`. The visitor's stored choice wins. Without one, the system setting picks: `matchMedia('(prefers-color-scheme: light)').matches` means light. Otherwise it is dark. The script writes the answer as `data-theme` on `<html>`.
|
|
112
|
+
- The served HTML carries `<html data-theme="dark">`, so a page without script is dark too. Blazon writes no `prefers-color-scheme` block, so CSS alone does not follow the system setting.
|
|
113
|
+
- A toggle in the header switches between the two. It is a secondary button with a word on it ("Light" or "Dark"), it sets `data-theme` on `<html>`, and it stores the choice. Each page has one toggle.
|
|
114
|
+
- The switch is a hard cut. Colors do not fade from one theme to the other.
|
|
115
|
+
|
|
116
|
+
On a dark page:
|
|
117
|
+
|
|
118
|
+
- The page is `surface.background` (Graphite) and alternate bands are `surface.canvas` (Carbon).
|
|
119
|
+
- The one inverse band is Bone, with Graphite text. A page still has at most one.
|
|
120
|
+
- Signal Orange marks the single primary action and small accents, as in light. It is never text, though it measures 5.29:1 on Graphite: the `usage` rule on the signal colors fails a text token that aliases one.
|
|
121
|
+
- Hazard Yellow marks a warning and nothing else.
|
|
122
|
+
- The plate and the shim are Carbon and the recess is Zinc, at the same offsets as in light (see the [form page](05-form.md)).
|
|
123
|
+
|
|
124
|
+
### Industrial details
|
|
125
|
+
|
|
126
|
+
Three details give a page the brand's industrial look. Each uses only tokens, and each holds in both themes.
|
|
127
|
+
|
|
128
|
+
- Hazard stripes mark a warning and nothing else. A stripe is Hazard Yellow and Graphite, the ink of `text.onSignal`, at 45 degrees, on the warning's own panel. It is never a divider or a decoration.
|
|
129
|
+
- A readout (a count, a version, a port, a measurement) is `type.label` in `text.primary`, and its caption is `type.label` in `text.muted`. A command or a file excerpt in it is `type.code`.
|
|
130
|
+
- Scales and ticks are rules: a major tick is `border.rule` in `rule.default`, a minor tick is `border.hairline` in `rule.quiet`. In dark `rule.quiet` is Steel, 2.30:1 on Graphite, under the 3:1 a mark needs, so a scale in dark draws every tick in `rule.default`.
|
|
131
|
+
|
|
132
|
+
`blazon check` enforces the color rules behind these details (signal colors are never text, and every text pair keeps its contrast in both themes). It does not see a page you build, so it does not check where a site puts a stripe or a tick.
|
|
133
|
+
|
|
134
|
+
## The logo on the web
|
|
135
|
+
|
|
136
|
+
- Put the logo at the left of the header.
|
|
137
|
+
- The variant follows the surface. Use `onLight` (Graphite) on Bone and Concrete, and `onDark` (Bone) on Graphite and Carbon. On a light page that is `onLight` on `surface.background` and `surface.canvas`, and `onDark` on `surface.inverse`. On a dark page it is the other way round: `onDark` in the header and on the page, `onLight` on the Bone inverse band.
|
|
138
|
+
- Never place it on `interactive.primary`. `blazon check` flags it.
|
|
139
|
+
- Keep the clear space the logo's sidecar states.
|
|
140
|
+
- Show the mark with the wordmark at 32px high or more: `blazon logo` gives it as the `min size` of `blazon-graphite` and `blazon-bone`. Show the mark alone at 24px high or more. Its sidecar does not state that, because `blazon.favicons` would then warn that the 16px tab icon is under it. Blazon does not measure a size on a page you build.
|
|
141
|
+
- The favicon is the mark alone.
|
|
142
|
+
|
|
143
|
+
## Imagery and copy
|
|
144
|
+
|
|
145
|
+
- Imagery is the brand's own: construction drawings, the mark and diagrams. No stock photography, no gradients, and no shadow other than the three on the form page.
|
|
146
|
+
- Copy follows the four traits of the [voice page](11-voice.md). Headlines are in sentence case and say what the thing does. They name a file, a command or a number where one exists.
|
|
147
|
+
|
|
148
|
+
## Using shadcn/ui
|
|
149
|
+
|
|
150
|
+
A shadcn/ui project takes its colors from the brand as the "Using shadcn/ui" section of `docs/manual/19-building-a-website.md` in the blazon source repository describes. Its components also hard-code `text-sm`, `h-8`, `rounded-xl`, `ring/10`, opacity blends such as `hover:bg-primary/80`, and 0.35s transitions. The brand takes none of them. A site overrides each in its own button and card components, using the rules on this page.
|
|
151
|
+
|
|
152
|
+
The brand has no role for two groups of shadcn variables, so `blazon.json` maps them:
|
|
153
|
+
|
|
154
|
+
- `destructive` is `text.primary`. The brand has no red. An error is `text.primary` with `border.rule`, and the message is in words. It is never a red fill.
|
|
155
|
+
- `chart-1` to `chart-5` are `text.primary`, `text.muted`, `surface.canvas`, `rule.default` and `rule.quiet`, in that order. Separate series with `rule.default` hatching. Add no hue.
|
|
156
|
+
|
|
157
|
+
## Do not
|
|
158
|
+
|
|
159
|
+
- Do not use `interactive.primary` as a background.
|
|
160
|
+
- Do not darken, lighten or fade `interactive.primary` for a hover or a press.
|
|
161
|
+
- Do not use a blurred or translucent shadow, or one deeper than `shadow.plate`.
|
|
162
|
+
- Do not put a second inverse band on a page.
|
|
163
|
+
- Do not round a corner past `radius.hairline`.
|
|
164
|
+
- Do not set body text in the display family.
|
|
165
|
+
- Do not put a second primary button in a view.
|
|
166
|
+
- Do not put a second theme toggle on a page, or fade between the themes.
|
|
167
|
+
- Do not make Signal Orange text on a dark page because it measures AA there.
|
|
Binary file
|
|
Binary file
|