vouchington-tooling 0.6.2 → 0.7.0

package/ast-grep/rules/pagination-no-exact-limit-has-next.yml

@@ -0,0 +1,111 @@
+id: pagination-no-exact-limit-has-next
+language: TypeScript
+severity: error
+message: 'Do not infer another page from an exact page-size boundary; fetch limit + 1 and test rows.length > limit.'
+files:
+  - 'backend/**/*.mts'
+ignores:
+  - 'backend/**/*.test.mts'
+  - 'backend/**/__tests__/**'
+rule:
+  all:
+    - any:
+        - pattern: $ROWS.length === $BOUND
+        - pattern: $ROWS.length == $BOUND
+        - pattern: $ROWS.length >= $BOUND
+        - pattern: $BOUND === $ROWS.length
+        - pattern: $BOUND == $ROWS.length
+        - pattern: $BOUND <= $ROWS.length
+    - any:
+        - inside:
+            kind: variable_declarator
+            stopBy: end
+            has:
+              kind: identifier
+              regex: '^has(?:More|NextPage)$'
+              stopBy: neighbor
+        - inside:
+            kind: assignment_expression
+            stopBy: end
+            has:
+              field: left
+              kind: identifier
+              regex: '^has(?:More|NextPage)$'
+        - inside:
+            kind: pair
+            stopBy: end
+            has:
+              kind: property_identifier
+              regex: '^(?:has_next_page|hasNextPage)$'
+              stopBy: neighbor
+constraints:
+  BOUND:
+    any:
+      - all:
+          - regex: '(?i)(?:limit|pageSize)'
+          - not:
+              kind: binary_expression
+      - all:
+          - kind: number
+          - regex: '^[1-9][0-9]*$'
+examples:
+  - code: 'const hasMore = messages.length === effectiveLimit'
+    isValid: false
+    file: 'backend/api/v1/example/list.mts'
+  - code: 'const hasNextPage = rows.length >= limit'
+    isValid: false
+    file: 'backend/services/example/search.mts'
+  - code: 'hasMore = users.length === 100'
+    isValid: false
+    file: 'backend/services/example/search.mts'
+  - code: 'const hasMore = effectiveLimit === messages.length'
+    isValid: false
+    file: 'backend/api/v1/example/list.mts'
+  - code: 'const hasNextPage = options.pageSize <= rows.length'
+    isValid: false
+    file: 'backend/services/example/search.mts'
+  - code: 'const hasMore = rows.length == options.pagination.limit'
+    isValid: false
+    file: 'backend/services/example/search.mts'
+  - code: 'const hasNextPage = getEffectiveLimit(options) == rows.length'
+    isValid: false
+    file: 'backend/services/example/search.mts'
+  - code: 'const options = { hasNextPage: rows.length === limit }'
+    isValid: false
+    file: 'backend/services/example/search.mts'
+  - code: 'const pageInfo = { has_next_page: limit <= rows.length }'
+    isValid: false
+    file: 'backend/services/example/search.mts'
+  - code: 'const hasNextPage = rows.length > limit'
+    isValid: true
+    file: 'backend/services/example/search.mts'
+  - code: 'hasMore = users.length > limit'
+    isValid: true
+    file: 'backend/services/example/search.mts'
+  - code: 'const nextCursor = userIds.length === limit ? userIds.at(-1) : null'
+    isValid: true
+    file: 'backend/services/example/find-users-needing-recalculation.mts'
+  - code: 'const hasMore = rows.length === 0'
+    isValid: true
+    file: 'backend/services/example/search.mts'
+  - code: 'const hasMore = rows.length >= minimumResults'
+    isValid: true
+    file: 'backend/services/example/search.mts'
+  - code: 'const hasMore = rows.length === limit + 1'
+    isValid: true
+    file: 'backend/services/example/search.mts'
+  - code: 'const options = { hasMoreRows: rows.length === limit }'
+    isValid: true
+    file: 'backend/services/example/search.mts'
+  - code: 'nextCursor = users.length === 100 ? users.at(-1)?.id : null'
+    isValid: true
+    file: 'backend/services/example/search.mts'
+  - code: 'const hasMore = messages.length === effectiveLimit'
+    isValid: true
+    file: 'backend/api/v1/example/list.test.mts'
+  - code: 'hasMore = users.length === 100'
+    isValid: true
+    file: 'backend/services/example/search.test.mts'
+  - code: 'const hasNextPage = rows.length === limit'
+    isValid: true
+    file: 'backend/services/example/search.mock.test.mts'

