Skip to content

Docs: owner fixes of 2026-11-11 (recipes, copy, smart pages, palettes, functions) - #19

Merged
zabarov merged 53 commits into
mainfrom
docs/owner-fixes-1111
Nov 11, 2026
Merged

zabarov merged 53 commits into
mainfrom
docs/owner-fixes-1111

Conversation

@zabarov

@zabarov zabarov commented Nov 11, 2026

Copy link
Copy Markdown
Contributor

Owner-reviewed documentation fixes from 2026-11-11, accepted on ui-doc.test; the owner approved sending them to ui.simai.io.

Demo API keys in the copy recipe examples were changed to neutral demo strings (demo-live-key-..., demo-test-key-...) so push protection no longer reads them as Stripe keys; the strings were fake and are now unmistakably so.

Commits (52):

  • Palettes: the status example fits a phone column
  • Smart guide: the comparison names the shipped table verbs (GS-05)
  • Palettes: status roles are hues of the static palette
  • Reference tables: the name column is wide enough for its names (C10 A)
  • Buttons: cycle values are visible, the theme cycle has its own frame
  • Toast placement example: a fixed-height frame, no height loop
  • Smart menu: the examples draw the C30 looks on the pair
  • Menu: group headings are a row's height and type in the muted ink (C30, R070)
  • Guide: «Формы: фон и группировка»; settings recipe, cart, support form and field looks follow C52
  • Smart menu: the C30 path sign, overflow more, open-on and search in the page text
  • Pin SIMAI Framework ui-2bd5a3ab478a with Docara 3.14.1 and package pro dc13c0f (local)
  • Copy recipe: table cells keep the value and its button on one line
  • Docs text carries no counts that change between releases (D19, R117)
  • SF.Position example: one anchored panel that follows, flips and shifts (R116)
  • Copy examples: code scenes copy with sf-button-copy over the block
  • Copy examples: code blocks render on the page so the code block draws its own head
  • Copy button: whole field value, code block without line numbers, distinct names
  • Recipes: «Копирование» from the copy demo (C48)
  • Functions examples: createAsync builds a quantity field, ensure waits 2 s
  • Functions examples wait for the Loader to exist before reading window.SF
  • Links: SF.notify points at its function page, the old toast fragment was missing
  • Guide: «Функции» section, one page per author-facing Framework function (D17, R103)
  • JavaScript API: the page becomes the index of window.SF by layer (D17, R103)
  • Docs: drop comparisons with other systems (D16, R100)
  • Recipes: «Как делать» block -- each example in a role-coloured frame with its own «Правильно» / «Неправильно» lab
  • Recipes: notifications -- bell counts unread, popover with day groups and a read filter
  • Recipes: overview -- attention list first, metric tiles two by two, last events
  • Recipes: filters in a drawer -- applied filters as tags, live «Показать N» count
  • Recipes: empty section -- one first action, header action only after the first record
  • Recipes: delete -- own with undo, shared asked in the row, final in a window with the name typed
  • Recipes: settings form -- card sections, quiet cancel, error under the field, toast on save
  • Recipes: record card -- facts as text with «Не указан», menu for the rest, history timeline
  • Recipes: resource list -- header with count, search, two-way filter, rows, nothing-found
  • Recipes: new section with the eight-screen index and why they were chosen
  • Surfaces page: «Фоны в компонентах», component to background table, plate inside a card, coloured places, density (C41, C42)
  • Palettes page: «Почему эти тона», role to tone table, alpha in place of extra tones, world comparison (C43)
  • Smart feedback and navigation pages: former-name paragraphs out, phone layouts of contents, spinner and settings examples, pager checkbox, dropdown
  • Smart content pages: old names out, kind on list items, accordion and file-preview events, gallery title, icons wording (SC-S04, LI-04/05, AC-01/03,
  • Smart forms pages: current event and selector names only, theme generator statuses (forms-b pre-review)
  • Class component pages: old names out, catalogue leads, content slider under media
  • Guide smart components: current facts, no release history, unbuilt parts marked
  • Guide foundations: height instead of spacing, shipped colour and shadow values
  • Docs shared pass: D13 attribute lines, D15 event logs, retired names, short tab labels
  • Reference sections: version badge line on sf- class pages from the passport
  • Forms index: a lead and a choice table, one wording style in the list
  • Rich text page: current names, a key table, a news editor, short example tabs
  • Lookup page: fourth standard, a provider example with paging, empty, error and unavailable, an assignee
  • Textarea page: fourth standard, the message composer fills its row, a support request, inherited text
  • Quantity page: fourth standard, a cart, steppers as wide as their number, real labels and error
  • Text field page: fourth standard, a real form, every size, inherited value, fixed error and mask examples
  • Download file page: sizes side by side, prepared files carry their size, short tabs, no dated old names
  • Copy button page: label column with aligned values, long address wraps on a phone, no dated old names

🤖 Generated with Claude Code

zabarov and others added 30 commits November 10, 2026 03:31
…s on a phone, no dated old names

Docs review CB-11 (one value axis, C33), CB-12 (the documentation address
breaks anywhere instead of running past the card at 390), S-02 (the
appearance alias lives on the names guide only), and a short example tab.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ze, short tabs, no dated old names

Docs review DF-14 (each size beside an icon button of the same step; the
ladder reads 28, 32, 40, 48, 56), DF-15 docs side (the prepare examples set
file-size with the address, so no HEAD to a blob URL), DF-17 (two- or
one-word example tabs fit at 390), S-02 (icon and download aliases stay on
the names guide).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…value, fixed error and mask examples

Docs review forms part A for sf-input: attribute line under each heading
(FA-01), when to take and not to take it (FA-02), specimen grids (FA-04),
an application form with the example log (FA-05, IN-02), descriptions for
every attribute in the reference (FA-06), no jargon in the class line
(FA-10), sizes 1/3 to 3 beside buttons and radius (IN-01), no Ctrl K text
in the field (IN-03), no old names (IN-04, IN-08), inherited value (IN-05),
number and when to take Quantity (IN-06), an error that clears (IN-07), a
mask whose value and hint agree (IN-10), title in the singular (IN-11).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ber, real labels and error

Docs review QT-01 (example widths fit the number), QT-02 (the snippet
queries sf-input-quantity), QT-05 (no money stepper), QT-06 (more than in
stock), QT-07 (real field labels in specimen grids), QT-09 (no error
alias), QT-10 (a cart with line totals and the example log), and FA-01,
FA-02, FA-04, FA-05, FA-10.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… support request, inherited text

Docs review TA-01 (the composer's field takes the free width), TA-03 (the
snippet queries sf-input-textarea), TA-05 (flush is a value of the look
table, the composer a task, no selector jargon), TA-06 (focus() folded into
working from code), TA-08 (inherited value), TA-09 (a support request
form), and FA-01, FA-02, FA-04, FA-05, FA-06, FA-10.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…error and unavailable, an assignee

Docs review LK-01 (search answered by the site with a pause, «Показать
ещё», nothing found, retry, unavailable, exclude), LK-02 (the snippet
queries sf-input-lookup), LK-10 (a single assignee with avatars), LK-11
(when not to take it), and FA-01, FA-02, FA-04, FA-05, FA-06.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ple tabs

Docs review RT-03 (sf-input-rich in the snippet, no internal names in the
text or reference), RT-08 (says there is no class version), RT-09 (keys as
a Mac / other systems table), RT-10 (the toolbar grows with the size),
RT-11 (a news editor with the example log; paste cleaning to try in the
first example), RT-12 (example tabs that fit at 390). The toolbar, heading
scale and link panel wait for a study.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Docs review FX-01: the group index takes a written lead from
config/catalogue-group-leads.json (description, a «what to take» table,
then the list under its own heading); groups without a lead stay as
generated. FX-03: every list line says what the field does for the person.
Links to the text field use its singular title.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ssport

Class component pages now carry the same tag and version badges as Smart
pages (D13/D12 group). The audit checks badges on every sf- block page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… short tab labels

- D13 attribute lines under look/state/size sections on Smart and class pages
- D15 event logs on overview examples of 28 Smart pages and six class pages
- link -> ghost in examples and text (C15), alert-bar danger -> error,
  sf-modal label= -> heading=, size 1/3 height 28 in tables
- D12 leads that started with a class rewritten (card, figure, procedure,
  close, datepicker, dot, smart tooltip TT-03)
- icon-buttons look/scheme specimen grids (IB-01/03/04), list LS-01
- example tab labels shortened so the strip fits at 390 px

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ow values

GF-02/03/23 the size ladder, vertical sizing, settings and glossary teach
height (low/default/high/highest) and sf-button--height-* instead of the
deprecated spacing; GF-06 button values default/tonal/outline/ghost, scheme
on-surface-variant, status danger (C13); GF-07 old-name table removed;
GF-08/09 dark outline neutral-90 at 48, 4.1:1; GF-10 disabled ink is the one
translucent role; GF-11 reworded to the shipped 18/26 px title heights;
GF-12 elevation-4 shadow is modal; GF-13 text sizes below 1/4 are leaving;
GF-15 on-surface-disabled; GF-18/19/20 mark, info and paper values; GF-21
compatibility notes removed; GF-22 four places; GF-25 zones stack on phone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rts marked

IX-01/02/03 standard 1.3.15, no release ids in the status box; MD-01/02/03;
PG-02/03/04 current event names, head lines of the page; GS-06 one event
template <tag>-<verb>; GS-07 alias notes removed; FD-01/CM-02/PK-01 D31
wording (Framework and its component sets); FD-02/03/04, FP-01..04, RT-01/02,
DT-01..03, QL-01/02, AI-01/02 release history and stand figures out;
MK-01/02 template syntax is the standard's target, real sf-switch snapshot;
AS-01, GS-04 illustrative tags marked; SL-01 accepts/each slots and EN-01
settle marked as not in the runtime; RL-01 real actions; FM-01..03, FR-01,
LY-02/03, LK-01/02, AC-01..03, NM-01/03, CM-01/03/04.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… under media

Content: S-04 old-name paragraphs (accordion legacy, divider buttons,
featured-icon light/mid/dark/modern/clear, icon one-dash names,
reference-link __ parts), CD-01 focus example on sf-button, AV-01 company
badge drawing, AV-02 avatar sizes, AV-04 outline add button, FL-03 country
names, FG-02, DC-01/02, HL-03, TG-04 info tag, CI-02 descriptions, emoji
page «Эмодзи».
Navigation and rest: CP-01 @simai-studio/ui, CX-02/03 and CFX-02/03, CBX-02
catalogue names, DL-03, LN-02, DD-04, TR-04, SB-01 alias text, MN-03 four
levels (C30), TH-02/03 theme choice pressed at load, desktop_windows icon.
Forms and feedback: CTA-01 no blocked submit, CQT-01 reset label, CCC-01
two columns, CAL-01, CSK-01, CSP-02 specimen layout at 390/1440, CSP-01
pixel spinner attributes moved to the names guide, dot statuses that differ
in colour.
Leads and choice tables for the class actions, forms, navigation, feedback,
content groups and the Smart feedback and navigation groups (CI-01, IX-01,
CFX-01, CBX-01, AI-01). The content slider moves to «Слои и медиаконтент»
and Smart «Содержимое и медиа», with redirects.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ator statuses (forms-b pre-review)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… file-preview events, gallery title, icons wording (SC-S04, LI-04/05, AC-01/03, FP-01/04, GA-02/03, IC-01/02, LF-01/02, TM-02, INC-03)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…e layouts of contents, spinner and settings examples, pager checkbox, dropdown trigger room, tree selection name (S-08, CT-01/02, SP-02, SE-02, PR-01, DD-03/04, TR-01, TT-01)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…of extra tones, world comparison (C43)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…late inside a card, coloured places, density (C41, C42)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…osen

Adds «Рецепты» after the references in the header and lets the two header
audits expect it: recipes assemble reference parts into screens.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rows, nothing-found

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rest, history timeline

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…e field, toast on save

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… window with the name typed

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…the first record

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ть N» count

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ast events

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… and a read filter

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…with its own «Правильно» / «Неправильно» label on top (R101)

The label sat between two examples and «Так / не так» read poorly. Every
do/don't figure is now one card: border-success or border-error around
it, a tinted first row with check_circle / cancel, the word and the
explanation, then the example. Framework utilities only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Palettes: «Почему эти тона» becomes «Тона, прозрачность и роли» -- the
tones, the alpha families and the role-to-tone table, without the
cross-system survey, the «Сколько у других» table or Material lightness
matches. Colour roles and palettes no longer say they follow Material.
Legacy English pages lose their Material, Google theme builder and
Bootstrap references; the glossary loses its Bootstrap entry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…, R103)

