@tempoxyz/ds 0.3.10 → 0.3.13

package/src/marketing/zyzz.config.ts

@@ -0,0 +1,376 @@
+import { Config } from 'zyzz'
+import { fontFace, global } from 'zyzz/web'
+import { variables } from './vars.js'
+
+/**
+ * Zyzz authoring helpers bound to the Marketing variables, so token strings such as
+ * `content.primary`, `'6'` and `body.b2` type-check and compile ahead of time.
+ *
+ * - `style(definition)` returns a callable that produces `className` and `style` props.
+ * - `variants({ base, variants, defaultVariants })` returns a callable that takes the variant
+ *   selection.
+ * - `vars` holds references such as `vars.ease.snappy`. Call `vars({ colorScheme })` for props
+ *   that apply the variables, and optionally a color scheme, to a scope.
+ *
+ * @example
+ * namespace styles {
+ *   export const panel = style({ backgroundColor: 'background.elevated', padding: '24' })
+ * }
+ *
+ * <section {...styles.panel()} />
+ */
+export const { style, variants, vars } = Config.create({
+  cssOutput: 'atomic',
+  id: 'tds/marketing',
+  // React Native's axis shorthands. Zyzz reads config options as literal data, so each config repeats them.
+  shorthands: {
+    marginHorizontal: ['marginLeft', 'marginRight'],
+    marginVertical: ['marginTop', 'marginBottom'],
+    paddingHorizontal: ['paddingLeft', 'paddingRight'],
+    paddingVertical: ['paddingTop', 'paddingBottom'],
+  },
+  vars: variables,
+})
+
+// Inter's subsets, written by `scripts/subset-fonts.ts`. A browser downloads only the subsets whose
+// `unicodeRange` the page's text uses, and a face declared later takes precedence where ranges
+// overlap, so the order is intentional: `symbols` first and `latin` last, as Google Fonts orders them.
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Inter',
+  fontStyle: 'normal',
+  fontWeight: '100 900',
+  src: "url('../fonts/Inter-symbols.woff2') format('woff2')",
+  unicodeRange:
+    'U+02CD-036F,U+0E3F,U+1DC0-1DFF,U+2070-2298,U+2303-232B,U+2380-238B,U+23CE-23CF,U+2423-2468,U+24B6-24EA,U+25A0-26A0,U+2713-2788,U+27EF-27FA,U+2913,U+2A38,U+2B06-2B24,U+2E18,U+A92E,U+E000-E163,U+E1C3-E2DC,U+EE01-EEE1,U+F6C3,U+1F12F-1F16B,U+1F850-1F852',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Inter',
+  fontStyle: 'normal',
+  fontWeight: '100 900',
+  src: "url('../fonts/Inter-cyrillic-ext.woff2') format('woff2')",
+  unicodeRange: 'U+0460-052F,U+1C80-1C8A,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Inter',
+  fontStyle: 'normal',
+  fontWeight: '100 900',
+  src: "url('../fonts/Inter-cyrillic.woff2') format('woff2')",
+  unicodeRange: 'U+0301,U+0400-045F,U+0490-0491,U+04B0-04B1,U+2116',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Inter',
+  fontStyle: 'normal',
+  fontWeight: '100 900',
+  src: "url('../fonts/Inter-greek-ext.woff2') format('woff2')",
+  unicodeRange: 'U+1F00-1FFF',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Inter',
+  fontStyle: 'normal',
+  fontWeight: '100 900',
+  src: "url('../fonts/Inter-greek.woff2') format('woff2')",
+  unicodeRange: 'U+0370-0377,U+037A-037F,U+0384-038A,U+038C,U+038E-03A1,U+03A3-03FF',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Inter',
+  fontStyle: 'normal',
+  fontWeight: '100 900',
+  src: "url('../fonts/Inter-vietnamese.woff2') format('woff2')",
+  unicodeRange:
+    'U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Inter',
+  fontStyle: 'normal',
+  fontWeight: '100 900',
+  src: "url('../fonts/Inter-latin-ext.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Inter',
+  fontStyle: 'normal',
+  fontWeight: '100 900',
+  src: "url('../fonts/Inter-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+// The JetBrains Mono and Pilat subsets, also written by `scripts/subset-fonts.ts`. Each weight has a
+// `latin` subset with Inter's Latin range and an `other` subset with every other character. The
+// `latin` face is declared after the `other` face, so it takes precedence where their ranges overlap.
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'JetBrains Mono',
+  fontStyle: 'normal',
+  fontWeight: 400,
+  src: "url('../fonts/JetBrainsMono-Regular-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0259,U+02B9-04F5,U+0AEA,U+1E80-1EF9,U+2070-20BF,U+2102-2140,U+218A-2424,U+2500-25F6,U+266D-26A1,U+2713-27F7,U+2916-2988,U+2A00-2A06,U+2B58,U+E0A0-E0B3,U+FE62,U+FF5B-FF5D,U+16910,U+1D538-1D56B',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'JetBrains Mono',
+  fontStyle: 'normal',
+  fontWeight: 400,
+  src: "url('../fonts/JetBrainsMono-Regular-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'JetBrains Mono',
+  fontStyle: 'normal',
+  fontWeight: 500,
+  src: "url('../fonts/JetBrainsMono-Medium-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0259,U+02B9-04F5,U+0AEA,U+1E80-1EF9,U+2070-20BF,U+2102-2140,U+218A-2424,U+2500-25F6,U+266D-26A1,U+2713-27F7,U+2916-2988,U+2A00-2A06,U+2B58,U+E0A0-E0B3,U+FE62,U+FF5B-FF5D,U+16910,U+1D538-1D56B',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'JetBrains Mono',
+  fontStyle: 'normal',
+  fontWeight: 500,
+  src: "url('../fonts/JetBrainsMono-Medium-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'JetBrains Mono',
+  fontStyle: 'normal',
+  fontWeight: 600,
+  src: "url('../fonts/JetBrainsMono-SemiBold-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0259,U+02B9-04F5,U+0AEA,U+1E80-1EF9,U+2070-20BF,U+2102-2140,U+218A-2424,U+2500-25F6,U+266D-26A1,U+2713-27F7,U+2916-2988,U+2A00-2A06,U+2B58,U+E0A0-E0B3,U+FE62,U+FF5B-FF5D,U+16910,U+1D538-1D56B',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'JetBrains Mono',
+  fontStyle: 'normal',
+  fontWeight: 600,
+  src: "url('../fonts/JetBrainsMono-SemiBold-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'JetBrains Mono',
+  fontStyle: 'normal',
+  fontWeight: 700,
+  src: "url('../fonts/JetBrainsMono-Bold-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0259,U+02B9-04F5,U+0AEA,U+1E80-1EF9,U+2070-20BF,U+2102-2140,U+218A-2424,U+2500-25F6,U+266D-26A1,U+2713-27F7,U+2916-2988,U+2A00-2A06,U+2B58,U+E0A0-E0B3,U+FE62,U+FF5B-FF5D,U+16910,U+1D538-1D56B',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'JetBrains Mono',
+  fontStyle: 'normal',
+  fontWeight: 700,
+  src: "url('../fonts/JetBrainsMono-Bold-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 100,
+  src: "url('../fonts/Pilat-Thin-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0192,U+01FA-0237,U+02C7-0328,U+03A9-03C0,U+1E80-1E85,U+1EF2-1EF3,U+2070-208E,U+2113-212E,U+2190-2199,U+2202-2265,U+25CA-25CC,U+FB00',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 100,
+  src: "url('../fonts/Pilat-Thin-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 300,
+  src: "url('../fonts/Pilat-Light-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0192,U+01FA-0237,U+02C7-0328,U+03A9-03C0,U+1E80-1E85,U+1EF2-1EF3,U+2070-208E,U+2113-212E,U+2190-2199,U+2202-2265,U+25CA-25CC,U+FB00',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 300,
+  src: "url('../fonts/Pilat-Light-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 400,
+  src: "url('../fonts/Pilat-Regular-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0192,U+01FA-0237,U+02C7-0328,U+03A9-03C0,U+1E80-1E85,U+1EF2-1EF3,U+2070-208E,U+2113-212E,U+2190-2199,U+2202-2265,U+25CA-25CC,U+FB00',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 400,
+  src: "url('../fonts/Pilat-Regular-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 500,
+  src: "url('../fonts/Pilat-Book-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0192,U+01FA-0237,U+02C7-0328,U+03A9-03C0,U+1E80-1E85,U+1EF2-1EF3,U+2070-208E,U+2113-212E,U+2190-2199,U+2202-2265,U+25CA-25CC,U+FB00',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 500,
+  src: "url('../fonts/Pilat-Book-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 600,
+  src: "url('../fonts/Pilat-Demi-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0192,U+01FA-0237,U+02C7-0328,U+03A9-03C0,U+1E80-1E85,U+1EF2-1EF3,U+2070-208E,U+2113-212E,U+2190-2199,U+2202-2265,U+25CA-25CC,U+FB00',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 600,
+  src: "url('../fonts/Pilat-Demi-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 700,
+  src: "url('../fonts/Pilat-Bold-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0192,U+01FA-0237,U+02C7-0328,U+03A9-03C0,U+1E80-1E85,U+1EF2-1EF3,U+2070-208E,U+2113-212E,U+2190-2199,U+2202-2265,U+25CA-25CC,U+FB00',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 700,
+  src: "url('../fonts/Pilat-Bold-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 800,
+  src: "url('../fonts/Pilat-Heavy-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0192,U+01FA-0237,U+02C7-0328,U+03A9-03C0,U+1E80-1E85,U+1EF2-1EF3,U+2070-208E,U+2113-212E,U+2190-2199,U+2202-2265,U+25CA-25CC,U+FB00',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 800,
+  src: "url('../fonts/Pilat-Heavy-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 900,
+  src: "url('../fonts/Pilat-Black-other.woff2') format('woff2')",
+  unicodeRange:
+    'U+0100-0192,U+01FA-0237,U+02C7-0328,U+03A9-03C0,U+1E80-1E85,U+1EF2-1EF3,U+2070-208E,U+2113-212E,U+2190-2199,U+2202-2265,U+25CA-25CC,U+FB00',
+})
+
+fontFace({
+  fontDisplay: 'swap',
+  fontFamily: 'Pilat',
+  fontStyle: 'normal',
+  fontWeight: 900,
+  src: "url('../fonts/Pilat-Black-latin.woff2') format('woff2')",
+  unicodeRange:
+    'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
+})
+
+global({
+  // Squircles at 1.84 times the radius meet the 45 degree point of a round corner, which is where
+  // the designs' fully smoothed corners pass. Browsers without `corner-shape` skip the block.
+  // Pseudo-elements usually paint a state layer over their element, so they take its shape.
+  '@supports (corner-shape: squircle)': {
+    ':root': { '--tds-corner-scale': '1.84' },
+    ':where(*)': { cornerShape: 'squircle' },
+    ':where(*)::after, :where(*)::before': { cornerShape: 'inherit' },
+  },
+  body: {
+    WebkitFontSmoothing: 'antialiased',
+    MozOsxFontSmoothing: 'grayscale',
+    color: vars.color.content.secondary,
+    fontFamily: vars.typography.body.b1.fontFamily,
+    fontSize: vars.typography.body.b1.fontSize,
+    fontWeight: vars.typography.body.b1.fontWeight,
+    letterSpacing: vars.typography.body.b1.letterSpacing,
+    lineHeight: vars.typography.body.b1.lineHeight,
+  },
+})