package/ast-grep/rules/playwright-no-bare-meta-press.yml

@@ -0,0 +1,29 @@
+id: playwright-no-bare-meta-press
+language: TypeScript
+severity: error
+message: "use 'ControlOrMeta+' instead of 'Meta+' in Playwright .press() calls; bare Meta+ fails on Linux CI"
+files:
+  - '**/*.spec.mts'
+rule:
+  any:
+    - pattern: $OBJ.press($ARG)
+    - pattern: $OBJ.press($ARG, $$$REST)
+constraints:
+  ARG:
+    regex: '[^A-Za-z]Meta\+'
+examples:
+  - code: "await input.press('Meta+Enter')"
+    isValid: false
+    file: 'playwright/tests/forms/form.spec.mts'
+  - code: "await input.press('Meta+Enter', { delay: 10 })"
+    isValid: false
+    file: 'playwright/tests/forms/form.spec.mts'
+  - code: "await input.press('Shift+Meta+Enter')"
+    isValid: false
+    file: 'playwright/tests/forms/form.spec.mts'
+  - code: "await input.press('ControlOrMeta+Enter')"
+    isValid: true
+    file: 'playwright/tests/forms/form.spec.mts'
+  - code: "await input.press('Shift+ControlOrMeta+Enter')"
+    isValid: true
+    file: 'playwright/tests/forms/form.spec.mts'

package/ast-grep/rules/storybook-no-webpack-final.yml

@@ -0,0 +1,31 @@
+id: storybook-no-webpack-final
+language: TypeScript
+severity: error
+message: 'Storybook must use viteFinal, not webpackFinal; this project uses @storybook/nextjs-vite'
+files:
+  - '**/.storybook/main.ts'
+  - '**/.storybook/main.mts'
+  - '**/.storybook/main.cts'
+rule:
+  regex: '^webpackFinal$|^["''`]webpackFinal["''`]$'
+  any:
+    - kind: property_identifier
+    - kind: shorthand_property_identifier
+    - kind: identifier
+    - kind: string
+examples:
+  - code: 'const config = { webpackFinal: (c) => c }'
+    isValid: false
+    file: 'web/.storybook/main.ts'
+  - code: "const config = { 'webpackFinal': (c) => c }"
+    isValid: false
+    file: 'web/.storybook/main.ts'
+  - code: 'const webpackFinal = (c) => c; export default { framework, webpackFinal }'
+    isValid: false
+    file: 'web/.storybook/main.ts'
+  - code: 'const config = { viteFinal: (c) => c }'
+    isValid: true
+    file: 'web/.storybook/main.ts'
+  - code: '// webpackFinal'
+    isValid: true
+    file: 'web/.storybook/main.ts'

package/ast-grep/rules/web-class-component-needs-use-client.yml

