@dxtmisha/wiki 0.25.1 → 0.39.2

package/src/media/functional/scripts/classes/convectorColor/convectorColor.vi.mdx

@@ -0,0 +1,58 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Functions/convectorColor - Chuyển đổi màu sắc'/>
+
+# Hàm convectorColor
+
+Hàm `convectorColor` là một phần của hệ thống convector để xử lý các token thuộc tính. Vai trò chính của nó là trích xuất siêu dữ liệu màu sắc cụ thể từ các phần mở rộng 'studio.tokens' và áp dụng chúng vào đối tượng thuộc tính. Hiện tại, hàm chuyên về xử lý các sửa đổi độ mờ (alpha).
+
+## Các tính năng chính
+
+- **Tích hợp Studio Tokens** — hoạt động với các phần mở rộng `$extensions['studio.tokens']`.
+- **Sửa đổi độ mờ** — trích xuất giá trị `alpha` từ các tham số sửa đổi và lưu trữ nó trong khóa hệ thống `cssColorOpacity`.
+- **Tự động hóa** — được gọi trong quá trình chuẩn hóa thuộc tính khi phát hiện siêu dữ liệu tương ứng.
+
+## Tham số
+
+Hàm chấp nhận một đối số duy nhất:
+
+- `item: PropertyItemInput` — đối tượng dữ liệu đầu vào của thuộc tính, đối tượng này sẽ được thay đổi (mute) trong quá trình thực thi.
+
+## Ví dụ (Examples)
+
+### Xử lý sửa đổi độ mờ
+
+Nếu một token chứa thông tin sửa đổi màu sắc, `convectorColor` sẽ trích xuất thông tin đó:
+
+```typescript
+import { convectorColor, PropertyKey } from '@dxtmisha/scripts'
+
+const item = {
+  value: '#ff0000',
+  $extensions: {
+    'studio.tokens': {
+      modify: {
+        type: 'alpha',
+        value: '0.5'
+      }
+    }
+  }
+};
+
+convectorColor(item);
+
+console.log(item[PropertyKey.cssColorOpacity]); // '0.5'
+```
+
+## Các thao tác (Operations)
+
+### Cơ chế xử lý
+
+Quá trình xử lý dữ liệu trong `convectorColor` bao gồm các bước sau:
+1. **Tìm kiếm phần mở rộng**: Hàm tìm kiếm đường dẫn `$extensions['studio.tokens'].modify`.
+2. **Xác định kiểu**: Nếu kiểu sửa đổi được thiết lập là `alpha`, hàm sẽ bắt đầu xử lý.
+3. **Lưu trữ dữ liệu**: Giá trị độ mờ (`value`) được ghi vào thuộc tính của đối tượng `item` bằng khóa `_o` (được lưu trong `PropertyKey.cssColorOpacity`). Nếu không có giá trị nào được chỉ định, giá trị mặc định là `'1'`.
+
+## Phạm vi ứng dụng
+
+Hàm này được dùng trong các lớp xử lý thuộc tính (ví dụ: `PropertiesStandard`) để làm phong phú dữ liệu token với thông tin về độ mờ được lấy từ các công cụ thiết kế.

package/src/media/functional/scripts/composables/useAi/useAi.en.mdx

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Composables/useAi - AI Instance Procurement'/>
+
+# `useAi`
+
+Composable to obtain an AI instance based on the current configuration.
+
+**Returns:**
+`AiAbstract | undefined` — An instance of an AI class (e.g., `AiGoogle` or `AiGoogleCli`) based on the configured AI type, or `undefined` if the type is not recognized or not configured.
+
+## How it works
+
+The composable reads the AI type from `PropertiesConfig.getAiType()` and returns a new instance of the corresponding class:
+- `'gemini'` returns a new `AiGoogle` instance.
+- `'gemini-cli'` returns a new `AiGoogleCli` instance.
+- Other types return `undefined`.
+
+## Example
+
+```typescript
+import { useAi } from '@dxtmisha/scripts'
+
+const ai = useAi()
+
+if (ai) {
+  // Use the AI instance
+  const response = await ai.generate('Hello, AI!')
+  console.log(response)
+}
+```

