@nestia/sdk 14.0.1 → 14.0.3

package/src/utils/TtscExecutor.ts

@@ -2,13 +2,35 @@ import cp from "child_process";
 import fs from "fs";
 import path from "path";
 
+/**
+ * Runs the `ttsc` compiler of the project.
+ *
+ * @evidence contracts/common.md#principled-implementation The binary is found from the project's own `ttsc` package, with the SDK's dependency as a fallback, and is run with the current Node.
+ * @evidence contracts/common.md#clear-and-simple-design One function and a resolution cache.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The binary comes from the package manifest, not a fixed path.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidence contracts/portability.md#os-neutral-implementation The compiler runs as a child of the current Node executable (`process.execPath`) on the JavaScript entry that the package manifest's `bin` names, found through Node module resolution from the project directory, so no platform shim (`.cmd`, `.ps1` or shell script) and no `PATH` lookup is involved. Arguments are an array, never a command line, and the entry path is joined with `path.join` and checked with `existsSync`.
+ */
 export namespace TtscExecutor {
+  /**
+   * Compiles a project with `ttsc` and returns captured output, or null when
+   * the selected stdio does not pipe standard output.
+   *
+   * The cache directory of the environment is passed on, and a non-zero exit
+   * throws.
+   *
+   * @evidence contracts/common.md#principled-implementation The command is run with an argument array and the current Node executable, so no shell or platform shim is involved.
+   * @evidence contracts/common.md#clear-and-simple-design One function.
+   * @evidence contracts/common.md#prohibited-implementation-shortcuts The environment is extended, not replaced.
+   * @evidence contracts/common.md#meaningful-documentation The comment states the arguments and the failure.
+   * @evidence contracts/portability.md#os-neutral-implementation The working directory and the environment are explicit. Standard output is piped by default with a 64 MiB buffer; callers may select another stdio mode. A non-zero exit surfaces as Node's process error carrying `status` and available captured output.
+   */
   export const run = (props: {
     cwd: string;
     env?: NodeJS.ProcessEnv;
     project: string;
     stdio?: cp.StdioOptions;
-  }): Buffer => {
+  }): Buffer | null => {
     const args: string[] = [bin(props.cwd), "-p", props.project];
     if (process.env.TTSC_CACHE_DIR !== undefined)
       args.push("--cache-dir", process.env.TTSC_CACHE_DIR);

package/src/utils/VersioningStrategy.ts

@@ -1,12 +1,34 @@
-import { VERSION_NEUTRAL, VersionValue } from "@nestjs/common/interfaces";
+import {
+  VERSION_NEUTRAL,
+  VersionValue,
+} from "@nestjs/common/interfaces/index.js";
 
 import { INestiaProject } from "../structures/INestiaProject";
 
+/**
+ * Resolves the URI versions of a controller method as NestJS does.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace turns version metadata and the default version into path segments.
+ * @evidence contracts/common.md#clear-and-simple-design Two functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The precedence is NestJS's.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation VersioningStrategy maps Nest version metadata to URI segments, which are protocol spelling rather than native file paths.
+ */
 export namespace VersioningStrategy {
+  /**
+   * Casts version metadata to a list: absence stays absent and a single value
+   * is a one-element list.
+   *
+   * @evidence contracts/common.md#principled-implementation A single version becomes a list while absence stays distinct from an explicit empty list, which registers no paths rather than inheriting other versions.
+   * @evidence contracts/common.md#clear-and-simple-design One conditional.
+   * @evidence contracts/common.md#prohibited-implementation-shortcuts It adds nothing.
+   * @evidence contracts/common.md#meaningful-documentation The comment states the cases.
+   * @evidenceExclude contracts/portability.md#os-neutral-implementation VersioningStrategy.cast maps Nest version metadata to URI segments, which are protocol spelling rather than native file paths.
+   */
   export const cast = (
     value: VersionValue | undefined,
-  ): Array<string | typeof VERSION_NEUTRAL> =>
-    value === undefined ? [] : Array.isArray(value) ? value : [value];
+  ): Array<string | typeof VERSION_NEUTRAL> | undefined =>
+    value === undefined ? undefined : Array.isArray(value) ? value : [value];
 
   /**
    * Version path segments of a route, resolved as NestJS resolves them: the
@@ -16,6 +38,12 @@ export namespace VersioningStrategy {
    * The controller's and the method's versions were joined, so a method
    * overriding its controller's version was also described at the controller's,
    * and a route with no version and no default got no path at all (#1735).
+   *
+   * @evidence contracts/common.md#principled-implementation The first present method, controller or default list wins, including an empty list that registers no paths. Duplicates are removed, neutral and absent versions have no segment, and with versioning off the only segment is empty.
+   * @evidence contracts/common.md#clear-and-simple-design One curried function.
+   * @evidence contracts/common.md#prohibited-implementation-shortcuts The precedence is NestJS's.
+   * @evidence contracts/common.md#meaningful-documentation The comment states the precedence.
+   * @evidenceExclude contracts/portability.md#os-neutral-implementation VersioningStrategy.merge maps Nest version metadata to URI segments, which are protocol spelling rather than native file paths.
    */
   export const merge =
     (project: Omit<INestiaProject, "config">) =>
@@ -25,19 +53,14 @@ export namespace VersioningStrategy {
     }): string[] => {
       const versioning = project.input.versioning;
       if (versioning === undefined) return [""];
-      const chosen: Array<string | typeof VERSION_NEUTRAL> = props.method
-        ?.length
-        ? props.method
-        : props.controller?.length
-          ? props.controller
-          : cast(versioning.defaultVersion);
+      const chosen: Array<string | typeof VERSION_NEUTRAL> | undefined =
+        props.method ?? props.controller ?? cast(versioning.defaultVersion);
+      if (chosen === undefined) return [""];
       const unique: Array<string | typeof VERSION_NEUTRAL> = [
         ...new Set(chosen),
       ];
-      return unique.length
-        ? unique.map((x) =>
-            typeof x === "symbol" ? "" : `${versioning.prefix}${x}`,
-          )
-        : [""];
+      return unique.map((x) =>
+        typeof x === "symbol" ? "" : `${versioning.prefix}${x}`,
+      );
     };
 }

