@_elcaten/expo-list-section-index 1.0.0

package/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "singleQuote": true,
+  "bracketSameLine": true,
+  "trailingComma": "es5",
+  "jsxSingleQuote": false,
+}

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# @_elcaten/expo-list-section-index
+
+Adds native iOS 26 alphabetical section indexes to
+[`@expo/ui`](https://docs.expo.dev/versions/v57.0.0/sdk/ui/swift-ui/) SwiftUI lists.
+
+## Requirements
+
+- Expo SDK 57 or newer
+- `@expo/ui`
+- iOS 26 or newer
+- A development or production build; the native module is not included in Expo Go
+
+The modifiers are no-ops on earlier iOS versions.
+
+## Installation
+
+```sh
+npx expo install @expo/ui
+npm install @_elcaten/expo-list-section-index
+npx expo run:ios
+```
+
+You can also build the app with EAS Build.
+
+## Usage
+
+Apply `sectionIndexLabel` to every `Section` and
+`listSectionIndexVisibility` to the containing `List`.
+
+```tsx
+import { listSectionIndexVisibility, sectionIndexLabel } from '@_elcaten/expo-list-section-index';
+import { Host, List, Section, Text } from '@expo/ui/swift-ui';
+import { listStyle } from '@expo/ui/swift-ui/modifiers';
+
+const CONTACTS = [
+  'Ada Lovelace',
+  'Barbara Liskov',
+  'Charles Babbage',
+  'Dorothy Vaughan',
+  'Edsger Dijkstra',
+  'Frances Allen',
+  'Grace Hopper',
+  'Hedy Lamarr',
+] as const;
+
+export default function App() {
+  return (
+    <Host style={{ flex: 1 }}>
+      <List modifiers={[listStyle('plain'), listSectionIndexVisibility('visible')]}>
+        {CONTACTS.map((name) => {
+          const letter = name.charAt(0);
+
+          return (
+            <Section key={name} title={letter} modifiers={[sectionIndexLabel(letter)]}>
+              <Text>{name}</Text>
+            </Section>
+          );
+        })}
+      </List>
+    </Host>
+  );
+}
+```
+
+`listSectionIndexVisibility` accepts `'automatic'`, `'visible'`, or `'hidden'`.
+Pass `null` to `sectionIndexLabel` to omit a section from the index.

package/build/index.d.ts

@@ -0,0 +1,2 @@
+export { listSectionIndexVisibility, sectionIndexLabel, type ListSectionIndexVisibility, } from './modifiers';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,EACjB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAC"}

package/build/index.js

@@ -0,0 +1,2 @@
+export { listSectionIndexVisibility, sectionIndexLabel, } from './modifiers';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,GAElB,MAAM,aAAa,CAAC","sourcesContent":["export {\n  listSectionIndexVisibility,\n  sectionIndexLabel,\n  type ListSectionIndexVisibility,\n} from './modifiers';\n"]}

package/build/modifiers.d.ts

@@ -0,0 +1,5 @@
+import { type ModifierConfig } from '@expo/ui/swift-ui/modifiers';
+export type ListSectionIndexVisibility = 'automatic' | 'visible' | 'hidden';
+export declare function sectionIndexLabel(label: string | null): ModifierConfig;
+export declare function listSectionIndexVisibility(visibility?: ListSectionIndexVisibility): ModifierConfig;
+//# sourceMappingURL=modifiers.d.ts.map

package/build/modifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifiers.d.ts","sourceRoot":"","sources":["../src/modifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAKlF,MAAM,MAAM,0BAA0B,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CAEtE;AAED,wBAAgB,0BAA0B,CACxC,UAAU,GAAE,0BAAwC,GACnD,cAAc,CAEhB"}

package/build/modifiers.js

@@ -0,0 +1,10 @@
+import { createModifier } from '@expo/ui/swift-ui/modifiers';
+const sectionIndexLabelModifier = 'expoListSectionIndex.sectionIndexLabel';
+const listSectionIndexVisibilityModifier = 'expoListSectionIndex.listSectionIndexVisibility';
+export function sectionIndexLabel(label) {
+    return createModifier(sectionIndexLabelModifier, { label });
+}
+export function listSectionIndexVisibility(visibility = 'automatic') {
+    return createModifier(listSectionIndexVisibilityModifier, { visibility });
+}
+//# sourceMappingURL=modifiers.js.map

package/build/modifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifiers.js","sourceRoot":"","sources":["../src/modifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,6BAA6B,CAAC;AAElF,MAAM,yBAAyB,GAAG,wCAAwC,CAAC;AAC3E,MAAM,kCAAkC,GAAG,iDAAiD,CAAC;AAI7F,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,OAAO,cAAc,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,aAAyC,WAAW;IAEpD,OAAO,cAAc,CAAC,kCAAkC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AAC5E,CAAC","sourcesContent":["import { createModifier, type ModifierConfig } from '@expo/ui/swift-ui/modifiers';\n\nconst sectionIndexLabelModifier = 'expoListSectionIndex.sectionIndexLabel';\nconst listSectionIndexVisibilityModifier = 'expoListSectionIndex.listSectionIndexVisibility';\n\nexport type ListSectionIndexVisibility = 'automatic' | 'visible' | 'hidden';\n\nexport function sectionIndexLabel(label: string | null): ModifierConfig {\n  return createModifier(sectionIndexLabelModifier, { label });\n}\n\nexport function listSectionIndexVisibility(\n  visibility: ListSectionIndexVisibility = 'automatic'\n): ModifierConfig {\n  return createModifier(listSectionIndexVisibilityModifier, { visibility });\n}\n"]}

package/eslint.config.cjs

@@ -0,0 +1,5 @@
+const { defineConfig } = require('eslint/config');
+const universe = require('eslint-config-universe/flat/native');
+const universeWeb = require('eslint-config-universe/flat/web');
+
+module.exports = defineConfig([{ ignores: ['build'] }, ...universe, ...universeWeb]);

package/expo-module.config.json

@@ -0,0 +1,6 @@
+{
+  "platforms": ["apple"],
+  "apple": {
+    "modules": ["ExpoListSectionIndexModule"]
+  }
+}

package/ios/ExpoListSectionIndex.podspec

@@ -0,0 +1,25 @@
+Pod::Spec.new do |s|
+  s.name           = 'ExpoListSectionIndex'
+  s.version        = '1.0.0'
+  s.summary        = 'Native iOS 26 alphabetical section indexes for Expo UI'
+  s.description    = 'Adds SwiftUI sectionIndexLabel and listSectionIndexVisibility modifiers to Expo UI.'
+  s.author         = 'Elcaten'
+  s.homepage       = 'https://github.com/Elcaten/expo-list-section-index'
+  s.license        = { :type => 'MIT', :file => '../LICENSE' }
+  s.platforms      = { :ios => '16.4' }
+  s.swift_version  = '5.9'
+  s.source         = {
+    :git => 'https://github.com/Elcaten/expo-list-section-index.git',
+    :tag => s.version.to_s
+  }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+  s.dependency 'ExpoUI'
+
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES'
+  }
+
+  s.source_files = '**/*.{h,m,mm,swift,hpp,cpp}'
+end