package/src/media/functional/scripts/composables/useAi/useAi.ru.mdx

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Composables/useAi - Получение экземпляра AI'/>
+
+# `useAi`
+
+Композабл для получения экземпляра AI на основе текущей конфигурации.
+
+**Возвращает:**
+`AiAbstract | undefined` — экземпляр класса AI (например, `AiGoogle` или `AiGoogleCli`) в зависимости от настроенного типа AI, или `undefined`, если тип не распознан или не настроен.
+
+## Как это работает
+
+Композабл считывает тип AI из `PropertiesConfig.getAiType()` и возвращает новый экземпляр соответствующего класса:
+- `'gemini'` возвращает новый экземпляр `AiGoogle`.
+- `'gemini-cli'` возвращает новый экземпляр `AiGoogleCli`.
+- Другие типы возвращают `undefined`.
+
+## Пример
+
+```typescript
+import { useAi } from '@dxtmisha/scripts'
+
+const ai = useAi()
+
+if (ai) {
+  // Использование экземпляра AI
+  const response = await ai.generate('Привет, AI!')
+  console.log(response)
+}
+```

package/src/media/functional/scripts/composables/useAi/useAi.vi.mdx

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Composables/useAi - Lấy instance AI'/>
+
+# `useAi`
+
+Composable để lấy một instance AI dựa trên cấu hình hiện tại.
+
+**Trả về:**
+`AiAbstract | undefined` — Một instance của lớp AI (ví dụ: `AiGoogle` hoặc `AiGoogleCli`) dựa trên loại AI được định cấu hình, hoặc `undefined` nếu loại đó không được nhận dạng hoặc không được định cấu hình.
+
+## Cơ chế hoạt động
+
+Composable đọc loại AI từ `PropertiesConfig.getAiType()` và trả về một instance mới của lớp tương ứng:
+- `'gemini'` trả về một instance `AiGoogle` mới.
+- `'gemini-cli'` trả về một instance `AiGoogleCli` mới.
+- Các loại khác trả về `undefined`.
+
+## Ví dụ
+
+```typescript
+import { useAi } from '@dxtmisha/scripts'
+
+const ai = useAi()
+
+if (ai) {
+  // Sử dụng instance AI
+  const response = await ai.generate('Xin chào, AI!')
+  console.log(response)
+}
+```

package/src/media/functional/scripts/functions/getComponentPaths/getComponentPaths.en.mdx

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Functions/getComponentPaths - Get component paths'/>
+
+# `getComponentPaths`
+
+The function returns the paths to the component by combining the base component directory with the specified path.
+
+**Parameters:**
+- `path: string` — component path.
+
+**Returns:**
+`string[]` — an array of paths.
+
+## How it works
+
+The function is used to generate a full path to a component based on the global project configuration. It uses the `UI_DIRS_COMPONENTS` constant which defines the base directory for all components.
+
+## Example
+
+```typescript
+import { getComponentPaths } from '@dxtmisha/scripts'
+
+getComponentPaths('button') // ['src', 'components', 'button']
+```

package/src/media/functional/scripts/functions/getComponentPaths/getComponentPaths.ru.mdx

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Functions/getComponentPaths - Получение путей компонентов'/>
+
+# `getComponentPaths`
+
+Функция возвращает пути к компоненту, объединяя базовую директорию компонентов с указанным путем.
+
+**Параметры:**
+- `path: string` — путь к компоненту.
+
+**Возвращает:**
+`string[]` — массив путей.
+
+## Как это работает
+
+Функция используется для формирования полного пути к компоненту на основе глобальной конфигурации проекта. Она использует константу `UI_DIRS_COMPONENTS`, которая определяет базовую директорию для всех компонентов.
+
+## Пример
+
+```typescript
+import { getComponentPaths } from '@dxtmisha/scripts'
+
+getComponentPaths('button') // ['src', 'components', 'button']
+```

package/src/media/functional/scripts/functions/getComponentPaths/getComponentPaths.vi.mdx

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Functions/getComponentPaths - Lấy đường dẫn thành phần'/>
+
+# `getComponentPaths`
+
+Hàm trả về các đường dẫn đến thành phần bằng cách kết hợp thư mục thành phần cơ sở với đường dẫn được chỉ định.
+
+**Tham số:**
+- `path: string` — đường dẫn thành phần.
+
+**Trả về:**
+`string[]` — một mảng các đường dẫn.
+
+## Cơ chế hoạt động
+
+Hàm này được sử dụng để tạo đường dẫn đầy đủ đến một thành phần dựa trên cấu hình dự án toàn cục. Nó sử dụng hằng số `UI_DIRS_COMPONENTS` xác định thư mục gốc cho tất cả các thành phần.
+
+## Ví dụ
+
+```typescript
+import { getComponentPaths } from '@dxtmisha/scripts'
+
+getComponentPaths('button') // ['src', 'components', 'button']
+```

