zdp-design-system 0.43.8

package/dist/schemas/design-tokens.schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "design-tokens.schema.json",
+  "title": "ZDP design token document",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema",
+    "name",
+    "version",
+    "color",
+    "space",
+    "radius",
+    "font",
+    "type",
+    "breakpoint",
+    "control",
+    "i18n",
+    "shadow",
+    "motion"
+  ],
+  "properties": {
+    "$schema": {
+      "const": "../schemas/design-tokens.schema.json"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "color": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": {
+          "$ref": "#/$defs/colorToken"
+        }
+      }
+    },
+    "space": {
+      "$ref": "#/$defs/stringMap"
+    },
+    "radius": {
+      "$ref": "#/$defs/stringMap"
+    },
+    "font": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "family",
+        "size",
+        "weight",
+        "lineHeight"
+      ],
+      "properties": {
+        "family": {
+          "$ref": "#/$defs/stringMap"
+        },
+        "size": {
+          "$ref": "#/$defs/stringMap"
+        },
+        "weight": {
+          "$ref": "#/$defs/stringMap"
+        },
+        "lineHeight": {
+          "$ref": "#/$defs/stringMap"
+        }
+      }
+    },
+    "type": {
+      "$ref": "#/$defs/stringMap"
+    },
+    "breakpoint": {
+      "$ref": "#/$defs/stringMap"
+    },
+    "control": {
+      "$ref": "#/$defs/stringMap"
+    },
+    "i18n": {
+      "$ref": "#/$defs/stringMap"
+    },
+    "shadow": {
+      "$ref": "#/$defs/stringMap"
+    },
+    "motion": {
+      "$ref": "#/$defs/stringMap"
+    }
+  },
+  "$defs": {
+    "colorToken": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "hex",
+        "oklch"
+      ],
+      "properties": {
+        "hex": {
+          "type": "string",
+          "pattern": "^#[0-9a-fA-F]{6}$"
+        },
+        "oklch": {
+          "type": "string",
+          "pattern": "^oklch\\([^)]+\\)$"
+        }
+      }
+    },
+    "stringMap": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  }
+}

package/dist/segmented.ts

@@ -0,0 +1,8 @@
+export type ZdpSegmentedControlSize = 'sm' | 'md';
+
+export interface ZdpSegmentedControlItem {
+  readonly id: string;
+  readonly label: string;
+  readonly ariaLabel?: string;
+  readonly disabled?: boolean;
+}

package/dist/share.d.ts

@@ -0,0 +1,48 @@
+export type ZdpShareIconName = 'copy' | 'device' | 'telegram' | 'line' | 'whatsapp' | 'x' | 'reddit';
+
+export interface ZdpShareIconPath {
+  readonly d: string;
+  readonly fill?: boolean;
+  readonly stroke?: boolean;
+  readonly strokeLinecap?: 'round';
+  readonly strokeLinejoin?: 'round';
+  readonly strokeWidth?: string;
+}
+
+export interface ZdpShareIconCircle {
+  readonly cx: string;
+  readonly cy: string;
+  readonly r: string;
+  readonly fill?: boolean;
+  readonly stroke?: boolean;
+  readonly strokeWidth?: string;
+}
+
+export interface ZdpShareIconLine {
+  readonly x1: string;
+  readonly y1: string;
+  readonly x2: string;
+  readonly y2: string;
+  readonly strokeWidth?: string;
+}
+
+export interface ZdpShareIconShape {
+  readonly viewBox: string;
+  readonly paths?: readonly ZdpShareIconPath[];
+  readonly circles?: readonly ZdpShareIconCircle[];
+  readonly lines?: readonly ZdpShareIconLine[];
+}
+
+export interface ZdpShareDockItem {
+  readonly id: string;
+  readonly label: string;
+  readonly icon: ZdpShareIconName;
+  readonly href?: string;
+  readonly target?: '_blank' | '_self' | '_parent' | '_top';
+  readonly rel?: string;
+  readonly disabled?: boolean;
+  readonly ariaLabel?: string;
+  readonly onclick?: (event: MouseEvent, item: ZdpShareDockItem) => void;
+}
+
+export declare const zdpShareIcons: Record<ZdpShareIconName, ZdpShareIconShape>;

