@ryuzaki13/react-foundation-lib 1.4.3 → 1.5.0

package/dist/currency/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/currency/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/currency/index.js

@@ -1,16 +0,0 @@
-//#region src/currency/currency.ts
-var e = "p_curr";
-function t(e, t, n) {
-	if (!t || !n) return e;
-	let r = t[n === "internal" ? 0 : 1]?.trim() ?? "", i = r.startsWith(",");
-	return r ? `${e}${i ? "" : " "}${r}` : e;
-}
-function n(t) {
-	if (!t || !Object.prototype.hasOwnProperty.call(t, e)) return null;
-	let n = t[e]?.value;
-	return n === !1 ? "internal" : n === !0 ? "rub" : null;
-}
-//#endregion
-export { t as resolveCurrencyAwareLabel, n as resolveCurrencyModeFromODataParameters };
-
-//# sourceMappingURL=index.js.map

package/dist/currency/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/currency/currency.ts"],"sourcesContent":["import { type WrappedODataParameters } from \"../odata-service\";\n\nconst CURRENCY_PARAMETER_ID = \"p_curr\";\n\n/** Runtime-режим валюты, который задается общим OData-параметром страницы. */\nexport type CurrencyMode = \"internal\" | \"rub\";\n\n/** Собирает display-подпись с валютным суффиксом. */\nexport function resolveCurrencyAwareLabel(\n\tlabel: string,\n\tcurrencyLabels: readonly [string, string] | undefined,\n\tcurrencyMode: CurrencyMode | null | undefined\n): string {\n\tif (!currencyLabels || !currencyMode) {\n\t\treturn label;\n\t}\n\n\tconst currencyLabelIndex = currencyMode === \"internal\" ? 0 : 1;\n\tconst currencyLabel = currencyLabels[currencyLabelIndex]?.trim() ?? \"\";\n\tconst hasComma = currencyLabel.startsWith(\",\");\n\n\t// NOTE: нужно закрепить правило, что запятая ставится в currencyLabel\n\treturn currencyLabel ? `${label}${hasComma ? \"\" : \" \"}${currencyLabel}` : label;\n}\n\n/** Определяет режим валюты по общему OData-параметру `p_curr`. */\nexport function resolveCurrencyModeFromODataParameters(params?: WrappedODataParameters): CurrencyMode | null {\n\tif (!params || !Object.prototype.hasOwnProperty.call(params, CURRENCY_PARAMETER_ID)) {\n\t\treturn null;\n\t}\n\n\tconst value = params[CURRENCY_PARAMETER_ID]?.value;\n\tif (value === false) return \"internal\";\n\tif (value === true) return \"rub\";\n\n\treturn null;\n}\n"],"mappings":";AAEA,IAAM,IAAwB;AAM9B,SAAgB,EACf,GACA,GACA,GACS;CACT,IAAI,CAAC,KAAkB,CAAC,GACvB,OAAO;CAIR,IAAM,IAAgB,EADK,MAAiB,aAAa,IAAI,EACL,EAAE,KAAK,KAAK,IAC9D,IAAW,EAAc,WAAW,GAAG;CAG7C,OAAO,IAAgB,GAAG,IAAQ,IAAW,KAAK,MAAM,MAAkB;AAC3E;AAGA,SAAgB,EAAuC,GAAsD;CAC5G,IAAI,CAAC,KAAU,CAAC,OAAO,UAAU,eAAe,KAAK,GAAQ,CAAqB,GACjF,OAAO;CAGR,IAAM,IAAQ,EAAO,EAAsB,EAAE;CAI7C,OAHI,MAAU,KAAc,aACxB,MAAU,KAAa,QAEpB;AACR"}

package/src/currency/README.mdx

