typia 9.7.1 → 10.0.0-dev.20251107

package/src/programmers/internal/json_schema_object.ts

@@ -1,158 +1,150 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { CommentFactory } from "../../factories/CommentFactory";
-
-import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataObject } from "../../schemas/metadata/MetadataObject";
-
-import { PatternUtil } from "../../utils/PatternUtil";
-
-import { json_schema_description } from "./json_schema_description";
-import { json_schema_plugin } from "./json_schema_plugin";
-import { json_schema_station } from "./json_schema_station";
-import { json_schema_title } from "./json_schema_title";
-import { metadata_to_pattern } from "./metadata_to_pattern";
-
-/**
- * @internal
- */
-export const json_schema_object = (props: {
-  components: OpenApi.IComponents;
-  object: MetadataObject;
-}): Array<OpenApi.IJsonSchema.IReference | OpenApi.IJsonSchema.IObject> =>
-  json_schema_plugin({
-    schema: emplace_object(props),
-    tags: props.object.tags,
-  });
-
-const emplace_object = (props: {
-  components: OpenApi.IComponents;
-  object: MetadataObject;
-}): OpenApi.IJsonSchema.IReference | OpenApi.IJsonSchema.IObject => {
-  if (props.object.type.isLiteral() === true)
-    return create_object_schema(props);
-
-  const key: string = props.object.type.name;
-  const $ref: string = `#/components/schemas/${key}`;
-  if (props.components.schemas?.[key] !== undefined) return { $ref };
-
-  const lazy: OpenApi.IJsonSchema = {};
-  props.components.schemas ??= {};
-  props.components.schemas[key] = lazy;
-  Object.assign(lazy, create_object_schema(props));
-  return { $ref };
-};
-
-/**
- * @internal
- */
-const create_object_schema = (props: {
-  components: OpenApi.IComponents;
-  object: MetadataObject;
-}): OpenApi.IJsonSchema.IObject => {
-  // ITERATE PROPERTIES
-  const properties: Record<string, any> = {};
-  const extraMeta: ISuperfluous = {
-    patternProperties: {},
-    additionalProperties: undefined,
-  };
-  const required: string[] = [];
-
-  for (const property of props.object.type.properties) {
-    if (
-      // FUNCTIONAL TYPE
-      property.value.functions.length &&
-      property.value.nullable === false &&
-      property.value.isRequired() === true &&
-      property.value.size() === 0
-    )
-      continue;
-    else if (property.jsDocTags.find((tag) => tag.name === "hidden")) continue; // THE HIDDEN TAG
-
-    const key: string | null = property.key.getSoleLiteral();
-    const schema: OpenApi.IJsonSchema | null = json_schema_station({
-      blockNever: true,
-      components: props.components,
-      attribute: {
-        deprecated:
-          property.jsDocTags.some((tag) => tag.name === "deprecated") ||
-          undefined,
-        title: json_schema_title(property),
-        description: json_schema_description(property),
-      },
-      metadata: property.value,
-    });
-
-    if (schema === null) continue;
-    if (key !== null) {
-      properties[key] = schema;
-      if (property.value.isRequired() === true) required.push(key);
-    } else {
-      const pattern: string = metadata_to_pattern({
-        top: true,
-        metadata: property.key,
-      });
-      if (pattern === PatternUtil.STRING)
-        extraMeta.additionalProperties = [property.value, schema];
-      else extraMeta.patternProperties[pattern] = [property.value, schema];
-    }
-  }
-
-  return {
-    type: "object",
-    properties,
-    required,
-    title: (() => {
-      const info: IJsDocTagInfo | undefined = props.object.type.jsDocTags.find(
-        (tag) => tag.name === "title",
-      );
-      return info?.text?.length ? CommentFactory.merge(info.text) : undefined;
-    })(),
-    description: json_schema_description(props.object.type),
-    additionalProperties: join({
-      components: props.components,
-      extra: extraMeta,
-    }),
-  };
-};
-
-/**
- * @internal
- */
-const join = (props: {
-  components: OpenApi.IComponents;
-  extra: ISuperfluous;
-}): OpenApi.IJsonSchema | undefined => {
-  // LIST UP METADATA
-  const elements: [Metadata, OpenApi.IJsonSchema][] = Object.values(
-    props.extra.patternProperties || {},
-  );
-  if (props.extra.additionalProperties)
-    elements.push(props.extra.additionalProperties);
-
-  // SHORT RETURN
-  if (elements.length === 0) return undefined;
-  else if (elements.length === 1) return elements[0]![1]!;
-
-  // MERGE METADATA AND GENERATE VULNERABLE SCHEMA
-  const metadata: Metadata = elements
-    .map((tuple) => tuple[0])
-    .reduce((x, y) => Metadata.merge(x, y));
-  return (
-    json_schema_station({
-      blockNever: true,
-      components: props.components,
-      attribute: {},
-      metadata,
-    }) ?? undefined
-  );
-};
-
-/**
- * @internal
- */
-interface ISuperfluous {
-  additionalProperties?: undefined | [Metadata, OpenApi.IJsonSchema];
-  patternProperties: Record<string, [Metadata, OpenApi.IJsonSchema]>;
-}
+import { OpenApi } from "@samchon/openapi";
+
+import { CommentFactory } from "../../factories/CommentFactory";
+
+import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataObject } from "../../schemas/metadata/MetadataObject";
+
+import { PatternUtil } from "../../utils/PatternUtil";
+
+import { json_schema_description } from "./json_schema_description";
+import { json_schema_plugin } from "./json_schema_plugin";
+import { json_schema_station } from "./json_schema_station";
+import { json_schema_title } from "./json_schema_title";
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+/** @internal */
+export const json_schema_object = (props: {
+  components: OpenApi.IComponents;
+  object: MetadataObject;
+}): Array<OpenApi.IJsonSchema.IReference | OpenApi.IJsonSchema.IObject> =>
+  json_schema_plugin({
+    schema: emplace_object(props),
+    tags: props.object.tags,
+  });
+
+const emplace_object = (props: {
+  components: OpenApi.IComponents;
+  object: MetadataObject;
+}): OpenApi.IJsonSchema.IReference | OpenApi.IJsonSchema.IObject => {
+  if (props.object.type.isLiteral() === true)
+    return create_object_schema(props);
+
+  const key: string = props.object.type.name;
+  const $ref: string = `#/components/schemas/${key}`;
+  if (props.components.schemas?.[key] !== undefined) return { $ref };
+
+  const lazy: OpenApi.IJsonSchema = {};
+  props.components.schemas ??= {};
+  props.components.schemas[key] = lazy;
+  Object.assign(lazy, create_object_schema(props));
+  return { $ref };
+};
+
+/** @internal */
+const create_object_schema = (props: {
+  components: OpenApi.IComponents;
+  object: MetadataObject;
+}): OpenApi.IJsonSchema.IObject => {
+  // ITERATE PROPERTIES
+  const properties: Record<string, any> = {};
+  const extraMeta: ISuperfluous = {
+    patternProperties: {},
+    additionalProperties: undefined,
+  };
+  const required: string[] = [];
+
+  for (const property of props.object.type.properties) {
+    if (
+      // FUNCTIONAL TYPE
+      property.value.functions.length &&
+      property.value.nullable === false &&
+      property.value.isRequired() === true &&
+      property.value.size() === 0
+    )
+      continue;
+    else if (property.jsDocTags.find((tag) => tag.name === "hidden")) continue; // THE HIDDEN TAG
+
+    const key: string | null = property.key.getSoleLiteral();
+    const schema: OpenApi.IJsonSchema | null = json_schema_station({
+      blockNever: true,
+      components: props.components,
+      attribute: {
+        deprecated:
+          property.jsDocTags.some((tag) => tag.name === "deprecated") ||
+          undefined,
+        title: json_schema_title(property),
+        description: json_schema_description(property),
+      },
+      metadata: property.value,
+    });
+
+    if (schema === null) continue;
+    if (key !== null) {
+      properties[key] = schema;
+      if (property.value.isRequired() === true) required.push(key);
+    } else {
+      const pattern: string = metadata_to_pattern({
+        top: true,
+        metadata: property.key,
+      });
+      if (pattern === PatternUtil.STRING)
+        extraMeta.additionalProperties = [property.value, schema];
+      else extraMeta.patternProperties[pattern] = [property.value, schema];
+    }
+  }
+
+  return {
+    type: "object",
+    properties,
+    required,
+    title: (() => {
+      const info: IJsDocTagInfo | undefined = props.object.type.jsDocTags.find(
+        (tag) => tag.name === "title",
+      );
+      return info?.text?.length ? CommentFactory.merge(info.text) : undefined;
+    })(),
+    description: json_schema_description(props.object.type),
+    additionalProperties: join({
+      components: props.components,
+      extra: extraMeta,
+    }),
+  };
+};
+
+/** @internal */
+const join = (props: {
+  components: OpenApi.IComponents;
+  extra: ISuperfluous;
+}): OpenApi.IJsonSchema | undefined => {
+  // LIST UP METADATA
+  const elements: [Metadata, OpenApi.IJsonSchema][] = Object.values(
+    props.extra.patternProperties || {},
+  );
+  if (props.extra.additionalProperties)
+    elements.push(props.extra.additionalProperties);
+
+  // SHORT RETURN
+  if (elements.length === 0) return undefined;
+  else if (elements.length === 1) return elements[0]![1]!;
+
+  // MERGE METADATA AND GENERATE VULNERABLE SCHEMA
+  const metadata: Metadata = elements
+    .map((tuple) => tuple[0])
+    .reduce((x, y) => Metadata.merge(x, y));
+  return (
+    json_schema_station({
+      blockNever: true,
+      components: props.components,
+      attribute: {},
+      metadata,
+    }) ?? undefined
+  );
+};
+
+/** @internal */
+interface ISuperfluous {
+  additionalProperties?: undefined | [Metadata, OpenApi.IJsonSchema];
+  patternProperties: Record<string, [Metadata, OpenApi.IJsonSchema]>;
+}