package/dist/share.js

@@ -0,0 +1,115 @@
+export const zdpShareIcons = {
+  "copy": {
+    "viewBox": "0 0 24 24",
+    "paths": [
+      {
+        "d": "M9.5 13.5 14.5 8.5",
+        "fill": false,
+        "stroke": true,
+        "strokeLinecap": "round",
+        "strokeWidth": "2"
+      },
+      {
+        "d": "m8.2 9.8-1.4 1.4a4 4 0 0 0 5.7 5.7l1.2-1.2",
+        "fill": false,
+        "stroke": true,
+        "strokeLinecap": "round",
+        "strokeLinejoin": "round",
+        "strokeWidth": "2"
+      },
+      {
+        "d": "m10.3 8.3 1.2-1.2a4 4 0 0 1 5.7 5.7l-1.4 1.4",
+        "fill": false,
+        "stroke": true,
+        "strokeLinecap": "round",
+        "strokeLinejoin": "round",
+        "strokeWidth": "2"
+      }
+    ]
+  },
+  "device": {
+    "viewBox": "0 0 24 24",
+    "lines": [
+      {
+        "x1": "9",
+        "y1": "12",
+        "x2": "15",
+        "y2": "7",
+        "strokeWidth": "2"
+      },
+      {
+        "x1": "9",
+        "y1": "12",
+        "x2": "15",
+        "y2": "17",
+        "strokeWidth": "2"
+      }
+    ],
+    "circles": [
+      {
+        "cx": "7",
+        "cy": "12",
+        "r": "2.6",
+        "fill": false,
+        "stroke": true,
+        "strokeWidth": "2"
+      },
+      {
+        "cx": "17",
+        "cy": "6",
+        "r": "2.6",
+        "fill": false,
+        "stroke": true,
+        "strokeWidth": "2"
+      },
+      {
+        "cx": "17",
+        "cy": "18",
+        "r": "2.6",
+        "fill": false,
+        "stroke": true,
+        "strokeWidth": "2"
+      }
+    ]
+  },
+  "telegram": {
+    "viewBox": "0 0 24 24",
+    "paths": [
+      {
+        "d": "M11.944 0A12 12 0 0 0 0 12a12 12 0 0 0 12 12 12 12 0 0 0 12-12A12 12 0 0 0 12 0a12 12 0 0 0-.056 0zm4.962 7.224c.1-.002.321.023.465.14a.506.506 0 0 1 .171.325c.016.093.036.306.02.472-.18 1.898-.962 6.502-1.36 8.627-.168.9-.499 1.201-.82 1.23-.696.065-1.225-.46-1.9-.902-1.056-.693-1.653-1.124-2.678-1.8-1.185-.78-.417-1.21.258-1.91.177-.184 3.247-2.977 3.307-3.23.007-.032.014-.15-.056-.212s-.174-.041-.249-.024c-.106.024-1.793 1.14-5.061 3.345-.48.33-.913.49-1.302.48-.428-.008-1.252-.241-1.865-.44-.752-.245-1.349-.374-1.297-.789.027-.216.325-.437.893-.663 3.498-1.524 5.83-2.529 6.998-3.014 3.332-1.386 4.025-1.627 4.476-1.635z"
+      }
+    ]
+  },
+  "line": {
+    "viewBox": "0 0 24 24",
+    "paths": [
+      {
+        "d": "M19.365 9.863c.349 0 .63.285.63.631 0 .345-.281.63-.63.63H17.61v1.125h1.755c.349 0 .63.283.63.63 0 .344-.281.629-.63.629h-2.386c-.345 0-.627-.285-.627-.629V8.108c0-.345.282-.63.63-.63h2.386c.346 0 .627.285.627.63 0 .349-.281.63-.63.63H17.61v1.125h1.755zm-3.855 3.016c0 .27-.174.51-.432.596-.064.021-.133.031-.199.031-.211 0-.391-.09-.51-.25l-2.443-3.317v2.94c0 .344-.279.629-.631.629-.346 0-.626-.285-.626-.629V8.108c0-.27.173-.51.43-.595.06-.023.136-.033.194-.033.195 0 .375.104.495.254l2.462 3.33V8.108c0-.345.282-.63.63-.63.345 0 .63.285.63.63v4.771zm-5.741 0c0 .344-.282.629-.631.629-.345 0-.627-.285-.627-.629V8.108c0-.345.282-.63.63-.63.346 0 .628.285.628.63v4.771zm-2.466.629H4.917c-.345 0-.63-.285-.63-.629V8.108c0-.345.285-.63.63-.63.348 0 .63.285.63.63v4.141h1.756c.348 0 .629.283.629.63 0 .344-.282.629-.629.629M24 10.314C24 4.943 18.615.572 12 .572S0 4.943 0 10.314c0 4.811 4.27 8.842 10.035 9.608.391.082.923.258 1.058.59.12.301.079.766.038 1.08l-.164 1.02c-.045.301-.24 1.186 1.049.645 1.291-.539 6.916-4.078 9.436-6.975C23.176 14.393 24 12.458 24 10.314"
+      }
+    ]
+  },
+  "whatsapp": {
+    "viewBox": "0 0 24 24",
+    "paths": [
+      {
+        "d": "M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347m-5.421 7.403h-.004a9.87 9.87 0 01-5.031-1.378l-.361-.214-3.741.982.998-3.648-.235-.374a9.86 9.86 0 01-1.51-5.26c.001-5.45 4.436-9.884 9.888-9.884 2.64 0 5.122 1.03 6.988 2.898a9.825 9.825 0 012.893 6.994c-.003 5.45-4.437 9.884-9.885 9.884m8.413-18.297A11.815 11.815 0 0012.05 0C5.495 0 .16 5.335.157 11.892c0 2.096.547 4.142 1.588 5.945L.057 24l6.305-1.654a11.882 11.882 0 005.683 1.448h.005c6.554 0 11.89-5.335 11.893-11.893a11.821 11.821 0 00-3.48-8.413Z"
+      }
+    ]
+  },
+  "x": {
+    "viewBox": "0 0 24 24",
+    "paths": [
+      {
+        "d": "M14.234 10.162 22.977 0h-2.072l-7.591 8.824L7.251 0H.258l9.168 13.343L.258 24H2.33l8.016-9.318L16.749 24h6.993zm-2.837 3.299-.929-1.329L3.076 1.56h3.182l5.965 8.532.929 1.329 7.754 11.09h-3.182z"
+      }
+    ]
+  },
+  "reddit": {
+    "viewBox": "0 0 24 24",
+    "paths": [
+      {
+        "d": "M12 0C5.373 0 0 5.373 0 12c0 3.314 1.343 6.314 3.515 8.485l-2.286 2.286C.775 23.225 1.097 24 1.738 24H12c6.627 0 12-5.373 12-12S18.627 0 12 0Zm4.388 3.199c1.104 0 1.999.895 1.999 1.999 0 1.105-.895 2-1.999 2-.946 0-1.739-.657-1.947-1.539v.002c-1.147.162-2.032 1.15-2.032 2.341v.007c1.776.067 3.4.567 4.686 1.363.473-.363 1.064-.58 1.707-.58 1.547 0 2.802 1.254 2.802 2.802 0 1.117-.655 2.081-1.601 2.531-.088 3.256-3.637 5.876-7.997 5.876-4.361 0-7.905-2.617-7.998-5.87-.954-.447-1.614-1.415-1.614-2.538 0-1.548 1.255-2.802 2.803-2.802.645 0 1.239.218 1.712.585 1.275-.79 2.881-1.291 4.64-1.365v-.01c0-1.663 1.263-3.034 2.88-3.207.188-.911.993-1.595 1.959-1.595Zm-8.085 8.376c-.784 0-1.459.78-1.506 1.797-.047 1.016.64 1.429 1.426 1.429.786 0 1.371-.369 1.418-1.385.047-1.017-.553-1.841-1.338-1.841Zm7.406 0c-.786 0-1.385.824-1.338 1.841.047 1.017.634 1.385 1.418 1.385.785 0 1.473-.413 1.426-1.429-.046-1.017-.721-1.797-1.506-1.797Zm-3.703 4.013c-.974 0-1.907.048-2.77.135-.147.015-.241.168-.183.305.483 1.154 1.622 1.964 2.953 1.964 1.33 0 2.47-.81 2.953-1.964.057-.137-.037-.29-.184-.305-.863-.087-1.795-.135-2.769-.135Z"
+      }
+    ]
+  }
+};

