android2harmony 0.1.6 → 0.1.8

package/skills/a2h-app-req-gen/scripts/reqgen/src/analysis/source-facts/compose-api-registry.js

@@ -0,0 +1,395 @@
+/**
+ * Version of the resolved Compose public-API semantics consumed by source
+ * normalization. Bump this when an API selector or its semantic contract
+ * changes; application names and project-local wrappers never belong here.
+ */
+export const COMPOSE_API_SEMANTIC_REGISTRY_VERSION = "1.0.0";
+const materialOwnerPrefixes = [
+  "androidx.compose.material.",
+  "androidx.compose.material3.",
+];
+const foundationOwnerPrefixes = ["androidx.compose.foundation."];
+const pagerOwnerPrefixes = [
+  "androidx.compose.foundation.pager.",
+  "com.google.accompanist.pager.",
+];
+function controlEntries(
+  apiNames,
+  semantics,
+  ownerPrefixes = materialOwnerPrefixes,
+) {
+  return apiNames.map((apiName) => ({
+    selector: { ownerPrefixes, apiNames: [apiName] },
+    semantics: { ...semantics, apiName },
+  }));
+}
+const controlRegistry = [
+  ...controlEntries(
+    [
+      "Button",
+      "ElevatedButton",
+      "FilledTonalButton",
+      "OutlinedButton",
+      "TextButton",
+      "FloatingActionButton",
+      "SmallFloatingActionButton",
+      "LargeFloatingActionButton",
+      "ExtendedFloatingActionButton",
+    ],
+    {
+      elementType: "button",
+      callbacks: { onClick: "click" },
+      namingParameters: ["content", "text"],
+      nestedTextRole: "visibleText",
+    },
+  ),
+  ...controlEntries(["IconButton"], {
+    elementType: "icon-button",
+    callbacks: { onClick: "click" },
+    namingParameters: ["content", "text"],
+    nestedTextRole: "visibleText",
+  }),
+  ...controlEntries(["IconToggleButton"], {
+    elementType: "icon-button",
+    callbacks: { onCheckedChange: "toggle" },
+    namingParameters: ["content", "text"],
+    nestedTextRole: "visibleText",
+    defaultValueParameter: "checked",
+    options: [false, true],
+  }),
+  ...controlEntries(["DropdownMenuItem", "NavigationDrawerItem"], {
+    elementType: "menu-item",
+    callbacks: { onClick: "click" },
+    namingParameters: ["text", "label"],
+    nestedTextRole: "visibleText",
+  }),
+  ...controlEntries(["Checkbox"], {
+    elementType: "checkbox",
+    callbacks: { onCheckedChange: "toggle" },
+    namingParameters: [],
+    nestedTextRole: "associatedLabel",
+    defaultValueParameter: "checked",
+    options: [false, true],
+  }),
+  ...controlEntries(["TriStateCheckbox"], {
+    elementType: "checkbox",
+    callbacks: { onClick: "toggle" },
+    namingParameters: [],
+    nestedTextRole: "associatedLabel",
+    defaultValueParameter: "state",
+    options: ["On", "Off", "Indeterminate"],
+  }),
+  ...controlEntries(["Switch"], {
+    elementType: "switch",
+    callbacks: { onCheckedChange: "toggle" },
+    namingParameters: [],
+    nestedTextRole: "associatedLabel",
+    defaultValueParameter: "checked",
+    options: [false, true],
+  }),
+  ...controlEntries(["RadioButton"], {
+    elementType: "radio-button",
+    callbacks: { onClick: "toggle" },
+    namingParameters: [],
+    nestedTextRole: "associatedLabel",
+    defaultValueParameter: "selected",
+    options: [false, true],
+  }),
+  ...controlEntries(["TextField", "OutlinedTextField"], {
+    elementType: "text-field",
+    callbacks: { onValueChange: "text-input" },
+    namingParameters: ["label", "placeholder"],
+    nestedTextRole: "associatedLabel",
+    defaultValueParameter: "value",
+  }),
+  ...controlEntries(
+    ["BasicTextField"],
+    {
+      elementType: "text-field",
+      callbacks: { onValueChange: "text-input" },
+      namingParameters: ["label", "placeholder"],
+      nestedTextRole: "associatedLabel",
+      defaultValueParameter: "value",
+    },
+    foundationOwnerPrefixes,
+  ),
+  ...controlEntries(["Tab"], {
+    elementType: "tab",
+    callbacks: { onClick: "select" },
+    namingParameters: ["content", "text"],
+    nestedTextRole: "visibleText",
+  }),
+  ...controlEntries(
+    ["clickable"],
+    {
+      elementType: "modifier-action",
+      callbacks: { onClick: "click" },
+      namingParameters: [],
+      nestedTextRole: "visibleText",
+    },
+    foundationOwnerPrefixes,
+  ),
+  ...controlEntries(
+    ["combinedClickable"],
+    {
+      elementType: "modifier-action",
+      callbacks: {
+        onClick: "click",
+        onLongClick: "long-press",
+      },
+      namingParameters: [],
+      nestedTextRole: "visibleText",
+    },
+    foundationOwnerPrefixes,
+  ),
+  ...controlEntries(
+    ["toggleable"],
+    {
+      elementType: "modifier-action",
+      callbacks: { onValueChange: "toggle" },
+      namingParameters: [],
+      nestedTextRole: "visibleText",
+      defaultValueParameter: "value",
+      options: [false, true],
+    },
+    foundationOwnerPrefixes,
+  ),
+  ...controlEntries(
+    ["selectable"],
+    {
+      elementType: "modifier-action",
+      callbacks: { onClick: "select" },
+      namingParameters: [],
+      nestedTextRole: "visibleText",
+      defaultValueParameter: "selected",
+      options: [false, true],
+    },
+    foundationOwnerPrefixes,
+  ),
+];
+const surfaceRegistry = [
+  {
+    selector: {
+      ownerPrefixes: ["androidx.compose.ui.window."],
+      apiNames: ["Dialog"],
+    },
+    semantics: {
+      componentType: "dialog",
+      bindingKind: "surface",
+      contentParameters: ["content"],
+      titleParameters: [],
+      genericName: "Dialog",
+      stateParameters: [],
+    },
+  },
+  {
+    selector: {
+      ownerPrefixes: materialOwnerPrefixes,
+      apiNames: ["AlertDialog"],
+    },
+    semantics: {
+      componentType: "dialog",
+      bindingKind: "surface",
+      contentParameters: [
+        "content",
+        "confirmButton",
+        "dismissButton",
+        "icon",
+        "title",
+        "text",
+      ],
+      titleParameters: ["title"],
+      genericName: "Alert Dialog",
+      stateParameters: [],
+    },
+  },
+  {
+    selector: {
+      ownerPrefixes: materialOwnerPrefixes,
+      apiNames: ["BasicAlertDialog"],
+    },
+    semantics: {
+      componentType: "dialog",
+      bindingKind: "surface",
+      contentParameters: [
+        "content",
+        "confirmButton",
+        "dismissButton",
+        "icon",
+        "title",
+        "text",
+      ],
+      titleParameters: ["title"],
+      genericName: "Basic Alert Dialog",
+      stateParameters: [],
+    },
+  },
+  ...[
+    "ModalNavigationDrawer",
+    "DismissibleNavigationDrawer",
+    "PermanentNavigationDrawer",
+    "ModalDrawer",
+    "BottomDrawer",
+  ].map((apiName) => ({
+    selector: { ownerPrefixes: materialOwnerPrefixes, apiNames: [apiName] },
+    semantics: {
+      apiName,
+      componentType: "drawer",
+      bindingKind: "surface",
+      contentParameters: ["drawerContent"],
+      titleParameters: [],
+      genericName: apiName.replace(/([a-z0-9])([A-Z])/gu, "$1 $2"),
+      stateParameters: ["drawerState"],
+    },
+  })),
+  {
+    selector: {
+      ownerPrefixes: materialOwnerPrefixes,
+      apiNames: ["ModalBottomSheet"],
+    },
+    semantics: {
+      componentType: "bottom-sheet",
+      bindingKind: "surface",
+      contentParameters: ["content", "dragHandle"],
+      titleParameters: [],
+      genericName: "Modal Bottom Sheet",
+      stateParameters: ["sheetState"],
+    },
+  },
+  {
+    selector: {
+      ownerPrefixes: materialOwnerPrefixes,
+      apiNames: ["BottomSheetScaffold"],
+    },
+    semantics: {
+      componentType: "bottom-sheet",
+      bindingKind: "surface",
+      contentParameters: ["sheetContent", "sheetDragHandle"],
+      titleParameters: [],
+      genericName: "Bottom Sheet Scaffold",
+      stateParameters: ["sheetState"],
+    },
+  },
+  ...["HorizontalPager", "VerticalPager"].map((apiName) => ({
+    selector: { ownerPrefixes: pagerOwnerPrefixes, apiNames: [apiName] },
+    semantics: {
+      apiName,
+      componentType: "pager",
+      bindingKind: "pager",
+      contentParameters: ["content", "pageContent"],
+      titleParameters: [],
+      genericName: apiName.replace(/([a-z0-9])([A-Z])/gu, "$1 $2"),
+      stateParameters: ["state"],
+      countParameters: ["count", "pageCount"],
+    },
+  })),
+];
+const pagerStateFactoryRegistry = [
+  {
+    selector: {
+      ownerPrefixes: pagerOwnerPrefixes,
+      apiNames: ["rememberPagerState"],
+    },
+    semantics: {
+      initialPageParameters: ["initialPage", "initialPageIndex"],
+      defaultInitialPage: 0,
+    },
+  },
+];
+const pagerTransitionRegistry = [
+  {
+    selector: {
+      ownerPrefixes: pagerOwnerPrefixes,
+      apiNames: ["scrollToPage"],
+    },
+    semantics: {
+      targetPageParameters: ["page", "pageIndex"],
+      animation: "immediate",
+    },
+  },
+  {
+    selector: {
+      ownerPrefixes: pagerOwnerPrefixes,
+      apiNames: ["animateScrollToPage"],
+    },
+    semantics: {
+      targetPageParameters: ["page", "pageIndex"],
+      animation: "animated",
+    },
+  },
+];
+const lifecycleEffectRegistry = [
+  {
+    selector: {
+      ownerPrefixes: ["androidx.compose.runtime."],
+      apiNames: ["LaunchedEffect"],
+    },
+    semantics: {
+      blockParameters: ["block"],
+      lifecycleKind: "composition-start",
+    },
+  },
+];
+export const COMPOSE_API_SEMANTIC_REGISTRY = {
+  contractVersion: COMPOSE_API_SEMANTIC_REGISTRY_VERSION,
+  controls: controlRegistry,
+  surfaces: surfaceRegistry,
+  pagerStateFactories: pagerStateFactoryRegistry,
+  pagerTransitions: pagerTransitionRegistry,
+  lifecycleEffects: lifecycleEffectRegistry,
+};
+/** Normalize a resolved Kotlin/JVM target name back to its source API name. */
+export function composeSourceApiName(targetName) {
+  const normalized = targetName?.trim();
+  if (!normalized) return undefined;
+  const mangleSeparator = normalized.indexOf("-");
+  return mangleSeparator > 0
+    ? normalized.slice(0, mangleSeparator)
+    : normalized;
+}
+export function isComposeFrameworkOwner(ownerQualifiedName) {
+  return (
+    ownerQualifiedName !== undefined &&
+    (ownerQualifiedName.startsWith("androidx.compose.") ||
+      ownerQualifiedName.startsWith("androidx.navigation.compose."))
+  );
+}
+function resolveEntry(registry, ownerQualifiedName, targetName) {
+  const owner = ownerQualifiedName?.trim();
+  const apiName = composeSourceApiName(targetName);
+  if (!owner || !apiName) return undefined;
+  const entry = registry.find(
+    ({ selector }) =>
+      selector.apiNames.includes(apiName) &&
+      selector.ownerPrefixes.some((prefix) => owner.startsWith(prefix)),
+  );
+  return entry ? { ...entry.semantics, apiName } : undefined;
+}
+export function resolveComposeControlApi(ownerQualifiedName, targetName) {
+  return resolveEntry(controlRegistry, ownerQualifiedName, targetName);
+}
+export function resolveComposeSurfaceApi(ownerQualifiedName, targetName) {
+  return resolveEntry(surfaceRegistry, ownerQualifiedName, targetName);
+}
+export function resolveComposePagerStateFactoryApi(
+  ownerQualifiedName,
+  targetName,
+) {
+  return resolveEntry(
+    pagerStateFactoryRegistry,
+    ownerQualifiedName,
+    targetName,
+  );
+}
+export function resolveComposePagerTransitionApi(
+  ownerQualifiedName,
+  targetName,
+) {
+  return resolveEntry(pagerTransitionRegistry, ownerQualifiedName, targetName);
+}
+export function resolveComposeLifecycleEffectApi(
+  ownerQualifiedName,
+  targetName,
+) {
+  return resolveEntry(lifecycleEffectRegistry, ownerQualifiedName, targetName);
+}