package/src/programmers/internal/json_schema_station.ts

@@ -1,4 +1,4 @@
-import { OpenApi } from "@samchon/openapi";
+import { IJsonSchemaAttribute, OpenApi } from "@samchon/openapi";
 
 import { Metadata } from "../../schemas/metadata/Metadata";
 import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
@@ -24,7 +24,7 @@ import { json_schema_tuple } from "./json_schema_tuple";
 export const json_schema_station = <BlockNever extends boolean>(props: {
   blockNever: BlockNever;
   components: OpenApi.IComponents;
-  attribute: OpenApi.IJsonSchema.__IAttribute;
+  attribute: IJsonSchemaAttribute;
   metadata: Metadata;
 }): BlockNever extends true
   ? OpenApi.IJsonSchema | null

package/src/programmers/internal/metadata_to_pattern.ts

@@ -1,42 +1,40 @@
-import { Metadata } from "../../schemas/metadata/Metadata";
-
-import { PatternUtil } from "../../utils/PatternUtil";
-
-import { template_to_pattern } from "./template_to_pattern";
-
-/**
- * @internal
- */
-export const metadata_to_pattern = (props: {
-  top: boolean;
-  metadata: Metadata;
-}): string => {
-  if (props.metadata.atomics.find((a) => a.type === "string") !== undefined)
-    return "(.*)";
-
-  const values: string[] = props.metadata.constants
-    .map((c) => {
-      if (c.type !== "string") return c.values.map((v) => v.toString());
-      return (c.values.map((v) => v.value) as string[]).map((str) =>
-        PatternUtil.escape(str),
-      );
-    })
-    .flat();
-  for (const a of props.metadata.atomics)
-    if (a.type === "number" || a.type === "bigint")
-      values.push(PatternUtil.NUMBER);
-    else if (a.type === "boolean") values.push(PatternUtil.BOOLEAN);
-  for (const { row } of props.metadata.templates)
-    values.push(
-      "(" +
-        template_to_pattern({
-          top: false,
-          template: row,
-        }) +
-        ")",
-    );
-
-  const pattern: string =
-    values.length === 1 ? values[0]! : "(" + values.join("|") + ")";
-  return props.top ? PatternUtil.fix(pattern) : pattern;
-};
+import { Metadata } from "../../schemas/metadata/Metadata";
+
+import { PatternUtil } from "../../utils/PatternUtil";
+
+import { template_to_pattern } from "./template_to_pattern";
+
+/** @internal */
+export const metadata_to_pattern = (props: {
+  top: boolean;
+  metadata: Metadata;
+}): string => {
+  if (props.metadata.atomics.find((a) => a.type === "string") !== undefined)
+    return "(.*)";
+
+  const values: string[] = props.metadata.constants
+    .map((c) => {
+      if (c.type !== "string") return c.values.map((v) => v.toString());
+      return (c.values.map((v) => v.value) as string[]).map((str) =>
+        PatternUtil.escape(str),
+      );
+    })
+    .flat();
+  for (const a of props.metadata.atomics)
+    if (a.type === "number" || a.type === "bigint")
+      values.push(PatternUtil.NUMBER);
+    else if (a.type === "boolean") values.push(PatternUtil.BOOLEAN);
+  for (const { row } of props.metadata.templates)
+    values.push(
+      "(" +
+        template_to_pattern({
+          top: false,
+          template: row,
+        }) +
+        ")",
+    );
+
+  const pattern: string =
+    values.length === 1 ? values[0]! : "(" + values.join("|") + ")";
+  return props.top ? PatternUtil.fix(pattern) : pattern;
+};