package/dist/share.ts

@@ -0,0 +1,99 @@
+export type ZdpShareIconName = 'copy' | 'device' | 'telegram' | 'line' | 'whatsapp' | 'x' | 'reddit';
+
+export interface ZdpShareIconPath {
+  readonly d: string;
+  readonly fill?: boolean;
+  readonly stroke?: boolean;
+  readonly strokeLinecap?: 'round';
+  readonly strokeLinejoin?: 'round';
+  readonly strokeWidth?: string;
+}
+
+export interface ZdpShareIconCircle {
+  readonly cx: string;
+  readonly cy: string;
+  readonly r: string;
+  readonly fill?: boolean;
+  readonly stroke?: boolean;
+  readonly strokeWidth?: string;
+}
+
+export interface ZdpShareIconLine {
+  readonly x1: string;
+  readonly y1: string;
+  readonly x2: string;
+  readonly y2: string;
+  readonly strokeWidth?: string;
+}
+
+export interface ZdpShareIconShape {
+  readonly viewBox: string;
+  readonly paths?: readonly ZdpShareIconPath[];
+  readonly circles?: readonly ZdpShareIconCircle[];
+  readonly lines?: readonly ZdpShareIconLine[];
+}
+
+export interface ZdpShareDockItem {
+  readonly id: string;
+  readonly label: string;
+  readonly icon: ZdpShareIconName;
+  readonly href?: string;
+  readonly target?: '_blank' | '_self' | '_parent' | '_top';
+  readonly rel?: string;
+  readonly disabled?: boolean;
+  readonly ariaLabel?: string;
+  readonly onclick?: (event: MouseEvent, item: ZdpShareDockItem) => void;
+}
+
+export const zdpShareIcons: Record<ZdpShareIconName, ZdpShareIconShape> = {
+  copy: {
+    viewBox: '0 0 24 24',
+    paths: [
+      { d: 'M9.5 13.5 14.5 8.5', fill: false, stroke: true, strokeLinecap: 'round', strokeWidth: '2' },
+      { d: 'm8.2 9.8-1.4 1.4a4 4 0 0 0 5.7 5.7l1.2-1.2', fill: false, stroke: true, strokeLinecap: 'round', strokeLinejoin: 'round', strokeWidth: '2' },
+      { d: 'm10.3 8.3 1.2-1.2a4 4 0 0 1 5.7 5.7l-1.4 1.4', fill: false, stroke: true, strokeLinecap: 'round', strokeLinejoin: 'round', strokeWidth: '2' }
+    ]
+  },
+  device: {
+    viewBox: '0 0 24 24',
+    lines: [
+      { x1: '9', y1: '12', x2: '15', y2: '7', strokeWidth: '2' },
+      { x1: '9', y1: '12', x2: '15', y2: '17', strokeWidth: '2' }
+    ],
+    circles: [
+      { cx: '7', cy: '12', r: '2.6', fill: false, stroke: true, strokeWidth: '2' },
+      { cx: '17', cy: '6', r: '2.6', fill: false, stroke: true, strokeWidth: '2' },
+      { cx: '17', cy: '18', r: '2.6', fill: false, stroke: true, strokeWidth: '2' }
+    ]
+  },
+  telegram: {
+    viewBox: '0 0 24 24',
+    paths: [
+      { d: 'M11.944 0A12 12 0 0 0 0 12a12 12 0 0 0 12 12 12 12 0 0 0 12-12A12 12 0 0 0 12 0a12 12 0 0 0-.056 0zm4.962 7.224c.1-.002.321.023.465.14a.506.506 0 0 1 .171.325c.016.093.036.306.02.472-.18 1.898-.962 6.502-1.36 8.627-.168.9-.499 1.201-.82 1.23-.696.065-1.225-.46-1.9-.902-1.056-.693-1.653-1.124-2.678-1.8-1.185-.78-.417-1.21.258-1.91.177-.184 3.247-2.977 3.307-3.23.007-.032.014-.15-.056-.212s-.174-.041-.249-.024c-.106.024-1.793 1.14-5.061 3.345-.48.33-.913.49-1.302.48-.428-.008-1.252-.241-1.865-.44-.752-.245-1.349-.374-1.297-.789.027-.216.325-.437.893-.663 3.498-1.524 5.83-2.529 6.998-3.014 3.332-1.386 4.025-1.627 4.476-1.635z' }
+    ]
+  },
+  line: {
+    viewBox: '0 0 24 24',
+    paths: [
+      { d: 'M19.365 9.863c.349 0 .63.285.63.631 0 .345-.281.63-.63.63H17.61v1.125h1.755c.349 0 .63.283.63.63 0 .344-.281.629-.63.629h-2.386c-.345 0-.627-.285-.627-.629V8.108c0-.345.282-.63.63-.63h2.386c.346 0 .627.285.627.63 0 .349-.281.63-.63.63H17.61v1.125h1.755zm-3.855 3.016c0 .27-.174.51-.432.596-.064.021-.133.031-.199.031-.211 0-.391-.09-.51-.25l-2.443-3.317v2.94c0 .344-.279.629-.631.629-.346 0-.626-.285-.626-.629V8.108c0-.27.173-.51.43-.595.06-.023.136-.033.194-.033.195 0 .375.104.495.254l2.462 3.33V8.108c0-.345.282-.63.63-.63.345 0 .63.285.63.63v4.771zm-5.741 0c0 .344-.282.629-.631.629-.345 0-.627-.285-.627-.629V8.108c0-.345.282-.63.63-.63.346 0 .628.285.628.63v4.771zm-2.466.629H4.917c-.345 0-.63-.285-.63-.629V8.108c0-.345.285-.63.63-.63.348 0 .63.285.63.63v4.141h1.756c.348 0 .629.283.629.63 0 .344-.282.629-.629.629M24 10.314C24 4.943 18.615.572 12 .572S0 4.943 0 10.314c0 4.811 4.27 8.842 10.035 9.608.391.082.923.258 1.058.59.12.301.079.766.038 1.08l-.164 1.02c-.045.301-.24 1.186 1.049.645 1.291-.539 6.916-4.078 9.436-6.975C23.176 14.393 24 12.458 24 10.314' }
+    ]
+  },
+  whatsapp: {
+    viewBox: '0 0 24 24',
+    paths: [
+      { d: 'M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347m-5.421 7.403h-.004a9.87 9.87 0 01-5.031-1.378l-.361-.214-3.741.982.998-3.648-.235-.374a9.86 9.86 0 01-1.51-5.26c.001-5.45 4.436-9.884 9.888-9.884 2.64 0 5.122 1.03 6.988 2.898a9.825 9.825 0 012.893 6.994c-.003 5.45-4.437 9.884-9.885 9.884m8.413-18.297A11.815 11.815 0 0012.05 0C5.495 0 .16 5.335.157 11.892c0 2.096.547 4.142 1.588 5.945L.057 24l6.305-1.654a11.882 11.882 0 005.683 1.448h.005c6.554 0 11.89-5.335 11.893-11.893a11.821 11.821 0 00-3.48-8.413Z' }
+    ]
+  },
+  x: {
+    viewBox: '0 0 24 24',
+    paths: [
+      { d: 'M14.234 10.162 22.977 0h-2.072l-7.591 8.824L7.251 0H.258l9.168 13.343L.258 24H2.33l8.016-9.318L16.749 24h6.993zm-2.837 3.299-.929-1.329L3.076 1.56h3.182l5.965 8.532.929 1.329 7.754 11.09h-3.182z' }
+    ]
+  },
+  reddit: {
+    viewBox: '0 0 24 24',
+    paths: [
+      { d: 'M12 0C5.373 0 0 5.373 0 12c0 3.314 1.343 6.314 3.515 8.485l-2.286 2.286C.775 23.225 1.097 24 1.738 24H12c6.627 0 12-5.373 12-12S18.627 0 12 0Zm4.388 3.199c1.104 0 1.999.895 1.999 1.999 0 1.105-.895 2-1.999 2-.946 0-1.739-.657-1.947-1.539v.002c-1.147.162-2.032 1.15-2.032 2.341v.007c1.776.067 3.4.567 4.686 1.363.473-.363 1.064-.58 1.707-.58 1.547 0 2.802 1.254 2.802 2.802 0 1.117-.655 2.081-1.601 2.531-.088 3.256-3.637 5.876-7.997 5.876-4.361 0-7.905-2.617-7.998-5.87-.954-.447-1.614-1.415-1.614-2.538 0-1.548 1.255-2.802 2.803-2.802.645 0 1.239.218 1.712.585 1.275-.79 2.881-1.291 4.64-1.365v-.01c0-1.663 1.263-3.034 2.88-3.207.188-.911.993-1.595 1.959-1.595Zm-8.085 8.376c-.784 0-1.459.78-1.506 1.797-.047 1.016.64 1.429 1.426 1.429.786 0 1.371-.369 1.418-1.385.047-1.017-.553-1.841-1.338-1.841Zm7.406 0c-.786 0-1.385.824-1.338 1.841.047 1.017.634 1.385 1.418 1.385.785 0 1.473-.413 1.426-1.429-.046-1.017-.721-1.797-1.506-1.797Zm-3.703 4.013c-.974 0-1.907.048-2.77.135-.147.015-.241.168-.183.305.483 1.154 1.622 1.964 2.953 1.964 1.33 0 2.47-.81 2.953-1.964.057-.137-.037-.29-.184-.305-.863-.087-1.795-.135-2.769-.135Z' }
+    ]
+  }
+};