@@ -1,155 +0,0 @@
-import { Meta } from "@storybook/addon-docs/blocks";
-
-<Meta title="Foundation Lib/Data/Currency" />
-
-# Валютные подписи через `@ryuzaki13/react-foundation-lib/currency`
-
-Модуль связывает общий OData-параметр `p_curr` с отображаемой подписью показателя. Он определяет один из двух режимов валюты и добавляет соответствующий суффикс к label.
-
-## Содержание
-
-- [Назначение](#назначение)
-- [Установка и импорт](#установка-и-импорт)
-- [`CurrencyMode`](#currencymode)
-- [`resolveCurrencyModeFromODataParameters`](#resolvecurrencymodefromodataparameters)
-- [`resolveCurrencyAwareLabel`](#resolvecurrencyawarelabel)
-- [Готовый pipeline](#готовый-pipeline)
-- [Ограничения и ошибки](#ограничения-и-ошибки)
-- [API-справочник](#api-справочник)
-
-## Назначение
-
-```text
-wrapped OData params
-{ p_curr: { value: true } }
-              │
-              ▼
-      CurrencyMode "rub"
-              │
-              ▼
-"Выручка" + ["за тн", "руб/тн"]
-              │
-              ▼
-       "Выручка руб/тн"
-```
-
-Модуль не форматирует денежное число, не конвертирует валюту и не строит OData query. Для чисел используйте `/formatters`, для OData params — `/odata-service`.
-
-## Установка и импорт
-
-```ts
-import { resolveCurrencyAwareLabel, resolveCurrencyModeFromODataParameters } from "@ryuzaki13/react-foundation-lib/currency";
-
-import type { CurrencyMode } from "@ryuzaki13/react-foundation-lib/currency";
-```
-
-Модуль ESM, не требует React или browser API. Параметры должны иметь публичную wrapped-форму из `/odata-service`.
-
-## `CurrencyMode`
-
-```ts
-type CurrencyMode = "internal" | "rub";
-```
-
-- `internal` — внутренний режим;
-- `rub` — рублёвый режим.
-
-`null` используется resolver-функцией, когда режим определить нельзя.
-
-## `resolveCurrencyModeFromODataParameters`
-
-```ts
-const mode = resolveCurrencyModeFromODataParameters(params);
-```
-
-Функция читает только собственное поле `p_curr.value`:
-
-| Вход                            | Результат    |
-| ------------------------------- | ------------ |
-| параметров нет                  | `null`       |
-| поля `p_curr` нет               | `null`       |
-| `{ p_curr: { value: false } }`  | `"internal"` |
-| `{ p_curr: { value: true } }`   | `"rub"`      |
-| `{ p_curr: { value: "true" } }` | `null`       |
-| `{ p_curr: { value: 1 } }`      | `null`       |
-
-Строка `"true"` намеренно не приводится к boolean. Нормализуйте внешний payload на OData boundary, а не внутри UI label.
-
-Пример с helper `/odata-service`:
-
-```ts
-import { wrapODataParams } from "@ryuzaki13/react-foundation-lib/odata-service";
-
-const params = wrapODataParams({ p_curr: true });
-const mode = resolveCurrencyModeFromODataParameters(params);
-// "rub".
-```
-
-## `resolveCurrencyAwareLabel`
-
-```ts
-const label = resolveCurrencyAwareLabel("Выручка", ["за тн", "руб/тн"], "rub");
-// "Выручка руб/тн".
-```
-
-Пара `currencyLabels` имеет фиксированный смысл:
-
-```ts
-readonly[(internalLabel, rubLabel)];
-```
-
-| Mode       | Индекс суффикса |
-| ---------- | --------------: |
-| `internal` |               0 |
-| `rub`      |               1 |
-
-Точные правила:
-
-- без `currencyLabels` возвращается исходный `label`;
-- при `null`/`undefined` mode возвращается исходный `label`;
-- суффикс обрезается через `trim()`;
-- пустой суффикс не добавляется;
-- обычно между label и суффиксом добавляется один пробел;
-- если обрезанный суффикс начинается с запятой, дополнительный пробел не добавляется.
-
-```ts
-resolveCurrencyAwareLabel("Выручка", [", за тн", ", руб/тн"], "rub");
-// "Выручка, руб/тн".
-
-resolveCurrencyAwareLabel("Выручка", ["", "   "], "rub");
-// "Выручка".
-```
-
-Исходный `label` не обрезается и не нормализуется.
-
-## Готовый pipeline
-
-```ts
-function buildMetricLabel(
-	baseLabel: string,
-	currencyLabels: readonly [string, string] | undefined,
-	params: WrappedODataParameters | undefined
-) {
-	const mode = resolveCurrencyModeFromODataParameters(params);
-	return resolveCurrencyAwareLabel(baseLabel, currencyLabels, mode);
-}
-```
-
-Resolver чистый: одинаковый вход даёт одинаковую строку и не меняет params/labels.
-
-## Ограничения и ошибки
-
-- Поддерживается только параметр с точным id `p_curr`.
-- Поддерживаются только два режима; код валюты `USD`, `EUR` и exchange rate не обрабатываются.
-- Функция не проверяет грамматику и единицы измерения.
-- Запятая должна входить в сам суффикс, если нужна форма `"Выручка, руб"`.
-- Не передавайте плоский `{ p_curr: true }`: ожидается `{ p_curr: { value: true } }`.
-- Не используйте label helper для финансовых вычислений.
-
-## API-справочник
-
-| Export                                   | Результат               |
-| ---------------------------------------- | ----------------------- |
-| `CurrencyMode`                           | `"internal" \| "rub"`   |
-| `resolveCurrencyModeFromODataParameters` | `CurrencyMode \| null`  |
-| `resolveCurrencyAwareLabel`              | Итоговая display-строка |