package/src/programmers/internal/postfix_of_tuple.ts

@@ -1,5 +1,3 @@
-/**
- * @internal
- */
-export const postfix_of_tuple = (str: string): string =>
-  str.endsWith('"') ? str.slice(0, -1) : `${str} + "`;
+/** @internal */
+export const postfix_of_tuple = (str: string): string =>
+  str.endsWith('"') ? str.slice(0, -1) : `${str} + "`;

package/src/programmers/internal/prune_object_properties.ts

@@ -1,71 +1,69 @@
-import ts from "typescript";
-
-import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
-
-import { metadata_to_pattern } from "./metadata_to_pattern";
-
-/**
- * @internal
- */
-export const prune_object_properties = (object: MetadataObjectType) => {
-  const input: ts.Expression = ts.factory.createIdentifier("input");
-  const key: ts.Expression = ts.factory.createIdentifier("key");
-
-  const condition: ts.Expression[] = object.properties.map((prop) => {
-    const name: string | null = prop.key.getSoleLiteral();
-    if (name !== null)
-      return ts.factory.createStrictEquality(
-        ts.factory.createStringLiteral(name),
-        ts.factory.createIdentifier("key"),
-      );
-    return ts.factory.createCallExpression(
-      ts.factory.createIdentifier(
-        `RegExp(/${metadata_to_pattern({
-          top: true,
-          metadata: prop.key,
-        })}/).test`,
-      ),
-      undefined,
-      [key],
-    );
-  });
-
-  const statements: ts.Statement[] = [];
-  if (condition.length)
-    statements.push(
-      ts.factory.createIfStatement(
-        condition.reduce((a, b) => ts.factory.createLogicalOr(a, b)),
-        ts.factory.createContinueStatement(),
-      ),
-    );
-  statements.push(
-    ts.factory.createExpressionStatement(
-      ts.factory.createDeleteExpression(
-        ts.factory.createElementAccessExpression(input, key),
-      ),
-    ),
-  );
-
-  return ts.factory.createForOfStatement(
-    undefined,
-    ts.factory.createVariableDeclarationList(
-      [
-        ts.factory.createVariableDeclaration(
-          ts.factory.createIdentifier("key"),
-          undefined,
-          undefined,
-          undefined,
-        ),
-      ],
-      ts.NodeFlags.Const,
-    ),
-    ts.factory.createCallExpression(
-      ts.factory.createIdentifier("Object.keys"),
-      undefined,
-      [input],
-    ),
-    statements.length === 1
-      ? statements[0]!
-      : ts.factory.createBlock(statements, true),
-  );
-};
+import ts from "typescript";
+
+import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
+
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+/** @internal */
+export const prune_object_properties = (object: MetadataObjectType) => {
+  const input: ts.Expression = ts.factory.createIdentifier("input");
+  const key: ts.Expression = ts.factory.createIdentifier("key");
+
+  const condition: ts.Expression[] = object.properties.map((prop) => {
+    const name: string | null = prop.key.getSoleLiteral();
+    if (name !== null)
+      return ts.factory.createStrictEquality(
+        ts.factory.createStringLiteral(name),
+        ts.factory.createIdentifier("key"),
+      );
+    return ts.factory.createCallExpression(
+      ts.factory.createIdentifier(
+        `RegExp(/${metadata_to_pattern({
+          top: true,
+          metadata: prop.key,
+        })}/).test`,
+      ),
+      undefined,
+      [key],
+    );
+  });
+
+  const statements: ts.Statement[] = [];
+  if (condition.length)
+    statements.push(
+      ts.factory.createIfStatement(
+        condition.reduce((a, b) => ts.factory.createLogicalOr(a, b)),
+        ts.factory.createContinueStatement(),
+      ),
+    );
+  statements.push(
+    ts.factory.createExpressionStatement(
+      ts.factory.createDeleteExpression(
+        ts.factory.createElementAccessExpression(input, key),
+      ),
+    ),
+  );
+
+  return ts.factory.createForOfStatement(
+    undefined,
+    ts.factory.createVariableDeclarationList(
+      [
+        ts.factory.createVariableDeclaration(
+          ts.factory.createIdentifier("key"),
+          undefined,
+          undefined,
+          undefined,
+        ),
+      ],
+      ts.NodeFlags.Const,
+    ),
+    ts.factory.createCallExpression(
+      ts.factory.createIdentifier("Object.keys"),
+      undefined,
+      [input],
+    ),
+    statements.length === 1
+      ? statements[0]!
+      : ts.factory.createBlock(statements, true),
+  );
+};