package/src/oxlint/index.ts

@@ -1,10 +1,16 @@
 /** Oxlint plugin and configurations that check how an app uses `@tempoxyz/ds`. @module */
 import type { Plugin } from '@oxlint/plugins'
 import * as NoCrossSurface from './rules/NoCrossSurface.ts'
+import * as NoCustomValues from './rules/NoCustomValues.ts'
 import * as NoInternalImports from './rules/NoInternalImports.ts'
 import * as NoRawValues from './rules/NoRawValues.ts'
+import * as NoSingleKeyShortcuts from './rules/NoSingleKeyShortcuts.ts'
 import * as PreferComponent from './rules/PreferComponent.ts'
+import * as PreferLayout from './rules/PreferLayout.ts'
+import * as PreferProgress from './rules/PreferProgress.ts'
+import * as PreferSurface from './rules/PreferSurface.ts'
 import * as RequireAccessibleName from './rules/RequireAccessibleName.ts'
+import * as RequireScrollRegion from './rules/RequireScrollRegion.ts'
 
 /** An Oxlint rule severity. */
 export type Severity = 'error' | 'off' | 'warn'
@@ -31,6 +37,27 @@ const zyzz: Config['rules'] = {
   'zyzz/valid-styles': 'error',
 }
 
+/**
+ * Enables the TDS and Zyzz rules for a marketing site that renders `@tempoxyz/ds/marketing`.
+ *
+ * @example
+ * ```ts
+ * import { marketing } from '@tempoxyz/ds/oxlint'
+ *
+ * export default defineConfig({ lint: marketing })
+ * ```
+ */
+export const marketing: Config = {
+  jsPlugins: plugins,
+  rules: {
+    'tds/no-cross-surface': ['error', { surface: 'marketing' }],
+    'tds/no-internal-imports': 'error',
+    'tds/no-raw-values': 'warn',
+    'tds/require-accessible-name': 'error',
+    ...zyzz,
+  },
+}
+
 /**
  * Enables the TDS and Zyzz rules for an app that renders `@tempoxyz/ds/mobile`.
  *
@@ -66,23 +93,35 @@ export const web: Config = {
   jsPlugins: plugins,
   rules: {
     'tds/no-cross-surface': ['error', { surface: 'web' }],
+    'tds/no-custom-values': 'warn',
     'tds/no-internal-imports': 'error',
     'tds/no-raw-values': 'warn',
+    'tds/no-single-key-shortcuts': 'warn',
     'tds/prefer-component': 'warn',
+    'tds/prefer-layout': 'warn',
+    'tds/prefer-progress': 'warn',
+    'tds/prefer-surface': 'warn',
     'tds/require-accessible-name': 'error',
+    'tds/require-scroll-region': 'warn',
     ...zyzz,
   },
 }
 
-/** Register through `jsPlugins` as `tds`, then enable `tds/*` rules or spread `web` or `mobile`. */
+/** Register through `jsPlugins` as `tds`, then enable `tds/*` rules or spread `web`, `mobile`, or `marketing`. */
 const plugin: Plugin = {
   meta: { name: 'tds' },
   rules: {
     'no-cross-surface': NoCrossSurface.rule,
+    'no-custom-values': NoCustomValues.rule,
     'no-internal-imports': NoInternalImports.rule,
     'no-raw-values': NoRawValues.rule,
+    'no-single-key-shortcuts': NoSingleKeyShortcuts.rule,
     'prefer-component': PreferComponent.rule,
+    'prefer-layout': PreferLayout.rule,
+    'prefer-progress': PreferProgress.rule,
+    'prefer-surface': PreferSurface.rule,
     'require-accessible-name': RequireAccessibleName.rule,
+    'require-scroll-region': RequireScrollRegion.rule,
   },
 }
 

