@adea-ai/ui 0.81.1 → 0.82.1

package/dist/lint.js

@@ -26,6 +26,86 @@ var ELEMENT_PRIMITIVES = Object.freeze({
 		path: "@adea-ai/ui/components/ui/label"
 	}
 });
+/** Reads a static object-property key without evaluating a computed expression. */
+var staticPropertyKey = (node, computed) => {
+	if (!computed && node?.type === "Identifier") return node.name;
+	if (node?.type === "Literal" && typeof node.value === "string") return node.value;
+	if (node?.type === "TemplateLiteral" && node.expressions.length === 0) return node.quasis[0].value.cooked ?? node.quasis[0].value.raw;
+	return null;
+};
+/** Detects named props in a literal JSX spread, including nested literal spreads. */
+var objectHasStaticProperty = (node, name, seen = /* @__PURE__ */ new Set()) => {
+	if (!node || seen.has(node)) return false;
+	seen.add(node);
+	if (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "TSNonNullExpression") return objectHasStaticProperty(node.expression, name, seen);
+	if (node.type !== "ObjectExpression") return false;
+	return node.properties.some((property) => {
+		if (property.type === "Property") return staticPropertyKey(property.key, property.computed === true) === name;
+		if (property.type === "SpreadElement") return objectHasStaticProperty(property.argument, name, seen);
+		return false;
+	});
+};
+var noInlineStyles = {
+	meta: {
+		type: "problem",
+		docs: { description: "Consumer components cannot set appearance or layout with JSX style props; use shared variants and token-backed classes." },
+		schema: [],
+		messages: {
+			inlineStyle: "JSX style attributes are not permitted, including layout values and CSS custom properties. Use shared variants and token-backed classes.",
+			inlineStyleElement: "A JSX style element bypasses the shared design system. Use shared variants and token-backed classes.",
+			inlineStyleSpread: "A JSX spread contains a style prop. Pass named shared component props instead of hiding inline styles in a spread."
+		}
+	},
+	create(context) {
+		return {
+			JSXAttribute(node) {
+				if (node.name?.type === "JSXIdentifier" && node.name.name === "style") context.report({
+					node,
+					messageId: "inlineStyle"
+				});
+			},
+			JSXOpeningElement(node) {
+				if (node.name?.type === "JSXIdentifier" && node.name.name === "style") context.report({
+					node,
+					messageId: "inlineStyleElement"
+				});
+			},
+			JSXSpreadAttribute(node) {
+				if (objectHasStaticProperty(node.argument, "style")) context.report({
+					node,
+					messageId: "inlineStyleSpread"
+				});
+			}
+		};
+	}
+};
+var noClassList = {
+	meta: {
+		type: "problem",
+		docs: { description: "Solid classList props hide conditional classes from static design-system lint; use cn() with its object-key form." },
+		schema: [],
+		messages: {
+			classList: "classList hides classes from design-system lint. Use cn() with its object-key form and statically readable class names.",
+			classListSpread: "A JSX spread contains classList. Use cn() with its object-key form instead of hiding classes in a spread."
+		}
+	},
+	create(context) {
+		return {
+			JSXAttribute(node) {
+				if (node.name?.type === "JSXIdentifier" && node.name.name === "classList") context.report({
+					node,
+					messageId: "classList"
+				});
+			},
+			JSXSpreadAttribute(node) {
+				if (objectHasStaticProperty(node.argument, "classList")) context.report({
+					node,
+					messageId: "classListSpread"
+				});
+			}
+		};
+	}
+};
 var noRawInteractiveElements = {
 	meta: {
 		type: "problem",
@@ -188,6 +268,8 @@ var hasTabStop = (node) => (node.attributes ?? []).some((attribute) => {
 var plugin = {
 	meta: { name: "adea" },
 	rules: {
+		"no-inline-styles": noInlineStyles,
+		"no-class-list": noClassList,
 		"no-raw-interactive-elements": noRawInteractiveElements,
 		"no-primitive-library-imports": {
 			meta: {

package/dist/lint.js.map

@@ -1 +1 @@
-{"version":3,"file":"lint.js","names":[],"sources":["../src/lint/index.ts"],"sourcesContent":["/*\n * The design system's own oxlint plugin.\n *\n * The styling rules live in `@shadcn/lint`; what that plugin cannot know is which\n * *elements* the design system owns. This is the other half of the contract, for\n * the applications that consume the library: an interactive element this package\n * provides is not re-implemented at the application layer, and the primitive\n * libraries this package is built from are not imported around it.\n *\n * Loaded as an oxlint jsPlugin:\n *\n *   // .oxlintrc.json\n *   { \"jsPlugins\": [\"@adea-ai/ui/lint\"], \"rules\": { \"adea/no-raw-interactive-elements\": \"error\" } }\n *\n * Rules are errors by intent. A violation means an application composed its own\n * control out of raw markup — unreachable focus behaviour, an absent keyboard\n * story, a second implementation of a decision this package exists to make once.\n */\n\ntype Json = string | number | boolean | null | Json[] | { [key: string]: Json }\n\n/** The raw elements this package replaces, and the primitive that replaces them. */\nconst ELEMENT_PRIMITIVES: Readonly<Record<string, { primitive: string; path: string }>> =\n  Object.freeze({\n    button: { primitive: 'Button', path: '@adea-ai/ui/components/ui/button' },\n    input: { primitive: 'Input', path: '@adea-ai/ui/components/ui/input' },\n    textarea: { primitive: 'Textarea', path: '@adea-ai/ui/components/ui/textarea' },\n    select: { primitive: 'Select', path: '@adea-ai/ui/components/ui/select' },\n    option: { primitive: 'Select', path: '@adea-ai/ui/components/ui/select' },\n    label: { primitive: 'Label', path: '@adea-ai/ui/components/ui/label' },\n  })\n\ntype RuleModule = {\n  meta: {\n    type: 'problem'\n    docs: { description: string }\n    schema: Json[]\n    messages: Record<string, string>\n  }\n  create: (context: LintContext) => Record<string, (node: any) => void>\n}\n\ninterface LintContext {\n  options?: unknown[]\n  report: (descriptor: {\n    node: unknown\n    messageId?: string\n    message?: string\n    data?: Record<string, Json>\n  }) => void\n}\n\ninterface RawElementOptions {\n  /** Element names this rule should not report (rare; prefer fixing the file). */\n  allow?: string[]\n  /** Replaces the default report message. */\n  message?: string\n}\n\nconst noRawInteractiveElements: RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Interactive elements this package provides (button, input, textarea, select, option, label) are composed from the package, not written as raw markup.',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: {\n          allow: { type: 'array', items: { type: 'string' } },\n          message: { type: 'string' },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      rawElement:\n        '{{element}} is provided by the design system: use {{primitive}} from {{path}}. A raw element has no keyboard story, no focus behaviour and no token styling — that is the work the primitive already did.',\n    },\n  },\n  create(context) {\n    const options = (context.options?.[0] ?? {}) as RawElementOptions\n    const allowed = new Set(options.allow ?? [])\n    const emit = (node: unknown, element: string) => {\n      const target = ELEMENT_PRIMITIVES[element]!\n      context.report({\n        node,\n        messageId: 'rawElement',\n        data: { element, primitive: target.primitive, path: target.path },\n        ...(options.message ? { message: options.message } : {}),\n      })\n    }\n    return {\n      JSXOpeningElement(node: any) {\n        if (node.name?.type !== 'JSXIdentifier') return\n        const element = node.name.name\n        if (!(element in ELEMENT_PRIMITIVES) || allowed.has(element)) return\n        emit(node, element)\n      },\n    }\n  },\n}\n\ninterface PrimitiveImportOptions {\n  /** Package prefixes this rule reports. Defaults to the primitive libraries the ui package wraps. */\n  packages?: string[]\n  /** Replaces the default report message. */\n  message?: string\n}\n\nconst DEFAULT_PRIMITIVE_PACKAGES = Object.freeze([\n  '@kobalte/core',\n  '@corvu',\n  'cmdk-solid',\n  '@ark-ui',\n  '@zag-js',\n  '@radix-ui',\n  'radix-ui',\n  '@base-ui-components',\n  '@base-ui',\n])\n\n/**\n * The interactive ARIA roles an application can dress a generic element in, and\n * the primitive that owns each role. `link` is deliberately absent: an `<a>` is\n * natively interactive and Button itself supports `as=\"a\"` for the link-styled\n * case.\n */\nconst ROLE_PRIMITIVES: Readonly<Record<string, { primitive: string; path: string }>> =\n  Object.freeze({\n    button: { primitive: 'Button', path: '@adea-ai/ui/components/ui/button' },\n    checkbox: { primitive: 'Checkbox', path: '@adea-ai/ui/components/ui/checkbox' },\n    radio: { primitive: 'RadioGroup', path: '@adea-ai/ui/components/ui/radio-group' },\n    switch: { primitive: 'Switch', path: '@adea-ai/ui/components/ui/switch' },\n    tab: { primitive: 'Tabs', path: '@adea-ai/ui/components/ui/tabs' },\n    option: { primitive: 'Select', path: '@adea-ai/ui/components/ui/select' },\n    menuitem: { primitive: 'DropdownMenu', path: '@adea-ai/ui/components/ui/dropdown-menu' },\n    textbox: { primitive: 'Input', path: '@adea-ai/ui/components/ui/input' },\n  })\n\n/**\n * The elements whose only job is layout or text. A click handler or a tabindex on\n * one of these is a control being hand-built out of a non-control.\n */\nconst GENERIC_ELEMENTS: ReadonlySet<string> = new Set([\n  'div',\n  'span',\n  'li',\n  'ul',\n  'ol',\n  'td',\n  'th',\n  'p',\n  'h1',\n  'h2',\n  'h3',\n  'h4',\n  'h5',\n  'h6',\n  'section',\n  'article',\n  'aside',\n  'header',\n  'footer',\n  'nav',\n  'main',\n  'img',\n  'svg',\n])\n\nconst CLICK_HANDLERS: ReadonlySet<string> = new Set([\n  'onClick',\n  'onDoubleClick',\n  'onPointerDown',\n  'onPointerUp',\n  'onMouseDown',\n  'onMouseUp',\n  'on:click',\n  'on:dblclick',\n  'on:pointerdown',\n  'on:pointerup',\n  'on:mousedown',\n  'on:mouseup',\n])\n\ninterface InteractiveWrapperOptions {\n  /** Element names this rule should not report (rare; prefer fixing the file). */\n  allow?: string[]\n  /** Replaces the default report message. */\n  message?: string\n}\n\n/** Only statically knowable branches; unresolved roles remain a review boundary. */\nconst staticStrings = (node: any): string[] => {\n  if (node?.type === 'Literal' && typeof node.value === 'string') return [node.value]\n  if (node?.type === 'JSXExpressionContainer') return staticStrings(node.expression)\n  if (node?.type === 'ConditionalExpression')\n    return [...staticStrings(node.consequent), ...staticStrings(node.alternate)]\n  if (node?.type === 'TemplateLiteral' && node.expressions.length === 0)\n    return [node.quasis[0].value.cooked ?? node.quasis[0].value.raw]\n  return []\n}\n\nconst roleOf = (node: any): string | null => {\n  for (const attribute of node.attributes ?? []) {\n    if (attribute.type !== 'JSXAttribute' || attribute.name?.name !== 'role') continue\n    return (\n      staticStrings(attribute.value)\n        .flatMap((role) => role.split(/\\s+/))\n        .find((role) => role in ROLE_PRIMITIVES) ?? null\n    )\n  }\n  return null\n}\n\n/** Whether the element carries the attribute, by name. */\nconst has = (node: any, name: string): boolean =>\n  (node.attributes ?? []).some(\n    (attribute: any) =>\n      attribute.type === 'JSXAttribute' &&\n      (attribute.name?.type === 'JSXNamespacedName'\n        ? `${attribute.name.namespace.name}:${attribute.name.name.name}`\n        : attribute.name?.name) === name\n  )\n\nconst hasTabStop = (node: any): boolean =>\n  (node.attributes ?? []).some((attribute: any) => {\n    if (\n      attribute.type !== 'JSXAttribute' ||\n      !['tabIndex', 'tabindex'].includes(attribute.name?.name)\n    )\n      return false\n    const value =\n      attribute.value?.type === 'JSXExpressionContainer'\n        ? attribute.value.expression\n        : attribute.value\n    if (value?.type === 'Literal') return !(Number(value.value) < 0)\n    if (\n      value?.type === 'UnaryExpression' &&\n      value.operator === '-' &&\n      value.argument?.type === 'Literal'\n    )\n      return !(Number(value.argument.value) > 0)\n    return true\n  })\n\nconst noInteractiveWrappers: RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Generic elements dressed as interactive controls — an interactive role, a click handler or a tabindex on a layout element — re-implement a primitive by hand. Compose the real component.',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: {\n          allow: { type: 'array', items: { type: 'string' } },\n          message: { type: 'string' },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      roleWrapper:\n        'A {{element}} with role=\"{{role}}\" hand-builds {{primitive}}: use {{primitive}} from {{path}}. The primitive brings keyboard activation, focus behaviour and ARIA wiring; the wrapper re-implements them badly.',\n      clickWrapper:\n        'A click handler on {{element}} composes {{primitive}} by hand: use {{primitive}} from {{path}}. A div that reacts to clicks is a button that cannot be reached by keyboard.',\n      tabindexWrapper:\n        'A tabindex on {{element}} makes a layout element focusable, which is focus management the primitives already own: compose the real component instead.',\n    },\n  },\n  create(context) {\n    const options = (context.options?.[0] ?? {}) as InteractiveWrapperOptions\n    const allowed = new Set(options.allow ?? [])\n    return {\n      JSXOpeningElement(node: any) {\n        if (node.name?.type !== 'JSXIdentifier') return\n        const element = node.name.name\n        if (allowed.has(element) || element in ELEMENT_PRIMITIVES) return\n        // A capitalized element is a component — often a design-system primitive\n        // composing a role deliberately (a Button carrying role=\"option\" inside a\n        // custom listbox, for example). That is composition, not impersonation.\n        if (element[0] === element[0]?.toUpperCase()) return\n\n        const role = roleOf(node)\n        if (role && role in ROLE_PRIMITIVES) {\n          const target = ROLE_PRIMITIVES[role]!\n          context.report({\n            node,\n            messageId: 'roleWrapper',\n            data: { element, role, primitive: target.primitive, path: target.path },\n            ...(options.message ? { message: options.message } : {}),\n          })\n          return\n        }\n\n        if (GENERIC_ELEMENTS.has(element)) {\n          const click = [...CLICK_HANDLERS].find((handler) => has(node, handler))\n          if (click) {\n            const target = ROLE_PRIMITIVES.button!\n            context.report({\n              node,\n              messageId: 'clickWrapper',\n              data: { element, primitive: target.primitive, path: target.path },\n              ...(options.message ? { message: options.message } : {}),\n            })\n            return\n          }\n          if (hasTabStop(node)) {\n            context.report({\n              node,\n              messageId: 'tabindexWrapper',\n              data: { element },\n              ...(options.message ? { message: options.message } : {}),\n            })\n          }\n        }\n      },\n    }\n  },\n}\n\nconst noPrimitiveLibraryImports: RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'The primitive libraries the design system is built on (Kobalte and friends) are its internal affair — compose the exported components instead of importing the primitives.',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: {\n          packages: { type: 'array', items: { type: 'string' } },\n          message: { type: 'string' },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      primitiveImport:\n        'Import from the design system, not from {{package}}: the primitives it wraps carry the focus, keyboard and ARIA behaviour the components exist to provide.',\n    },\n  },\n  create(context) {\n    const options = (context.options?.[0] ?? {}) as PrimitiveImportOptions\n    const prefixes = options.packages ?? DEFAULT_PRIMITIVE_PACKAGES\n    const offender = (source: unknown): string | null => {\n      const name = String(source ?? '')\n      return prefixes.find((prefix) => name === prefix || name.startsWith(`${prefix}/`)) ?? null\n    }\n    const report = (node: unknown, source: unknown) => {\n      const pkg = offender(source)!\n      context.report({\n        node,\n        messageId: 'primitiveImport',\n        data: { package: pkg },\n        ...(options.message ? { message: options.message } : {}),\n      })\n    }\n    return {\n      ImportDeclaration(node: any) {\n        if (offender(node.source?.value)) report(node, node.source.value)\n      },\n      ImportExpression(node: any) {\n        if (typeof node.source?.value === 'string' && offender(node.source.value))\n          report(node, node.source.value)\n      },\n      ExportNamedDeclaration(node: any) {\n        if (offender(node.source?.value)) report(node, node.source.value)\n      },\n      ExportAllDeclaration(node: any) {\n        if (offender(node.source?.value)) report(node, node.source.value)\n      },\n      CallExpression(node: any) {\n        if (node.callee?.type !== 'Identifier' || node.callee.name !== 'require') return\n        const source = node.arguments?.[0]?.value\n        if (typeof source === 'string' && offender(source)) report(node, source)\n      },\n    }\n  },\n}\n\nconst plugin = {\n  meta: { name: 'adea' },\n  rules: {\n    'no-raw-interactive-elements': noRawInteractiveElements,\n    'no-primitive-library-imports': noPrimitiveLibraryImports,\n    'no-interactive-wrappers': noInteractiveWrappers,\n  },\n}\n\nexport default plugin\n"],"mappings":"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"}
+{"version":3,"file":"lint.js","names":[],"sources":["../src/lint/index.ts"],"sourcesContent":["/*\n * The design system's own oxlint plugin.\n *\n * The styling rules live in `@shadcn/lint`; what that plugin cannot know is which\n * *elements* the design system owns. This is the other half of the contract, for\n * the applications that consume the library: an interactive element this package\n * provides is not re-implemented at the application layer, and the primitive\n * libraries this package is built from are not imported around it.\n *\n * Loaded as an oxlint jsPlugin:\n *\n *   // .oxlintrc.json\n *   { \"jsPlugins\": [\"@adea-ai/ui/lint\"], \"rules\": { \"adea/no-raw-interactive-elements\": \"error\" } }\n *\n * Rules are errors by intent. A violation means an application composed its own\n * control out of raw markup — unreachable focus behaviour, an absent keyboard\n * story, a second implementation of a decision this package exists to make once.\n */\n\ntype Json = string | number | boolean | null | Json[] | { [key: string]: Json }\n\n/** The raw elements this package replaces, and the primitive that replaces them. */\nconst ELEMENT_PRIMITIVES: Readonly<Record<string, { primitive: string; path: string }>> =\n  Object.freeze({\n    button: { primitive: 'Button', path: '@adea-ai/ui/components/ui/button' },\n    input: { primitive: 'Input', path: '@adea-ai/ui/components/ui/input' },\n    textarea: { primitive: 'Textarea', path: '@adea-ai/ui/components/ui/textarea' },\n    select: { primitive: 'Select', path: '@adea-ai/ui/components/ui/select' },\n    option: { primitive: 'Select', path: '@adea-ai/ui/components/ui/select' },\n    label: { primitive: 'Label', path: '@adea-ai/ui/components/ui/label' },\n  })\n\ntype RuleModule = {\n  meta: {\n    type: 'problem'\n    docs: { description: string }\n    schema: Json[]\n    messages: Record<string, string>\n  }\n  create: (context: LintContext) => Record<string, (node: any) => void>\n}\n\ninterface LintContext {\n  options?: unknown[]\n  report: (descriptor: {\n    node: unknown\n    messageId?: string\n    message?: string\n    data?: Record<string, Json>\n  }) => void\n}\n\n/** Reads a static object-property key without evaluating a computed expression. */\nconst staticPropertyKey = (node: any, computed: boolean): string | null => {\n  if (!computed && node?.type === 'Identifier') return node.name\n  if (node?.type === 'Literal' && typeof node.value === 'string') return node.value\n  if (node?.type === 'TemplateLiteral' && node.expressions.length === 0)\n    return node.quasis[0].value.cooked ?? node.quasis[0].value.raw\n  return null\n}\n\n/** Detects named props in a literal JSX spread, including nested literal spreads. */\nconst objectHasStaticProperty = (node: any, name: string, seen = new Set<unknown>()): boolean => {\n  if (!node || seen.has(node)) return false\n  seen.add(node)\n  if (\n    node.type === 'TSAsExpression' ||\n    node.type === 'TSSatisfiesExpression' ||\n    node.type === 'TSNonNullExpression'\n  )\n    return objectHasStaticProperty(node.expression, name, seen)\n  if (node.type !== 'ObjectExpression') return false\n  return node.properties.some((property: any) => {\n    if (property.type === 'Property')\n      return staticPropertyKey(property.key, property.computed === true) === name\n    if (property.type === 'SpreadElement')\n      return objectHasStaticProperty(property.argument, name, seen)\n    return false\n  })\n}\n\nconst noInlineStyles: RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Consumer components cannot set appearance or layout with JSX style props; use shared variants and token-backed classes.',\n    },\n    schema: [],\n    messages: {\n      inlineStyle:\n        'JSX style attributes are not permitted, including layout values and CSS custom properties. Use shared variants and token-backed classes.',\n      inlineStyleElement:\n        'A JSX style element bypasses the shared design system. Use shared variants and token-backed classes.',\n      inlineStyleSpread:\n        'A JSX spread contains a style prop. Pass named shared component props instead of hiding inline styles in a spread.',\n    },\n  },\n  create(context) {\n    return {\n      JSXAttribute(node: any) {\n        if (node.name?.type === 'JSXIdentifier' && node.name.name === 'style')\n          context.report({ node, messageId: 'inlineStyle' })\n      },\n      JSXOpeningElement(node: any) {\n        if (node.name?.type === 'JSXIdentifier' && node.name.name === 'style')\n          context.report({ node, messageId: 'inlineStyleElement' })\n      },\n      JSXSpreadAttribute(node: any) {\n        if (objectHasStaticProperty(node.argument, 'style'))\n          context.report({ node, messageId: 'inlineStyleSpread' })\n      },\n    }\n  },\n}\n\nconst noClassList: RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Solid classList props hide conditional classes from static design-system lint; use cn() with its object-key form.',\n    },\n    schema: [],\n    messages: {\n      classList:\n        'classList hides classes from design-system lint. Use cn() with its object-key form and statically readable class names.',\n      classListSpread:\n        'A JSX spread contains classList. Use cn() with its object-key form instead of hiding classes in a spread.',\n    },\n  },\n  create(context) {\n    return {\n      JSXAttribute(node: any) {\n        if (node.name?.type === 'JSXIdentifier' && node.name.name === 'classList')\n          context.report({ node, messageId: 'classList' })\n      },\n      JSXSpreadAttribute(node: any) {\n        if (objectHasStaticProperty(node.argument, 'classList'))\n          context.report({ node, messageId: 'classListSpread' })\n      },\n    }\n  },\n}\n\ninterface RawElementOptions {\n  /** Element names this rule should not report (rare; prefer fixing the file). */\n  allow?: string[]\n  /** Replaces the default report message. */\n  message?: string\n}\n\nconst noRawInteractiveElements: RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Interactive elements this package provides (button, input, textarea, select, option, label) are composed from the package, not written as raw markup.',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: {\n          allow: { type: 'array', items: { type: 'string' } },\n          message: { type: 'string' },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      rawElement:\n        '{{element}} is provided by the design system: use {{primitive}} from {{path}}. A raw element has no keyboard story, no focus behaviour and no token styling — that is the work the primitive already did.',\n    },\n  },\n  create(context) {\n    const options = (context.options?.[0] ?? {}) as RawElementOptions\n    const allowed = new Set(options.allow ?? [])\n    const emit = (node: unknown, element: string) => {\n      const target = ELEMENT_PRIMITIVES[element]!\n      context.report({\n        node,\n        messageId: 'rawElement',\n        data: { element, primitive: target.primitive, path: target.path },\n        ...(options.message ? { message: options.message } : {}),\n      })\n    }\n    return {\n      JSXOpeningElement(node: any) {\n        if (node.name?.type !== 'JSXIdentifier') return\n        const element = node.name.name\n        if (!(element in ELEMENT_PRIMITIVES) || allowed.has(element)) return\n        emit(node, element)\n      },\n    }\n  },\n}\n\ninterface PrimitiveImportOptions {\n  /** Package prefixes this rule reports. Defaults to the primitive libraries the ui package wraps. */\n  packages?: string[]\n  /** Replaces the default report message. */\n  message?: string\n}\n\nconst DEFAULT_PRIMITIVE_PACKAGES = Object.freeze([\n  '@kobalte/core',\n  '@corvu',\n  'cmdk-solid',\n  '@ark-ui',\n  '@zag-js',\n  '@radix-ui',\n  'radix-ui',\n  '@base-ui-components',\n  '@base-ui',\n])\n\n/**\n * The interactive ARIA roles an application can dress a generic element in, and\n * the primitive that owns each role. `link` is deliberately absent: an `<a>` is\n * natively interactive and Button itself supports `as=\"a\"` for the link-styled\n * case.\n */\nconst ROLE_PRIMITIVES: Readonly<Record<string, { primitive: string; path: string }>> =\n  Object.freeze({\n    button: { primitive: 'Button', path: '@adea-ai/ui/components/ui/button' },\n    checkbox: { primitive: 'Checkbox', path: '@adea-ai/ui/components/ui/checkbox' },\n    radio: { primitive: 'RadioGroup', path: '@adea-ai/ui/components/ui/radio-group' },\n    switch: { primitive: 'Switch', path: '@adea-ai/ui/components/ui/switch' },\n    tab: { primitive: 'Tabs', path: '@adea-ai/ui/components/ui/tabs' },\n    option: { primitive: 'Select', path: '@adea-ai/ui/components/ui/select' },\n    menuitem: { primitive: 'DropdownMenu', path: '@adea-ai/ui/components/ui/dropdown-menu' },\n    textbox: { primitive: 'Input', path: '@adea-ai/ui/components/ui/input' },\n  })\n\n/**\n * The elements whose only job is layout or text. A click handler or a tabindex on\n * one of these is a control being hand-built out of a non-control.\n */\nconst GENERIC_ELEMENTS: ReadonlySet<string> = new Set([\n  'div',\n  'span',\n  'li',\n  'ul',\n  'ol',\n  'td',\n  'th',\n  'p',\n  'h1',\n  'h2',\n  'h3',\n  'h4',\n  'h5',\n  'h6',\n  'section',\n  'article',\n  'aside',\n  'header',\n  'footer',\n  'nav',\n  'main',\n  'img',\n  'svg',\n])\n\nconst CLICK_HANDLERS: ReadonlySet<string> = new Set([\n  'onClick',\n  'onDoubleClick',\n  'onPointerDown',\n  'onPointerUp',\n  'onMouseDown',\n  'onMouseUp',\n  'on:click',\n  'on:dblclick',\n  'on:pointerdown',\n  'on:pointerup',\n  'on:mousedown',\n  'on:mouseup',\n])\n\ninterface InteractiveWrapperOptions {\n  /** Element names this rule should not report (rare; prefer fixing the file). */\n  allow?: string[]\n  /** Replaces the default report message. */\n  message?: string\n}\n\n/** Only statically knowable branches; unresolved roles remain a review boundary. */\nconst staticStrings = (node: any): string[] => {\n  if (node?.type === 'Literal' && typeof node.value === 'string') return [node.value]\n  if (node?.type === 'JSXExpressionContainer') return staticStrings(node.expression)\n  if (node?.type === 'ConditionalExpression')\n    return [...staticStrings(node.consequent), ...staticStrings(node.alternate)]\n  if (node?.type === 'TemplateLiteral' && node.expressions.length === 0)\n    return [node.quasis[0].value.cooked ?? node.quasis[0].value.raw]\n  return []\n}\n\nconst roleOf = (node: any): string | null => {\n  for (const attribute of node.attributes ?? []) {\n    if (attribute.type !== 'JSXAttribute' || attribute.name?.name !== 'role') continue\n    return (\n      staticStrings(attribute.value)\n        .flatMap((role) => role.split(/\\s+/))\n        .find((role) => role in ROLE_PRIMITIVES) ?? null\n    )\n  }\n  return null\n}\n\n/** Whether the element carries the attribute, by name. */\nconst has = (node: any, name: string): boolean =>\n  (node.attributes ?? []).some(\n    (attribute: any) =>\n      attribute.type === 'JSXAttribute' &&\n      (attribute.name?.type === 'JSXNamespacedName'\n        ? `${attribute.name.namespace.name}:${attribute.name.name.name}`\n        : attribute.name?.name) === name\n  )\n\nconst hasTabStop = (node: any): boolean =>\n  (node.attributes ?? []).some((attribute: any) => {\n    if (\n      attribute.type !== 'JSXAttribute' ||\n      !['tabIndex', 'tabindex'].includes(attribute.name?.name)\n    )\n      return false\n    const value =\n      attribute.value?.type === 'JSXExpressionContainer'\n        ? attribute.value.expression\n        : attribute.value\n    if (value?.type === 'Literal') return !(Number(value.value) < 0)\n    if (\n      value?.type === 'UnaryExpression' &&\n      value.operator === '-' &&\n      value.argument?.type === 'Literal'\n    )\n      return !(Number(value.argument.value) > 0)\n    return true\n  })\n\nconst noInteractiveWrappers: RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Generic elements dressed as interactive controls — an interactive role, a click handler or a tabindex on a layout element — re-implement a primitive by hand. Compose the real component.',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: {\n          allow: { type: 'array', items: { type: 'string' } },\n          message: { type: 'string' },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      roleWrapper:\n        'A {{element}} with role=\"{{role}}\" hand-builds {{primitive}}: use {{primitive}} from {{path}}. The primitive brings keyboard activation, focus behaviour and ARIA wiring; the wrapper re-implements them badly.',\n      clickWrapper:\n        'A click handler on {{element}} composes {{primitive}} by hand: use {{primitive}} from {{path}}. A div that reacts to clicks is a button that cannot be reached by keyboard.',\n      tabindexWrapper:\n        'A tabindex on {{element}} makes a layout element focusable, which is focus management the primitives already own: compose the real component instead.',\n    },\n  },\n  create(context) {\n    const options = (context.options?.[0] ?? {}) as InteractiveWrapperOptions\n    const allowed = new Set(options.allow ?? [])\n    return {\n      JSXOpeningElement(node: any) {\n        if (node.name?.type !== 'JSXIdentifier') return\n        const element = node.name.name\n        if (allowed.has(element) || element in ELEMENT_PRIMITIVES) return\n        // A capitalized element is a component — often a design-system primitive\n        // composing a role deliberately (a Button carrying role=\"option\" inside a\n        // custom listbox, for example). That is composition, not impersonation.\n        if (element[0] === element[0]?.toUpperCase()) return\n\n        const role = roleOf(node)\n        if (role && role in ROLE_PRIMITIVES) {\n          const target = ROLE_PRIMITIVES[role]!\n          context.report({\n            node,\n            messageId: 'roleWrapper',\n            data: { element, role, primitive: target.primitive, path: target.path },\n            ...(options.message ? { message: options.message } : {}),\n          })\n          return\n        }\n\n        if (GENERIC_ELEMENTS.has(element)) {\n          const click = [...CLICK_HANDLERS].find((handler) => has(node, handler))\n          if (click) {\n            const target = ROLE_PRIMITIVES.button!\n            context.report({\n              node,\n              messageId: 'clickWrapper',\n              data: { element, primitive: target.primitive, path: target.path },\n              ...(options.message ? { message: options.message } : {}),\n            })\n            return\n          }\n          if (hasTabStop(node)) {\n            context.report({\n              node,\n              messageId: 'tabindexWrapper',\n              data: { element },\n              ...(options.message ? { message: options.message } : {}),\n            })\n          }\n        }\n      },\n    }\n  },\n}\n\nconst noPrimitiveLibraryImports: RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'The primitive libraries the design system is built on (Kobalte and friends) are its internal affair — compose the exported components instead of importing the primitives.',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: {\n          packages: { type: 'array', items: { type: 'string' } },\n          message: { type: 'string' },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      primitiveImport:\n        'Import from the design system, not from {{package}}: the primitives it wraps carry the focus, keyboard and ARIA behaviour the components exist to provide.',\n    },\n  },\n  create(context) {\n    const options = (context.options?.[0] ?? {}) as PrimitiveImportOptions\n    const prefixes = options.packages ?? DEFAULT_PRIMITIVE_PACKAGES\n    const offender = (source: unknown): string | null => {\n      const name = String(source ?? '')\n      return prefixes.find((prefix) => name === prefix || name.startsWith(`${prefix}/`)) ?? null\n    }\n    const report = (node: unknown, source: unknown) => {\n      const pkg = offender(source)!\n      context.report({\n        node,\n        messageId: 'primitiveImport',\n        data: { package: pkg },\n        ...(options.message ? { message: options.message } : {}),\n      })\n    }\n    return {\n      ImportDeclaration(node: any) {\n        if (offender(node.source?.value)) report(node, node.source.value)\n      },\n      ImportExpression(node: any) {\n        if (typeof node.source?.value === 'string' && offender(node.source.value))\n          report(node, node.source.value)\n      },\n      ExportNamedDeclaration(node: any) {\n        if (offender(node.source?.value)) report(node, node.source.value)\n      },\n      ExportAllDeclaration(node: any) {\n        if (offender(node.source?.value)) report(node, node.source.value)\n      },\n      CallExpression(node: any) {\n        if (node.callee?.type !== 'Identifier' || node.callee.name !== 'require') return\n        const source = node.arguments?.[0]?.value\n        if (typeof source === 'string' && offender(source)) report(node, source)\n      },\n    }\n  },\n}\n\nconst plugin = {\n  meta: { name: 'adea' },\n  rules: {\n    'no-inline-styles': noInlineStyles,\n    'no-class-list': noClassList,\n    'no-raw-interactive-elements': noRawInteractiveElements,\n    'no-primitive-library-imports': noPrimitiveLibraryImports,\n    'no-interactive-wrappers': noInteractiveWrappers,\n  },\n}\n\nexport default plugin\n"],"mappings":"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"}

package/dist/r/account-menu.json

@@ -9,6 +9,7 @@
   "registryDependencies": [
     "@adea-ai/ui/button",
     "@adea-ai/ui/dropdown-menu",
+    "@adea-ai/ui/tooltip",
     "lib"
   ],
   "files": [

package/dist/r/action-button.json

@@ -0,0 +1,24 @@
+{
+  "name": "action-button",
+  "type": "registry:ui",
+  "title": "Action Button",
+  "description": "A shared Button with optional tooltip and busy-state feedback.",
+  "dependencies": [],
+  "registryDependencies": [
+    "@adea-ai/ui/button",
+    "@adea-ai/ui/spinner",
+    "@adea-ai/ui/tooltip"
+  ],
+  "files": [
+    {
+      "path": "src/components/composites/action-button/action-button.tsx",
+      "type": "registry:ui",
+      "target": "components/composites/action-button/action-button.tsx"
+    },
+    {
+      "path": "src/components/composites/action-button/index.ts",
+      "type": "registry:ui",
+      "target": "components/composites/action-button/index.ts"
+    }
+  ]
+}

package/dist/r/conversation.json

@@ -15,6 +15,7 @@
     "@adea-ai/ui/kbd",
     "@adea-ai/ui/spinner",
     "@adea-ai/ui/textarea",
+    "@adea-ai/ui/tooltip",
     "lib"
   ],
   "files": [

package/dist/r/registry.json

@@ -1649,6 +1649,7 @@
       "registryDependencies": [
         "@adea-ai/ui/button",
         "@adea-ai/ui/dropdown-menu",
+        "@adea-ai/ui/tooltip",
         "lib"
       ],
       "files": [
@@ -1664,6 +1665,30 @@
         }
       ]
     },
+    {
+      "name": "action-button",
+      "type": "registry:ui",
+      "title": "Action Button",
+      "description": "A shared Button with optional tooltip and busy-state feedback.",
+      "dependencies": [],
+      "registryDependencies": [
+        "@adea-ai/ui/button",
+        "@adea-ai/ui/spinner",
+        "@adea-ai/ui/tooltip"
+      ],
+      "files": [
+        {
+          "path": "src/components/composites/action-button/action-button.tsx",
+          "type": "registry:ui",
+          "target": "components/composites/action-button/action-button.tsx"
+        },
+        {
+          "path": "src/components/composites/action-button/index.ts",
+          "type": "registry:ui",
+          "target": "components/composites/action-button/index.ts"
+        }
+      ]
+    },
     {
       "name": "appearance-editor",
       "type": "registry:ui",
@@ -1853,6 +1878,7 @@
         "@adea-ai/ui/kbd",
         "@adea-ai/ui/spinner",
         "@adea-ai/ui/textarea",
+        "@adea-ai/ui/tooltip",
         "lib"
       ],
       "files": [

package/dist/r/src/components/composites/account-menu/account-menu.tsx

@@ -9,10 +9,10 @@ import {
   Smartphone,
   UserRound,
 } from 'lucide-solid'
-import type { JSX } from 'solid-js'
-import { For, Show, splitProps } from 'solid-js'
+import type { ComponentProps, JSX } from 'solid-js'
+import { For, Show, createSignal, onCleanup, splitProps } from 'solid-js'
 import { cn } from '../../../lib/utils'
-import { Button } from '../../ui/button/button'
+import { Button, type ButtonProps } from '../../ui/button/button'
 import {
   DropdownMenu,
   DropdownMenuContent,
@@ -21,6 +21,7 @@ import {
   DropdownMenuSeparator,
   DropdownMenuTrigger,
 } from '../../ui/dropdown-menu/dropdown-menu'
+import { Tooltip, TooltipContent, TooltipTrigger } from '../../ui/tooltip/tooltip'
 
 /**
  * AccountMenu.
@@ -49,10 +50,14 @@ export type AccountMenuItem = {
   /** Render only on this platform. Omit to always render. */
   platform?: 'desktop' | 'web'
   onSelect?: () => void
+  /** Run after the menu's close-focus cycle, with its trigger as a stable opener. */
+  onSelectAfterClose?: (trigger: HTMLButtonElement | undefined) => void
 }
 
 export type AccountMenuProps = {
   class?: string
+  /** The trigger size. Icon-only menus default to the standard icon size. */
+  size?: ButtonProps['size']
   /** The entries above the separator. */
   items: readonly AccountMenuItem[]
   /** Which platform this is rendered on, for items that declare one. */
@@ -81,6 +86,7 @@ const FALLBACK_ICONS: Record<string, typeof Settings2> = {
 export function AccountMenu(props: AccountMenuProps) {
   const [local, rest] = splitProps(props, [
     'class',
+    'size',
     'items',
     'platform',
     'authenticated',
@@ -91,55 +97,105 @@ export function AccountMenu(props: AccountMenuProps) {
     'onIntent',
   ])
 
+  let trigger: HTMLButtonElement | undefined
+  let pendingAfterClose:
+    | { callback: NonNullable<AccountMenuItem['onSelectAfterClose']> }
+    | undefined
+  let scheduledAfterClose:
+    | { callback: NonNullable<AccountMenuItem['onSelectAfterClose']> }
+    | undefined
+  const [menuOpen, setMenuOpen] = createSignal(false)
+  const [tooltipOpen, setTooltipOpen] = createSignal(false)
+
+  onCleanup(() => {
+    pendingAfterClose = undefined
+    scheduledAfterClose = undefined
+  })
+
   const visible = () =>
     local.items.filter((item) => !item.platform || item.platform === (local.platform ?? 'desktop'))
 
   return (
-    <DropdownMenu modal={false}>
-      <DropdownMenuTrigger
-        as={Button}
-        variant="ghost"
-        size="icon-md"
-        class={cn('text-muted-foreground', local.class)}
-        aria-label={local.label ?? 'Account and settings'}
-        onFocus={() => local.onIntent?.()}
-        onPointerEnter={() => local.onIntent?.()}
-        {...rest}
+    <Tooltip open={tooltipOpen()} onOpenChange={(open) => setTooltipOpen(open && !menuOpen())}>
+      <DropdownMenu
+        modal={false}
+        onOpenChange={(open) => {
+          setMenuOpen(open)
+          if (open) setTooltipOpen(false)
+        }}
       >
-        <UserRound aria-hidden="true" />
-      </DropdownMenuTrigger>
-      <DropdownMenuContent side="top" align="start" class="min-w-56">
-        <DropdownMenuGroup>
-          <For each={visible()}>
-            {(item) => (
-              <DropdownMenuItem
-                disabled={item.disabled}
-                onSelect={() => item.onSelect?.()}
-                shortcut={item.shortcut}
-              >
-                {item.icon ?? renderFallbackIcon(item.id)}
-                <span>{item.label}</span>
-              </DropdownMenuItem>
-            )}
-          </For>
-        </DropdownMenuGroup>
-        <DropdownMenuSeparator />
-        <DropdownMenuGroup>
-          <DropdownMenuItem
-            disabled={local.busy}
-            onSelect={() => (local.authenticated ? local.onSignOut?.() : local.onSignIn?.())}
-          >
-            <Show when={local.authenticated} fallback={<LogIn aria-hidden="true" />}>
-              <LogOut aria-hidden="true" />
-            </Show>
-            <span>{local.authenticated ? 'Sign out' : 'Sign in'}</span>
-          </DropdownMenuItem>
-        </DropdownMenuGroup>
-      </DropdownMenuContent>
-    </DropdownMenu>
+        <TooltipTrigger
+          as={AccountMenuButton}
+          ref={(element: HTMLButtonElement) => (trigger = element)}
+          variant="ghost"
+          size={local.size ?? 'icon-md'}
+          class={cn('text-muted-foreground', local.class)}
+          aria-label={local.label ?? 'Account and settings'}
+          onFocus={() => local.onIntent?.()}
+          onPointerEnter={() => local.onIntent?.()}
+          {...rest}
+        >
+          <UserRound aria-hidden="true" />
+        </TooltipTrigger>
+        <TooltipContent placement="top">{local.label ?? 'Account and settings'}</TooltipContent>
+        <DropdownMenuContent
+          placement="top-start"
+          class="min-w-56 max-h-(--kb-popper-available-height) overflow-x-hidden overflow-y-auto"
+          onCloseAutoFocus={(event) => {
+            const selection = pendingAfterClose
+            pendingAfterClose = undefined
+            if (!selection) return
+
+            event.preventDefault()
+            scheduledAfterClose = selection
+            queueMicrotask(() => {
+              if (scheduledAfterClose !== selection) return
+              scheduledAfterClose = undefined
+              selection.callback(trigger)
+            })
+          }}
+        >
+          <DropdownMenuGroup>
+            <For each={visible()}>
+              {(item) => (
+                <DropdownMenuItem
+                  disabled={item.disabled}
+                  onSelect={() => {
+                    pendingAfterClose = item.onSelectAfterClose
+                      ? { callback: item.onSelectAfterClose }
+                      : undefined
+                    item.onSelect?.()
+                  }}
+                  shortcut={item.shortcut}
+                >
+                  {item.icon ?? renderFallbackIcon(item.id)}
+                  <span>{item.label}</span>
+                </DropdownMenuItem>
+              )}
+            </For>
+          </DropdownMenuGroup>
+          <DropdownMenuSeparator />
+          <DropdownMenuGroup>
+            <DropdownMenuItem
+              disabled={local.busy}
+              onSelect={() => (local.authenticated ? local.onSignOut?.() : local.onSignIn?.())}
+            >
+              <Show when={local.authenticated} fallback={<LogIn aria-hidden="true" />}>
+                <LogOut aria-hidden="true" />
+              </Show>
+              <span>{local.authenticated ? 'Sign out' : 'Sign in'}</span>
+            </DropdownMenuItem>
+          </DropdownMenuGroup>
+        </DropdownMenuContent>
+      </DropdownMenu>
+    </Tooltip>
   )
 }
 
+function AccountMenuButton(props: ComponentProps<typeof Button>) {
+  return <DropdownMenuTrigger as={Button} {...props} />
+}
+
 /**
  * A known item id gets its conventional glyph, so a caller that only wants the
  * standard menu does not have to import six icons to get it.

package/dist/r/src/components/composites/action-button/action-button.tsx

@@ -0,0 +1,139 @@
+import { Show, splitProps, type ComponentProps, type JSX, type ValidComponent } from 'solid-js'
+import { Button, type ButtonProps } from '../../ui/button'
+import { Spinner } from '../../ui/spinner'
+import { Tooltip, TooltipContent, TooltipTrigger } from '../../ui/tooltip'
+
+/**
+ * ActionButton.
+ *
+ * A Button with optional explanatory tooltip and busy feedback. Use it for a
+ * simple action that needs these states; actions with product-specific rules
+ * should compose Button directly.
+ *
+ * The tooltip trigger renders the polymorphic Button itself. A disabled native
+ * control cannot receive pointer or keyboard events. When a tooltip is set,
+ * disabled actions therefore use focusable `aria-disabled` semantics and guard
+ * activation; without a tooltip, native buttons retain native disabling.
+ * Custom polymorphic components must forward aria, event, and href props for
+ * these guarantees to apply.
+ */
+export type ActionButtonProps<T extends ValidComponent = 'button'> = ButtonProps<T> & {
+  /** A short explanation, also shown on keyboard focus. The Button still needs its own name. */
+  tooltip?: string
+  tooltipSide?: 'top' | 'right' | 'bottom' | 'left'
+  /** Disables the action and announces the busy label through a polite status region. */
+  busy?: boolean
+  /** The activity announced while busy. The Button's accessible name stays unchanged. */
+  busyLabel?: string
+}
+
+function guardedClick(handler: unknown, disabled: () => boolean) {
+  return (event: MouseEvent) => {
+    if (disabled()) {
+      event.preventDefault()
+      event.stopImmediatePropagation()
+      return
+    }
+
+    if (Array.isArray(handler)) {
+      const [callback, data] = handler as [(data: unknown, event: MouseEvent) => void, unknown]
+      callback(data, event)
+    } else if (typeof handler === 'function') {
+      const callback = handler as (event: MouseEvent) => void
+      callback(event)
+    }
+  }
+}
+
+type ButtonTargetProps<T extends ValidComponent = 'button'> = Omit<ButtonProps<T>, 'as'> & {
+  actionAs?: T
+}
+
+/** Adapter keeps TooltipTrigger's `as` separate from Button's polymorphic `as`. */
+function ButtonTarget<T extends ValidComponent = 'button'>(props: ButtonTargetProps<T>) {
+  const [local, rest] = splitProps(props as ButtonTargetProps, ['actionAs'])
+  const PolymorphicButton = Button as (targetProps: ButtonProps<T>) => JSX.Element
+  return <PolymorphicButton as={(local.actionAs ?? 'button') as T} {...(rest as ButtonProps<T>)} />
+}
+
+export function ActionButton<T extends ValidComponent = 'button'>(props: ActionButtonProps<T>) {
+  const [local, rest] = splitProps(props as ActionButtonProps, [
+    'as',
+    'variant',
+    'size',
+    'class',
+    'children',
+    'disabled',
+    'aria-busy',
+    'tooltip',
+    'tooltipSide',
+    'busy',
+    'busyLabel',
+  ])
+  const busy = () => local.busy ?? false
+  const disabled = () => busy() || !!local.disabled
+  const busyStatus = () => local.busyLabel ?? 'Working'
+  const onClickCapture = (rest as { onClickCapture?: unknown }).onClickCapture
+  const PolymorphicButton = Button as (buttonProps: ButtonProps<T>) => JSX.Element
+  const PolymorphicButtonTarget = ButtonTarget as (targetProps: ButtonTargetProps<T>) => JSX.Element
+
+  const buttonProps = () => ({
+    ...rest,
+    variant: local.variant,
+    size: local.size,
+    class: [local.class, local.tooltip && disabled() && 'aria-disabled:pointer-events-auto']
+      .filter(Boolean)
+      .join(' '),
+    disabled: disabled() && !local.tooltip,
+    'aria-disabled': disabled() ? true : rest['aria-disabled'],
+    tabIndex: local.as === 'a' && disabled() ? (local.tooltip ? 0 : -1) : rest.tabIndex,
+    role: local.as === 'a' && disabled() ? 'link' : rest.role,
+    href: local.as === 'a' && disabled() ? undefined : (rest as { href?: string }).href,
+    'aria-busy': busy() || local['aria-busy'],
+    onClick: guardedClick(rest.onClick, disabled),
+    onClickCapture: onClickCapture ? guardedClick(onClickCapture, disabled) : undefined,
+    'on:click': guardedClick((rest as Record<string, unknown>)['on:click'], disabled),
+    'oncapture:click': guardedClick((rest as Record<string, unknown>)['oncapture:click'], disabled),
+  })
+
+  const contents = () => (
+    <>
+      <Show when={busy()}>
+        <Spinner size="sm" label={false} aria-hidden="true" data-icon="inline-start" />
+      </Show>
+      {local.children}
+    </>
+  )
+
+  return (
+    <>
+      <Show
+        when={local.tooltip}
+        fallback={
+          <PolymorphicButton
+            as={(local.as ?? 'button') as T}
+            {...(buttonProps() as unknown as ButtonProps<T>)}
+          >
+            {contents()}
+          </PolymorphicButton>
+        }
+      >
+        <Tooltip>
+          <TooltipTrigger
+            as={PolymorphicButtonTarget}
+            {...(buttonProps() as unknown as ComponentProps<typeof PolymorphicButtonTarget>)}
+            actionAs={(local.as ?? 'button') as T}
+          >
+            {contents()}
+          </TooltipTrigger>
+          <TooltipContent side={local.tooltipSide}>{local.tooltip}</TooltipContent>
+        </Tooltip>
+      </Show>
+      <Show when={busy()}>
+        <span role="status" aria-live="polite" class="visually-hidden">
+          {busyStatus()}
+        </span>
+      </Show>
+    </>
+  )
+}

package/dist/r/src/components/composites/action-button/index.ts

@@ -0,0 +1,2 @@
+/** A shared Button with optional tooltip and busy-state feedback. */
+export { ActionButton, type ActionButtonProps } from './action-button'