package/src/media/functional/scripts/functions/getConfigAi/getConfigAi.en.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Functions/getConfigAi - Get AI configuration'/>
+
+# `getConfigAi`
+
+The function returns the AI configuration, including the API key and model.
+
+**Returns:**
+`[string, string]` — a tuple with the API key and the model name.
+
+## How it works
+
+The function retrieves the configuration values from the `PropertiesConfig` class, which manages project-level settings.
+
+## Example
+
+```typescript
+import { getConfigAi } from '@dxtmisha/scripts'
+
+const [apiKey, model] = getConfigAi()
+console.log(`API Key: ${apiKey}, Model: ${model}`)
+```

package/src/media/functional/scripts/functions/getConfigAi/getConfigAi.ru.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Functions/getConfigAi - Получение конфигурации ИИ'/>
+
+# `getConfigAi`
+
+Функция возвращает конфигурацию ИИ, включая API ключ и модель.
+
+**Возвращает:**
+`[string, string]` — кортеж с API ключом и названием модели.
+
+## Как это работает
+
+Функция извлекает значения конфигурации из класса `PropertiesConfig`, который управляет настройками уровня проекта.
+
+## Пример
+
+```typescript
+import { getConfigAi } from '@dxtmisha/scripts'
+
+const [apiKey, model] = getConfigAi()
+console.log(`API Key: ${apiKey}, Model: ${model}`)
+```

package/src/media/functional/scripts/functions/getConfigAi/getConfigAi.vi.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Functions/getConfigAi - Lấy cấu hình AI'/>
+
+# `getConfigAi`
+
+Hàm trả về cấu hình AI, bao gồm khóa API và mô hình.
+
+**Trả về:**
+`[string, string]` — một bộ gồm khóa API và tên mô hình.
+
+## Cơ chế hoạt động
+
+Hàm truy xuất các giá trị cấu hình từ lớp `PropertiesConfig`, lớp này quản lý các cài đặt cấp dự án.
+
+## Ví dụ
+
+```typescript
+import { getConfigAi } from '@dxtmisha/scripts'
+
+const [apiKey, model] = getConfigAi()
+console.log(`API Key: ${apiKey}, Model: ${model}`)
+```

package/src/media/functional/scripts/functions/getConstructorProperties/getConstructorProperties.en.mdx

@@ -0,0 +1,26 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Functions/getConstructorProperties - Get constructor properties'/>
+
+# `getConstructorProperties`
+
+The function returns the properties of the specified constructors by reading their `properties.json` files.
+
+**Parameters:**
+- `names: string[]` — list of constructor names.
+
+**Returns:**
+`PropertyList` — an object where keys are constructor names and values are their properties.
+
+## How it works
+
+The function iterates through the provided names and constructs the path to the `properties.json` file for each constructor. It uses the `PropertiesFile.readFile` method to load the data.
+
+## Example
+
+```typescript
+import { getConstructorProperties } from '@dxtmisha/scripts'
+
+const properties = getConstructorProperties(['Button', 'Input'])
+// { Button: { ... }, Input: { ... } }
+```

package/src/media/functional/scripts/functions/getConstructorProperties/getConstructorProperties.ru.mdx

@@ -0,0 +1,26 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Functions/getConstructorProperties - Получение свойств конструкторов'/>
+
+# `getConstructorProperties`
+
+Функция возвращает свойства указанных конструкторов, считывая их файлы `properties.json`.
+
+**Параметры:**
+- `names: string[]` — список названий конструкторов.
+
+**Возвращает:**
+`PropertyList` — объект, где ключи — названия конструкторов, а значения — их свойства.
+
+## Как это работает
+
+Функция перебирает переданные имена и формирует путь к файлу `properties.json` для каждого конструктора. Для загрузки данных используется метод `PropertiesFile.readFile`.
+
+## Пример
+
+```typescript
+import { getConstructorProperties } from '@dxtmisha/scripts'
+
+const properties = getConstructorProperties(['Button', 'Input'])
+// { Button: { ... }, Input: { ... } }
+```

package/src/media/functional/scripts/functions/getConstructorProperties/getConstructorProperties.vi.mdx