package/ios/ExpoListSectionIndexModule.swift

@@ -0,0 +1,26 @@
+import ExpoModulesCore
+import ExpoUI
+
+private let sectionIndexLabelModifier = "expoListSectionIndex.sectionIndexLabel"
+private let listSectionIndexVisibilityModifier =
+  "expoListSectionIndex.listSectionIndexVisibility"
+
+public final class ExpoListSectionIndexModule: Module {
+  public func definition() -> ModuleDefinition {
+    Name("ExpoListSectionIndex")
+
+    OnCreate {
+      ViewModifierRegistry.register(sectionIndexLabelModifier) { params, appContext, _ in
+        try SectionIndexLabelModifier(from: params, appContext: appContext)
+      }
+      ViewModifierRegistry.register(listSectionIndexVisibilityModifier) { params, appContext, _ in
+        try ListSectionIndexVisibilityModifier(from: params, appContext: appContext)
+      }
+    }
+
+    OnDestroy {
+      ViewModifierRegistry.unregister(sectionIndexLabelModifier)
+      ViewModifierRegistry.unregister(listSectionIndexVisibilityModifier)
+    }
+  }
+}

package/ios/ExpoListSectionIndexSwiftUIModifier.swift

@@ -0,0 +1,51 @@
+import ExpoModulesCore
+import SwiftUI
+
+struct SectionIndexLabelModifier: ViewModifier, Record {
+  @Field var label: String?
+
+  func body(content: Content) -> some View {
+#if compiler(>=6.2) && os(iOS)
+    if #available(iOS 26.0, *) {
+      content.sectionIndexLabel(label.map(Text.init))
+    } else {
+      content
+    }
+#else
+    content
+#endif
+  }
+}
+
+enum ListSectionIndexVisibilityOption: String, Enumerable {
+  case automatic
+  case visible
+  case hidden
+
+  var swiftUIVisibility: Visibility {
+    switch self {
+    case .automatic:
+      .automatic
+    case .visible:
+      .visible
+    case .hidden:
+      .hidden
+    }
+  }
+}
+
+struct ListSectionIndexVisibilityModifier: ViewModifier, Record {
+  @Field var visibility: ListSectionIndexVisibilityOption = .automatic
+
+  func body(content: Content) -> some View {
+#if compiler(>=6.2) && os(iOS)
+    if #available(iOS 26.0, *) {
+      content.listSectionIndexVisibility(visibility.swiftUIVisibility)
+    } else {
+      content
+    }
+#else
+    content
+#endif
+  }
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@_elcaten/expo-list-section-index",
+  "version": "1.0.0",
+  "description": "Adds native iOS 26 alphabetical section indexes to Expo UI SwiftUI lists.",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "build": "node internal/module_scripts/build.js",
+    "clean": "node internal/module_scripts/clean.js",
+    "lint": "eslint src/",
+    "test": "node internal/module_scripts/test.js",
+    "prepack": "node internal/module_scripts/prepare.js",
+    "open:ios": "node internal/module_scripts/open-ios.js",
+    "open:android": "node internal/module_scripts/open-android.js"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "expo-ui",
+    "swiftui",
+    "section-index",
+    "alphabet-list",
+    "ios-26"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Elcaten/expo-list-section-index.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Elcaten/expo-list-section-index/issues"
+  },
+  "author": "Elcaten <sweet.bunch7296@fastmail.com> (https://github.com/Elcaten)",
+  "license": "MIT",
+  "homepage": "https://github.com/Elcaten/expo-list-section-index#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@babel/core": "^7.26.0",
+    "@expo/ui": "~57.0.7",
+    "@types/jest": "^29.2.1",
+    "@types/react": "~19.2.2",
+    "babel-preset-expo": "~57.0.4",
+    "eslint": "~9.39.4",
+    "eslint-config-universe": "^15.0.3",
+    "expo": "^57.0.7",
+    "expo-modules-core": "~57.0.7",
+    "jest": "^29.7.0",
+    "jest-expo": "~57.0.2",
+    "prettier": "^3.0.0",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "react-native": "0.86.0",
+    "typescript": "^5.9.2"
+  },
+  "jest": {
+    "preset": "jest-expo",
+    "roots": [
+      "<rootDir>/src"
+    ]
+  },
+  "peerDependencies": {
+    "@expo/ui": ">=57.0.0",
+    "expo": "*",
+    "react": "*",
+    "react-native": "*"
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export {
+  listSectionIndexVisibility,
+  sectionIndexLabel,
+  type ListSectionIndexVisibility,
+} from './modifiers';

package/src/modifiers.ts

@@ -0,0 +1,16 @@
+import { createModifier, type ModifierConfig } from '@expo/ui/swift-ui/modifiers';
+
+const sectionIndexLabelModifier = 'expoListSectionIndex.sectionIndexLabel';
+const listSectionIndexVisibilityModifier = 'expoListSectionIndex.listSectionIndexVisibility';
+
+export type ListSectionIndexVisibility = 'automatic' | 'visible' | 'hidden';
+
+export function sectionIndexLabel(label: string | null): ModifierConfig {
+  return createModifier(sectionIndexLabelModifier, { label });
+}
+
+export function listSectionIndexVisibility(
+  visibility: ListSectionIndexVisibility = 'automatic'
+): ModifierConfig {
+  return createModifier(listSectionIndexVisibilityModifier, { visibility });
+}

package/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "lib": ["dom", "DOM.Iterable", "esnext"],
+    "types": ["jest"],
+    "typeRoots": ["./ts-declarations", "./node_modules/@types"],
+    "jsx": "react-native",
+    "target": "esnext",
+    "moduleResolution": "bundler",
+    "module": "esnext",
+    "moduleDetection": "force",
+    "esModuleInterop": true,
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+    "inlineSources": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": false,
+    "noImplicitReturns": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": false,
+    "rootDir": "./src",
+    "outDir": "./build"
+  },
+  "include": ["./src"],
+  "exclude": ["**/__mocks__/*", "**/__tests__/*"]
+}