# tectra roadmap Everything tectra covers, ordered by dependencies and by how much the first consumer app needs each part. We go top to bottom, one item at a time. **Legend:** โœ… done ยท ๐ŸŸก started, not at parity ยท โฌœ to do **Usage** = how many files of the first consumer app use the part (counted 2026-11-05). It is the main signal for priority inside a stage. ## The next twelve months - **Planned:** stage 14 (one-command setup, live examples in StackBlitz, bundle size and 95% coverage checks, link checks, the silver OpenSSF Best Practices level), the editor backlog, and support for each new Angular major release. - **Not planned:** an own rich text or code editor engine (the ProseMirror and CodeMirror cores stay), support for frameworks other than Angular (only `@tectra-ng/qr` is framework-free), NgModule-based or zone-dependent APIs, server-side services or hosted products โ€” tectra stays a client-side library. ## Definition of done (every item) 1. Component in `packages//` โ€” signals, OnPush, standalone, keyboard + ARIA. 2. Design tokens in `packages/themes/src/components/.tokens.ts`, light + dark. 3. `dt`, `pt` (+ `ptOptions`), `unstyled` where the component has parts. 4. Feature parity with the PrimeNG component of the same role (inputs, outputs, templates) โ€” list in the README. 5. `README.md` (Inputs / Outputs / Slots / Keyboard) and docs content: overview + one example per feature. 6. Unit tests (once the test runner exists) and a Playwright check of the docs page (light + dark, no layout shifts). --- ## Stage 0 โ€” foundation โœ… | Item | Package | Status | |---|---|---| | Tokens: ink surface, 5 accents, severity palettes, radius, typography, shadows | `@tectra-ng/tokens` | โœ… | | Themes: light / dark semantic, `createTectraPreset(options)`, component tokens, deep `definePreset` | `@tectra-ng/themes` | โœ… | | Theme picker: 17 primaries (`noir` follows the surface), 13 surfaces, 3 themes (`tectra` default, `edge`, `paper`; `soft` taken out until it reshapes the whole kit) via `createTectraPreset({ style, primary, surface })`, runtime ripple switch; docs header picker; e2e of every style in light and dark (`themes.spec.ts`) | `@tectra-ng/tokens`, `@tectra-ng/themes`, `@tectra-ng/core/config` | โœ… | | `provideTectra` (preset, mode, `darkSelector`, ripple, unstyled, pt, ptOptions), forms base, i18n, style loader, ripple, fluid | `@tectra-ng/core` | โœ… | | 334 icons with PrimeIcons names + registry, brand logos | `@tectra-ng/icons`, `@tectra-ng/brand-icons` | โœ… | | Docs site, registry builder, sandbox | `apps/docs` | โœ… | ## Stage 1 โ€” infrastructure before the next components | Item | Why now | Status | |---|---|---| | Unit tests: Vitest through `@angular/build:unit-test` (`npm run test`) โ€” specs for themes, core, icons, badge, button, button-group, toggle-button, input, select | every next item ships with tests | โœ… | | Playwright checks in `e2e/visual` (`npm run e2e`): every page light + dark, console errors, layout shift, axe serious / critical; select, code panel, navigation, square buttons, theme toggle | the check we ran by hand is permanent | โœ… | | CI (`.github/workflows/ci.yml`): test โ†’ package build โ†’ e2e, report on failure | | โœ… | | ESLint (`npm run lint`): angular-eslint (OnPush, signals readonly, control flow, template a11y), typescript-eslint, Nx module boundaries by package tags; first step in CI | keeps the conventions and the package graph honest | โœ… | | Release flow: `nx release` (one version for all packages, changelog from conventional commits), `tools/release.mjs` (version โ†’ build โ†’ publish โ†’ tag), `release` workflow with npm trusted publishing; `tectra-ng` installs everything | needed before apps can install from npm | โœ… 0.1.0 on npm | Found and fixed while setting it up: a disabled `a[txButton]` still let the parent `(click)` run; `tx-select` had no accessible name (`ariaLabel`, `ariaLabelledBy`, falls back to the placeholder); light muted text and the white-on-green success colour were below WCAG AA (muted โ†’ surface 600, success โ†’ green 700); toggle-button text contrast. ## Stage 2 โ€” overlay core โœ… | Item | Package | Notes | Status | |---|---|---|---| | Overlay: `TxOverlay.open(template \| component, options)` โ†’ `TxOverlayRef` (`placement`, `closed`, `close`, `updatePosition`); 12 placements with flip (`txPositions`), enter / leave motion from the origin side (`txAnimateEnter`, `txAnimateLeave`, off with reduced motion), viewport margin, scroll strategies, `matchWidth`, Escape / outside click, focus back to the origin; z-index layers (`--tx-layer-dropdown โ€ฆ toast`); sticky chrome insets (`txOverlayInset`, measured while pinned, or `provideTectra({ overlay: { viewportInsets } })`) โ€” panels fit around a sticky header / bar and close once the origin scrolls under it, also in `tx-select`; CDK loads its structural CSS itself โ€” no `overlay-prebuilt.css` needed | `@tectra-ng/core/overlay` | docs page Core โ†’ Overlay | โœ… | | `txFocusTrap` (auto focus, restore focus), `nextListIndex` (arrows, Home / End, Page, disabled, loop), `TxTypeahead`, `TxAnnouncer` | `@tectra-ng/core/a11y` | | โœ… | | Locale: `us` / `ua` definitions, `provideTectra({ locale })`, `TxLocaleService` (runtime `setLocale`, `translate` with params, Intl numbers / dates, month and weekday names from the first day of week), `injectTranslations()` is a signal | `@tectra-ng/core/i18n` | docs page Core โ†’ Locale | โœ… | | Select on the new core: placements with flip, reposition on scroll, Home / End / Page keys, type-to-find, translated texts | `@tectra-ng/ui/select` | | โœ… | ## Stage 3 โ€” form primitives (high usage, low complexity) โœ… Detailed checklist per component: [roadmap/stage-3-forms.md](roadmap/stage-3-forms.md). | tectra | PrimeNG equivalent | Usage | Status | |---|---|---|---| | form-field foundation โ€” shared tokens, `filled` variant, focus / invalid / readonly states, invalid from the form control | BaseInput | โ€” | โœ… | | `ui/input` + `ui/icon-field` + `ui/input-group` + `ui/key-filter` โ€” icons, addons, prefix / suffix, clear, copy, key filter (PrimeNG presets + `positive`, `nospace`, `latin`), sizes, `fluid`, `dt` / `pt` / `unstyled` | InputText, IconField, InputIcon, InputGroup, KeyFilter | 239 | โœ… | | `ui/label` โ€” label (required, colon, help, subtle), float label (over / in / on), ifta label | FloatLabel / IftaLabel | 353 | โœ… | | `ui/message` (field part) โ€” hint, error from the control, success | Message | 18 | โœ… | | `ui/field` โ€” label + control + hint + error, ids and aria wired | โ€” | every form | โœ… | | `ui/textarea` โ€” auto resize | Textarea | 68 | โœ… | | `ui/checkbox` โ€” binary, group, indeterminate | Checkbox | 73 | โœ… | | `ui/radio-button` | RadioButton | โ€” (parity) | โœ… | | `ui/toggle-switch` | ToggleSwitch | 33 | โœ… | | `ui/password` โ€” strength meter, toggle mask | Password | 20 | โœ… | | `ui/input-otp` | InputOtp | 5 | โœ… | | `ui/input-mask` | InputMask | 2 | โœ… | | `ui/input-number` | InputNumber | โ€” (parity) | โœ… | | `ui/rating` | Rating | 7 | โœ… | | `ui/knob` | Knob | 1 | โœ… | | `ui/slider` | Slider | โ€” (parity) | โœ… | | `ui/password-generator` (button + generator service) | โ€” | 2 | โœ… | ## Stage 4 โ€” feedback & display primitives Detailed checklist per component: [roadmap/stage-4-display.md](roadmap/stage-4-display.md). | tectra | PrimeNG equivalent | Usage | Status | |---|---|---|---| | `ui/badge` | Badge | โ€” | โœ… | | `ui/overlay-badge` | OverlayBadge | 0 | โœ… | | `ui/pill` โ€” tone, icon, size | Tag (rounded) | **852** | โœ… | | `ui/tag` + `ui/chip` | Tag, Chip | 43, 0 | โœ… | | `ui/message` (alert) โ€” built in 3.3 (`tx-message`) | Message | **370** | โœ… | | `ui/progress-bar` | ProgressBar | 30 | โœ… | | `ui/progress-spinner` (loader) | ProgressSpinner | 25 | โœ… | | `ui/skeleton` | Skeleton | 0 | โœ… | | `ui/avatar` (+ group, initials fallback, photo) | Avatar, AvatarGroup | 174, 9, 6 | โœ… | | `ui/divider` | Divider | โ€” (parity) | โœ… | | `ui/card` / `ui/panel` | Card, Panel | 115 | โœ… | | `ui/fieldset` | Fieldset | โ€” (parity) | โœ… | | `ui/highlight-text` | โ€” | 43 | โœ… | | `ui/amount` (money / number formatting) | โ€” | 40 | โœ… | | `ui/status-icon` | โ€” | 6 | โœ… | | `ui/link` (link-view, icon-link) | โ€” | 202, 4 | โœ… | ## Stage 5 โ€” overlays (after stage 2) โœ… Detailed checklist per component: [roadmap/stage-5-overlays.md](roadmap/stage-5-overlays.md). | tectra | PrimeNG equivalent | Usage | Status | |---|---|---|---| | `ui/tooltip` directive | Tooltip | used by 20+ kit libs, `[toolTip]` on 751 buttons; 4 | โœ… | | `ui/popover` | Popover | 16 | โœ… | | `ui/toast` + toast service | Toast + MessageService | 4, core-utils `custom-toastr` | โœ… | | `ui/dialog` + dialog service (`open(component, { data })`, `DialogRef`, close result) | Dialog, DynamicDialog | core-utils `modal` (`ModalService`, all modals), 2 | โœ… | | `ui/drawer` | Drawer | 13 | โœ… | | `ui/confirm` (dialog + popup) + confirm service | ConfirmPopup, ConfirmDialog | 1 | โœ… | | `ui/menu` โ€” menu, tiered menu, context menu | Menu, TieredMenu, ContextMenu | table row menu, 6 | โœ… | | `ui/split-button` | SplitButton | โ€” (parity, needs menu) | โœ… | | `ui/speed-dial` | SpeedDial | โ€” (parity, needs menu) | โœ… | ## Stage 6 โ€” selection โœ… Detailed checklist per component: [roadmap/stage-6-selection.md](roadmap/stage-6-selection.md). | tectra | PrimeNG equivalent | Usage | Status | |---|---|---|---| | `ui/select` โ€” parity: clear, groups, disabled options, `dataKey`, filter fields / match modes / delay, virtual scroll, lazy, editable, loading, checkmark, all templates, `dt` / `pt` / `unstyled` | Select | **406** | โœ… | | `ui/multiselect` โ€” chips display, select all, filter, max selected, selection limit | MultiSelect | 129 + 8 (multiselect mode of the select wrapper) | โœ… | | `ui/autocomplete` โ€” single / multiple, dropdown, force selection, local or server search, groups | AutoComplete | 1, 2 | โœ… | | `ui/listbox` โ€” single / multiple, checkbox, meta key selection, filter, groups, virtual scroll | Listbox | โ€” (parity) | โœ… | | `ui/chips-input` (keywords, pasted lists, pattern, limits) | AutoComplete multiple / InputChips | 3, 5 | โœ… | | `ui/color-picker` โ€” popover or inline, area + hue + hex, presets, hex / rgb / hsb | ColorPicker | 3 | โœ… | | `ui/country` + `ui/country-select` (flags, `Intl.DisplayNames`, counts, hints, "+N") + `@tectra-ng/flags` | โ€” | 91 | โœ… | | `ui/mention-textarea` โ€” suggestions at the caret, mentions output | โ€” | 2 | โœ… | | `ui/email-suggestion` โ€” own domain completion, typo fixes | โ€” | 4 | โœ… | | `ui/tree-select`, `ui/cascade-select` | TreeSelect, CascadeSelect | โ€” (parity) | โœ… | | `ui/select-button` โ€” segmented single / multiple choice, icons, item template, sizes, `fluid`, form control | SelectButton | โ€” (parity) | โœ… | ## Stage 7 โ€” data โœ… Detailed checklist per component: [roadmap/stage-7-data.md](roadmap/stage-7-data.md). | tectra | PrimeNG equivalent | Usage | Status | |---|---|---|---| | `ui/paginator` โ€” compact mode below 40rem, page size options, `PaginationInterface` | Paginator | 170 | โœ… | | `ui/table` โ€” sort, selection, resize, reorder, sticky columns, row actions, context menu, settings (visible / order / width persistence), cards below 1024px, loading overlay, virtual scroll, row expansion | Table | **356** | โœ… | | `ui/tree`, `ui/tree-table` | Tree, TreeTable | โ€” (parity) | โœ… | | `ui/data-view`, `ui/virtual-scroller` | DataView, VirtualScroller | โ€” (parity) | โœ… | | `ui/timeline` | Timeline | โ€” (parity) | โœ… | | `ui/stat-tiles` | โ€” | 48 | โœ… | | `ui/sparkline` | โ€” | 4 | โœ… | | `ui/export` โ€” CSV, Excel, Word, PDF, JSON, HTML, Markdown, copy, print, no third-party libraries (`ui/export-font` for PDF) | โ€” | 0, 2 | โœ… | ## Stage 8 โ€” date & time โœ… Detailed checklist per component: [roadmap/stage-8-date.md](roadmap/stage-8-date.md). | tectra | PrimeNG equivalent | Usage | Status | |---|---|---|---| | `ui/datepicker` โ€” single / range / multiple, time, month / year views, inline, touch, min / max, locale | DatePicker | 58 | โœ… | | `ui/month-calendar` (events grid) | โ€” | 23 | โœ… | | `ui/countdown` (value / unit or target date, remaining-time pipe) | โ€” | 1 | โœ… | | `ui/analog-clock` | โ€” | 1 | โœ… | ## Stage 9 โ€” navigation & structure โœ… Detailed checklist per component: [roadmap/stage-9-navigation.md](roadmap/stage-9-navigation.md). | tectra | PrimeNG equivalent | Usage | Status | |---|---|---|---| | `ui/tabs` โ€” segmented / pills / line, scrollable, icons, counters, descriptions, lazy panels, router links (also the docs page tabs) | Tabs | 182 | โœ… | | `ui/accordion` โ€” panels or items, tones, lazy content | Accordion | 8 | โœ… | | `ui/stepper` โ€” stepper (linear, vertical) + steps (default / track) | Stepper / Steps | 12 | โœ… | | `ui/breadcrumb` โ€” chevron / slash, router links, commands | Breadcrumb | console crumbs | โœ… | | `ui/menubar` (submenus on the kit menu, mobile menu), `ui/panel-menu` (`panel` and the app `sidebar` look, current route) | Menubar, PanelMenu | sidebar menu | โœ… | | `ui/splitter` (sizes, collapsible, nested, stored state), `ui/scroll-panel`, `ui/toolbar` | Splitter, ScrollPanel, Toolbar | โ€” (parity) | โœ… | | `ui/file-upload` โ€” drop zone or button, previews, validation, upload with progress, form control (own design) | FileUpload | 8 | โœ… | | `@tectra-ng/editor` โ€” own package on the ProseMirror core: toolbar presets, selection menu, links, colours, lists, checklists, images (resize, drag), video, mentions, Markdown shortcuts, Quill HTML in and out, full view, AI; `@tectra-ng/editor/content` renderer | Editor | 6, 16 | โœ… | | `ui/image` (preview with rotate, zoom and pan), `ui/galleria` (thumbnails on any side, indicators, slideshow, full screen), `ui/carousel` (responsive, vertical, autoplay, swipe) | Image, Galleria, Carousel | 2 | โœ… | ## Stage 10 โ€” blocks (`@tectra-ng/blocks`, what PrimeNG does not have) Detailed checklist per block: [roadmap/stage-10-blocks.md](roadmap/stage-10-blocks.md). `@tectra-ng/blocks` is a published package and part of `tectra-ng`. | Block | Usage | Status | |---|---|---| | `filters-panel` (card above a table, popover below 1024px, reset, field state) | 81 | โœ… | | `page-header` | 186 | โœ… | | `empty-state` | **193** | โœ… | | `console-layout` (header + crumbs, icon rail, footer, panel) | 10 | โœ… | | `app-layout` (sidebar + topbar + menu, responsive) | 22 | โœ… | | `wizard` (stages, step head, progress, footer) | 53 | โœ… | | `pinned-tabs` | 1 | โœ… | | `command-palette` | 13 | โœ… | | `kanban` | 6 | โœ… | | `actions-menu` | 6 | โœ… | | `action-tile` | 1 | โœ… | | `topbar-preferences`, `switch-theme` (circle reveal), `switch-language` | 12, 1, 2 | โœ… | | `public-header`, `app-footer`, `cookie-notice` | 5, 7, 4 | โœ… | | `network-status` | 4 | โœ… | | `qr-code` | 1 | โœ… | | `confetti`, `hover-effect` | 7, 0 | โœ… | ## Catch-up โ€” added in the first consumer app after its stage Parts the first app gained after their stage here was planned (usage counted 2026-11-09). Small items; do them before stage 11. Everything else it added is covered under another name: `ring-slider` = `ui/knob` (`arc="ring"`, `txKnobValue`), `keywords-input` = `ui/chips-input`, `link-view` = `ui/link`, `user-avatar` = `ui/avatar`, `confirm-modal` = `ui/confirm`, `upload-file` = `ui/file-upload`, `validation-message` = `tx-field-error`, `editor-preview` = `@tectra-ng/editor/content`, `export-csv` / `export-excel` = `ui/export`. | Item | Usage | Status | |---|---|---| | `ui/avatar` group: `+N` opens a popover that lists the hidden people (avatar + name), a name tooltip on every avatar (`tooltips`, `tooltip` on a single avatar), `morePopover="false"` keeps `+N` a label | 10 | โœ… | | `ui/list-input` โ€” a textarea for pasting many lines (domains, URLs, emails, ids): live parsing with an own parser / validator, duplicate and invalid counters, "Clean up" (drop invalid and duplicates) and "Clear", the parsed array as the value; plural forms in `@tectra-ng/core/i18n` (`formatMessage`, `{count, plural, โ€ฆ}`) | 6 | โœ… | | `ui/truncate-text` โ€” one line cut to a character limit with the full value in a tooltip, search highlight, optional link and copy button (long URLs, ids and names in table cells) | 4 | โœ… | | `blocks/mascot` โ€” a pixel-art SVG mascot in the accent colour with animated states (idle, thinking, happy, sleeping, walking, short tricks) for assistants, empty states and onboarding | 4 | โœ… | | `ui/color-picker` field mode โ€” a text field with a colour dot at its start: type the hex or open the picker from the dot, both in sync, a hex validator | 1 | โœ… | | `ui/avatar` editable photo โ€” pick, replace or remove the photo from the avatar itself: file picker with type and size checks, loading state, a hint, remove behind a confirm, an output with the chosen file (found by the migration audit, 2026-11-11) โ€” `tx-avatar-editor` | 6 | โœ… | | `ui/tag` list with a limit โ€” a row of tags that shows the first N and a `+N` tag with the rest in a popover (found by the migration audit, 2026-11-11) โ€” `tx-tag-list` | 2 | โœ… | ## Stage 11 โ€” charts (`@tectra-ng/charts`) Own SVG charts, no chart library: they render on the server like the rest of the kit, take every colour, font and radius from the tokens (so the themes, dark mode and `dt` work), use the kit's tooltip, legend and empty state, and are reachable from the keyboard. A broad catalogue for any app, not only the first one, built in levels on one core; each level ships on its own. Engine-level maths that is unreasonable to write (a hard layout) may come from a small pure module, decided per item. SVG holds tens of thousands of points with decimation; a canvas renderer can join the same core later. Detailed checklist: [roadmap/stage-11-charts.md](roadmap/stage-11-charts.md). Usage = elements in the first app (2026-11-09). | Level | Charts and features | Usage | Status | |---|---|---|---| | 1. Core | Scales (linear, log, time, band), nice ticks, axes, grid, legend that toggles series, tooltip with a crosshair, responsive size, motion, "No data", numbers and dates in the tectra locale, series palette from tokens, decimation, keyboard and screen reader access | 46 | โœ… | | 2. Basic | line and area (`spline`), column and bar (grouped, stacked, 100%, horizontal), combo (columns + line, two y axes), pie and donut (centre total, legend beside), scatter and bubble โ€” all done | 18, 18, 9 | โœ… | | 3. Lists and grids | bar-list, segmented-bar, heatmap (grid with sticky headers, calendar), treemap, rank-line (positions over time, rank 1 on top, gaps) | 11, 6, 4, 1, 1 | โœ… | | 4. More shapes | radar, radial bar and gauge, funnel, waterfall, bullet | 0 | โœ… | | 5. Special | candlestick (OHLC), boxplot, range area, timeline and gantt, sankey, sunburst, org-chart (pan / zoom canvas, minimap, search) | 2 (org-chart) | โœ… | | 6. Interaction | zoom, pan and brush on an axis, annotations (lines, bands, points), export PNG / SVG / CSV, live updates | 0 (zoom is off in the first app) | โœ… | ## Stage 12 โ€” utils (`@tectra-ng/utils`) โœ… Directives, pipes, services and helpers apps use next to the components โ€” the first consumer app's utility library, reviewed: generic parts kept and extended, parts the kit already covers or that are app wiring left out (list in the checklist), PrimeNG utility directives added. Own package above `ui`, one entry point per utility. Detailed checklist: [roadmap/stage-12-utils.md](roadmap/stage-12-utils.md). Usage = files of the first app (2026-11-11). | Group | Items | Usage | Status | |---|---|---|---| | Package | `@tectra-ng/utils`, docs category `Utilities`, README API tables (pipes, functions, methods, options, constants, providers) on the docs API tab | โ€” | โœ… | | Dates and text | `date` (`txDate`, functions, date range), `plural`, `relative-time`, `currency`, `text`, `file` (file size, download), `number` (`txNumber` in the active locale) | 318, 173, 48, 8, 7, 11, โ€” | โœ… | | Forms | `debounce-input`, `form-validation`, `validators`, `form-changes`, `auto-focus` | 79, 70, 45, 1, 6 | โœ… | | Data | `filter-state` (local storage + URL), `scrolling` (router scrolling for URL list state), `http` (params, retry, status), `polling`, `selection`, `filter`, `stream`, `random` | 70, โ€”, 98, 24, 4, 4, 3, 1 | โœ… | | DOM | `clipboard`, `in-view` (+ visible on scroll; deferred blocks use Angular `@defer (on viewport)`), `go-back`, `stop-propagation`, `drag-scroll`, `scroll-end`, `style-class` | 38, 8, 9, 4, 2, 0, 0 | โœ… | | Services | `clock`, `title`, `breakpoint` | 18, 5, 5 | โœ… | ## Editor backlog (`@tectra-ng/editor`, between stages) Ideas for the editor on top of 9.8, no new engine dependencies. Already shipped: slash menu, tables (rows, columns, header row, column resize), callouts, AI actions on a selection, emoji by `:`, typography, link over a selection, drafts. | Feature | What | Status | |---|---|---| | Block handle | โ‹ฎโ‹ฎ on hover: drag a paragraph, list or table; menu "Turn intoโ€ฆ", "Duplicate", "Delete", "Copy link to block" | โฌœ | | Code blocks | Own light tokenizer (TS / JS / JSON / HTML / CSS / SQL / bash), language picker, "Copy" button | โฌœ | | Image menu | Align left / center / right, caption, alt text, open in preview, replace | โฌœ | | Find and replace | Ctrl/โŒ˜+F inside the editor: highlight matches, next / previous, replace all | โฌœ | | Dates | "Date" item next to mentions, opens the kit datepicker, inserts a localized date chip | โฌœ | | Tasks with due dates | Due date and assignee (`@`) on a task item | โฌœ | | Table of contents | Built from headings, heading anchors | โฌœ | | Export | PDF / DOCX of the text through `ui/export` | โฌœ | | Sticky toolbar | Toolbar sticks to the top while a long text scrolls | โฌœ | | Shortcut sheet | Ctrl/โŒ˜+/ opens all shortcuts and markdown rules | โฌœ | | Word count | Words and reading time in the footer, word goal | โฌœ | | Focus mode | Full view: narrow centred column, toolbar hides while typing | โฌœ | | Table cells | Cell background, merge and split cells | โฌœ | | Hashtags | `#` suggestions for tags or task links on the suggestion engine | โฌœ | | Markdown | `format="markdown"`: read and write Markdown, paste Markdown as formatting | โฌœ | | Templates | Snippets and document templates | โฌœ | | Comments | Comments on text ranges, review style | โฌœ | | Version history | Versions with highlighted changes | โฌœ | | Collaboration | Real-time co-editing (needs a backend, own stage) | โฌœ | ## Stage 13 โ€” code editor (`@tectra-ng/code-editor`) โœ… Detailed checklist: [roadmap/stage-13-code-editor.md](roadmap/stage-13-code-editor.md). Engine: the CodeMirror core (state + view) as a dependency, everything above it our code. The first app edits HTML, CSS, JavaScript and other source text and shows the changes between two versions (16 uses). | Item | Usage | Status | |---|---|---| | Editor: `value` / `valueChange`, `language` (HTML, CSS, JavaScript, TypeScript, JSON, Markdown, plain), `height`, `readOnly`, line numbers, indent guides, syntax colours from tokens (light / dark / styles), search, undo, works with forms | 16 | โœ… | | Diff: inline and side by side views of `original` โ†’ `value`, scroll to the first change, read-only or editable modified side | 1 | โœ… | | Docs, tests, server rendering (a static highlighted view on the server, the editor after hydration) | โ€” | โœ… | ## Stage 14 โ€” developer experience Make the kit easy to try, keep its promises checked in CI and the repository ready for contributors. Detailed checklist: [roadmap/stage-14-dx.md](roadmap/stage-14-dx.md). | Item | What | Status | |---|---|---| | `ng add tectra-ng` | One command installs the packages, adds `provideTectra` with a preset to `app.config.ts` and the fonts to `index.html` โ€” the three manual steps of Getting started | โœ… | | Open in StackBlitz | A button on every docs example opens it as a live, editable project โ€” nothing to install locally | โœ… | | Bundle size check | Size budgets in CI (`npm run size`, own script on a production `ng build`, no `size-limit`): importing one component must not pull the whole kit, CI fails when a size budget grows or a new entry point is pulled in โ€” guards "tree-shakable" | โœ… | | Test coverage 95% | The same setup as the UI kit of the first consumer app, on our Vitest runner: coverage always on in the `test` target of every package with tests (`coverage: true`, include `src/**/*.ts`, exclude specs, `index.ts` and test setup), `coverageThresholds` statements, branches, functions and lines โ‰ฅ 95% (`@vitest/coverage-v8` as the only new dev dependency), so `npm run test` and CI fail below it; coverage report in CI with a README badge; a step toward the silver OpenSSF Best Practices level. Raise the packages below 95% first (lines / branches of each package's own files on 2026-11-12; all packages together: 87% of statements): themes 100 / 94, core 96 / 86, icons 100 / 96, qr 99 / 98, utils 96 / 88, charts 93 / 76, ui 90 / 82, blocks 90 / 79, code-editor 86 / 73, editor 64 / 57 || โœ… | | Link check | Weekly workflow that checks every link in the READMEs and the built docs site, so a broken link is caught before a user finds it || โœ… | | Best Practices silver | The silver level of the OpenSSF Best Practices badge: `GOVERNANCE.md` (who decides, how to become a maintainer), roles and responsibilities, access continuity if the maintainer is away, test coverage from the item above | โฌœ | | Smaller base bundle | The base the first size check found: theme tokens, locale texts and icons of the whole kit came with the first component, the table loaded its editors at start. Now each component brings its own tokens and icons, only English ships, the table loads its editors on first use โ€” each app ships only its own style โ€” `provideTectra` alone 159 โ†’ 15 kB, a button 276 โ†’ 90 kB at start. Details in the checklist | โœ… |