@retailcrm/embed-ui 0.9.16 → 0.9.18

package/CHANGELOG.md

@@ -1,6 +1,17 @@
 # Changelog
 
 
+## [0.9.18](https://github.com/retailcrm/embed-ui/compare/v0.9.17...v0.9.18) (2026-04-06)
+
+### Bug Fixes
+
+* **v1-components:** Remote root component registry synchronized ([71f89d4](https://github.com/retailcrm/embed-ui/commit/71f89d4bff091c7ef4c9cfff3330d21fe340e45d))
+## [0.9.17](https://github.com/retailcrm/embed-ui/compare/v0.9.16...v0.9.17) (2026-04-06)
+
+### Features
+
+* **v1-components:** UiSkeleton loading placeholder added ([635e331](https://github.com/retailcrm/embed-ui/commit/635e331833aa7a4a385553068bfc1d16060f1d3d))
+* **v1-components:** Width modes for UiTextbox and UiSelect added ([895e1fe](https://github.com/retailcrm/embed-ui/commit/895e1febe6bc43329834897f94f57adcfceabd04))
 ## [0.9.16](https://github.com/retailcrm/embed-ui/compare/v0.9.15...v0.9.16) (2026-04-05)
 
 ### Features

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@retailcrm/embed-ui",
   "type": "module",
-  "version": "0.9.16",
+  "version": "0.9.18",
   "description": "API and components for creating RetailCRM UI extensions",
   "repository": "git@github.com:retailcrm/embed-ui.git",
   "author": "RetailDriverLLC <integration@retailcrm.ru>",
@@ -42,9 +42,9 @@
     "@omnicajs/symfony-router": "^1.0.0",
     "@omnicajs/vue-remote": "^0.2.23",
     "@remote-ui/rpc": "^1.4.5",
-    "@retailcrm/embed-ui-v1-components": "^0.9.16",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.16",
-    "@retailcrm/embed-ui-v1-types": "^0.9.16"
+    "@retailcrm/embed-ui-v1-components": "^0.9.18",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.18",
+    "@retailcrm/embed-ui-v1-types": "^0.9.18"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.3",
@@ -52,7 +52,7 @@
     "@modulify/git-toolkit": "^0.0.2",
     "@modulify/pkg": "^1.0.1",
     "@omnicajs/eslint-plugin-dependencies": "^0.0.2",
-    "@retailcrm/embed-ui-v1-testing": "^0.9.16",
+    "@retailcrm/embed-ui-v1-testing": "^0.9.18",
     "@types/git-semver-tags": "^7.0.0",
     "@types/node": "^22.19.2",
     "@types/semver": "^7.7.1",

package/.actrc

@@ -1,3 +0,0 @@
--P ubuntu-latest=catthehacker/ubuntu:act-latest
--P ubuntu-24.04=catthehacker/ubuntu:act-latest
--P ubuntu-22.04=catthehacker/ubuntu:act-latest

package/.docker/act/Dockerfile

@@ -1,20 +0,0 @@
-FROM ubuntu:24.04
-
-ARG DEBIAN_FRONTEND=noninteractive
-ARG TARGETARCH
-
-RUN apt-get update \
-    && apt-get install -y --no-install-recommends ca-certificates curl tar git \
-    && rm -rf /var/lib/apt/lists/*
-
-RUN set -eu; \
-    case "${TARGETARCH}" in \
-      amd64) ACT_ARCH="x86_64" ;; \
-      arm64) ACT_ARCH="arm64" ;; \
-      *) echo "Unsupported TARGETARCH: ${TARGETARCH}" >&2; exit 1 ;; \
-    esac; \
-    curl -fsSL "https://github.com/nektos/act/releases/latest/download/act_Linux_${ACT_ARCH}.tar.gz" \
-      | tar -xz -C /usr/local/bin act; \
-    chmod +x /usr/local/bin/act
-
-ENTRYPOINT ["act"]

package/.versionrc.json

@@ -1,12 +0,0 @@
-{
-    "types": [
-        {"type": "feat", "section": "Features"},
-        {"type": "fix", "section": "Fixes"},
-        {"type": "chore", "hidden": true},
-        {"type": "docs", "hidden": true},
-        {"type": "style", "hidden": true},
-        {"type": "refactor", "hidden": true},
-        {"type": "perf", "hidden": true},
-        {"type": "test", "hidden": true}
-    ]
-}

package/.yarnrc.dist.yml

@@ -1,15 +0,0 @@
-yarnPath: .yarn/releases/yarn-4.12.0.cjs
-
-compressionLevel: mixed
-
-enableGlobalCache: false
-
-logFilters:
-  - code: YN0013
-    level: discard
-  - code: YN0019
-    level: discard
-
-nmHoistingLimits: workspaces
-
-nodeLinker: node-modules

package/.yarnrc.yml

@@ -1,15 +0,0 @@
-yarnPath: .yarn/releases/yarn-4.12.0.cjs
-
-compressionLevel: mixed
-
-enableGlobalCache: false
-
-logFilters:
-  - code: YN0013
-    level: discard
-  - code: YN0019
-    level: discard
-
-nmHoistingLimits: workspaces
-
-nodeLinker: node-modules

package/AGENTS.md

@@ -1,110 +0,0 @@
-# AGENTS.md
-
-## Goals
-- Avoid clarification loops by proposing a concrete interpretation when details are missing.
-- Default to the language of the user's initial message unless they explicitly request a different language.
-- Match the tone and formality of the user's initial message unless they explicitly ask for a change.
-- Treat a language switch in the user's message as an explicit request to respond in that language.
-- If a message is mixed-language, reply in the dominant language unless the user specifies otherwise.
-
-## Purpose
-This file defines practical instructions for working in the `@retailcrm/embed-ui` repository.
-
-## Repository Structure
-- This project is a Yarn Workspaces monorepo.
-- Workspace glob: `packages/*`.
-- Current workspace folders:
-  - `v1-components`
-  - `v1-contexts`
-  - `v1-testing`
-  - `v1-types`
-- Workspace package names may differ from folder names, but commit scopes in this repository are based on workspace folder names.
-
-## Local Environment Prerequisites
-- Yarn version is `4.12.0` (see `packageManager` in `package.json` and `yarnPath` in `.yarnrc.yml`).
-- Package manager mode is `node-modules` (see `.yarnrc.yml`).
-- Local Yarn config is generated from `.yarnrc.dist.yml` using:
-```bash
-make .yarnrc.yml
-```
-- Root install:
-```bash
-yarn install
-```
-
-## Running Checks
-
-### Local Path (without Docker)
-- Prepare Yarn config:
-```bash
-make .yarnrc.yml
-```
-- Install dependencies:
-```bash
-yarn install
-```
-- Build all workspaces:
-```bash
-yarn workspaces foreach -A --topological-dev run build
-```
-- Run lint:
-```bash
-yarn eslint
-```
-- Run tests:
-```bash
-yarn test
-```
-
-### Docker Path (Makefile)
-- Install dependencies in container:
-```bash
-make node_modules
-```
-- Build all workspaces:
-```bash
-make build
-```
-- Run tests:
-```bash
-make tests
-```
-- Pass custom Vitest CLI arguments via Makefile:
-```bash
-make tests cli="-t outOfRangeErrorText"
-```
-
-## Related Commands
-- Build root package only:
-```bash
-yarn build
-```
-- Build root code artifacts only:
-```bash
-yarn build:code
-```
-- Build root meta artifacts only:
-```bash
-yarn build:meta
-```
-- Build Storybook for `v1-components`:
-```bash
-yarn workspace @retailcrm/embed-ui-v1-components run storybook:build
-```
-
-## Commit Workflow
-- Before creating commits, you must read `skills/commit-workflow/SKILL.md` and follow its rules.
-
-## Skills
-- Repository-local skills are available under `skills/`.
-- If a skill conflicts with this file, follow `AGENTS.md`.
-- Current local skills:
-  - `skills/commit-workflow/SKILL.md`
-  - `skills/sync-remote-host-registry/SKILL.md`
-  - `skills/yarn-lock-conflict-resolution/SKILL.md`
-
-## Notes
-- Do not assume legacy rules from other repositories (especially `omnica`) apply here.
-- Keep imports grouped by type-only, external, internal alias, and relative blocks, separated from each other and alphabetized within each block: this improves scanability and reduces merge conflicts when multiple PRs add imports to the same file.
-- When resolving lint issues, prefer running `eslint` with `--fix` first to avoid manual import reshuffling and unnecessary reading of repository-specific lint rules.
-- If repository policy is unclear, ask a short clarifying question before making irreversible actions.

package/ARCHITECTURE.md

@@ -1,143 +0,0 @@
-# Архитектура `@retailcrm/embed-ui`
-
-## 1. Назначение
-
-Репозиторий содержит библиотечный слой для JS-расширений RetailCRM:
-
-- контракт и транспорт между `remote` (код расширения) и `host` (CRM-страница);
-- UI-компоненты с разделением на remote-описания и host-реализации;
-- реактивные контексты (предопределенные и пользовательские);
-- вспомогательные типы и тестовые утилиты.
-
-Ключевая идея: расширение не рендерит «реальный DOM» CRM напрямую.  
-Оно отправляет инструкции рендера и вызовов в host-часть через RPC/remote-runtime.
-
-## 2. Структура монорепозитория
-
-Монорепозиторий на Yarn Workspaces (`packages/*`), Yarn `4.12.0`, linker `node-modules`.
-
-### `src/` (корневой пакет `@retailcrm/embed-ui`)
-
-- точка входа SDK для расширений;
-- `createWidgetEndpoint(widget, messenger)` поднимает endpoint и lifecycle `run/release`;
-- создает remote-root с whitelist host-компонентов (`createRoot`);
-- подключает Pinia + плагины доступа к контекстам (`injectEndpoint`, `injectAccessor`);
-- экспортирует публичный API контекстов и composables (`useField`, `useCustomField`, `useHost`, `useRouter`).
-
-### `packages/v1-components`
-
-- UI-библиотека разделена на два entrypoint:
-- `src/host.ts`: host-компоненты для реального рендера в CRM;
-- `src/remote.ts`: remote-компоненты (описания/схемы для передачи в host).
-- Storybook живет здесь и используется как витрина компонентов и сценариев.
-
-### `packages/v1-contexts`
-
-- слой реактивных контекстов и action-вызовов;
-- `src/host.ts`: сборка host-accessor’ов (`createGetter`, `createSetter`, `createContextAccessor`, `createCustomContextAccessor`) и типизированные ошибки (`HostError`, `LogicalError`, `RuntimeError`);
-- `src/remote.ts`: Pinia-обертки для предопределенных контекстов (`defineContext`) и инвокаций (`defineActions`);
-- `src/remote/custom.ts`: доступ к пользовательским полям и словарям.
-
-### `packages/v1-types`
-
-- базовые TS-контракты (контексты, поля, отклонения, action-схемы и пр.);
-- используется всеми остальными workspace.
-
-### `packages/v1-testing`
-
-- тестовые утилиты для runtime-сценариев (RPC/polyfill и хелперы событий).
-
-## 3. Runtime-модель host/remote
-
-### 3.1 Поток инициализации виджета
-
-1. CRM (host) создает `messenger` и вызывает `createWidgetEndpoint(...)` из корневого SDK.
-2. SDK поднимает RPC endpoint и экспортирует методы lifecycle: `run(channel, target)`, `release()`.
-3. При `run(...)` создается remote-root с допустимыми host-компонентами, инициализируется Pinia с endpoint-плагинами контекстов, после чего вызывается `widget.run(createApp, root, pinia, target)`.
-4. При `release()` вызывается destroy-функция виджета и освобождаются RPC-ресурсы.
-
-### 3.2 Каналы ответственности
-
-- `remote`: бизнес-логика расширения, декларативная сборка UI через remote-компоненты, чтение/запись контекстов через Pinia stores.
-- `host`: фактический рендер, геометрия, DOM, popper/positioning, интерактивность, предоставление данных контекста и invokable-методов (`goTo`, `httpCall`, domain actions).
-
-## 4. Архитектура компонентов
-
-### 4.1 Общий паттерн
-
-Для большинства компонентов сохраняется 1:1 соответствие:
-
-- remote-компонент описывает схему и события;
-- host-компонент выполняет фактический рендер.
-
-Примеры: `UiButton`, `UiCheckbox`, `UiTooltip`.
-
-### 4.2 Важный частный случай: `UiSelect`
-
-`UiSelect` — первый явно композиционный пример, где соответствие не 1:1:
-
-- remote-слой содержит семейство: `UiSelect`, `UiSelectOption`, `UiSelectOptionGroup`, `UiSelectOptionGroupHeader`;
-- host-рендер опирается на `UiSelectTrigger` + `UiSelectPopper` + menu/popper-примитивы;
-- состояние выбора/фильтрации и регистрация опций координируются через `provide/inject`-ключи.
-
-Следствие: host-реестр компонентов должен отражать не только «публичные remote-компоненты», но и необходимые host-примитивы, из которых они фактически собираются.
-
-### 4.3 Реестр host-компонентов: что в него входит
-
-Реестр в `src/index.ts` должен содержать только те host-компоненты, которые достижимы из remote-схемы рендера.
-
-- часть host-компонентов может быть внутренней (не remote-публичной) и потому не обязана попадать в реестр root SDK;
-- обратный случай тоже возможен: один remote-компонент может требовать несколько host-примитивов;
-- пример host-only компонента: `UiToolbar` экспортируется в `v1-components/host`, но не участвует в текущем remote render graph корневого SDK.
-
-## 5. Контексты и данные
-
-### 5.1 Предопределенные контексты
-
-- контекст задается описанием схемы полей;
-- remote-store инициализируется через `endpoint.call.get(context, '~')`;
-- подписки на изменения поля устанавливаются через `endpoint.call.on('change:field', ...)`;
-- запись идет через `endpoint.call.set(...)` с валидацией по schema.
-
-### 5.2 Пользовательские контексты (custom fields)
-
-- схема контекста запрашивается динамически у host;
-- значения и типы полей становятся известны после `initialize()`;
-- чтение/запись выполняются через `getCustomField/setCustomField`;
-- словари грузятся отдельным каналом `getCustomDictionary`.
-
-### 5.3 Ошибки и отклонения
-
-- host-часть разделяет логические и runtime-ошибки;
-- remote-часть может получать `Rejection` через callback `onReject`;
-- в composables заданы безопасные обработчики по умолчанию (логирование в `console.error`).
-
-## 6. Storybook как архитектурная песочница
-
-`packages/v1-components/storybook` выполняет две роли:
-
-- документация и интерактивная проверка host-компонентов;
-- демонстрация host/remote-связки (сейчас явно показана в `UiSelect`-истории через worker + endpoint + HostedTree/provider/receiver).
-
-Текущее состояние: bridge-механика визуально раскрыта не во всех историях, что усложняет onboarding для новых участников.
-
-## 7. Сборка, релиз, CI
-
-- сборка корня: `vite build` + генерация meta (`scripts/build.meta.ts`);
-- workspace-сборка в CI: `yarn workspaces foreach -A --topological-dev run build`;
-- тестовый workflow: Node `22.x` и `24.x`, шаги build + eslint + test;
-- release workflow: build/lint/test, bump/release scripts, публикация npm, деплой Storybook (`version` + обновление `latest`).
-
-## 8. Дальнейшее развитие качества
-
-Следующий этап развития проекта направлен на усиление автоматизированного контроля качества и формализацию ключевых архитектурных инвариантов.
-
-## 9. Планы по усилению контроля качества
-
-Ближайшие шаги:
-
-1. Ввести обязательный typecheck в локальный и CI-пайплайн.
-2. Расширить тесты на ключевые контракты host/remote и на синхронизацию реестров компонентов.
-3. Добавить автоматические проверки целостности render graph (минимум smoke/contract test).
-4. Расширить Storybook-документацию: явно показывать host/remote-binding не только для `UiSelect`.
-5. После стабилизации перейти к автоматизации registry/provider (кодогенерация) как к следующему этапу эволюции.

package/Makefile

@@ -1,245 +0,0 @@
-.DEFAULT_GOAL := help
-
-TARGET_HEADER=@echo -e '===== \e[34m' $@ '\e[0m'
-TARGET_OK=@echo -e '\e[32mOK\e[0m'
-COMPOSE=$(shell if command -v docker-compose >/dev/null 2>&1; then echo "docker-compose"; elif command -v docker >/dev/null 2>&1 && docker compose version >/dev/null 2>&1; then echo "docker compose"; fi)
-YARN=$(COMPOSE) run --rm node yarn
-
-.PHONY: .require-compose
-.require-compose:
-	@if [ -z "$(COMPOSE)" ]; then \
-		echo "docker compose is unavailable (need 'docker compose' or 'docker-compose')"; \
-		exit 1; \
-	fi
-
-.PHONY: .yarnrc.yml
-.yarnrc.yml:  ## [Setup][local] Generates yarn configuration
-	$(TARGET_HEADER)
-	cp .yarnrc.dist.yml .yarnrc.yml
-	$(TARGET_OK)
-
-.PHONY: node_modules
-node_modules: .require-compose package.json yarn.lock ## [Setup][docker][heavy] Installs dependencies
-	$(TARGET_HEADER)
-	@$(COMPOSE) run --rm node yarn install --silent
-	$(TARGET_OK)
-
-.PHONY: build
-build: .require-compose ## [Build][docker][heavy] Builds all workspaces
-	$(TARGET_HEADER)
-	$(YARN) workspaces foreach -A --topological-dev run build
-	$(TARGET_OK)
-
-.PHONY: storybook.build
-storybook.build: .require-compose ## [Build][docker][heavy] Builds Storybook for v1-components
-	$(TARGET_HEADER)
-	$(YARN) workspace @retailcrm/embed-ui-v1-components run storybook:build
-	$(TARGET_OK)
-
-.PHONY: storybook.serve
-storybook.serve: .require-compose ## [Build][docker] Runs Storybook for v1-components
-	$(TARGET_HEADER)
-	$(COMPOSE) up v1-components
-
-.PHONY: storybook.shot
-storybook.shot: .require-compose ## [Research][docker] Captures a Storybook screenshot for v1-components docs/story page
-	$(TARGET_HEADER)
-	@$(COMPOSE) up -d v1-components
-	@UID=$$(id -u) GID=$$(id -g) $(COMPOSE) run --rm playwright \
-		yarn workspace @retailcrm/embed-ui-v1-components run storybook:shot \
-			--base-url http://v1-components:6006 \
-			--path "$(if $(story_path),$(story_path),/iframe.html?viewMode=docs&id=components-uitable--docs)" \
-			--output "$(if $(output),$(output),artifacts/storybook/UiTable.docs.png)" \
-			--wait-for-selector "$(if $(wait_for),$(wait_for),#storybook-docs)" \
-			--settle-ms "$(if $(settle_ms),$(settle_ms),2500)" \
-			--timeout-ms "$(if $(timeout_ms),$(timeout_ms),60000)" \
-			--viewport-width "$(if $(viewport_width),$(viewport_width),1600)" \
-			--viewport-height "$(if $(viewport_height),$(viewport_height),1600)"
-	$(TARGET_OK)
-
-.PHONY: prepare
-prepare: .require-compose ## [Build][docker][heavy] Runs prepare in all workspaces
-	$(TARGET_HEADER)
-	$(YARN) workspaces foreach -A --topological-dev run prepare
-	$(TARGET_OK)
-
-.PHONY: release
-release: .require-compose ## [Release][docker][heavy][network] Bumps version and creates tag
-	$(TARGET_HEADER)
-ifdef as
-	$(YARN) release:$(as)
-else
-	$(YARN) release
-endif
-	$(TARGET_OK)
-
-.PHONY: tests
-tests: .require-compose ## [Tests][docker] Runs autotests
-	$(TARGET_HEADER)
-ifdef cli
-	$(YARN) test $(cli) --passWithNoTests
-else
-	$(YARN) test
-endif
-	$(TARGET_OK)
-
-.PHONY: tests-coverage
-tests-coverage: .require-compose ## [Tests][docker][heavy] Runs autotests with coverage report
-	$(TARGET_HEADER)
-ifdef cli
-	$(YARN) vitest --run --coverage $(cli) --passWithNoTests
-else
-	$(YARN) test:coverage
-endif
-	$(TARGET_OK)
-
-.PHONY: tests-typecheck-contexts
-tests-typecheck-contexts: .require-compose ## [Tests][docker] Runs typecheck tests (test-d.ts) for v1-contexts
-	$(TARGET_HEADER)
-ifdef cli
-	$(YARN) vitest run -c packages/v1-contexts/vitest.config.ts --typecheck.only --typecheck.checker tsc --typecheck.tsconfig packages/v1-contexts/tsconfig.json $(cli)
-else
-	$(YARN) vitest run -c packages/v1-contexts/vitest.config.ts --typecheck.only --typecheck.checker tsc --typecheck.tsconfig packages/v1-contexts/tsconfig.json
-endif
-	$(TARGET_OK)
-
-.PHONY: tests-typecheck-v1-contexts
-tests-typecheck-v1-contexts: tests-typecheck-contexts ## [Tests][alias] Alias for tests-typecheck-contexts
-
-.PHONY: tests-typecheck
-tests-typecheck: tests-typecheck-contexts ## [Tests][alias] Runs typecheck tests (currently v1-contexts)
-
-.PHONY: ci-actionlint
-ci-actionlint: ## [CI][docker] Lints GitHub Actions workflows locally (actionlint binary or docker image)
-	$(TARGET_HEADER)
-	@if command -v actionlint >/dev/null 2>&1; then \
-		actionlint; \
-	elif [ -n "$(COMPOSE)" ]; then \
-		$(COMPOSE) run --rm actionlint; \
-	elif command -v docker >/dev/null 2>&1; then \
-		docker run --rm -v "$$(pwd):/repo" -w /repo rhysd/actionlint:latest; \
-	else \
-		echo "actionlint is not installed and docker/docker-compose is unavailable"; \
-		exit 1; \
-	fi
-	$(TARGET_OK)
-
-.PHONY: ci-act-plan
-ci-act-plan: ## [CI][docker] Shows act execution plan for tests workflow without running jobs
-	$(TARGET_HEADER)
-	@if command -v act >/dev/null 2>&1; then \
-		act -n pull_request -W .github/workflows/tests.yml; \
-	elif [ -n "$(COMPOSE)" ]; then \
-		$(COMPOSE) run --rm --build act -n pull_request -W .github/workflows/tests.yml; \
-	else \
-		echo "act is not installed and docker compose is unavailable"; \
-		exit 1; \
-	fi
-	$(TARGET_OK)
-
-.PHONY: ci-act-tests
-ci-act-tests: ## [CI][docker][heavy][network] Runs tests workflow locally via act
-	$(TARGET_HEADER)
-	@if command -v act >/dev/null 2>&1; then \
-		act pull_request -W .github/workflows/tests.yml -j workflow-lint -j eslint -j tests; \
-	elif [ -n "$(COMPOSE)" ]; then \
-		$(COMPOSE) run --rm --build act pull_request -W .github/workflows/tests.yml -j workflow-lint -j eslint -j tests; \
-	else \
-		echo "act is not installed and docker compose is unavailable"; \
-		exit 1; \
-	fi
-	$(TARGET_OK)
-
-.PHONY: help
-help: ## [General] Shows grouped command help
-	@set -eu; \
-	if [ -t 1 ] && [ -z "$${CI:-}" ] && [ -z "$${NO_COLOR:-}" ]; then \
-		C_HEAD="$$(printf '\033[1;36m')"; \
-		C_TGT="$$(printf '\033[36m')"; \
-		C_TAG="$$(printf '\033[33m')"; \
-		C_WARN="$$(printf '\033[33m')"; \
-		C_RST="$$(printf '\033[0m')"; \
-	else \
-		C_HEAD=''; C_TGT=''; C_TAG=''; C_WARN=''; C_RST=''; \
-	fi; \
-	FILTER="$$(printf '%s' "$(value filter)" | tr '[:upper:]' '[:lower:]')"; \
-	SHOW_INTERNAL="$(value show_internal)"; \
-	awk -v filter="$$FILTER" -v show_internal="$$SHOW_INTERNAL" '\
-		function trim(s){ sub(/^[ \t\r\n]+/, "", s); sub(/[ \t\r\n]+$$/, "", s); return s } \
-		function group_order(g){ \
-			if (g=="General") return 1; \
-			if (g=="Setup") return 2; \
-			if (g=="Build") return 3; \
-			if (g=="Tests") return 4; \
-			if (g=="CI") return 5; \
-			if (g=="Release") return 6; \
-			return 99; \
-		} \
-		/^[a-zA-Z0-9_.-]+:.*##[[:space:]]+/ { \
-			target = $$1; sub(/:.*/, "", target); \
-			if (show_internal != "1" && target ~ /^\./) next; \
-			desc = $$0; sub(/^.*##[[:space:]]*/, "", desc); \
-			group = "Other"; tags = ""; \
-			if (match(desc, /^\[[^]]+\]/)) { \
-				group = substr(desc, 2, RLENGTH - 2); \
-				desc = substr(desc, RLENGTH + 1); \
-			} \
-			while (match(desc, /^[[:space:]]*\[[^]]+\]/)) { \
-				sub(/^[[:space:]]*/, "", desc); \
-				rb = index(desc, "]"); \
-				if (rb == 0) break; \
-				tags = tags "[" substr(desc, 2, rb - 2) "]"; \
-				desc = substr(desc, rb + 1); \
-			} \
-			desc = trim(desc); \
-			hay = tolower(target " " group " " tags " " desc); \
-			if (filter != "" && index(hay, filter) == 0) next; \
-			printf "%02d\t%s\t%s\t%s\t%s\n", group_order(group), group, target, tags, desc; \
-		} \
-	' $(MAKEFILE_LIST) \
-	| sort -t "$$(printf '\t')" -k1,1n -k3,3 \
-	| awk -F '\t' -v c_head="$$C_HEAD" -v c_tgt="$$C_TGT" -v c_tag="$$C_TAG" -v c_rst="$$C_RST" '\
-		BEGIN { current = ""; count = 0 } \
-		{ \
-			if ($$2 != current) { \
-				if (current != "") print ""; \
-				printf "%s%s%s\n", c_head, $$2, c_rst; \
-				current = $$2; \
-			} \
-			printf "  %s%-30s%s %s", c_tgt, $$3, c_rst, $$5; \
-			if ($$4 != "") printf " %s%s%s", c_tag, $$4, c_rst; \
-			printf "\n"; \
-			count++; \
-		} \
-		END { if (count == 0) print "No targets matched the current filter." }'; \
-	echo ""; \
-	printf "%sQuick Start%s\n" "$$C_HEAD" "$$C_RST"; \
-	printf "  make ci-actionlint\n"; \
-	printf "  make tests\n"; \
-	printf "  make tests-coverage\n"; \
-	printf "  make ci-act-plan\n"; \
-	echo ""; \
-	printf "%sExamples%s\n" "$$C_HEAD" "$$C_RST"; \
-	printf "  make help filter=ci\n"; \
-	printf "  make help show_internal=1\n"; \
-	printf "  make tests cli='tests/scenarios/customer/phone.test.ts'\n"; \
-	printf "  make release as=beta\n"; \
-	dup_targets="$$(awk -F: '/^[a-zA-Z0-9_.-]+:/ && $$1 != ".PHONY" {print $$1}' $(MAKEFILE_LIST) | sort | uniq -d | tr '\n' ' ')"; \
-	dup_phony="$$(awk '/^\.PHONY:[[:space:]]*/ {for (i=2; i<=NF; i++) print $$i}' $(MAKEFILE_LIST) | sort | uniq -d | tr '\n' ' ')"; \
-	if [ -n "$$dup_targets$$dup_phony" ]; then \
-		echo ""; \
-		printf "%sWarnings%s\n" "$$C_WARN" "$$C_RST"; \
-		if [ -n "$$dup_targets" ]; then printf "  duplicate targets: %s\n" "$$dup_targets"; fi; \
-		if [ -n "$$dup_phony" ]; then printf "  duplicate .PHONY entries: %s\n" "$$dup_phony"; fi; \
-	fi
-
-# Colors
-$(call computable,CC_BLACK,$(shell tput -Txterm setaf 0 2>/dev/null))
-$(call computable,CC_RED,$(shell tput -Txterm setaf 1 2>/dev/null))
-$(call computable,CC_GREEN,$(shell tput -Txterm setaf 2 2>/dev/null))
-$(call computable,CC_YELLOW,$(shell tput -Txterm setaf 3 2>/dev/null))
-$(call computable,CC_BLUE,$(shell tput -Txterm setaf 4 2>/dev/null))
-$(call computable,CC_MAGENTA,$(shell tput -Txterm setaf 5 2>/dev/null))
-$(call computable,CC_CYAN,$(shell tput -Txterm setaf 6 2>/dev/null))
-$(call computable,CC_WHITE,$(shell tput -Txterm setaf 7 2>/dev/null))
-$(call computable,CC_END,$(shell tput -Txterm sgr0 2>/dev/null))