@@ -0,0 +1,175 @@
+# NOTE: This is a prevention guard on an already-clean surface — the only App Router
+# class component today is `web/components/ui/error-boundary.tsx`, which already has
+# `'use client'`. The Storybook ratchet class lives under `web/storybook/**` and is
+# ignored. Zero live hits from `ast-grep scan` is expected and correct; the rule's
+# ability to fire is proven by the `isValid: false` examples below, not by live
+# scan hits.
+# Known misses, not implied coverage: `import { Component as C }` when the
+# local name is not `Component`/`PureComponent`, and `implements` clauses.
+# tree-sitter-tsx puts heritage under `class_heritage` → `extends_clause`.
+# `Component` is an `identifier`; `React.Component` uses `property_identifier`.
+# The `'use client'` exemption is the leading directive only: Next ignores a
+# later program-level string after an import or other statement. A comment may
+# precede the directive. `interface … extends ComponentProps` is not a
+# `class_declaration` and cannot match.
+id: web-class-component-needs-use-client
+language: Tsx
+severity: error
+message: >-
+  React class components must live in a `'use client'` module. `'use server'` is
+  a server-action directive and does not make a class a valid Server Component.
+files:
+  - 'web/**/*.tsx'
+ignores:
+  - '**/*.test.tsx'
+  - '**/*.spec.tsx'
+  - '**/*.mock.test.tsx'
+  - '**/*.stories.tsx'
+  - 'web/storybook/**'
+rule:
+  kind: program
+  all:
+    - has:
+        stopBy: end
+        kind: class_declaration
+        has:
+          kind: class_heritage
+          has:
+            kind: extends_clause
+            has:
+              stopBy: end
+              any:
+                - kind: identifier
+                  regex: '^(?:Component|PureComponent)$'
+                - kind: property_identifier
+                  regex: '^(?:Component|PureComponent)$'
+    - not:
+        has:
+          kind: expression_statement
+          has:
+            any:
+              - pattern: "'use client'"
+              - pattern: '"use client"'
+          # Next only honors a leading directive. A later program-level
+          # string after an import or other statement is not a directive.
+          # `stopBy: end` looks past intervening comments so
+          # `import ...; // note; 'use client'` stays a violation. A
+          # file-leading comment before the directive still exempts.
+          not:
+            follows:
+              stopBy: end
+              any:
+                - kind: import_statement
+                - kind: export_statement
+                - kind: class_declaration
+                - kind: lexical_declaration
+                - kind: variable_declaration
+                - kind: function_declaration
+                - kind: interface_declaration
+                - kind: type_alias_declaration
+                - kind: expression_statement
+examples:
+  - code: |
+      import { Component, type ReactNode } from 'react'
+      export class ErrorBoundary extends Component<{ children: ReactNode }, { hasError: boolean }> {
+        render(): ReactNode { return this.props.children }
+      }
+    isValid: false
+    file: 'web/components/ui/example.tsx'
+  - code: |
+      import { Component, type ReactNode } from 'react'
+      export default class FallbackBoundary extends Component<{ children: ReactNode }> {
+        render(): ReactNode { return this.props.children }
+      }
+    isValid: false
+    file: 'web/components/ui/default-export.tsx'
+  - code: |
+      import { PureComponent, type ReactNode } from 'react'
+      export class PureBoundary extends PureComponent<{ children: ReactNode }> {
+        render(): ReactNode { return this.props.children }
+      }
+    isValid: false
+    file: 'web/components/ui/pure-example.tsx'
+  - code: |
+      import React from 'react'
+      export class NsBoundary extends React.Component<{ children: React.ReactNode }> {
+        render() { return this.props.children }
+      }
+    isValid: false
+    file: 'web/components/ui/react-ns.tsx'
+  - code: |
+      export class NestedDirective extends Component {
+        render() {
+          const mark = 'use client'
+          return mark
+        }
+      }
+    isValid: false
+    file: 'web/components/ui/nested-directive.tsx'
+  - code: |
+      import { Component, type ReactNode } from 'react'
+      'use client'
+      export class LateBoundary extends Component<{ children: ReactNode }> {
+        render(): ReactNode { return this.props.children }
+      }
+    isValid: false
+    file: 'web/components/ui/late-directive.tsx'
+  - code: |
+      import { Component, type ReactNode } from 'react'
+      // explanation
+      'use client'
+      export class InterleavedBoundary extends Component<{ children: ReactNode }> {
+        render(): ReactNode { return this.props.children }
+      }
+    isValid: false
+    file: 'web/components/ui/interleaved-directive.tsx'
+  - code: |
+      'use client'
+      import { Component, type ReactNode } from 'react'
+      export class ErrorBoundary extends Component<{ children: ReactNode }, { hasError: boolean }> {
+        render(): ReactNode { return this.props.children }
+      }
+    isValid: true
+    file: 'web/components/ui/error-boundary.tsx'
+  - code: |
+      "use client"
+      import { Component, type ReactNode } from 'react'
+      export class QuotedBoundary extends Component<{ children: ReactNode }> {
+        render(): ReactNode { return this.props.children }
+      }
+    isValid: true
+    file: 'web/components/ui/quoted-boundary.tsx'
+  - code: |
+      import { type ComponentProps } from 'react'
+      interface Props extends ComponentProps<typeof Date> {
+        extra: boolean
+      }
+    isValid: true
+    file: 'web/components/ui/component-props.tsx'
+  - code: |
+      export interface ExternalLinkProps extends React.ComponentPropsWithoutRef<'a'> {
+        href: string
+      }
+    isValid: true
+    file: 'web/components/ui/external-link-props.tsx'
+  - code: |
+      import { Component, type ReactNode } from 'react'
+      export class ErrorBoundary extends Component<{ children: ReactNode }, { hasError: boolean }> {
+        render(): ReactNode { return this.props.children }
+      }
+    isValid: true
+    file: 'web/components/ui/error-boundary.test.tsx'
+  - code: |
+      import { Component, type ReactNode } from 'react'
+      export class ErrorBoundary extends Component<{ children: ReactNode }, { hasError: boolean }> {
+        render(): ReactNode { return this.props.children }
+      }
+    isValid: true
+    file: 'web/components/ui/error-boundary.stories.tsx'
+  - code: |
+      import { Component, type ReactNode } from 'react'
+      export class ErrorBoundary extends Component<{ children: ReactNode }, { hasError: boolean }> {
+        render(): ReactNode { return this.props.children }
+      }
+    isValid: true
+    file: 'web/storybook/component-story-ratchet-renderer.tsx'

package/ast-grep/rules/web-clickable-needs-pointer.yml

@@ -0,0 +1,74 @@
+id: web-clickable-needs-pointer
+language: Tsx
+severity: error
+message: >-
+  Clickable elements need a pointer cursor. Use a real <button>/<Button>, or
+  add `cursor-pointer` (native buttons and [role=button] already get it from
+  globals.css).
+files:
+  - 'web/**/*.tsx'
+ignores:
+  - 'web/components/ui/**'
+  - '**/*.test.tsx'
+  - '**/*.spec.tsx'
+  - '**/*.stories.tsx'
+rule:
+  all:
+    - any:
+        - kind: jsx_opening_element
+        - kind: jsx_self_closing_element
+    - has:
+        field: name
+        regex: '^(div|span|li|ul|ol|tr|td|th|section|article|header|footer|aside|nav|main|p|figure)$'
+    - has:
+        kind: jsx_attribute
+        regex: '^onClick'
+    - not:
+        has:
+          kind: jsx_attribute
+          regex: 'cursor-pointer'
+    - not:
+        has:
+          kind: jsx_attribute
+          regex: '^role=[''"]button[''"]'
+examples:
+  - code: |
+      <div onClick={fn}>click me</div>
+    isValid: false
+    file: web/app/clickable-example.tsx
+  - code: |
+      <span onClick={fn} className="text-sm">click me</span>
+    isValid: false
+    file: web/app/clickable-example.tsx
+  - code: |
+      <div onClick={fn} role="menuitem">click me</div>
+    isValid: false
+    file: web/app/clickable-example.tsx
+  - code: |
+      <div onClick={fn} className="cursor-pointer">click me</div>
+    isValid: true
+    file: web/app/clickable-example.tsx
+  - code: |
+      <button onClick={fn}>click me</button>
+    isValid: true
+    file: web/app/clickable-example.tsx
+  - code: |
+      <Button onClick={fn}>click me</Button>
+    isValid: true
+    file: web/app/clickable-example.tsx
+  - code: |
+      <div onClick={fn} role="button">click me</div>
+    isValid: true
+    file: web/app/clickable-example.tsx
+  - code: |
+      <div onClick={fn}>click me</div>
+    isValid: true
+    file: web/components/ui/foo.tsx
+  - code: |
+      <div onClick={fn}>click me</div>
+    isValid: true
+    file: SomeComponent.test.tsx
+  - code: |
+      <div onClick={fn}>click me</div>
+    isValid: true
+    file: SomeComponent.stories.tsx

package/ast-grep/rules/web-dialog-content-description.yml

@@ -0,0 +1,56 @@
+id: web-dialog-content-description
+language: Tsx
+severity: error
+message: 'DialogContent and AlertDialogContent must include a DialogDescription or AlertDialogDescription child.'
+files:
+  - 'web/**/*.tsx'
+ignores:
+  - 'web/**/*.test.tsx'
+  - 'web/**/*.mock.test.tsx'
+  - 'web/**/*.stories.tsx'
+  - 'web/components/ui/**/*.tsx'
+rule:
+  any:
+    - all:
+        - pattern: '<DialogContent $$$ATTRS>$$$CHILDREN</DialogContent>'
+        - not:
+            has:
+              pattern: '<DialogDescription $$$>$$$</DialogDescription>'
+              stopBy: end
+    - all:
+        - pattern: '<AlertDialogContent $$$ATTRS>$$$CHILDREN</AlertDialogContent>'
+        - not:
+            has:
+              pattern: '<AlertDialogDescription $$$>$$$</AlertDialogDescription>'
+              stopBy: end
+examples:
+  - code: |
+      export function X() {
+        return <DialogContent><DialogHeader><DialogTitle>Title</DialogTitle></DialogHeader></DialogContent>
+      }
+    isValid: false
+    file: 'web/components/example-dialog.tsx'
+  - code: |
+      export function X() {
+        return <AlertDialogContent><AlertDialogHeader><AlertDialogTitle>Title</AlertDialogTitle></AlertDialogHeader></AlertDialogContent>
+      }
+    isValid: false
+    file: 'web/components/example-alert-dialog.tsx'
+  - code: |
+      export function X() {
+        return <DialogContent><DialogHeader><DialogTitle>Title</DialogTitle><DialogDescription>Help text</DialogDescription></DialogHeader></DialogContent>
+      }
+    isValid: true
+    file: 'web/components/example-dialog.tsx'
+  - code: |
+      export function X() {
+        return <AlertDialogContent><AlertDialogHeader><AlertDialogTitle>Title</AlertDialogTitle><AlertDialogDescription>Help text</AlertDialogDescription></AlertDialogHeader></AlertDialogContent>
+      }
+    isValid: true
+    file: 'web/components/example-alert-dialog.tsx'
+  - code: |
+      export function X() {
+        return <DialogContent><DialogHeader><DialogTitle>Title</DialogTitle></DialogHeader></DialogContent>
+      }
+    isValid: true
+    file: 'web/components/example-dialog.mock.test.tsx'

package/ast-grep/rules/web-icon-button-tooltip.yml

@@ -0,0 +1,82 @@
+id: web-icon-button-tooltip
+language: Tsx
+severity: error
+message: 'Use TooltipButton or an aria-label/aria-labelledby accessible name for icon-only buttons.'
+files:
+  - 'web/**/*.tsx'
+ignores:
+  - 'web/**/*.test.tsx'
+  - 'web/**/*.mock.test.tsx'
+  - 'web/**/*.stories.tsx'
+  - 'web/components/ui/**/*.tsx'
+rule:
+  any:
+    - all:
+        - any:
+            - kind: jsx_opening_element
+            - kind: jsx_self_closing_element
+        - has:
+            field: name
+            regex: '^Button$'
+        - has:
+            kind: jsx_attribute
+            regex: '^size=["''](?:icon|touchIcon)["'']'
+        - not:
+            has:
+              kind: jsx_attribute
+              regex: '^asChild$'
+        - not:
+            has:
+              kind: jsx_attribute
+              regex: '^aria-label='
+        - not:
+            has:
+              kind: jsx_attribute
+              regex: '^aria-labelledby='
+        - not:
+            inside:
+              kind: jsx_element
+              has:
+                kind: jsx_opening_element
+                has:
+                  field: name
+                  regex: '^TooltipTrigger$'
+    - all:
+        - any:
+            - kind: jsx_opening_element
+            - kind: jsx_self_closing_element
+        - has:
+            field: name
+            regex: '^TooltipButton$'
+        - has:
+            kind: jsx_attribute
+            regex: '^size=["''](?:icon|touchIcon)["'']'
+        - not:
+            has:
+              kind: jsx_attribute
+              regex: '^tooltip='
+examples:
+  - code: 'export function X() { return <Button size="icon" /> }'
+    isValid: false
+    file: 'web/components/example/save-button.tsx'
+  - code: 'export function X() { return <Button size="touchIcon" /> }'
+    isValid: false
+    file: 'web/components/example/save-button.tsx'
+  - code: 'export function X() { return <Button size="icon" aria-label="Save" /> }'
+    isValid: true
+    file: 'web/components/example/save-button.tsx'
+  - code: 'export function X() { return <TooltipButton size="icon" /> }'
+    isValid: false
+    file: 'web/components/example/save-button.tsx'
+  - code: 'export function X() { return <TooltipButton size="icon" tooltip="Save" /> }'
+    isValid: true
+    file: 'web/components/example/save-button.tsx'
+  - code: 'export function X() { return <TooltipTrigger><Button size="icon" /></TooltipTrigger> }'
+    isValid: true
+    file: 'web/components/example/save-button.tsx'
+  - code: 'export function X() { return <Button size="default" /> }'
+    isValid: true
+    file: 'web/components/example/save-button.tsx'
+  - code: 'export function X() { return <Button size="icon" /> }'
+    isValid: true
+    file: 'web/components/ui/button.tsx'

package/ast-grep/rules/web-no-inline-scrollbar-hide.yml

@@ -0,0 +1,41 @@
+id: web-no-inline-scrollbar-hide
+language: Tsx
+severity: error
+message: "Use the Tailwind 'scrollbar-hide' utility class instead of inline scrollbar-hiding CSS"
+files:
+  - 'web/**/*.tsx'
+ignores:
+  - '**/*.test.tsx'
+  - '**/*.spec.tsx'
+  - '**/*.stories.tsx'
+rule:
+  # `pattern: 'style={$OBJ}'` does not work as a JSX attribute matcher in Tsx
+  # (ast-grep parses it as a TypeScript assignment). Use `kind: jsx_attribute`
+  # with an explicit `style` name check (attribute names are `property_identifier`
+  # in the TSX grammar) so that only the `style` attribute is flagged, not other
+  # JSX attributes that happen to contain those property names in their values.
+  all:
+    - kind: jsx_attribute
+    # No stopBy:end: the attribute name is an immediate child of jsx_attribute.
+    # Use regex (not pattern:) because `pattern: style` parses as an `identifier`
+    # AST node, which does not match the `property_identifier` grammar kind used
+    # for JSX attribute names.
+    - has:
+        kind: property_identifier
+        regex: '^style$'
+    # The scrollbar properties are nested inside the style object so stopBy:end
+    # is required to find them anywhere inside the attribute value.
+    - has:
+        stopBy: end
+        kind: property_identifier
+        regex: '^(scrollbarWidth|WebkitScrollbar|msOverflowStyle)$'
+examples:
+  - code: "<div style={{ scrollbarWidth: 'none' }} />"
+    isValid: false
+    file: 'web/app/page.tsx'
+  - code: "<div style={{ msOverflowStyle: 'none' }} />"
+    isValid: false
+    file: 'web/app/page.tsx'
+  - code: '<div className="scrollbar-hide" />'
+    isValid: true
+    file: 'web/app/page.tsx'

package/ast-grep/rules/web-no-window-open-navigation.yml

@@ -0,0 +1,39 @@
+id: web-no-window-open-navigation
+language: Tsx
+severity: error
+message: >
+  Use an ExternalLink component or <a target="_blank"> instead of window.open() for new-tab navigation.
+files:
+  - 'web/**/*.tsx'
+  - 'web/**/*.ts'
+ignores:
+  - '**/*.test.tsx'
+  - '**/*.test.ts'
+  - '**/*.stories.tsx'
+  - '**/*.stories.ts'
+rule:
+  any:
+    - pattern: window.open($URL, '_blank', $$$)
+    - pattern: window.open($URL, '_blank')
+examples:
+  - code: "window.open(url, '_blank', 'noopener,noreferrer')"
+    isValid: false
+    file: 'web/app/page.tsx'
+  - code: "window.open(url, '_blank')"
+    isValid: false
+    file: 'web/app/page.tsx'
+  - code: "window.open(href, '_blank', 'noopener,noreferrer')"
+    isValid: false
+    file: 'web/components/search/command-link-item.tsx'
+  - code: "window.open(messagesHref(conversation), '_blank')"
+    isValid: false
+    file: 'web/components/example/mod-queue-posts.tsx'
+  - code: "window.open(messagesHref(conversation), '_blank')"
+    isValid: false
+    file: 'web/components/example/mod-queue-reports.tsx'
+  - code: '<ExternalLink href={url}>Link</ExternalLink>'
+    isValid: true
+    file: 'web/app/page.tsx'
+  - code: '<a href={url} target="_blank" rel="noopener noreferrer">Link</a>'
+    isValid: true
+    file: 'web/app/page.tsx'

package/ast-grep/sgconfig.yml

@@ -0,0 +1,9 @@
+ruleDirs:
+  - rules
+languageGlobs:
+  TypeScript:
+    - '**/*.ts'
+    - '**/*.mts'
+    - '**/*.cts'
+  Tsx:
+    - '**/*.tsx'

package/dist/ast-grep-pack/index.d.mts

@@ -0,0 +1,6 @@
+export type AstGrepPackPaths = {
+    readonly rules: string;
+    readonly config: string;
+};
+export declare function astGrepPackPathsFrom(rules: string, config: string): AstGrepPackPaths;
+export declare function astGrepPackPaths(): AstGrepPackPaths;

package/dist/ast-grep-pack/index.mjs

@@ -0,0 +1,11 @@
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+export function astGrepPackPathsFrom(rules, config) {
+    if (!existsSync(rules) || !existsSync(config)) {
+        throw new Error('ast-grep pack is missing from the installed package');
+    }
+    return { rules, config };
+}
+export function astGrepPackPaths() {
+    return astGrepPackPathsFrom(fileURLToPath(new URL('../../ast-grep/rules', import.meta.url)), fileURLToPath(new URL('../../ast-grep/sgconfig.yml', import.meta.url)));
+}

package/dist/cli/commands/ast-grep-pack.d.mts

@@ -0,0 +1,2 @@
+import { type AstGrepPackPaths } from '../../ast-grep-pack/index.mts';
+export declare function runAstGrepPackCommand(load?: () => AstGrepPackPaths): number;