docs(time-range): update article text and preset labels (#DS-4918) by rmnturov · Pull Request #1713 · koobiq/angular-components

rmnturov · 2026-07-08T12:29:46Z

Summary

По итогам вычитки статьи Time Range обновлены текст статьи (RU/EN), локализация пресетов и примеры документации; учтены замечания из ревью.

Макет: https://www.figma.com/design/HxMaLxGvkFuopugeFHNqVJ/koobiq-%C2%B7-guides?node-id=40002393-59163&t=fTXnCLk89T54qdBV-4

List of notable changes:

обновлён текст статьи (RU/EN); пример min-max приведён в соответствие с текстом — ограничение дат с 01.01.2015 по 31.12.2017
обновлена локализация пресетов во всех пяти локалях (ru, en, es-LA, pt-BR, tk-TM): подписи в списке — с заглавной буквы и без предлога (новые ключи *Option), в триггере предлог сохранён; исправлена русская плюральная форма («последние 3 года»); api-репорт core перегенерирован
обновлены примеры: локализованные подписи пресетов и плейсхолдеры («Период»/“Period”), порядок пресетов в overview, исправлен translationType у last3Years, добавлена защита от незаданного значения в titleTemplate
исправлен сброс выбранного произвольного периода при повторном открытии попапа (в списке типов примера custom-range-types не было 'range')

What should reviewers focus on?

Переводы es-LA / pt-BR / tk-TM — сделаны по английскому образцу; fallback allTimeOption ?? allTime сохранён для пользовательских конфигов локали.

…le caption (#DS-4918)

… label (#DS-4918) В третьем примере (time-range-empty-type-list) добавлен кастомный titleTemplate, чтобы подпись выбранного периода шла без предлога «за»/«for» — только в этом примере, глобальное поведение компонента не тронуто.

github-actions · 2026-07-08T12:34:47Z

Visit the preview URL for this PR (updated for commit 6b00356):

https://koobiq-next--prs-1713-fv4aacgt.web.app

_{(expires Sun, 12 Jul 2026 11:27:18 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: c9e37e518febda70d0317d07e8ceb35ac43c534c}

…s (#DS-4918) Убрана подпись о диапазоне под примером. Текст незаполненного поля изменён на «Выбрать период»/«Select period». Для произвольного периода убран предлог «за»/«for», а для остальных значений первая буква теперь заглавная. Правки только в этом примере, остальные примеры не затронуты.

Подписи выбранных значений в примере теперь локализованы: без предлога «за»/«for» и с заглавной буквы (например, «Последние 3 минуты»). Текст незаполненного поля изменён на «Период»/«Period». Для произвольного периода подпись показывает не только даты, но и время. Правки только в этом примере, остальные примеры и компонент не затронуты.

…DS-4918) CI-проверка check-api падала: enUSLocaleData в core.api.md не содержал новые allTimeOption/currentQuarterOption/currentYearOption поля, добавленные ранее в en-US.ts. Файл сгенерирован заново через approve-api.

… (#DS-4918) В примере overview опция «Все время» теперь идёт последней в списке пресетов — после «Текущий квартал» и «Текущий год».

rmnturov · 2026-07-08T15:09:49Z

@lskramarov вопрос по объёму локализации.

Сейчас обновлены только русский (ru-RU) и английский (en-US). Не тронутыми остались три локали: es-LA, pt-BR, tk-TM.

Что именно было изменено для ru-RU и en-US:

добавлены ключи allTimeOption / currentQuarterOption / currentYearOption — подписи опций в списке пресетов (с заглавной буквы и без предлога «за»/«for»), в отличие от подписи в триггере, где предлог сохранён;
в durationTemplate.option первая буква сделана заглавной («Последние …» / «Last …») — только для списка опций в поповере, шаблон триггера (title) не меняли.

Для es-LA / pt-BR / tk-TM всё работает за счёт fallback (allTimeOption ?? allTime), но там в списке пресетов останутся старые подписи — с предлогом и со строчной буквы, то есть визуально разъедутся с ru/en.

Нужно ли доводить до единообразия и обновить эти три локали (в рамках этого PR или отдельной задачей), или scope осознанно ограничен только ru/en?

… (#DS-4918) В примере custom-range-types список типов для DI (KBQ_DEFAULT_TIME_RANGE_TYPES) не включал 'range', поэтому компонент считал выбранный произвольный период невалидным при повторном открытии и сбрасывал выбор на первый пресет. Добавлен 'range' в список типов примера — правка только в примере.

lskramarov · 2026-07-08T17:18:53Z

@lskramarov вопрос по объёму локализации.

Нужно ли доводить до единообразия и обновить эти три локали (в рамках этого PR или отдельной задачей), или scope осознанно ограничен только ru/en?

Я бы не разбивал на дополнительные задачи, а делал в этой. Давай завтра на синке обсудим.

Copilot

Pull request overview

This PR updates the Time Range documentation article (RU/EN), refines locale strings for preset labels (including separate “option” labels for the presets list), and adjusts multiple docs examples to better match the updated UX and localization rules.

Changes:

Added separate locale labels for presets list entries (*Option) and updated the time-range editor template to use them with fallbacks.
Updated RU/EN locale strings for time range presets and duration option formatting (capitalization / wording).
Updated docs examples (overview/min-max/empty-type-list/custom-range-types) to reflect revised labels, placeholders, ordering, and custom trigger/title rendering.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
tools/public_api_guard/components/core.api.md	Updates public API snapshot to include new optional locale fields for time-range preset option labels.
packages/docs-examples/components/time-range/time-range-overview/time-range-overview-example.ts	Adds localized “Events/События” caption and reorders presets list (moves `allTime` after quarter/year).
packages/docs-examples/components/time-range/time-range-min-max/time-range-min-max-example.ts	Reworks the example trigger rendering via `titleTemplate` (placeholder + range formatting + capitalization) and adds link/icon UI.
packages/docs-examples/components/time-range/time-range-empty-type-list/time-range-empty-type-list-example.ts	Adds `titleTemplate` to render the custom range title without the “for/за” prefix.
packages/docs-examples/components/time-range/time-range-custom-range-types/time-range-custom-range-types-example.ts	Localizes preset labels via `DateFormatter.duration`, adds localized placeholder, and includes `'range'` in default types to prevent selection reset.
packages/components/time-range/time-range.ru.md	Updates RU article text and section descriptions for Time Range.
packages/components/time-range/time-range.en.md	Updates EN article text and section descriptions for Time Range.
packages/components/time-range/time-range-editor.html	Uses new `*Option` locale fields (with fallback to existing labels) for the presets list labels.
packages/components/time-range/snapshots/time-range.spec.ts.snap	Updates snapshots to reflect new RU labels (“Период”, “Текущий год”, etc.).
packages/components/core/locales/types.ts	Extends `KbqTimeRangeLocaleConfig` with optional `allTimeOption/currentQuarterOption/currentYearOption` fields (+ docs).
packages/components/core/locales/ru-RU.ts	Updates RU time-range labels and adds new `*Option` translations; capitalizes duration option strings.
packages/components/core/locales/en-US.ts	Updates EN time-range labels and adds new `*Option` translations; capitalizes duration option strings.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

…locales (#DS-4918)

…elds (#DS-4918)

…n templates (#DS-4918)

… (#DS-4918)

…lue in examples (#DS-4918)

…stom-option examples (#DS-4918)

rmnturov added 3 commits July 8, 2026 14:00

docs(time-range): update article text per copy review (#DS-4918)

0bd1833

fix(time-range): capitalize preset labels and localize overview examp…

a8fa253

…le caption (#DS-4918)

rmnturov self-assigned this Jul 8, 2026

rmnturov requested review from NikGurev and lskramarov July 8, 2026 12:30

rmnturov added 4 commits July 8, 2026 19:57

rmnturov marked this pull request as ready for review July 8, 2026 15:48

rmnturov added documentation Improvements or additions to documentation help wanted Extra attention is needed labels Jul 8, 2026

NikGurev reviewed Jul 9, 2026

View reviewed changes

Comment thread packages/components/time-range/time-range.ru.md

NikGurev reviewed Jul 9, 2026

View reviewed changes

Comment thread packages/docs-examples/components/time-range/time-range-min-max/time-range-min-max-example.ts

NikGurev reviewed Jul 9, 2026

View reviewed changes

Comment thread packages/components/core/locales/types.ts

artembelik requested a review from Copilot July 9, 2026 07:59

Copilot started reviewing on behalf of artembelik July 9, 2026 07:59 View session

Copilot AI reviewed Jul 9, 2026

View reviewed changes

rmnturov added 6 commits July 9, 2026 18:21

fix(time-range): fill preset option labels in es-LA, pt-BR and tk-TM …

46c5eb9

…locales (#DS-4918)

chore(core): regenerate api report for remaining time-range locale fi…

f04e50a

…elds (#DS-4918)

fix(time-range): use correct russian plural form for years in duratio…

3abf02e

…n templates (#DS-4918)

docs(time-range): align min-max example date limits with article text…

f2268ee

… (#DS-4918)

docs(time-range): fix years translation type and guard empty range va…

26ae526

…lue in examples (#DS-4918)

docs(time-range): localize period placeholder in as-form-field and cu…

6b00356

…stom-option examples (#DS-4918)

rmnturov requested a review from NikGurev July 9, 2026 11:45

rmnturov requested a review from artembelik July 9, 2026 11:45

NikGurev approved these changes Jul 9, 2026

View reviewed changes

lskramarov approved these changes Jul 10, 2026

View reviewed changes

artembelik approved these changes Jul 10, 2026

View reviewed changes

rmnturov merged commit 290e6a2 into main Jul 10, 2026
10 checks passed

rmnturov deleted the docs/DS-4918-Update-time-range-article-text branch July 10, 2026 14:35

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs(time-range): update article text and preset labels (#DS-4918)#1713

docs(time-range): update article text and preset labels (#DS-4918)#1713
rmnturov merged 14 commits into
mainfrom
docs/DS-4918-Update-time-range-article-text

rmnturov commented Jul 8, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 8, 2026 •

edited

Loading

Uh oh!

rmnturov commented Jul 8, 2026 •

edited

Loading

Uh oh!

lskramarov commented Jul 8, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

rmnturov commented Jul 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

List of notable changes:

What should reviewers focus on?

Uh oh!

github-actions Bot commented Jul 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

rmnturov commented Jul 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lskramarov commented Jul 8, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

rmnturov commented Jul 8, 2026 •

edited

Loading

github-actions Bot commented Jul 8, 2026 •

edited

Loading

rmnturov commented Jul 8, 2026 •

edited

Loading