package/dist/sheet.ts

@@ -0,0 +1,3 @@
+export type ZdpSheetPlacement = 'right' | 'left' | 'bottom';
+
+export type ZdpSheetSize = 'sm' | 'md' | 'lg';

package/dist/shortcuts.js

@@ -0,0 +1,125 @@
+const textEntrySelector = [
+  'input',
+  'textarea',
+  'select',
+  '[contenteditable=""]',
+  '[contenteditable="true"]',
+  '[role="textbox"]',
+  '[role="searchbox"]',
+  '[role="combobox"]',
+  '[role="spinbutton"]'
+].join(',');
+
+const reservedModifierKeys = new Set([
+  'a',
+  'c',
+  'f',
+  'l',
+  'n',
+  'o',
+  'p',
+  'q',
+  'r',
+  's',
+  't',
+  'v',
+  'w',
+  'x',
+  'y',
+  'z'
+]);
+
+const reservedFunctionKeys = new Set(['F5', 'F11', 'F12']);
+
+export const zdpShortcutRecommendations = [
+  { intent: 'search', keys: ['/'], risk: 'safe', scope: 'global' },
+  { intent: 'help', keys: ['?'], risk: 'safe', scope: 'global' },
+  { intent: 'escape', keys: ['Esc'], risk: 'safe', scope: 'global' },
+  { intent: 'open', keys: ['Enter'], risk: 'safe', scope: 'focused-list' },
+  { intent: 'previous', keys: ['ArrowUp'], risk: 'safe', scope: 'focused-list' },
+  { intent: 'next', keys: ['ArrowDown'], risk: 'safe', scope: 'focused-list' },
+  { intent: 'submit', keys: ['Mod', 'Enter'], risk: 'safe', scope: 'focused-form' },
+  { intent: 'create', keys: ['N'], risk: 'safe', scope: 'global' },
+  { intent: 'edit', keys: ['E'], risk: 'safe', scope: 'global' },
+  { intent: 'filter', keys: ['F'], risk: 'safe', scope: 'global' },
+  { intent: 'goHome', keys: ['G', 'H'], risk: 'safe', scope: 'sequence' },
+  { intent: 'goSettings', keys: ['G', 'S'], risk: 'safe', scope: 'sequence' }
+];
+
+export const zdpShortcutReservedExamples = [
+  'Ctrl+S',
+  'Ctrl+P',
+  'Ctrl+F',
+  'Ctrl+R',
+  'Ctrl+L',
+  'Ctrl+T',
+  'Ctrl+W',
+  'Ctrl+A',
+  'Ctrl+C',
+  'Ctrl+V',
+  'Ctrl+X',
+  'Ctrl+Z',
+  'Ctrl+Y',
+  'Cmd+S',
+  'Cmd+P',
+  'Cmd+F',
+  'Cmd+R',
+  'Cmd+L',
+  'Cmd+T',
+  'Cmd+W',
+  'Cmd+Q',
+  'Alt+ArrowLeft',
+  'Alt+ArrowRight',
+  'F5',
+  'F11',
+  'F12',
+  'Space',
+  'Backspace'
+];
+
+export function isZdpTextEntryTarget(target) {
+  if (!(target instanceof Element)) {
+    return false;
+  }
+
+  return target.closest(textEntrySelector) !== null;
+}
+
+export function isZdpBrowserReservedShortcut(event) {
+  if (reservedFunctionKeys.has(event.key)) {
+    return true;
+  }
+
+  if (!event.ctrlKey && !event.metaKey && !event.altKey) {
+    return event.key === ' ' || event.key === 'Spacebar' || event.key === 'Backspace';
+  }
+
+  if (event.altKey && (event.key === 'ArrowLeft' || event.key === 'ArrowRight')) {
+    return true;
+  }
+
+  if (event.ctrlKey || event.metaKey) {
+    return reservedModifierKeys.has(event.key.toLowerCase());
+  }
+
+  return false;
+}
+
+export function shouldZdpIgnoreShortcutEvent(
+  event,
+  options = {}
+) {
+  if (event.defaultPrevented || event.isComposing || event.keyCode === 229) {
+    return true;
+  }
+
+  if (!options.allowTextEntryTarget && isZdpTextEntryTarget(event.target)) {
+    return true;
+  }
+
+  if (!options.allowBrowserReservedShortcut && isZdpBrowserReservedShortcut(event)) {
+    return true;
+  }
+
+  return false;
+}