package/src/oxlint/internal/Docs.ts

@@ -0,0 +1,18 @@
+/** Builds links to the Tempo Design System docs that lint messages cite. @module */
+
+const origin = 'https://ds.tehq.dev/product'
+
+/**
+ * Returns the docs page of a component, such as `https://ds.tehq.dev/product/components/list-group`
+ * for `ListGroup`. A part, such as `ListGroup.Meter`, links the page of its component.
+ */
+export function component(name: string): string {
+  const [head = name] = name.split('.')
+
+  return `${origin}/components/${head.replace(/(?<=[\da-z])(?=[A-Z])/g, '-').toLowerCase()}`
+}
+
+/** Returns a docs page by its path under `/product`, such as `foundations/layout#spacing`. */
+export function page(path: string): string {
+  return `${origin}/${path}`
+}

package/src/oxlint/internal/Imports.ts

@@ -3,7 +3,7 @@ import type { ESTree, Visitor } from '@oxlint/plugins'
 import * as Module from 'node:module'
 
 /** A library surface, named after the entrypoint that ships it. */
-export type Surface = 'mobile' | 'web'
+export type Surface = 'marketing' | 'mobile' | 'web'
 
 // The manifest sits three levels up from both `src/oxlint/internal` and `dist/oxlint/internal`.
 const manifest: { exports: Record<string, unknown>; name: string } = Module.createRequire(
@@ -29,6 +29,7 @@ export function surface(source: string): Surface | undefined {
 
   const subpath = source.slice(name.length)
 
+  if (subpath === '/marketing' || subpath.startsWith('/marketing/')) return 'marketing'
   if (subpath === '/mobile' || subpath.startsWith('/mobile/')) return 'mobile'
   if (subpath === '' || subpath.startsWith('/fonts/') || subpath.startsWith('/icons')) return 'web'
   return undefined