@@ -0,0 +1,26 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Functions/getConstructorProperties - Lấy thuộc tính hàm dựng'/>
+
+# `getConstructorProperties`
+
+Hàm trả về các thuộc tính của các hàm dựng được chỉ định bằng cách đọc các tệp `properties.json` của chúng.
+
+**Tham số:**
+- `names: string[]` — danh sách tên các hàm dựng.
+
+**Trả về:**
+`PropertyList` — một đối tượng trong đó các khóa là tên hàm dựng và các giá trị là các thuộc tính của chúng.
+
+## Cơ chế hoạt động
+
+Hàm lặp qua các tên được cung cấp và xây dựng đường dẫn đến tệp `properties.json` cho mỗi hàm dựng. Nó sử dụng phương thức `PropertiesFile.readFile` để tải dữ liệu.
+
+## Ví dụ
+
+```typescript
+import { getConstructorProperties } from '@dxtmisha/scripts'
+
+const properties = getConstructorProperties(['Button', 'Input'])
+// { Button: { ... }, Input: { ... } }
+```

package/src/media/functional/scripts/functions/getDirname/getDirname.en.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Functions/getDirname - Get current directory name'/>
+
+# `getDirname`
+
+The function returns the name of the current directory, handling both CommonJS and ESM environments.
+
+**Returns:**
+`string` — the current directory name.
+
+## How it works
+
+The function checks if the environment has native `__dirname` support (using `hasNativeDirname`). If it does, it returns `__dirname`. Otherwise, it derives the directory name from `import.meta.url`.
+
+## Example
+
+```typescript
+import { getDirname } from '@dxtmisha/scripts'
+
+const dirname = getDirname()
+console.log(dirname)
+```

package/src/media/functional/scripts/functions/getDirname/getDirname.ru.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Functions/getDirname - Получение имени текущей директории'/>
+
+# `getDirname`
+
+Функция возвращает имя текущей директории, обрабатывая как среды CommonJS, так и ESM.
+
+**Возвращает:**
+`string` — имя текущей директории.
+
+## Как это работает
+
+Функция проверяет, имеет ли среда встроенную поддержку `__dirname` (используя `hasNativeDirname`). Если да, возвращается `__dirname`. В противном случае имя директории вычисляется на основе `import.meta.url`.
+
+## Пример
+
+```typescript
+import { getDirname } from '@dxtmisha/scripts'
+
+const dirname = getDirname()
+console.log(dirname)
+```

package/src/media/functional/scripts/functions/getDirname/getDirname.vi.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Functions/getDirname - Lấy tên thư mục hiện tại'/>
+
+# `getDirname`
+
+Hàm trả về tên của thư mục hiện tại, xử lý cả môi trường CommonJS và ESM.
+
+**Trả về:**
+`string` — tên thư mục hiện tại.
+
+## Cơ chế hoạt động
+
+Hàm kiểm tra xem môi trường có hỗ trợ `__dirname` gốc hay không (sử dụng `hasNativeDirname`). Nếu có, nó sẽ trả về `__dirname`. Nếu không, nó sẽ lấy tên thư mục từ `import.meta.url`.
+
+## Ví dụ
+
+```typescript
+import { getDirname } from '@dxtmisha/scripts'
+
+const dirname = getDirname()
+console.log(dirname)
+```

package/src/media/functional/scripts/functions/getNameDirByPaths/getNameDirByPaths.en.mdx

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Functions/getNameDirByPaths - Get last directory name'/>
+
+# `getNameDirByPaths`
+
+The function returns the name of the last directory from the given array of path segments.
+
+**Parameters:**
+- `paths: PropertiesFilePath` — an array of path segments.
+
+**Returns:**
+`string` — the name of the last directory.
+
+## How it works
+
+The function joins the provided path segments using `PropertiesFile.joinPath`, then splits them back into directory segments using `PropertiesFile.splitForDir` and returns the last element of the resulting array.
+
+## Example
+
+```typescript
+import { getNameDirByPaths } from '@dxtmisha/scripts'
+
+getNameDirByPaths(['src', 'components', 'button']) // 'button'
+```

package/src/media/functional/scripts/functions/getNameDirByPaths/getNameDirByPaths.ru.mdx

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Functions/getNameDirByPaths - Получение имени последней директории'/>
+
+# `getNameDirByPaths`
+
+Функция возвращает имя последней директории из переданного массива сегментов пути.
+
+**Параметры:**
+- `paths: PropertiesFilePath` — массив сегментов пути.
+
+**Возвращает:**
+`string` — имя последней директории.
+
+## Как это работает
+
+Функция объединяет переданные сегменты пути с помощью `PropertiesFile.joinPath`, затем снова разбивает их на сегменты директорий с помощью `PropertiesFile.splitForDir` и возвращает последний элемент результирующего массива.
+
+## Пример
+
+```typescript
+import { getNameDirByPaths } from '@dxtmisha/scripts'
+
+getNameDirByPaths(['src', 'components', 'button']) // 'button'
+```

