An open source design system that's fully customizable and agent ready
TypeScript
docs(public-component-api): useMenuPress has no create twin by owner decision (#10053)
Cindy Zhang64b56eef9ed3
diff --git a/docs/architecture/public-component-api.md b/docs/architecture/public-component-api.mdindex e53f79c6e6..5e3f6a4f38 100644--- a/docs/architecture/public-component-api.md+++ b/docs/architecture/public-component-api.md@@ -245,7 +245,9 @@ guidance owns the process used to propose and test APIs.output feeds one Astryx component prop, or `useAnimatedLayout`,`useEntryAnimation`, `useContainerReveal`, `useTouchTrigger`,`useTableRowExpansion`, `useTableColumnResize`) has none by default; the owner- may add one (owner decision, 2026-11-04).+ may add one (owner decision, 2026-11-04). `useMenuPress` has no non-React+ equivalent by owner decision (2026-11-04); one may be added when a caller+ needs it.- **INV23 — Each private data attribute has one owner module.** A`data-astryx-*` attribute is private unless this invariant names it public.Each private attribute has one internal owner module in the package that@@ -413,7 +415,7 @@ Rejected: component-local names for shared concepts.| INV20 | Public-API review of new boolean props | A boolean whose only effect is a visual swap where a variant fits || INV21 | Public-API review against existing props, components, hooks, and factories | A new API that shares a job with an existing one that is not being deprecated in its favor; a hook fed to one component slot prop counted as a second API || INV21a | Public-API review of each breaking or deprecating change to a shipped API | A breaking or deprecating change to a shipped public API justified only by conformance to a system rule |-| INV22 | Public-API review of each public interaction utility hook against its `create…` equivalent | An interaction utility hook with no `create…` equivalent, outside hooks whose result only an Astryx component or StyleX can use, or an equivalent whose option names and meanings, events, or return concepts differ from its hook |+| INV22 | Public-API review of each public interaction utility hook against its `create…` equivalent | An interaction utility hook with no `create…` equivalent, outside hooks whose result only an Astryx component or StyleX can use and `useMenuPress` (by owner decision), or an equivalent whose option names and meanings, events, or return concepts differ from its hook || INV23 | `@astryx/no-raw-private-attribute` lint with its baseline (test files exempt), plus public-API review of the public list | A `data-astryx-*` name or selector written outside its owner module, a test, or the public list; a `dataAttr()` call that names a private attribute; an owner module that exports its raw name or a selector; a package that imports another package's owner module; a caller that sets a property an owner style it spreads also sets; a private attribute in a public export, `.doc.mjs`, or Changeset; a baseline entry added; a public data attribute changed without INV9 evidence || INV24 | API report generator tests over representative entry points, plus the pull-request report's API changes | A promised export, prop, hook, type, custom property, theme target, or public attribute is missing from a report; a reachable internal-tagged member is missing; an `./internal/*` or Lab member appears; a stale committed report is not flagged, or its rows are listed as the pull request's API changes; the check fails a pull request || INV25 | Public-API review routing against the pull request's API changes | A row that no current record decides does not reach human review; a row a current record decides is held for a human; an undeclared row alone draws a request for changes |@@ -442,7 +444,7 @@ Known verification gaps:another keeps its name until a minor renames it under INV9. Outline's`offset` is the distance below the top of its scroll root(`component:Outline` FR4), not a gap from an anchor.-- INV22: known gaps include `useLongPress`, `useMenuPress`, `usePressFeedback`,+- INV22: known gaps include `useLongPress`, `usePressFeedback`,`useClickableContainer`, `useInputContainer`, `useOverlay`, `useCombobox`,`useMultiCombobox`, `useResizable`, `useTooltip`, `useHoverCard`, and`useChatStreamScroll`: each attaches gesture, press, drag, or motion behavior