The generator groups every public name of core/contracts/public-js-api.json
by what brings it (core, Loader, Smart base, component script) and links each
row to its function page or the page that describes it; a component's script
API links to the component page. Short lines and links live in
config/js-api-index.json, and --check fails when a public name has no row or
a row names no public name. Internal names are no longer listed; the
readingPosition and format sections moved to their function pages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
zabarov and others added 23 commits November 10, 2026 14:59
…on (D17, R103)

Twenty-one function pages in five task groups (loading, text and language,
page actions, screen and scrolling, a person's choices), each with what it
does, the call, when it is available, a live sandbox example with the
example log, edge cases and see-also. Facts taken from the contract, the
ui-source modules at a29cc99 and a browser probe on ui-b4a77681f0a7. Set
functions are not documented here; SF.package says how a set exposes them.
Links from copy-button, include and list-feed point at the new pages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…was missing

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The example frame runs its script before core.js, so window.SF was undefined
on every load.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… 2 s

SF.createAsync('tag') asks for component/tags/js/tags.min.js, which the docs
runtime does not carry, so the create example drew a 404.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Five scenes on sf-button-copy and the code block: API key field copied whole,
code block without line numbers, table row with per-row names, several
buttons with distinct names, browser refusal with the selection and a visible
hint. Do/don't cards, copy for AI, listed in the recipes index. The attribute
route (data-sf-copy) waits for its Framework build: TODO in the source.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…inct names

Three examples from the copy demo, the visible refusal hint pointed at the
recipe, and a link to the «Копирование» recipe (C48).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… its own head

A sandboxed example frame does not load the code block component, so the
numbered block showed plain text without its copy button.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Inline, the docs page turns the block into its own code shell, whose copy
puts the line numbers into the clipboard; a sandboxed frame does not load
the code block component. The scenes now show the button over a block
without its head, with «В буфере» proving the text.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s (R116)

A scrolling frame with the anchor at its inline end and a panel saying which
side the last calculation chose; one-line caption on what to watch.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Generators drop the counts: catalogue group descriptions, the all-variables
lead, the retired-classes line. Hand-written pages and the theme
translations say what without how many.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
At 390 px «Открыть» broke letter by letter.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…o dc13c0f (local)

The pair is ui Build 2bd5a3ab4 (the runtime), bind c4d7d46f4 (the release
lock contracts/releases/ui-2bd5a3ab478a.lock.json), ui-source d25a01f9,
ui-builder 16e9a81, npm 5.20261110.1541, core.runtime 1.51.0. Docara moves
to v3.14.1 (5dff9b70); the runtime is materialized again after the update.

The Pro package is ui-pro dc13c0f (feat/admin-menu-c23-c24), builder
16e9a81, built over this pair: 722 files, archive sha 83741f60, the same
bytes as the Framework take's build. No pro-<12> release exists over this
pair yet; before this is pushed the pin moves to the released pro id.

Generators: the «Устаревшие» row of a class table no longer lists the
general status rename (danger -> error) for a block whose own journal
record goes the other way (C13: a control says danger); sf-button and
sf-icon-button now list error -> danger only. The button scheme example
and its text use sf-button--danger, with the surface look drawn (C13).

The reference adds Russian text for 91 new manifest strings (progress
run, attention list, list description, menu C30, view layout switch,
heights, kbd) and 8 public variables. The version sync moves every pinned
value; the block kit link names 5.20261110.1541; standards and ports sync
(simai.dataview-port 1.15.0).

C20 follow-up: elevation-N are former names. The «Высота» utilities page
teaches the pair of a place's surface and shadow, its examples draw the
four places, and the position example, «Фоны» and «Что такое компонент»
stop naming elevation classes; one line keeps the former names.

Reviews recorded: menu contract (the page states the C30 path sign: a
medium label and a 2 px line on a bordered column or a panel's border,
the horizontal row's line under the section, the side branch's ›),
composition contract (sf-button gains full-width, additive), smart
lessons (field renderers byte-identical; loader scans at DOM parsed,
smart-base may hold slotted children; no lesson states either).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…he page text

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…m and field looks follow C52

Owner decision C52 (R107, R108, R110): a form has no background of its
own. A new guide page under «Токены, цвет и темы» says where a form
stands (page, a card per settings section, no cards inside a drawer or
modal, never straight on the grey area), which field to take (bordered by
default; filled only for search and filters over a table, on a white
place, never mixed), the spacing ladder as tokens, fieldset and legend
without a frame, rows only for parts of one answer and widths by answer,
the phone. Six examples: a short form on the page, settings cards, a form
in a panel, filters over a table, rows and widths, do and don't.

Recipe «Форма настроек»: an address section with city and postcode in one
row and widths by answer, a do/don't pair (a section card vs a filled
field on the grey area), the bordered-only rule, the drawer and phone
notes, the AI copy rules and markup.