package/src/media/functional/scripts/functions/getNameDirByPaths/getNameDirByPaths.vi.mdx

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Functions/getNameDirByPaths - Lấy tên thư mục cuối cùng'/>
+
+# `getNameDirByPaths`
+
+Hàm trả về tên của thư mục cuối cùng từ mảng các đoạn đường dẫn được cung cấp.
+
+**Tham số:**
+- `paths: PropertiesFilePath` — một mảng các đoạn đường dẫn.
+
+**Trả về:**
+`string` — tên của thư mục cuối cùng.
+
+## Cơ chế hoạt động
+
+Hàm kết hợp các đoạn đường dẫn được cung cấp bằng cách sử dụng `PropertiesFile.joinPath`, sau đó chia chúng lại thành các đoạn thư mục bằng cách sử dụng `PropertiesFile.splitForDir` và trả về phần tử cuối cùng của mảng kết quả.
+
+## Ví dụ
+
+```typescript
+import { getNameDirByPaths } from '@dxtmisha/scripts'
+
+getNameDirByPaths(['src', 'components', 'button']) // 'button'
+```

package/src/media/functional/scripts/functions/getPackageJson/getPackageJson.en.mdx

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Functions/getPackageJson - Get package.json content'/>
+
+# `getPackageJson`
+
+The function returns the content of the `package.json` file.
+
+**Returns:**
+`Record<string, any> | undefined` — the content of the `package.json` file or `undefined` if the file could not be read.
+
+## How it works
+
+The function uses the `PropertiesFile.readFile` method to load the content of the `package.json` file specified in the global configuration.
+
+## Example
+
+```typescript
+import { getPackageJson } from '@dxtmisha/scripts'
+
+const packageJson = getPackageJson()
+if (packageJson) {
+  console.log(`Package Name: ${packageJson.name}`)
+}
+```

package/src/media/functional/scripts/functions/getPackageJson/getPackageJson.ru.mdx

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Functions/getPackageJson - Получение содержимого package.json'/>
+
+# `getPackageJson`
+
+Функция возвращает содержимое файла `package.json`.
+
+**Возвращает:**
+`Record<string, any> | undefined` — содержимое файла `package.json` или `undefined`, если файл не удалось прочитать.
+
+## Как это работает
+
+Функция использует метод `PropertiesFile.readFile` для загрузки содержимого файла `package.json`, указанного в глобальной конфигурации.
+
+## Пример
+
+```typescript
+import { getPackageJson } from '@dxtmisha/scripts'
+
+const packageJson = getPackageJson()
+if (packageJson) {
+  console.log(`Package Name: ${packageJson.name}`)
+}
+```

package/src/media/functional/scripts/functions/getPackageJson/getPackageJson.vi.mdx

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Functions/getPackageJson - Lấy nội dung package.json'/>
+
+# `getPackageJson`
+
+Hàm trả về nội dung của tệp `package.json`.
+
+**Trả về:**
+`Record<string, any> | undefined` — nội dung của tệp `package.json` hoặc `undefined` nếu không thể đọc được tệp.
+
+## Cơ chế hoạt động
+
+Hàm sử dụng phương thức `PropertiesFile.readFile` để tải nội dung của tệp `package.json` được chỉ định trong cấu hình toàn cục.
+
+## Ví dụ
+
+```typescript
+import { getPackageJson } from '@dxtmisha/scripts'
+
+const packageJson = getPackageJson()
+if (packageJson) {
+  console.log(`Package Name: ${packageJson.name}`)
+}
+```

package/src/media/functional/scripts/functions/hasNativeDirname/hasNativeDirname.en.mdx

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Functions/hasNativeDirname - Check __dirname availability'/>
+
+# `hasNativeDirname`
+
+The function checks if the global `__dirname` variable is available in the current environment.
+
+**Returns:**
+`boolean` — `true` if `__dirname` is defined, `false` otherwise.
+
+## How it works
+
+The function uses `typeof __dirname !== 'undefined'` to determine if the environment supports native directory name resolution (typically CommonJS environments).
+
+## Example
+
+```typescript
+import { hasNativeDirname } from '@dxtmisha/scripts'
+
+if (hasNativeDirname()) {
+  console.log('Environment supports native __dirname')
+}
+```