@nestia/factory 12.0.0-dev.20260520.1

package/src/structures/CommentNode.ts

@@ -0,0 +1,7 @@
+export interface CommentNode {
+  readonly kind: number;
+  readonly text: string;
+  readonly hasTrailingNewLine?: boolean;
+  readonly pos?: number;
+  readonly end?: number;
+}

package/src/structures/EmitNode.ts

@@ -0,0 +1,6 @@
+import type { CommentNode } from "./CommentNode";
+
+export interface EmitNode {
+  leadingComments?: CommentNode[];
+  trailingComments?: CommentNode[];
+}

package/src/structures/Node.ts

@@ -0,0 +1,76 @@
+import type { EmitNode } from "./EmitNode";
+import type { NodeArray } from "./NodeArray";
+
+export interface Node {
+  pos: number;
+  end: number;
+  kind: number;
+  flags: number;
+  modifierFlagsCache: number;
+  transformFlags: number;
+  emitNode?: EmitNode;
+
+  text?: string;
+  escapedText?: string;
+  rawText?: string;
+  singleQuote?: boolean;
+
+  modifiers?: NodeArray;
+  statements?: NodeArray;
+  members?: NodeArray;
+  parameters?: NodeArray;
+  declarations?: NodeArray;
+  elements?: NodeArray;
+  properties?: NodeArray;
+  typeArguments?: NodeArray;
+  typeParameters?: NodeArray;
+  templateSpans?: NodeArray;
+  types?: NodeArray;
+  heritageClauses?: NodeArray;
+
+  name?: Node;
+  propertyName?: Node;
+  typeName?: Node;
+  exprName?: Node;
+  left?: Node;
+  right?: Node;
+  expression?: Node;
+  initializer?: Node;
+  objectAssignmentInitializer?: Node;
+  operand?: Node;
+  operator?: number;
+  operatorToken?: Node;
+  questionDotToken?: Node;
+  questionToken?: Node;
+  dotDotDotToken?: Node;
+  equalsGreaterThanToken?: Node;
+  asteriskToken?: Node;
+  awaitModifier?: Node;
+  endOfFileToken?: Node;
+  literal?: Node;
+  head?: Node;
+  type?: Node;
+  elementType?: Node;
+  condition?: Node;
+  whenTrue?: Node;
+  whenFalse?: Node;
+  body?: Node;
+  thenStatement?: Node;
+  elseStatement?: Node;
+  statement?: Node;
+  tryBlock?: Node;
+  catchClause?: Node;
+  finallyBlock?: Node;
+  block?: Node;
+  variableDeclaration?: Node;
+  declarationList?: Node;
+  importClause?: Node;
+  moduleSpecifier?: Node;
+  namedBindings?: Node;
+  exportClause?: Node;
+
+  arguments?: NodeArray;
+  isTypeOnly?: boolean;
+  multiLine?: boolean;
+  fileName?: string;
+}

package/src/structures/NodeArray.ts

@@ -0,0 +1,8 @@
+import type { Node } from "./Node";
+
+export type NodeArray<T extends Node = Node> = T[] & {
+  pos: number;
+  end: number;
+  hasTrailingComma: boolean;
+  transformFlags: number;
+};

package/src/structures/NodeProps.ts

@@ -0,0 +1,3 @@
+import type { Node } from "./Node";
+
+export type NodeProps = Partial<Node> & Record<string, unknown>;

package/src/structures/index.ts

@@ -0,0 +1,5 @@
+export type { CommentNode } from "./CommentNode";
+export type { EmitNode } from "./EmitNode";
+export type { Node } from "./Node";
+export type { NodeArray } from "./NodeArray";
+export type { NodeProps } from "./NodeProps";

package/src/utils/asModuleSpecifier.ts

@@ -0,0 +1,5 @@
+import { createStringLiteral } from "../factory/literals/createStringLiteral";
+import type { Node } from "../structures/Node";
+
+export const asModuleSpecifier = (input: string | Node): Node =>
+  typeof input === "string" ? createStringLiteral(input) : input;

package/src/utils/asName.ts

@@ -0,0 +1,5 @@
+import { createIdentifier } from "../factory/literals/createIdentifier";
+import type { Node } from "../structures/Node";
+
+export const asName = (input: string | Node): Node =>
+  typeof input === "string" ? createIdentifier(input) : input;

package/src/utils/asToken.ts

@@ -0,0 +1,5 @@
+import { createToken } from "../factory/tokens/createToken";
+import type { Node } from "../structures/Node";
+
+export const asToken = (input: number | Node | undefined): Node | undefined =>
+  typeof input === "number" ? createToken(input) : input;

package/src/utils/createNode.ts

@@ -0,0 +1,13 @@
+import { NodeFlags } from "../constants/NodeFlags";
+import type { Node } from "../structures/Node";
+import type { NodeProps } from "../structures/NodeProps";
+
+export const createNode = (kind: number, props: NodeProps = {}): Node => ({
+  pos: -1,
+  end: -1,
+  kind,
+  flags: NodeFlags.Synthesized,
+  modifierFlagsCache: 0,
+  transformFlags: 0,
+  ...props,
+});

package/src/utils/createNodeArray.ts

@@ -0,0 +1,14 @@
+import type { Node } from "../structures/Node";
+import type { NodeArray } from "../structures/NodeArray";
+
+export const createNodeArray = <T extends Node>(
+  items: readonly T[] | undefined,
+): NodeArray<T> => {
+  const array: T[] = [...(items ?? [])];
+  return Object.assign(array, {
+    pos: -1,
+    end: -1,
+    hasTrailingComma: false,
+    transformFlags: 0,
+  });
+};