package/src/validators/TextPlainValidator.ts

@@ -1,6 +1,25 @@
 import { MetadataSchema, sizeOf } from "../internal/legacy";
 
+/**
+ * Validates that a type can be a `text/plain` body or response.
+ *
+ * @evidence contracts/common.md#principled-implementation A plain text body is a string, so the type may hold only string forms.
+ * @evidence contracts/common.md#clear-and-simple-design One function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule follows the content type.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation TextPlainValidator checks the metadata union accepted for a text/plain payload; it owns no native filesystem or executable representation.
+ */
 export namespace TextPlainValidator {
+  /**
+   * Returns an error message unless every member of the metadata is a string, a
+   * string constant, a string template, or the native String.
+   *
+   * @evidence contracts/common.md#principled-implementation The number of string forms is counted and compared with the size of the metadata, so any other form makes the counts differ, and an empty type is also refused.
+   * @evidence contracts/common.md#clear-and-simple-design One function.
+   * @evidence contracts/common.md#prohibited-implementation-shortcuts The count is exact and no type is special-cased.
+   * @evidence contracts/common.md#meaningful-documentation The comment states the accepted forms.
+   * @evidenceExclude contracts/portability.md#os-neutral-implementation TextPlainValidator.validate checks the metadata union accepted for a text/plain payload; it owns no native filesystem or executable representation.
+   */
   export const validate = (props: { metadata: MetadataSchema }): string[] => {
     const expected: number =
       props.metadata.atomics.filter((a) => a.type === "string").length +

package/lib/generates/internal/SwaggerReadonlyArrayEmender.d.ts

@@ -1,9 +0,0 @@
-import { OpenApi } from "@typia/interface";
-import { MetadataSchema } from "../../internal/legacy";
-export declare namespace SwaggerReadonlyArrayEmender {
-    const emend: (props: {
-        components: OpenApi.IComponents;
-        schema: OpenApi.IJsonSchema | undefined;
-        metadata: MetadataSchema;
-    }) => void;
-}

package/lib/generates/internal/SwaggerReadonlyArrayEmender.js

@@ -1,178 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SwaggerReadonlyArrayEmender = void 0;
-var SwaggerReadonlyArrayEmender;
-(function (SwaggerReadonlyArrayEmender) {
-    SwaggerReadonlyArrayEmender.emend = (props) => {
-        const visited = {
-            aliases: new WeakSet(),
-            arrays: new WeakSet(),
-            objects: new WeakSet(),
-            schemas: new WeakSet(),
-            tuples: new WeakSet(),
-        };
-        visitMetadata({
-            components: props.components,
-            schema: props.schema,
-            metadata: props.metadata,
-            visited,
-        });
-    };
-})(SwaggerReadonlyArrayEmender || (exports.SwaggerReadonlyArrayEmender = SwaggerReadonlyArrayEmender = {}));
-const visitMetadata = (props) => {
-    if (props.schema !== undefined && isReadonlyArrayLike(props.metadata))
-        setReadonlyArray(props.schema);
-    if (props.visited.schemas.has(props.metadata))
-        return;
-    props.visited.schemas.add(props.metadata);
-    for (const array of props.metadata.arrays) {
-        const type = array.type;
-        if (type !== undefined)
-            visitArrayType({
-                components: props.components,
-                schema: arraySchema(props.schema),
-                type,
-                visited: props.visited,
-            });
-    }
-    for (const tuple of props.metadata.tuples) {
-        const type = tuple.type;
-        if (type !== undefined)
-            visitTupleType({
-                components: props.components,
-                schema: props.schema,
-                type,
-                visited: props.visited,
-            });
-    }
-    for (const alias of props.metadata.aliases) {
-        const type = alias.type;
-        if (type !== undefined)
-            visitAliasType({
-                components: props.components,
-                schema: componentSchema(props.components, type.name),
-                type,
-                visited: props.visited,
-            });
-    }
-    for (const object of props.metadata.objects) {
-        const type = object.type;
-        if (type !== undefined)
-            visitObjectType({
-                components: props.components,
-                type,
-                visited: props.visited,
-            });
-    }
-};
-const visitAliasType = (props) => {
-    if (props.visited.aliases.has(props.type))
-        return;
-    props.visited.aliases.add(props.type);
-    if (props.schema !== undefined && isReadonlyArrayLike(props.type.value))
-        setReadonlyArray(props.schema);
-    visitMetadata({
-        components: props.components,
-        schema: props.schema,
-        metadata: props.type.value,
-        visited: props.visited,
-    });
-};
-const visitArrayType = (props) => {
-    var _a;
-    if (props.visited.arrays.has(props.type))
-        return;
-    props.visited.arrays.add(props.type);
-    const component = componentSchema(props.components, props.type.name);
-    if (component !== undefined && isReadonlyArrayName(props.type.name))
-        setReadonlyArray(component);
-    visitMetadata({
-        components: props.components,
-        schema: arraySchema((_a = props.schema) !== null && _a !== void 0 ? _a : component),
-        metadata: props.type.value,
-        visited: props.visited,
-    });
-};
-const visitTupleType = (props) => {
-    var _a;
-    if (props.visited.tuples.has(props.type))
-        return;
-    props.visited.tuples.add(props.type);
-    const component = componentSchema(props.components, props.type.name);
-    if (component !== undefined && isReadonlyArrayName(props.type.name))
-        setReadonlyArray(component);
-    const schema = objectSchema((_a = props.schema) !== null && _a !== void 0 ? _a : component);
-    props.type.elements.forEach((metadata, index) => visitMetadata({
-        components: props.components,
-        schema: Array.isArray(schema === null || schema === void 0 ? void 0 : schema.prefixItems)
-            ? schema.prefixItems[index]
-            : undefined,
-        metadata,
-        visited: props.visited,
-    }));
-};
-const visitObjectType = (props) => {
-    if (props.visited.objects.has(props.type))
-        return;
-    props.visited.objects.add(props.type);
-    const schema = objectSchema(componentSchema(props.components, props.type.name));
-    const properties = schema === null || schema === void 0 ? void 0 : schema.properties;
-    for (const property of props.type.properties) {
-        const key = propertyKey(property.key);
-        const child = key === undefined ? undefined : properties === null || properties === void 0 ? void 0 : properties[key];
-        visitMetadata({
-            components: props.components,
-            schema: child,
-            metadata: property.value,
-            visited: props.visited,
-        });
-    }
-};
-const isReadonlyArrayLike = (metadata, visited = new WeakSet()) => {
-    if (visited.has(metadata))
-        return false;
-    visited.add(metadata);
-    const name = metadata.name;
-    return ((typeof name === "string" && isReadonlyArrayName(name)) ||
-        metadata.arrays.some((array) => isReadonlyArrayName(array.name)) ||
-        metadata.tuples.some((tuple) => isReadonlyArrayName(tuple.name)) ||
-        metadata.aliases.some((alias) => {
-            const type = alias.type;
-            return type !== undefined && isReadonlyArrayLike(type.value, visited);
-        }));
-};
-const isReadonlyArrayName = (name) => {
-    const compact = name.replace(/\s+/g, "");
-    // Metadata identity names pass through the generator's name replacer, which
-    // strips TypeScript punctuation for schema-key safety — depending on the
-    // compiler shim, `ReadonlyArray<string>` arrives here as "ReadonlyArray",
-    // "ReadonlyArray<string>", or the stripped "ReadonlyArraystring", and
-    // `readonly string[]` as "readonly string[]" or "readonlystring". Match on
-    // the prefixes that survive every form; this predicate only ever sees names
-    // of array/tuple metadata entries, whose spelling the generator controls
-    // ("readonly" is case-sensitive, so PascalCase user types cannot collide).
-    return compact.startsWith("ReadonlyArray") || compact.startsWith("readonly");
-};
-const componentSchema = (components, name) => { var _a; return ((_a = components.schemas) !== null && _a !== void 0 ? _a : {})[name]; };
-const arraySchema = (schema) => {
-    const obj = objectSchema(schema);
-    return obj === null || obj === void 0 ? void 0 : obj.items;
-};
-const objectSchema = (schema) => typeof schema === "object" && schema !== null
-    ? schema
-    : undefined;
-const propertyKey = (metadata) => {
-    var _a, _b;
-    const value = (_b = (_a = metadata.constants[0]) === null || _a === void 0 ? void 0 : _a.values[0]) === null || _b === void 0 ? void 0 : _b.value;
-    return typeof value === "string"
-        ? value
-        : typeof value === "number"
-            ? String(value)
-            : undefined;
-};
-const setReadonlyArray = (schema) => {
-    const obj = objectSchema(schema);
-    if (obj !== undefined)
-        obj["x-readonly-array"] = true;
-};
-//# sourceMappingURL=SwaggerReadonlyArrayEmender.js.map

package/lib/generates/internal/SwaggerReadonlyArrayEmender.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SwaggerReadonlyArrayEmender.js","sourceRoot":"","sources":["../../../src/generates/internal/SwaggerReadonlyArrayEmender.ts"],"names":[],"mappings":"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"}

package/src/generates/internal/SwaggerReadonlyArrayEmender.ts

@@ -1,264 +0,0 @@
-import { OpenApi } from "@typia/interface";
-
-import {
-  MetadataAliasType,
-  MetadataArrayType,
-  MetadataObjectType,
-  MetadataSchema,
-  MetadataTupleType,
-} from "../../internal/legacy";
-
-type JsonSchemaObject = OpenApi.IJsonSchema & Record<string, any>;
-
-export namespace SwaggerReadonlyArrayEmender {
-  export const emend = (props: {
-    components: OpenApi.IComponents;
-    schema: OpenApi.IJsonSchema | undefined;
-    metadata: MetadataSchema;
-  }): void => {
-    const visited: IVisited = {
-      aliases: new WeakSet(),
-      arrays: new WeakSet(),
-      objects: new WeakSet(),
-      schemas: new WeakSet(),
-      tuples: new WeakSet(),
-    };
-    visitMetadata({
-      components: props.components,
-      schema: props.schema,
-      metadata: props.metadata,
-      visited,
-    });
-  };
-}
-
-interface IVisited {
-  aliases: WeakSet<MetadataAliasType>;
-  arrays: WeakSet<MetadataArrayType>;
-  objects: WeakSet<MetadataObjectType>;
-  schemas: WeakSet<MetadataSchema>;
-  tuples: WeakSet<MetadataTupleType>;
-}
-
-const visitMetadata = (props: {
-  components: OpenApi.IComponents;
-  schema: OpenApi.IJsonSchema | undefined;
-  metadata: MetadataSchema;
-  visited: IVisited;
-}): void => {
-  if (props.schema !== undefined && isReadonlyArrayLike(props.metadata))
-    setReadonlyArray(props.schema);
-
-  if (props.visited.schemas.has(props.metadata)) return;
-  props.visited.schemas.add(props.metadata);
-
-  for (const array of props.metadata.arrays) {
-    const type: MetadataArrayType | undefined = array.type as
-      | MetadataArrayType
-      | undefined;
-    if (type !== undefined)
-      visitArrayType({
-        components: props.components,
-        schema: arraySchema(props.schema),
-        type,
-        visited: props.visited,
-      });
-  }
-  for (const tuple of props.metadata.tuples) {
-    const type: MetadataTupleType | undefined = tuple.type as
-      | MetadataTupleType
-      | undefined;
-    if (type !== undefined)
-      visitTupleType({
-        components: props.components,
-        schema: props.schema,
-        type,
-        visited: props.visited,
-      });
-  }
-  for (const alias of props.metadata.aliases) {
-    const type: MetadataAliasType | undefined = alias.type as
-      | MetadataAliasType
-      | undefined;
-    if (type !== undefined)
-      visitAliasType({
-        components: props.components,
-        schema: componentSchema(props.components, type.name),
-        type,
-        visited: props.visited,
-      });
-  }
-  for (const object of props.metadata.objects) {
-    const type: MetadataObjectType | undefined = object.type as
-      | MetadataObjectType
-      | undefined;
-    if (type !== undefined)
-      visitObjectType({
-        components: props.components,
-        type,
-        visited: props.visited,
-      });
-  }
-};
-
-const visitAliasType = (props: {
-  components: OpenApi.IComponents;
-  schema: OpenApi.IJsonSchema | undefined;
-  type: MetadataAliasType;
-  visited: IVisited;
-}): void => {
-  if (props.visited.aliases.has(props.type)) return;
-  props.visited.aliases.add(props.type);
-  if (props.schema !== undefined && isReadonlyArrayLike(props.type.value))
-    setReadonlyArray(props.schema);
-  visitMetadata({
-    components: props.components,
-    schema: props.schema,
-    metadata: props.type.value,
-    visited: props.visited,
-  });
-};
-
-const visitArrayType = (props: {
-  components: OpenApi.IComponents;
-  schema: OpenApi.IJsonSchema | undefined;
-  type: MetadataArrayType;
-  visited: IVisited;
-}): void => {
-  if (props.visited.arrays.has(props.type)) return;
-  props.visited.arrays.add(props.type);
-  const component: OpenApi.IJsonSchema | undefined = componentSchema(
-    props.components,
-    props.type.name,
-  );
-  if (component !== undefined && isReadonlyArrayName(props.type.name))
-    setReadonlyArray(component);
-  visitMetadata({
-    components: props.components,
-    schema: arraySchema(props.schema ?? component),
-    metadata: props.type.value,
-    visited: props.visited,
-  });
-};
-
-const visitTupleType = (props: {
-  components: OpenApi.IComponents;
-  schema: OpenApi.IJsonSchema | undefined;
-  type: MetadataTupleType;
-  visited: IVisited;
-}): void => {
-  if (props.visited.tuples.has(props.type)) return;
-  props.visited.tuples.add(props.type);
-  const component: OpenApi.IJsonSchema | undefined = componentSchema(
-    props.components,
-    props.type.name,
-  );
-  if (component !== undefined && isReadonlyArrayName(props.type.name))
-    setReadonlyArray(component);
-  const schema: JsonSchemaObject | undefined = objectSchema(
-    props.schema ?? component,
-  );
-  props.type.elements.forEach((metadata, index) =>
-    visitMetadata({
-      components: props.components,
-      schema: Array.isArray(schema?.prefixItems)
-        ? schema.prefixItems[index]
-        : undefined,
-      metadata,
-      visited: props.visited,
-    }),
-  );
-};
-
-const visitObjectType = (props: {
-  components: OpenApi.IComponents;
-  type: MetadataObjectType;
-  visited: IVisited;
-}): void => {
-  if (props.visited.objects.has(props.type)) return;
-  props.visited.objects.add(props.type);
-
-  const schema: JsonSchemaObject | undefined = objectSchema(
-    componentSchema(props.components, props.type.name),
-  );
-  const properties: Record<string, OpenApi.IJsonSchema> | undefined =
-    schema?.properties as Record<string, OpenApi.IJsonSchema> | undefined;
-  for (const property of props.type.properties) {
-    const key: string | undefined = propertyKey(property.key);
-    const child: OpenApi.IJsonSchema | undefined =
-      key === undefined ? undefined : properties?.[key];
-    visitMetadata({
-      components: props.components,
-      schema: child,
-      metadata: property.value,
-      visited: props.visited,
-    });
-  }
-};
-
-const isReadonlyArrayLike = (
-  metadata: MetadataSchema,
-  visited: WeakSet<MetadataSchema> = new WeakSet(),
-): boolean => {
-  if (visited.has(metadata)) return false;
-  visited.add(metadata);
-  const name: unknown = (metadata as { name?: unknown }).name;
-  return (
-    (typeof name === "string" && isReadonlyArrayName(name)) ||
-    metadata.arrays.some((array) => isReadonlyArrayName(array.name)) ||
-    metadata.tuples.some((tuple) => isReadonlyArrayName(tuple.name)) ||
-    metadata.aliases.some((alias) => {
-      const type: MetadataAliasType | undefined = alias.type as
-        | MetadataAliasType
-        | undefined;
-      return type !== undefined && isReadonlyArrayLike(type.value, visited);
-    })
-  );
-};
-
-const isReadonlyArrayName = (name: string): boolean => {
-  const compact: string = name.replace(/\s+/g, "");
-  // Metadata identity names pass through the generator's name replacer, which
-  // strips TypeScript punctuation for schema-key safety — depending on the
-  // compiler shim, `ReadonlyArray<string>` arrives here as "ReadonlyArray",
-  // "ReadonlyArray<string>", or the stripped "ReadonlyArraystring", and
-  // `readonly string[]` as "readonly string[]" or "readonlystring". Match on
-  // the prefixes that survive every form; this predicate only ever sees names
-  // of array/tuple metadata entries, whose spelling the generator controls
-  // ("readonly" is case-sensitive, so PascalCase user types cannot collide).
-  return compact.startsWith("ReadonlyArray") || compact.startsWith("readonly");
-};
-
-const componentSchema = (
-  components: OpenApi.IComponents,
-  name: string,
-): OpenApi.IJsonSchema | undefined =>
-  (components.schemas ?? {})[name] as OpenApi.IJsonSchema | undefined;
-
-const arraySchema = (
-  schema: OpenApi.IJsonSchema | undefined,
-): OpenApi.IJsonSchema | undefined => {
-  const obj: JsonSchemaObject | undefined = objectSchema(schema);
-  return obj?.items as OpenApi.IJsonSchema | undefined;
-};
-
-const objectSchema = (
-  schema: OpenApi.IJsonSchema | undefined,
-): JsonSchemaObject | undefined =>
-  typeof schema === "object" && schema !== null
-    ? (schema as JsonSchemaObject)
-    : undefined;
-
-const propertyKey = (metadata: MetadataSchema): string | undefined => {
-  const value: unknown = metadata.constants[0]?.values[0]?.value;
-  return typeof value === "string"
-    ? value
-    : typeof value === "number"
-      ? String(value)
-      : undefined;
-};
-
-const setReadonlyArray = (schema: OpenApi.IJsonSchema): void => {
-  const obj: JsonSchemaObject | undefined = objectSchema(schema);
-  if (obj !== undefined) obj["x-readonly-array"] = true;
-};