package/dist/shortcuts.ts

@@ -0,0 +1,153 @@
+export type ZdpShortcutIntent =
+  | 'search'
+  | 'help'
+  | 'escape'
+  | 'open'
+  | 'submit'
+  | 'create'
+  | 'edit'
+  | 'filter'
+  | 'next'
+  | 'previous'
+  | 'goHome'
+  | 'goSettings';
+
+export type ZdpShortcutRisk = 'safe' | 'confirm' | 'reserved';
+
+export interface ZdpShortcutRecommendation {
+  readonly intent: ZdpShortcutIntent;
+  readonly keys: readonly string[];
+  readonly risk: ZdpShortcutRisk;
+  readonly scope: 'global' | 'focused-list' | 'focused-form' | 'sequence';
+}
+
+export interface ZdpShortcutGuardOptions {
+  readonly allowTextEntryTarget?: boolean;
+  readonly allowBrowserReservedShortcut?: boolean;
+}
+
+const textEntrySelector = [
+  'input',
+  'textarea',
+  'select',
+  '[contenteditable=""]',
+  '[contenteditable="true"]',
+  '[role="textbox"]',
+  '[role="searchbox"]',
+  '[role="combobox"]',
+  '[role="spinbutton"]'
+].join(',');
+
+const reservedModifierKeys = new Set([
+  'a',
+  'c',
+  'f',
+  'l',
+  'n',
+  'o',
+  'p',
+  'q',
+  'r',
+  's',
+  't',
+  'v',
+  'w',
+  'x',
+  'y',
+  'z'
+]);
+
+const reservedFunctionKeys = new Set(['F5', 'F11', 'F12']);
+
+export const zdpShortcutRecommendations = [
+  { intent: 'search', keys: ['/'], risk: 'safe', scope: 'global' },
+  { intent: 'help', keys: ['?'], risk: 'safe', scope: 'global' },
+  { intent: 'escape', keys: ['Esc'], risk: 'safe', scope: 'global' },
+  { intent: 'open', keys: ['Enter'], risk: 'safe', scope: 'focused-list' },
+  { intent: 'previous', keys: ['ArrowUp'], risk: 'safe', scope: 'focused-list' },
+  { intent: 'next', keys: ['ArrowDown'], risk: 'safe', scope: 'focused-list' },
+  { intent: 'submit', keys: ['Mod', 'Enter'], risk: 'safe', scope: 'focused-form' },
+  { intent: 'create', keys: ['N'], risk: 'safe', scope: 'global' },
+  { intent: 'edit', keys: ['E'], risk: 'safe', scope: 'global' },
+  { intent: 'filter', keys: ['F'], risk: 'safe', scope: 'global' },
+  { intent: 'goHome', keys: ['G', 'H'], risk: 'safe', scope: 'sequence' },
+  { intent: 'goSettings', keys: ['G', 'S'], risk: 'safe', scope: 'sequence' }
+] as const satisfies readonly ZdpShortcutRecommendation[];
+
+export const zdpShortcutReservedExamples = [
+  'Ctrl+S',
+  'Ctrl+P',
+  'Ctrl+F',
+  'Ctrl+R',
+  'Ctrl+L',
+  'Ctrl+T',
+  'Ctrl+W',
+  'Ctrl+A',
+  'Ctrl+C',
+  'Ctrl+V',
+  'Ctrl+X',
+  'Ctrl+Z',
+  'Ctrl+Y',
+  'Cmd+S',
+  'Cmd+P',
+  'Cmd+F',
+  'Cmd+R',
+  'Cmd+L',
+  'Cmd+T',
+  'Cmd+W',
+  'Cmd+Q',
+  'Alt+ArrowLeft',
+  'Alt+ArrowRight',
+  'F5',
+  'F11',
+  'F12',
+  'Space',
+  'Backspace'
+] as const;
+
+export function isZdpTextEntryTarget(target: EventTarget | null): boolean {
+  if (!(target instanceof Element)) {
+    return false;
+  }
+
+  return target.closest(textEntrySelector) !== null;
+}
+
+export function isZdpBrowserReservedShortcut(event: KeyboardEvent): boolean {
+  if (reservedFunctionKeys.has(event.key)) {
+    return true;
+  }
+
+  if (!event.ctrlKey && !event.metaKey && !event.altKey) {
+    return event.key === ' ' || event.key === 'Spacebar' || event.key === 'Backspace';
+  }
+
+  if (event.altKey && (event.key === 'ArrowLeft' || event.key === 'ArrowRight')) {
+    return true;
+  }
+
+  if (event.ctrlKey || event.metaKey) {
+    return reservedModifierKeys.has(event.key.toLowerCase());
+  }
+
+  return false;
+}
+
+export function shouldZdpIgnoreShortcutEvent(
+  event: KeyboardEvent,
+  options: ZdpShortcutGuardOptions = {}
+): boolean {
+  if (event.defaultPrevented || event.isComposing || event.keyCode === 229) {
+    return true;
+  }
+
+  if (!options.allowTextEntryTarget && isZdpTextEntryTarget(event.target)) {
+    return true;
+  }
+
+  if (!options.allowBrowserReservedShortcut && isZdpBrowserReservedShortcut(event)) {
+    return true;
+  }
+
+  return false;
+}