R110: the quantity cart is an sf-card, not the area colour. R118: the
support form on the textarea page sits on the page. R119: the filled
textarea is captioned as for search and filters only; the inputs and
textarea «Вид» texts follow C52. The filled grey itself (C41, 8 %) is
not in the pinned pair.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…0, R070)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Smart menu page showed six of ten examples in the default look (a box
per row, no current plate). Every example now uses appearance="navigation"
and the page follows the prototype prototypes/menu-simple.html:

- site row in sf-header-site: «Ещё» (overflow="more"), the current section's
  2 px line on the header border, no icons;
- the row's panels (second level below, third beside, the path line on the
  panel border), opened from code since a row ignores open: true;
- mega menu: «Каталог» with region, columns drawn from its children;
- site column, bordered, with search, four levels;
- simple admin: icons on the first level only, two levels, compact density,
  group headings;
- phone: sf-header-site collapse="always", the tree in the side panel with
  the path open;
- indicator line and fill side by side; markup, current, disabled and
  status examples in the navigation look with a visible current page.

The navigation section's text and state table now say what the pair draws
(current page = primary container plate, open branch grey in the row only).
The class menu page: the horizontal and four-level examples carry
sf-menu--navigation with a current page, and the current-item example adds
a bordered navigation column whose closed branch holds the current page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The fixed toast container sat directly in a frame that sizes itself to its
content, so the toast taller than the frame moved the measure on every
frame (58 <-> 62 px, about 150 changes in 7 s) and was clipped. The example
now stands in a 12rem box with contain: layout, which holds the fixed
container: the toast sits in the box's corner and the frame keeps one
height (198 px at 1440 and 390, light and dark, for the toast's 5 s).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The speed values shared one icon, so 1.5 -> 2 changed nothing visible. The
values now have no icon of their own: the label (1×, 1,5×, 2×) is the text
beside the button's icon-start, and aria-label «Скорость» starts the name.
A sort cycle shows the other form (an icon per value). The theme cycle
moves to its own example with theme_switch=true: the Loader's theme works
there, and a press changes the theme inside the example only. The text
explains both forms and the code sample uses the visible-label form.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
C10 variant A (owner 2026-11-11) lets code in a table cell break anywhere,
so one long value never widens the table; the documentation gives the name
column a width so names usually stay whole. A page transform marks the
first header cell of a reference table (most body rows start with a cell
holding code alone) with min-inline-size: its longest name, at most 24
characters, plus room for the padding.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Owner 2026-11-11: a status is not a colour of its own; it takes a hue of the
static palette (error red, warning amber, success green, info blue, sky in
the next release). The page says so where it listed status palettes, and a
live example shows each status role beside the tones 40 and 80 of its hue
and its container, so the reader sees they match in either theme. Counts
are not written into the new text.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
sf-table-query and sf-table-apply are former names; the pair's Pro table
sends sf-view-table-query and sf-view-table-apply.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
At 390 the info row's note took the hue column's width and the containers
were cut off. The note now wraps in a narrow block, the heading is shorter,
and the containers wrap under the swatches.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The /proto/ pages exist only on the local review site, so the Pages build
failed its local-reference check. The 'still on the way' notes keep their
text; the prototype link goes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@zabarov
zabarov merged commit cca8187 into main Nov 11, 2026
5 of 8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant