Add typescript types to bin

.ncurc.cjs

@@ -1,6 +1,7 @@
 "use strict";
 
 module.exports = {
+  "dep": ["prod", "dev", "packageManager"],
   "reject": [
     "chai", // Moved to es6
     "@types/chai", // Should match chai

.npmignore

@@ -29,3 +29,4 @@ tsconfig*.json
 web-test/
 yarn.lock
 pnpm-workspace.yaml
+bin/tsconfig.json

CHANGELOG.md

@@ -12,6 +12,8 @@ Released: TBD
 
 ### New features
 
+- [#477](https://github.com/peggyjs/peggy/issues/477) Option to output .d.ts
+  files next to .js from CLI.
 - [#530](https://github.com/peggyjs/peggy/issues/531) Allow es6 plugins from CLI
 - [#532](https://github.com/peggyjs/peggy/issues/532) Allow es6 options files
   from the CLI

bin/generated_template.d.ts

@@ -0,0 +1,113 @@
+/** Provides information pointing to a location within a source. */
+export interface Location {
+  /** Line in the parsed source (1-based). */
+  line: number;
+  /** Column in the parsed source (1-based). */
+  column: number;
+  /** Offset in the parsed source (0-based). */
+  offset: number;
+}
+
+/** The `start` and `end` position's of an object within the source. */
+export interface LocationRange {
+  /** Any object that was supplied to the `parse()` call as the `grammarSource` option. */
+  source: any;
+  /** Position at the beginning of the expression. */
+  start: Location;
+  /** Position after the end of the expression. */
+  end: Location;
+}
+
+export interface LiteralExpectation {
+  type: "literal";
+  text: string;
+  ignoreCase: boolean;
+}
+export interface ClassParts extends Array<string | ClassParts> {
+}
+export interface ClassExpectation {
+  type: "class";
+  parts: ClassParts;
+  inverted: boolean;
+  ignoreCase: boolean;
+}
+export interface AnyExpectation {
+  type: "any";
+}
+export interface EndExpectation {
+  type: "end";
+}
+export interface OtherExpectation {
+  type: "other";
+  description: string;
+}
+export type Expectation =
+  | AnyExpectation
+  | ClassExpectation
+  | EndExpectation
+  | LiteralExpectation
+  | OtherExpectation;
+
+declare class _PeggySyntaxError extends Error {
+  /**
+   * Constructs the human-readable message from the machine representation.
+   *
+   * @param expected Array of expected items, generated by the parser
+   * @param found Any text that will appear as found in the input instead of
+   *   expected
+   */
+  static buildMessage(expected: Expectation[], found: string | null): string;
+  message: string;
+  expected: Expectation[];
+  found: string | null;
+  location: LocationRange;
+  name: string;
+  constructor(
+    message: string,
+    expected: Expectation[],
+    found: string | null,
+    location: LocationRange,
+  );
+  format(sources: {
+    source?: any;
+    text: string;
+  }[]): string;
+}
+
+export interface ParserTracer {
+  trace(event: ParserTracerEvent): void;
+}
+
+export type ParserTracerEvent
+  = { type: "rule.enter"; rule: string; location: LocationRange }
+  | { type: "rule.fail"; rule: string; location: LocationRange }
+  | { type: "rule.match"; rule: string; result: any; location: LocationRange };
+
+export type StartRules = $$$StartRules$$$;
+export interface ParseOptions<T extends  StartRules = $$$DefaultStartRule$$$> {
+  /**
+   * Object that will be attached to the each `LocationRange` object created by
+   * the parser. For example, this can be path to the parsed file or even the
+   * File object.
+   */
+  grammarSource?: any;
+  startRule?: T;
+  tracer?: ParserTracer;
+
+  // Internal use only:
+  peg$library?: boolean;
+  // Internal use only:
+  peg$currPos?: number;
+  // Internal use only:
+  peg$silentFails?: number;
+  // Internal use only:
+  peg$maxFailExpected?: Expectation[];
+  // Extra application-specific properties
+  [key: string]: any;
+}
+
+export declare const parse: typeof ParseFunction;
+export declare const SyntaxError: typeof _PeggySyntaxError;
+export type SyntaxError = _PeggySyntaxError;
+
+// Overload of ParseFunction for each allowedStartRule