@iksnerd/blazon 0.0.0-stage → 0.1.1
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 +259 -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-CPfjBOmR.js +13804 -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 +609 -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 +161 -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 +73 -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-D0WCUmtA.css +2 -0
- package/dist/ui/assets/index-DhSc0Zxv.js +75 -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 +40 -0
- package/plugins/blazon.print-book/bin/blazon-blazon.print-book./360/237/224/214 +9268 -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,24 @@
|
|
|
1
|
+
import { Answers } from '../core/init/answers.js';
|
|
2
|
+
import { SiteFindings } from '../core/init/from-site/index.js';
|
|
3
|
+
import { Prompter } from '../core/init/prompts.js';
|
|
4
|
+
import { Look } from './init-ui.js';
|
|
5
|
+
export interface FlowContext {
|
|
6
|
+
prompter: Prompter;
|
|
7
|
+
look: Look;
|
|
8
|
+
/** The folder being initialised, for the header */
|
|
9
|
+
dir: string;
|
|
10
|
+
/** Starter files that were already in the folder and were kept */
|
|
11
|
+
kept?: number;
|
|
12
|
+
/** Reads a site; replaced in tests */
|
|
13
|
+
inspect?: (url: string) => Promise<SiteFindings>;
|
|
14
|
+
}
|
|
15
|
+
export interface Plan {
|
|
16
|
+
answers: Answers;
|
|
17
|
+
site?: {
|
|
18
|
+
url: string;
|
|
19
|
+
findings: SiteFindings;
|
|
20
|
+
skipVars: Set<string>;
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
export declare function runGuided(ctx: FlowContext): Promise<Plan>;
|
|
24
|
+
//# sourceMappingURL=init-flow.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"init-flow.d.ts","sourceRoot":"","sources":["../../src/cli/init-flow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiF,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACtI,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEjF,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAA0D,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAIjG,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACvE;AAwBD,wBAAsB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8F/D"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { Contrast } from '../core/init/palette.js';
|
|
2
|
+
export interface Look {
|
|
3
|
+
/** Whether ANSI color may be used */
|
|
4
|
+
color: boolean;
|
|
5
|
+
/** Whether the terminal shows 24-bit color; otherwise the nearest of the 256 colors is used */
|
|
6
|
+
truecolor: boolean;
|
|
7
|
+
}
|
|
8
|
+
/** Color is on for a terminal, unless NO_COLOR is set or TERM is dumb; FORCE_COLOR turns it on (NO_COLOR still wins). */
|
|
9
|
+
export declare function lookFor(env?: NodeJS.ProcessEnv, tty?: boolean): Look;
|
|
10
|
+
declare const PLAIN: Look;
|
|
11
|
+
export { PLAIN };
|
|
12
|
+
/** A block of the color; without color, the hex in brackets. */
|
|
13
|
+
export declare function swatch(hex: string, look: Look, width?: number): string;
|
|
14
|
+
/** The color, a swatch, and how it reads on white and on near-black. One line each. */
|
|
15
|
+
export declare function contrastLines(hex: string, look: Look, c?: Contrast): string[];
|
|
16
|
+
/** What the label on the color will be: blazon's labels are graphite, bone when graphite is under AA, and a warning when neither reaches it. */
|
|
17
|
+
export declare function labelNote(hex: string): string;
|
|
18
|
+
export declare const stepTitle: (n: number, of: number, name: string) => string;
|
|
19
|
+
export declare function kilobytes(bytes: number): string;
|
|
20
|
+
//# sourceMappingURL=init-ui.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"init-ui.d.ts","sourceRoot":"","sources":["../../src/cli/init-ui.ts"],"names":[],"mappings":"AACA,OAAO,EAAiC,KAAK,QAAQ,EAAc,MAAM,yBAAyB,CAAC;AAKnG,MAAM,WAAW,IAAI;IACnB,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,+FAA+F;IAC/F,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,yHAAyH;AACzH,wBAAgB,OAAO,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,GAAG,GAAE,OAAuC,GAAG,IAAI,CAIhH;AAED,QAAA,MAAM,KAAK,EAAE,IAAyC,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,CAAC;AASjB,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,SAAI,GAAG,MAAM,CAEjE;AAMD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAE,QAA0B,GAAG,MAAM,EAAE,CAO9F;AAED,gJAAgJ;AAChJ,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,KAAG,MAAkC,CAAC;AAEnG,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { Finding } from '../types/index.js';
|
|
2
|
+
import { InitOptions } from './commands/init.js';
|
|
3
|
+
/**
|
|
4
|
+
* Runs a command that finds things and prints what it found as one JSON document on standard output. Everything else the
|
|
5
|
+
* command prints (its banner, its list of findings) goes to standard error for the time it runs, so a script can parse
|
|
6
|
+
* standard output whole. `counts` and `passed` cover every finding; `severity` only cuts the list. Exit status: 0 passed, 1 not passed. A command that cannot start throws, and prints nothing here.
|
|
7
|
+
*/
|
|
8
|
+
export declare const SEVERITIES: readonly ["error", "warning", "info"];
|
|
9
|
+
export type SeverityOption = (typeof SEVERITIES)[number];
|
|
10
|
+
export declare function asJson(command: 'check' | 'build' | 'tokens', strict: boolean, run: () => Promise<{
|
|
11
|
+
findings: Finding[];
|
|
12
|
+
}>, severity?: SeverityOption): Promise<void>;
|
|
13
|
+
/**
|
|
14
|
+
* `blazon init --json`: never asks, prints what it made as one JSON document on standard output and its usual text on standard error.
|
|
15
|
+
* `created` and `kept` are paths in the folder; a starter file that was already there is kept, not overwritten. Exit status: init's own.
|
|
16
|
+
*/
|
|
17
|
+
export declare function initAsJson(dir: string, options: InitOptions): Promise<number>;
|
|
18
|
+
//# sourceMappingURL=json.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/cli/json.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAW,KAAK,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,UAAU,uCAAwC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAKzD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,EACrC,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,MAAM,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,EAC3C,QAAQ,GAAE,cAAuB,GAChC,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBnF"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { CAC } from 'cac';
|
|
2
|
+
import { CliOption, Operation } from '../core/operations/index.js';
|
|
3
|
+
/** The first word of each command whose `--json` prints the result, for the error that `--json` turns into JSON. */
|
|
4
|
+
export declare const JSON_COMMANDS: string[];
|
|
5
|
+
/** The text that registers a command with the parser: `get <path> [dir]`. A positional is required when the input requires it. */
|
|
6
|
+
export declare function rawName(op: Operation): string;
|
|
7
|
+
/** The flag for an option: `--json`, `--type <type>`, `--key <path>`. */
|
|
8
|
+
export declare function flagOf(op: Operation, option: CliOption): string;
|
|
9
|
+
/** Registers every operation that has a command. The registration order is the order of `rank` in the list. */
|
|
10
|
+
export declare function registerOperations(cli: CAC, debug: boolean): void;
|
|
11
|
+
//# sourceMappingURL=operations.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/cli/operations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAiC,KAAK,SAAS,EAAgB,KAAK,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAY1H,oHAAoH;AACpH,eAAO,MAAM,aAAa,EAAE,MAAM,EAEI,CAAC;AAEvC,kIAAkI;AAClI,wBAAgB,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAI7C;AAED,yEAAyE;AACzE,wBAAgB,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAI/D;AAKD,+GAA+G;AAC/G,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CA6BjE"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { CAC } from 'cac';
|
|
2
|
+
/**
|
|
3
|
+
* Gives every text option the text that was typed. The parser turns a value that looks like a number into a number, and an empty one
|
|
4
|
+
* into 0, so `--name ""` became the title "0" and `--name 007` became 7. A value that is not there at all is refused: an
|
|
5
|
+
* empty value is nearly always an unset variable in a script. The options that name a port, and those that can repeat, are left alone.
|
|
6
|
+
*/
|
|
7
|
+
export declare function restoreOptionText(cli: CAC, argv: string[]): void;
|
|
8
|
+
//# sourceMappingURL=options.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/cli/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAU/B;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA2BhE"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { BlazonConfig, UserBlazonConfig } from '../types/index.js';
|
|
2
|
+
/** The folder a command was pointed at must exist: a build of a folder that is not there must not make one. */
|
|
3
|
+
export declare function requireFolder(cwd: string): void;
|
|
4
|
+
/** The folder of tokens must exist: a brand book with no tokens is a typo in the path, not an empty brand. */
|
|
5
|
+
export declare function requireTokens(cwd: string, tokensDir: string): void;
|
|
6
|
+
/** The config of the brand book in `cwd`, after checking that there is a folder and a tokens folder to read. */
|
|
7
|
+
export declare function loadProject(cwd: string, overrides?: UserBlazonConfig): Promise<BlazonConfig>;
|
|
8
|
+
//# sourceMappingURL=project.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/cli/project.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQxE,+GAA+G;AAC/G,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,8GAA8G;AAC9G,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAIlE;AAED,gHAAgH;AAChH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKlG"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { BlazonConfig, BlazonData } from '../types/index.js';
|
|
2
|
+
/** The brand in `dir`, from the same compile as `check`. A brand with errors is still read; standard error says so, since a value may be wrong. */
|
|
3
|
+
export declare function readBrand(dir: string): Promise<{
|
|
4
|
+
config: BlazonConfig;
|
|
5
|
+
data: BlazonData;
|
|
6
|
+
}>;
|
|
7
|
+
/** Runs a lookup. A token that is not there, or not a color, is a wrong use of the command line: exit 2, nothing printed on standard output. */
|
|
8
|
+
export declare function asked<T>(lookup: () => T): T;
|
|
9
|
+
/** The one JSON document `--json` prints: `command` and `passed` first, as `check --json` does. */
|
|
10
|
+
export declare function printJson(command: string, passed: boolean, body: object): void;
|
|
11
|
+
/** A list of "label value" lines, the labels lined up. */
|
|
12
|
+
export declare function printRows(rows: [string, string | undefined][], indent?: string): void;
|
|
13
|
+
//# sourceMappingURL=read.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/cli/read.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIlE,mJAAmJ;AACnJ,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAMhG;AAED,gJAAgJ;AAChJ,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAO3C;AAED,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9E;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,EAAE,MAAM,SAAO,GAAG,IAAI,CAInF"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A project folder as a person types it from `from`: '' for the folder itself, a relative path for one below it, else the
|
|
3
|
+
* absolute path (a long "../../.." says less than the place itself).
|
|
4
|
+
*/
|
|
5
|
+
export declare function shownDir(dir: string, from?: string): string;
|
|
6
|
+
/** A file or folder of the project, from where blazon was run: `a/tokens/colors.json`. */
|
|
7
|
+
export declare const inDir: (dir: string, file: string) => string;
|
|
8
|
+
/** A blazon command that works from where blazon was run: `blazon dev a`, or `blazon dev` in the folder itself. */
|
|
9
|
+
export declare const blazonCommand: (command: string, dir: string) => string;
|
|
10
|
+
//# sourceMappingURL=where.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"where.d.ts","sourceRoot":"","sources":["../../src/cli/where.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAsB,GAAG,MAAM,CAI1E;AAED,0FAA0F;AAC1F,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,KAAG,MAAyC,CAAC;AAK5F,mHAAmH;AACnH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,KAAK,MAAM,KAAG,MAA+D,CAAC"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { Asset, AssetCatalog, AssetCategoryConfig, AssetCategoryInfo, Finding } from '../../types/index.js';
|
|
2
|
+
/** An extra folder a category is scanned from: where it is, and how the config wrote it. */
|
|
3
|
+
export interface CategoryRoot {
|
|
4
|
+
dir: string;
|
|
5
|
+
/** The path as written in the config, for messages: a real path would leak the machine into the data */
|
|
6
|
+
label: string;
|
|
7
|
+
}
|
|
8
|
+
export interface ResolvedCategories {
|
|
9
|
+
/** The valid entries; an invalid one is left out whole, so nothing is half applied */
|
|
10
|
+
configs: Record<string, AssetCategoryConfig>;
|
|
11
|
+
/** Absolute, symlink-resolved folders, by category key */
|
|
12
|
+
roots: Record<string, CategoryRoot>;
|
|
13
|
+
problems: Finding[];
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Reads and checks the `assets` block. Each problem is a finding on its key. The folders are resolved
|
|
17
|
+
* against the project and may sit outside it (a shared folder in a monorepo) only when the person running blazon approved that folder
|
|
18
|
+
* (`--allow-dir`, BLAZON_ALLOW_DIRS; confine.ts); the config cannot approve it. This is the one place that decides: the scanner, the
|
|
19
|
+
* builder, the dev server and the MCP tools all get their folders through it (categoryDirs). Only image files inside the folder are ever
|
|
20
|
+
* served or copied, never through a link that leaves it.
|
|
21
|
+
*/
|
|
22
|
+
export declare function resolveCategories(block: Record<string, unknown> | undefined, cwd: string): ResolvedCategories;
|
|
23
|
+
/** The folder each category with its own folder is scanned from, by key: what the server and the build read files from. */
|
|
24
|
+
export declare function categoryDirs(block: Record<string, unknown> | undefined, cwd: string): Record<string, string>;
|
|
25
|
+
/**
|
|
26
|
+
* Where an asset's file is on disk. An asset's `filePath` reads as if it sat in `assets/`; for a category with
|
|
27
|
+
* a folder of its own, the file is in that folder when it is there.
|
|
28
|
+
*/
|
|
29
|
+
export declare function assetSourcePath(asset: Asset, assetsDir: string, dirs: Record<string, string>): string;
|
|
30
|
+
/** "photography" becomes "Photography", "iconUsage" becomes "Icon usage". */
|
|
31
|
+
export declare function humanize(segment: string): string;
|
|
32
|
+
/** The categories that have assets, as the brand book shows them: configured `order` first, then logos, icons, the rest by name. */
|
|
33
|
+
export declare function assetCategoryInfo(catalog: AssetCatalog, configs: Record<string, AssetCategoryConfig>): AssetCategoryInfo[];
|
|
34
|
+
/** The asset ids in experimental or reference categories: neither is the live identity, so their `review` is data and does not gate the book. */
|
|
35
|
+
export declare function ungatedAssetIds(catalog: AssetCatalog, configs: Record<string, AssetCategoryConfig>): Set<string>;
|
|
36
|
+
/** The local categories (`local`) with no image here: their images were not made in this checkout. */
|
|
37
|
+
export declare function absentLocalCategories(catalog: AssetCatalog, configs: Record<string, AssetCategoryConfig>): Set<string>;
|
|
38
|
+
/** One note per absent local category, which stands in for the findings its absence would cause. */
|
|
39
|
+
export declare function absentLocalFindings(absent: ReadonlySet<string>, configs: Record<string, AssetCategoryConfig>): Finding[];
|
|
40
|
+
/** A configured key with no assets is usually a typo of a folder name. A local category says why it has none. */
|
|
41
|
+
export declare function unusedFindings(catalog: AssetCatalog, configs: Record<string, AssetCategoryConfig>): Finding[];
|
|
42
|
+
/**
|
|
43
|
+
* Tests each file against the rules of its category: its format, the pixel size of a raster image, and its
|
|
44
|
+
* aspect ratio. Each broken rule is an error on the file's id, as a broken contrast pair is on its tokens.
|
|
45
|
+
*/
|
|
46
|
+
export declare function ruleFindings(catalog: AssetCatalog, configs: Record<string, AssetCategoryConfig>): Finding[];
|
|
47
|
+
//# sourceMappingURL=categories.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../../src/core/assets/categories.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAA2B,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAmB1I,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,wGAAwG;IACxG,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC7C,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAiD7G;AA6CD,2HAA2H;AAC3H,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5G;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAGrG;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,oIAAoI;AACpI,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,iBAAiB,EAAE,CAyB1H;AAID,iJAAiJ;AACjJ,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAEhH;AAED,sGAAsG;AACtG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAEtH;AAED,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,OAAO,EAAE,CAIxH;AAED,iHAAiH;AACjH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,OAAO,EAAE,CAI7G;AAOD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,OAAO,EAAE,CAiC3G"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/** Where a statement came from: a document and the place in it. */
|
|
2
|
+
export interface Source {
|
|
3
|
+
doc: string;
|
|
4
|
+
locator: string;
|
|
5
|
+
}
|
|
6
|
+
export declare function isObject(value: unknown): value is Record<string, unknown>;
|
|
7
|
+
export declare function isSource(value: unknown): value is Source;
|
|
8
|
+
/** A list of plain strings with at least one entry and no blank one. */
|
|
9
|
+
export declare function isStringList(value: unknown): value is string[];
|
|
10
|
+
export declare const SOURCE_MESSAGE = "source must be {\"doc\": string, \"locator\": string}";
|
|
11
|
+
export declare const listMessage: (name: string) => string;
|
|
12
|
+
//# sourceMappingURL=fields.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/core/assets/fields.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAE9D;AAED,eAAO,MAAM,cAAc,0DAAsD,CAAC;AAElF,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAuD,CAAC"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { AssetFormat } from '../../types/index.js';
|
|
2
|
+
export interface PixelSize {
|
|
3
|
+
width: number;
|
|
4
|
+
height: number;
|
|
5
|
+
}
|
|
6
|
+
/** Bytes read from the start of a file; enough for every header image-size reads, except a JPEG with large metadata. */
|
|
7
|
+
export declare const HEADER_BYTES: number;
|
|
8
|
+
/** Pixel size from a raster file's header (PNG, GIF, JPEG, WebP, AVIF), or undefined when the header cannot be read. */
|
|
9
|
+
export declare function imageSize(format: AssetFormat, header: Buffer): PixelSize | undefined;
|
|
10
|
+
//# sourceMappingURL=image-size.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"image-size.d.ts","sourceRoot":"","sources":["../../../src/core/assets/image-size.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wHAAwH;AACxH,eAAO,MAAM,YAAY,QAAY,CAAC;AAEtC,wHAAwH;AACxH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAQpF"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { Asset, AssetDimension, AssetMeasure, AssetMeta, Finding } from '../../types/index.js';
|
|
2
|
+
export declare const dimensionToPx: (d: AssetDimension) => number;
|
|
3
|
+
/** True for a multiple of the artwork's unit, as opposed to a dimension. */
|
|
4
|
+
export declare function isUnits(measure: AssetMeasure): measure is {
|
|
5
|
+
units: number;
|
|
6
|
+
};
|
|
7
|
+
/**
|
|
8
|
+
* A measure in the artwork's own pixels. A multiple needs the sidecar's `unit`; without one it has no
|
|
9
|
+
* size, which the sidecar check reports before anything draws it.
|
|
10
|
+
*/
|
|
11
|
+
export declare function measurePx(measure: AssetMeasure, meta: Pick<AssetMeta, 'unit'>): number | undefined;
|
|
12
|
+
/** The artwork's own pixel size: a raster file's, an SVG's width and height, or its viewBox. Undefined when unknown. */
|
|
13
|
+
export declare function artworkSize(asset: Pick<Asset, 'width' | 'height' | 'viewBox'>): {
|
|
14
|
+
width: number;
|
|
15
|
+
height: number;
|
|
16
|
+
} | undefined;
|
|
17
|
+
/**
|
|
18
|
+
* A unit taller than its artwork is a unit measured in the wrong size, such as a logo re-exported at
|
|
19
|
+
* another resolution. One finding per sidecar, even when it describes an SVG and a PNG.
|
|
20
|
+
*/
|
|
21
|
+
export declare function unitFindings(assets: readonly Asset[]): Finding[];
|
|
22
|
+
//# sourceMappingURL=measure.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../../src/core/assets/measure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAMpG,eAAO,MAAM,aAAa,GAAI,GAAG,cAAc,KAAG,MAAyD,CAAC;AAE5G,4EAA4E;AAC5E,wBAAgB,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,IAAI;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAE3E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAGlG;AAED,wHAAwH;AACxH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAU7H;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,OAAO,EAAE,CAkBhE"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { AssetCatalog, AssetFormat, Finding, ParsedTokens } from '../../types/index.js';
|
|
2
|
+
import { CategoryRoot } from './categories.js';
|
|
3
|
+
/** File extension → format and media type. Anything else in the assets folder is ignored. */
|
|
4
|
+
export declare const ASSET_TYPES: Record<string, {
|
|
5
|
+
format: AssetFormat;
|
|
6
|
+
mediaType: string;
|
|
7
|
+
}>;
|
|
8
|
+
export interface ScanOptions {
|
|
9
|
+
/** Resolved tokens, for a sidecar that aliases a dimension token */
|
|
10
|
+
tokens?: ParsedTokens;
|
|
11
|
+
/** Receives sidecar problems, orphaned sidecars and ids that two files share */
|
|
12
|
+
problems?: Finding[];
|
|
13
|
+
/** Folders scanned as a category of their own, by category key (the `dir` of an `assets` entry) */
|
|
14
|
+
extraRoots?: Record<string, CategoryRoot>;
|
|
15
|
+
/** The lockups a sidecar may state; the standard ones when absent */
|
|
16
|
+
lockups?: readonly string[];
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Catalogs SVG and raster images under `assetsDir`, and under any extra folder a category names. A file's
|
|
20
|
+
* category is its first folder (`logos`, `icons`, or any other name); files at the top level get the
|
|
21
|
+
* category "assets"; every file under an extra folder gets that folder's category. A `<name>.json` beside
|
|
22
|
+
* an image is its sidecar (RFC 0001 §7); one with no image of that name is reported. Two files that share
|
|
23
|
+
* an id from different folders are reported too: the id would name both. Files are read in name order.
|
|
24
|
+
*/
|
|
25
|
+
export declare function scanAssets(assetsDir: string, options?: ScanOptions): AssetCatalog;
|
|
26
|
+
//# sourceMappingURL=scanner.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/core/assets/scanner.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8B,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAExI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,6FAA6F;AAC7F,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAQlF,CAAC;AA4EF,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,qEAAqE;IACrE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,YAAY,CAgErF"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { Asset, AssetMeta, Finding, ParsedTokens } from '../../types/index.js';
|
|
2
|
+
/**
|
|
3
|
+
* Reads the sidecar for an asset: `logos/mark.json` for `logos/mark.svg`. A missing sidecar is not a
|
|
4
|
+
* problem. A sidecar that is not valid JSON, has a bad field, or is a symlink out of the assets folder
|
|
5
|
+
* is an error and gives no metadata. `review-pending` is a warning, as on a token. An asset with `generated` and no `review` is an `asset-review-missing` warning.
|
|
6
|
+
*/
|
|
7
|
+
export declare function readSidecar(assetsDir: string, sidecarPath: string, assetId: string, tokens?: ParsedTokens,
|
|
8
|
+
/** Put before the path in findings: `<key>/` for a category scanned from its own folder */
|
|
9
|
+
displayPrefix?: string,
|
|
10
|
+
/** The lockups a sidecar may state: the standard ones and the brand's own (RFC 0002 §1) */
|
|
11
|
+
lockups?: readonly string[]): {
|
|
12
|
+
meta?: AssetMeta;
|
|
13
|
+
problems: Finding[];
|
|
14
|
+
};
|
|
15
|
+
/**
|
|
16
|
+
* A `replacedBelow` that names no asset, as an error on the sidecar. A name in a local category whose images
|
|
17
|
+
* are not in this checkout is not reported: the category's note says why it is missing.
|
|
18
|
+
*/
|
|
19
|
+
export declare function replacementFindings(assets: readonly Asset[], absentLocal: ReadonlySet<string>): Finding[];
|
|
20
|
+
/** An `initiative.mark` that names no asset, as an error on the sidecar; a name in a local category absent from this checkout is not reported, as for `replacedBelow`. */
|
|
21
|
+
export declare function initiativeFindings(assets: readonly Asset[], absentLocal: ReadonlySet<string>): Finding[];
|
|
22
|
+
//# sourceMappingURL=sidecar.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../../src/core/assets/sidecar.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,KAAK,EAGV,KAAK,SAAS,EACd,KAAK,OAAO,EAIZ,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AA2Q9B;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,YAAY;AACrB,2FAA2F;AAC3F,aAAa,SAAK;AAClB,2FAA2F;AAC3F,OAAO,GAAE,SAAS,MAAM,EAA0B,GACjD;IAAE,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CA6B3C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,EAAE,CAOzG;AAED,0KAA0K;AAC1K,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,EAAE,CAOxG"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { Finding } from '../types/index.js';
|
|
2
|
+
export declare const BLAZON_LOCK = "blazon.lock";
|
|
3
|
+
export interface BlazonIdentity {
|
|
4
|
+
commit: string;
|
|
5
|
+
/** True when the tree had changes git reported at the time (tracked, or untracked and not ignored) */
|
|
6
|
+
dirty: boolean;
|
|
7
|
+
from: 'build' | 'git';
|
|
8
|
+
}
|
|
9
|
+
/** The commit and cleanliness of the checkout at `root`, or undefined when it is not a git checkout. */
|
|
10
|
+
export declare function gitState(root: string): {
|
|
11
|
+
commit: string;
|
|
12
|
+
dirty: boolean;
|
|
13
|
+
} | undefined;
|
|
14
|
+
/** What this blazon is, as far as it can know. `stamp` and `root` are for tests. */
|
|
15
|
+
export declare function blazonIdentity(stamp?: {
|
|
16
|
+
commit: string;
|
|
17
|
+
dirty: boolean;
|
|
18
|
+
} | null | undefined, root?: string): BlazonIdentity | null;
|
|
19
|
+
export interface BlazonPin {
|
|
20
|
+
commit: string;
|
|
21
|
+
}
|
|
22
|
+
/** Read blazon.lock strictly. No file is no pin; a file with any mistake is an error, never a pin. */
|
|
23
|
+
export declare function readBlazonPin(cwd: string): {
|
|
24
|
+
pin?: BlazonPin;
|
|
25
|
+
line?: number;
|
|
26
|
+
problems: Finding[];
|
|
27
|
+
};
|
|
28
|
+
/**
|
|
29
|
+
* The findings for blazon.lock in `cwd`: none without a pin, `pin-invalid` for a file that cannot be read, and
|
|
30
|
+
* `pin-mismatch` when this blazon is not the pinned commit, was built from a tree with changes, or cannot say what it is.
|
|
31
|
+
* A pin that cannot be checked is not met.
|
|
32
|
+
*/
|
|
33
|
+
export declare function blazonPinFindings(cwd: string, identity?: BlazonIdentity | null, root?: string): Finding[];
|
|
34
|
+
/** Write blazon.lock for this blazon, replacing one that cannot be read, which is how a broken pin is mended. Throws an Error saying why not: an unknown or uncommitted blazon is not a version to pin. */
|
|
35
|
+
export declare function writeBlazonPin(cwd: string, identity?: BlazonIdentity | null): string;
|
|
36
|
+
//# sourceMappingURL=blazon-pin.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"blazon-pin.d.ts","sourceRoot":"","sources":["../../src/core/blazon-pin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAejD,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAIzC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;CACvB;AAYD,wGAAwG;AACxG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAIrF;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAC5B,KAAK,GAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAkF,EACrI,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,GAAG,IAAI,CAMvB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,GAAG,CAAC,EAAE,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CAgBlG;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAc,GAAG,IAAuB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAsB3H;AAED,2MAA2M;AAC3M,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAc,GAAG,IAAuB,GAAG,MAAM,CAgBtG"}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { AssetCategoryInfo, AssetMeta, Finding, BlazonConfig, BlazonData, BlazonExtension, IconSet, SectionId, SectionInfo, ThemeRole, Vocabulary } from '../../types/index.js';
|
|
2
|
+
import { ShadcnMapping } from '../tokens/shadcn.js';
|
|
3
|
+
import { BRAND_SCHEMA_FILE } from './schema.js';
|
|
4
|
+
import { BlazonIdentity } from '../blazon-pin.js';
|
|
5
|
+
export declare const BRAND_FORMAT = "blazon-brand";
|
|
6
|
+
/** Changes only when a field is removed or changes meaning. Adding a field does not change it. */
|
|
7
|
+
export declare const BRAND_VERSION = 1;
|
|
8
|
+
export interface BrandToken {
|
|
9
|
+
path: string;
|
|
10
|
+
type?: string;
|
|
11
|
+
/** CSS-ready: "#635DFF", "24px" */
|
|
12
|
+
value: string | number;
|
|
13
|
+
/** DTCG structure with every alias replaced */
|
|
14
|
+
resolvedValue: unknown;
|
|
15
|
+
/** As authored, aliases included */
|
|
16
|
+
rawValue: unknown;
|
|
17
|
+
/** The parts of a composite value, CSS-ready */
|
|
18
|
+
parts?: Record<string, string | number>;
|
|
19
|
+
aliasOf?: string;
|
|
20
|
+
description?: string;
|
|
21
|
+
deprecated?: boolean | string;
|
|
22
|
+
cssVariable: string;
|
|
23
|
+
/** The token file it was authored in, in the project. Not shipped beside brand.json, unlike an asset's `file` */
|
|
24
|
+
sourceFile: string;
|
|
25
|
+
/** `$extensions` other than `dev.blazon`, as authored */
|
|
26
|
+
extensions?: Record<string, unknown>;
|
|
27
|
+
/** `dev.blazon`: usage, role, tier, print values, source, review, angle, preview */
|
|
28
|
+
blazon?: BlazonExtension;
|
|
29
|
+
}
|
|
30
|
+
export interface BrandExport {
|
|
31
|
+
/** The JSON Schema this file follows, as a path beside it */
|
|
32
|
+
$schema: typeof BRAND_SCHEMA_FILE;
|
|
33
|
+
format: typeof BRAND_FORMAT;
|
|
34
|
+
version: typeof BRAND_VERSION;
|
|
35
|
+
/** Which blazon wrote the file. No timestamp or host: the file is the same for the same inputs and blazon. `commit` and `dirty` are absent when blazon cannot say its commit */
|
|
36
|
+
generator: {
|
|
37
|
+
name: 'blazon';
|
|
38
|
+
commit?: string;
|
|
39
|
+
dirty?: boolean;
|
|
40
|
+
};
|
|
41
|
+
brand: {
|
|
42
|
+
title: string;
|
|
43
|
+
description?: string;
|
|
44
|
+
};
|
|
45
|
+
theme: {
|
|
46
|
+
roles: Partial<Record<ThemeRole, string>>;
|
|
47
|
+
tokens: Partial<Record<ThemeRole, string>>;
|
|
48
|
+
fonts: string[];
|
|
49
|
+
/**
|
|
50
|
+
* The shadcn/ui variables (names without the leading dashes): for each one blazon can supply, the token it comes from and its value in the
|
|
51
|
+
* default context; `unsupplied` lists the rest; `pairs` (only when the brand declares contrast `pairs`) says which shadcn text-on-surface
|
|
52
|
+
* pairs a rule covers. Blazon writes no shadcn file: the reader writes the CSS
|
|
53
|
+
*/
|
|
54
|
+
shadcn: ShadcnMapping;
|
|
55
|
+
};
|
|
56
|
+
/** A path beside brand.json, or the file embedded as a data URI when it is not an asset. `onLightInk` and `onDarkInk`: the color a logo's sidecar declares for it, when it does; without one a reader judges the file as black on light or white on dark */
|
|
57
|
+
logo: {
|
|
58
|
+
onLight?: string;
|
|
59
|
+
onDark?: string;
|
|
60
|
+
onLightInk?: string;
|
|
61
|
+
onDarkInk?: string;
|
|
62
|
+
};
|
|
63
|
+
/** The lockups and usage roles a value may name: the standard ones, then the brand's own */
|
|
64
|
+
vocabulary: Vocabulary;
|
|
65
|
+
/** Every section a page may declare, with its title, so a reader needs no blazon to name a custom one */
|
|
66
|
+
sections: SectionInfo[];
|
|
67
|
+
tokens: BrandToken[];
|
|
68
|
+
/** Groups that carry a description or rules: proportions, contrast pairs, patterns */
|
|
69
|
+
groups: {
|
|
70
|
+
path: string;
|
|
71
|
+
description?: string;
|
|
72
|
+
blazon: BlazonExtension;
|
|
73
|
+
}[];
|
|
74
|
+
modifiers: {
|
|
75
|
+
name: string;
|
|
76
|
+
default: string;
|
|
77
|
+
contexts: string[];
|
|
78
|
+
}[];
|
|
79
|
+
/**
|
|
80
|
+
* Each non-default context with only what it changes: `tokens` have another value, `metadataChanges` (absent when there are none) keep the
|
|
81
|
+
* default's value and say something else
|
|
82
|
+
*/
|
|
83
|
+
contexts: {
|
|
84
|
+
modifier: string;
|
|
85
|
+
context: string;
|
|
86
|
+
selector: string;
|
|
87
|
+
tokens: BrandToken[];
|
|
88
|
+
metadataChanges?: BrandToken[];
|
|
89
|
+
}[];
|
|
90
|
+
pages: {
|
|
91
|
+
slug: string;
|
|
92
|
+
sourceFile: string;
|
|
93
|
+
title: string;
|
|
94
|
+
order: number;
|
|
95
|
+
meta: Record<string, unknown>;
|
|
96
|
+
sections: SectionId[];
|
|
97
|
+
markdown: string;
|
|
98
|
+
directives: {
|
|
99
|
+
name: string;
|
|
100
|
+
args: string[];
|
|
101
|
+
}[];
|
|
102
|
+
}[];
|
|
103
|
+
assets: {
|
|
104
|
+
id: string;
|
|
105
|
+
name: string;
|
|
106
|
+
category: string;
|
|
107
|
+
/** Beside brand.json */
|
|
108
|
+
file: string;
|
|
109
|
+
format: string;
|
|
110
|
+
mediaType: string;
|
|
111
|
+
bytes: number;
|
|
112
|
+
/** The artwork's own pixel size, when known */
|
|
113
|
+
width?: number;
|
|
114
|
+
height?: number;
|
|
115
|
+
/** What its sidecar states */
|
|
116
|
+
meta?: AssetMeta;
|
|
117
|
+
}[];
|
|
118
|
+
categories: AssetCategoryInfo[];
|
|
119
|
+
iconSets: (IconSet & {
|
|
120
|
+
dir: string;
|
|
121
|
+
})[];
|
|
122
|
+
findings: Finding[];
|
|
123
|
+
}
|
|
124
|
+
/** Builds the export: a pure projection of the compiled brand, with no timestamps, so it is the same every time. */
|
|
125
|
+
export declare function buildBrandExport(data: BlazonData, config: BlazonConfig, cwd: string, identity?: BlazonIdentity | null): BrandExport;
|
|
126
|
+
/** brand.json as written: two-space JSON with a final newline. */
|
|
127
|
+
export declare function formatBrandJson(data: BlazonData, config: BlazonConfig, cwd: string, identity?: BlazonIdentity | null): string;
|
|
128
|
+
//# sourceMappingURL=export.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/core/brand/export.ts"],"names":[],"mappings":"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"}
|