[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7551NAPRWVHKF4HM580MPZP":3,"skill-same:01M7551NAPRWVHKF4HM580MPZP":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M7551NAPRWVHKF4HM580MPZP","recursica-skill-transfer-list",null,"Rules for the Recursica transfer list — two lists side by side with buttons that move items from one list to the other, when a list of options is long enough to need a transfer list, the filter, and moving items without dragging. Use for assigning items to a group or picking columns. Not for a short list of options — see recursica-skill-checkbox; not for one value — see recursica-skill-dropdown.","borderux\u002Frecursica-knowledge","borderux","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F14911137?v=4","01M754SG94XX2Y7176KM2WGZG3","Border LLC","01M754SGA9E7YSNK6NWVMKMHYC",1,"MIT","https:\u002F\u002Fgithub.com\u002Fborderux\u002Frecursica-knowledge\u002Fblob\u002Fmain\u002Fskills\u002Fcomponents\u002Frecursica-skill-transfer-list\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: recursica-skill-transfer-list\ndescription: Rules for the Recursica transfer list — two lists side by side with buttons that move items from one list to the other, when a list of options is long enough to need a transfer list, the filter, and moving items without dragging. Use for assigning items to a group or picking columns. Not for a short list of options — see recursica-skill-checkbox; not for one value — see recursica-skill-dropdown.\nlicense: MIT\nmetadata:\n  author: hi@borderux.com\n  version: 0.2.0\n---\n\n# Transfer list\n\nA transfer list shows two lists of options side by side. An item is one option in a list. Move buttons move items from one list to the other. For example, one list holds the people available, and the other list holds the people on a team. A transfer list is also called a dual listbox, because each list is a listbox (a list the persona picks one or more options from).\n\n> **The transfer list is not built yet. Instead of building a workaround, follow the steps under \"Missing components\" in `recursica-skill-design-router`.** Both adapters (the Recursica component library for one framework, such as Mantine or Angular Material) ship the transfer list as a stub (an empty placeholder). A transfer list placed on a screen today shows only placeholder content, and no error. The adapters also apply none of the 31 `transfer-list` tokens (named design values, such as colors or sizes, set by the design system) that the UI kit (the token file, `recursica_ui-kit.json`, that says which variants and states each component has) exports. The rules below describe the intended transfer list, and the rules match the UI kit.\n\n## When to use a transfer list\n\n- **The list of options is vast, and the persona picks only a few.** For example, the persona picks 3 of 100 options. In a checkbox group, the 3 checked options are hard to find. The transfer list shows the selected options in a separate list, so the persona never searches for the selected options. A short list, such as 10 options, needs only a checkbox group.\n- **The items not chosen matter as much as the items chosen.** Examples are assigning people to a group, picking the columns of a report, and choosing which options a setup includes. The persona needs to see the items left out, not only the items chosen.\n- **Each item is either included or excluded.** Two lists show at a glance which items are included. Checkmarks spread through one long checkbox group do not show the included items at a glance.\n- **The persona moves many items at once.** The persona selects several items, then moves all the selected items in one action.\n\n## When not to use a transfer list\n\n| Situation                                                                                           | Use instead                                                                                                                                                                                                                                                |\n| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| The list has only a few options                                                                     | A checkbox group. See `recursica-skill-checkbox` and `recursica-skill-selection-controls`.                                                                                                                                                                 |\n| The persona chooses exactly one value                                                               | A dropdown or a radio group. See `recursica-skill-dropdown`.                                                                                                                                                                                               |\n| The persona chooses any number of options, including none, and the options not chosen do not matter | A multi-select dropdown. See `recursica-skill-selection-controls`.                                                                                                                                                                                         |\n| The container is too narrow for two lists side by side                                              | A different component. Each list has a fixed width.                                                                                                                                                                                                        |\n| The persona puts items in order, instead of including or excluding items                            | If the theme (the design a designer sets in Theme Forge: the token values, the components, and each component's variants, states and sizes) has an ordering variant for the transfer list, use the ordering variant. Otherwise, use a different component. |\n| The items are saved records with actions, such as Edit and Delete                                   | A table. See `recursica-skill-tables`.                                                                                                                                                                                                                     |\n| The persona viewing the screen cannot change which items are included                               | A read-only field. See `recursica-skill-read-only-field`.                                                                                                                                                                                                  |\n\n**A transfer list fixes one problem in how a screen is built.** The problem is a list of options too long for a checkbox group. For example, twenty checkboxes that need a \"Select all\" checkbox are the wrong control, as `recursica-skill-selection-controls` says. A transfer list replaces those twenty checkboxes. Where nine checkboxes would do, a transfer list is also the wrong control.\n\n## Variants\n\n**Use only the transfer list variants and options that the knowledge MCP server lists for the theme.** A designer can add variants and options in Theme Forge, so each theme can differ. Get the list with the server's `component_api` tool, and use the names the code uses. A wrong name in code has no effect and shows no error. Never invent a variant or an option.\n\nThe rules below describe each option by role, such as \"the error state\". The names in the standard UI kit (the unchanged UI kit in the official Recursica release) are examples only.\n\n- **The transfer list has an error state and a disabled state.** In the standard UI kit, the state variant is `states`, with the options `error` and `disabled`.\n- **Do not build a separate search field or heading above the transfer list.** The transfer list component shows a header with a title, a filter and both item lists. A filter is a search field that narrows a list to the matching items.\n- **The transfer list's height and width are fixed.** Neither the height nor the width is an option. Both lists are the same size, however many items each list holds.\n- **A move-all control is not wanted.** See the move-all rule under Rules.\n\n**Label placement is a variant.** A control's label sits beside the control or above the control. In the standard UI kit, the variant is `layouts`, with the options `side-by-side` and `stacked`. The label beside the control is the house default. The label above the control is the fallback when the form's container is too narrow for both side by side. The container's width decides, not the viewport's width. See `recursica-skill-forms`. The label placement variant does not arrange the two lists. The two lists always sit in two columns.\n\n**Set label placement explicitly on every field.** The house rule puts the label beside the input. The code library under an adapter may put the label above the input by default, at every container width. Set the label beside the input on every field. Use the names the code uses for the variant and the option.\n\n**Label placement is one decision per form, not per field.** This field uses the same label placement as every other field in the form. Apply the container-width test once, to the whole form. The result sets the placement of every field in the form. Short fields that would fit side by side follow the result too. A form may change placement at a breakpoint. A form never mixes placements at one breakpoint. A form section never gets a separate placement. `recursica-skill-forms` sets this rule.\n\n## Rules\n\n**Give each list a name that tells the two lists apart.** Use the product's words, such as \"Available\" and \"Selected\", or \"Excluded\" and \"Included\". Without names, the persona cannot tell which list holds the chosen items.\n\n**Always include the filter. Give the filter a label that names the list the filter searches.** For example, label the filter \"Search available people\". A list long enough for a transfer list is too long for the persona to read every item.\n\n**Keep selecting an item and moving an item as two separate actions.** For example, the persona selects three people in \"Available\", then presses the move button once to move all three.\n\n- Selecting, or checking, an item marks the item to be moved.\n- Moving the item puts the item in the other list.\n- Do not move an item when the persona selects the item.\n\nMoving many items at once is the reason a transfer list exists.\n\n**Do not build a move-all control.** For example, a \">>\" button that moves every item to the other list is a move-all control.\n\n- Use the filter to work with a long list, and keep the filter.\n- A list so long that a move-all control seems necessary is a sign that the screen is built wrong.\n- Raise that problem with the user instead of adding a move-all control, as `recursica-skill-design-system-conventions` says.\n\n`recursica-skill-selection-controls` treats a need for select-all as a sign to reconsider the control.\n\n**Sort both lists the same way, and keep the sort order the same after a move.** When the persona moves an item back and the item shows up in an unexpected place, the item looks lost.\n\n**Put the transfer list in the form's single column, and never inside a card.** A transfer list is a form control. `recursica-skill-forms` sets this rule.\n\n**Give the transfer list a real label, such as \"Team members\".** Put the selection rules in assistive text (help text shown with the control). The selection rules are:\n\n- the minimum number of items\n- the maximum number of items\n- what the two lists mean\n\nFor example, one selection rule is \"At least two must be included\". Put the rule under the transfer list, not in a validation message after the persona makes a mistake. See `recursica-skill-label` and `recursica-skill-assistive-element`.\n\n**Pair the error state with a signal that is not color, such as an icon or error text.** `recursica-skill-design-system-conventions` requires the second signal.\n\n**Let each list scroll inside the transfer list's fixed height.** A long list always scrolls. The filter narrows a long list.\n\n**Never disable a transfer list to show which items are included.** If the persona cannot change the included items in the current context, show the included items as read-only content.\n\n## Accessibility\n\nThe rules below add to the accessibility baseline in `recursica-skill-design-system-conventions`, including the focus ring, which every Recursica component follows.\n\nThe app must add every behavior listed under \"Screen readers\" and \"Keyboard and non-mouse navigation\". A transfer list with arrow buttons often works only with a mouse.\n\n### Screen readers\n\n- **Give each list a separate accessible name** (the name a screen reader reads out for a control). Without an accessible name, a persona using a screen reader hears a list of items. The persona cannot tell which list holds the items and cannot use the transfer list.\n- **Set the selected state in code, not by color.** Assistive technology does not treat an item with only a tinted background as selected. `recursica-skill-design-system-conventions` sets this rule.\n- **Name each move button with what moves and where**, such as \"Move selected to included\" or \"Remove selected from included\". A name like \"Right arrow\" or \">\" does not say what moves where. Two arrow buttons with no labels cannot be told apart.\n- **After a move, announce the result.** Announce the items that moved, and how many items each list now holds. The persona cannot see both lists change at once.\n- **When the filter changes a list, announce how many items the list shows**, such as \"3 of 120 shown\". Without the count, a persona using a screen reader hears a list that seems to empty for no reason.\n- **Each list's item count should be available.** The persona can then learn how many items a list holds without going through every item.\n- **Do not announce the same event twice.** When a move's result is announced, do not also announce every item again as focus lands on each item.\n\n### Keyboard and non-mouse navigation\n\n- **Every step of a transfer must work from the keyboard, with no dragging.** Selecting items, moving the items, and moving the items back must all work with keys alone. Drag and drop may be added as an extra way to move items, and never as the only way.\n- **After a move, put focus in a chosen place.** Put focus on the moved item in the item's new list, or on the move button that still applies. Never leave focus on a control that has just become disabled. Never let focus drop back to the top of the page.\n- **Make each move button a real button, pressed with Enter and Space.** Make the move buttons tab stops (places the Tab key lands), in visual order, between the two lists.\n- **Disable a move button when the move button has no item to move.**\n- **Make the tab order follow the visual order**: label, filter, first list, move buttons, second list.\n- **Do not move focus for the persona**, except to put focus in a chosen place after a move. Typing in the filter must not move focus into the list the filter searches.\n- **Do not show a control, label, count or other content the persona needs only on hover.** The rule covers the move buttons, a remove control on each item, and the item counts.\n\n## Styling set by tokens\n\n**Never set or override the transfer list's styling.** The theme sets every visual property of the transfer list, such as size, spacing, borders, colors and animation. Do not add extra containers or spacers to change the transfer list's look. If the design needs a look the theme does not give, report the missing look as a design-system gap. See `recursica-skill-design-router`.\n\n## Related skills\n\n- `recursica-skill-selection-controls` — the rules for choosing among selection controls:\n  - which selection control to choose\n  - the most options each selection control can hold\n  - select-all as a sign that the screen's structure is wrong\n  - disabled versus read-only\n  - when a selection is saved\n- `recursica-skill-working-memory` — the research behind the 7 ± 2 guideline. The skill also says why list length depends on the task:\n  - A list the persona scans to recognize an item may be long.\n  - A set of items the persona compares may not be long.\n- `recursica-skill-forms` — the form rules a transfer list follows:\n  - the single-column layout\n  - one label placement per form, and the container width that sets the label placement\n  - validation\n  - save mode\n  - the rule against a form control inside a card\n- `recursica-skill-label` — the transfer list's label, and the label for a group of fields.\n- `recursica-skill-assistive-element` — the help text for the selection rules, and the error message.\n- `recursica-skill-design-system-conventions` — the screen-wide rules:\n  - showing meaning in more than one way\n  - fixing the screen's structure instead of adding a feature to work around a problem in the structure\n\n## Open questions\n\n- **Where the transfer list fits among the selection controls.** Past the option limit, `recursica-skill-selection-controls` sends a choice of any number of options, including none, to a multi-select dropdown. `recursica-skill-selection-controls` never mentions a transfer list. No rule says at how many options a transfer list replaces the multi-select dropdown.\n- **Checkboxes on each item.** Only the design-system website shows a checkbox on every item. Nobody has settled whether the items are rows with checkboxes or items in a selectable listbox. Confirm with the user before relying on a checkbox on each item. Skip that confirmation when the theme has a checkbox option for an item.\n- **Narrow containers.** The label placement variant moves only the label, and the lists have a fixed width. The transfer list has no responsive behavior. `recursica-skill-responsive-layout` sets what a narrow screen may leave off.\n- **Empty states.** No rule sets an empty state for either list, including the starting state where every item is in one list. Confirm with the user only when the theme has no empty state.\n- **Ordering.** No rule says whether items are sorted alphabetically, keep the original order, or can be reordered by the persona.\n- **Disabled items.** No rule says whether a single item can be disabled, locked in one list while the other items move. Confirm with the user only when the theme has no disabled state for a single item.\n\n## Pre-flight checklist\n\n- [ ] The list of options is vast, and the persona picks only a few. The selected options show in a separate list. A checkbox group and a dropdown were ruled out for those reasons.\n- [ ] Both lists have visible names that tell the two lists apart, and each list has an accessible name.\n- [ ] A filter is present, and the filter announces how many items a filtered list shows.\n- [ ] Selecting an item does not move the item. Items move through the move buttons.\n- [ ] Both lists use the same sort order, and the sort order stays the same after a move.\n- [ ] Each move button's name says what moves where. Each move button is a real button, pressed with Enter and Space.\n- [ ] Every step of a transfer works from the keyboard, with no dragging. Any drag and drop is an extra way to move items.\n- [ ] After a move, focus goes to a chosen place.\n- [ ] After a move, the result is announced: the items that moved, and the new count in each list.\n- [ ] The selected state is set in code, not shown by highlight color alone.\n- [ ] No move-all control was built.\n- [ ] A list long enough to seem to need a move-all control was raised with the user as a screen-structure problem.\n- [ ] The transfer list has a real label, with the selection rules in assistive text.\n- [ ] The label placement matches every other field in the same form, with one placement per form, as `recursica-skill-forms` requires.\n- [ ] The error state has a signal that is not color. The label, the help text, and the error text are set through the transfer list component.\n- [ ] The tab order runs: label, filter, first list, move buttons, second list.\n- [ ] The transfer list is in the form's single column, and not inside a card.\n- [ ] Every variant, size, and state is one the theme's UI kit lists, and no variant or option is invented. No header, filter, or wrapper is built by hand.\n- [ ] No styling is set or overridden on the transfer list. No container or spacer is added to change the transfer list's look.\n- [ ] Open questions were asked about, not decided: item checkboxes, ordering.\n","# Transfer list\n\nA transfer list shows two lists of options side by side. An item is one option in a list. Move buttons move items from one list to the other. For example, one list holds the people available, and the other list holds the people on a team. A transfer list is also called a dual listbox, because each list is a listbox (a list the persona picks one or more options from).\n\n> **The transfer list is not built yet. Instead of building a workaround, follow the steps under \"Missing components\" in `recursica-skill-design-router`.** Both adapters (the Recursica component library for one framework, such as Mantine or Angular Material) ship the transfer list as a stub (an empty placeholder). A transfer list placed on a screen today shows only placeholder content, and no error. The adapters also apply none of the 31 `transfer-list` tokens (named design values, such as colors or sizes, set by the design system) that the UI kit (the token file, `recursica_ui-kit.json`, that says which variants and states each component has) exports. The rules below describe the intended transfer list, and the rules match the UI kit.\n\n## When to use a transfer list\n\n- **The list of options is vast, and the persona picks only a few.** For example, the persona picks 3 of 100 options. In a checkbox group, the 3 checked options are hard to find. The transfer list shows the selected options in a separate list, so the persona never searches for the selected options. A short list, such as 10 options, needs only a checkbox group.\n- **The items not chosen matter as much as the items chosen.** Examples are assigning people to a group, picking the columns of a report, and choosing which options a setup includes. The persona needs to see the items left out, not only the items chosen.\n- **Each item is either included or excluded.** Two lists show at a glance which items are included. Checkmarks spread through one long checkbox group do not show the included items at a glance.\n- **The persona moves many items at once.** The persona selects several items, then moves all the selected items in one action.\n\n## When not to use a transfer list\n\n| Situation                                                                                           | Use instead                                                                                                                                                                                                                                                |\n| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| The list has only a few options                                                                     | A checkbox group. See `recursica-skill-checkbox` and `recursica-skill-selection-controls`.                                                                                                                                                                 |\n| The persona chooses exactly one value                                                               | A dropdown or a radio group. See `recursica-skill-dropdown`.                                                                                                                                                                                               |\n| The persona chooses any number of options, including none, and the options not chosen do not matter | A multi-select dropdown. See `recursica-skill-selection-controls`.                                                                                                                                                                                         |\n| The container is too narrow for two lists side by side                                              | A different component. Each list has a fixed width.                                                                                                                                                                                                        |\n| The persona puts items in order, instead of including or excluding items                            | If the theme (the design a designer sets in Theme Forge: the token values, the components, and each component's variants, states and sizes) has an ordering variant for the transfer list, use the ordering variant. Otherwise, use a different component. |\n| The items are saved records with actions, such as Edit and Delete                                   | A table. See `recursica-skill-tables`.                                                                                                                                                                                                                     |\n| The persona viewing the screen cannot change which items are included                               | A read-only field. See `recursica-skill-read-only-field`.                                                                                                                                                                                                  |\n\n**A transfer list fixes one problem in how a screen is built.** The problem is a list of options too long for a checkbox group. For example, twenty checkboxes that need a \"Select all\" checkbox are the wrong control, as `recursica-skill-selection-controls` says. A transfer list replaces those twenty checkboxes. Where nine checkboxes would do, a transfer list is also the wrong control.\n\n## Variants\n\n**Use only the transfer list variants and options that the knowledge MCP server lists for the theme.** A designer can add variants and options in Theme Forge, so each theme can differ. Get the list with the server's `component_api` tool, and use the names the code uses. A wrong name in code has no effect and shows no error. Never invent a variant or an option.\n\nThe rules below describe each option by role, such as \"the error state\". The names in the standard UI kit (the unchanged UI kit in the official Recursica release) are examples only.\n\n- **The transfer list has an error state and a disabled state.** In the standard UI kit, the state variant is `states`, with the options `error` and `disabled`.\n- **Do not build a separate search field or heading above the transfer list.** The transfer list component shows a header with a title, a filter and both item lists. A filter is a search field that narrows a list to the matching items.\n- **The transfer list's height and width are fixed.** Neither the height nor the width is an option. Both lists are the same size, however many items each list holds.\n- **A move-all control is not wanted.** See the move-all rule under Rules.\n\n**Label placement is a variant.** A control's label sits beside the control or above the control. In the standard UI kit, the variant is `layouts`, with the options `side-by-side` and `stacked`. The label beside the control is the house default. The label above the control is the fallback when the form's container is too narrow for both side by side. The container's width decides, not the viewport's width. See `recursica-skill-forms`. The label placement variant does not arrange the two lists. The two lists always sit in two columns.\n\n**Set label placement explicitly on every field.** The house rule puts the label beside the input. The code library under an adapter may put the label above the input by default, at every container width. Set the label beside the input on every field. Use the names the code uses for the variant and the option.\n\n**Label placement is one decision per form, not per field.** This field uses the same label placement as every other field in the form. Apply the container-width test once, to the whole form. The result sets the placement of every field in the form. Short fields that would fit side by side follow the result too. A form may change placement at a breakpoint. A form never mixes placements at one breakpoint. A form section never gets a separate placement. `recursica-skill-forms` sets this rule.\n\n## Rules\n\n**Give each list a name that tells the two lists apart.** Use the product's words, such as \"Available\" and \"Selected\", or \"Excluded\" and \"Included\". Without names, the persona cannot tell which list holds the chosen items.\n\n**Always include the filter. Give the filter a label that names the list the filter searches.** For example, label the filter \"Search available people\". A list long enough for a transfer list is too long for the persona to read every item.\n\n**Keep selecting an item and moving an item as two separate actions.** For example, the persona selects three people in \"Available\", then presses the move button once to move all three.\n\n- Selecting, or checking, an item marks the item to be moved.\n- Moving the item puts the item in the other list.\n- Do not move an item when the persona selects the item.\n\nMoving many items at once is the reason a transfer list exists.\n\n**Do not build a move-all control.** For example, a \">>\" button that moves every item to the other list is a move-all control.\n\n- Use the filter to work with a long list, and keep the filter.\n- A list so long that a move-all control seems necessary is a sign that the screen is built wrong.\n- Raise that problem with the user instead of adding a move-all control, as `recursica-skill-design-system-conventions` says.\n\n`recursica-skill-selection-controls` treats a need for select-all as a sign to reconsider the control.\n\n**Sort both lists the same way, and keep the sort order the same after a move.** When the persona moves an item back and the item shows up in an unexpected place, the item looks lost.\n\n**Put the transfer list in the form's single column, and never inside a card.** A transfer list is a form control. `recursica-skill-forms` sets this rule.\n\n**Give the transfer list a real label, such as \"Team members\".** Put the selection rules in assistive text (help text shown with the control). The selection rules are:\n\n- the minimum number of items\n- the maximum number of items\n- what the two lists mean\n\nFor example, one selection rule is \"At least two must be included\". Put the rule under the transfer list, not in a validation message after the persona makes a mistake. See `recursica-skill-label` and `recursica-skill-assistive-element`.\n\n**Pair the error state with a signal that is not color, such as an icon or error text.** `recursica-skill-design-system-conventions` requires the second signal.\n\n**Let each list scroll inside the transfer list's fixed height.** A long list always scrolls. The filter narrows a long list.\n\n**Never disable a transfer list to show which items are included.** If the persona cannot change the included items in the current context, show the included items as read-only content.\n\n## Accessibility\n\nThe rules below add to the accessibility baseline in `recursica-skill-design-system-conventions`, including the focus ring, which every Recursica component follows.\n\nThe app must add every behavior listed under \"Screen readers\" and \"Keyboard and non-mouse navigation\". A transfer list with arrow buttons often works only with a mouse.\n\n### Screen readers\n\n- **Give each list a separate accessible name** (the name a screen reader reads out for a control). Without an accessible name, a persona using a screen reader hears a list of items. The persona cannot tell which list holds the items and cannot use the transfer list.\n- **Set the selected state in code, not by color.** Assistive technology does not treat an item with only a tinted background as selected. `recursica-skill-design-system-conventions` sets this rule.\n- **Name each move button with what moves and where**, such as \"Move selected to included\" or \"Remove selected from included\". A name like \"Right arrow\" or \">\" does not say what moves where. Two arrow buttons with no labels cannot be told apart.\n- **After a move, announce the result.** Announce the items that moved, and how many items each list now holds. The persona cannot see both lists change at once.\n- **When the filter changes a list, announce how many items the list shows**, such as \"3 of 120 shown\". Without the count, a persona using a screen reader hears a list that seems to empty for no reason.\n- **Each list's item count should be available.** The persona can then learn how many items a list holds without going through every item.\n- **Do not announce the same event twice.** When a move's result is announced, do not also announce every item again as focus lands on each item.\n\n### Keyboard and non-mouse navigation\n\n- **Every step of a transfer must work from the keyboard, with no dragging.** Selecting items, moving the items, and moving the items back must all work with keys alone. Drag and drop may be added as an extra way to move items, and never as the only way.\n- **After a move, put focus in a chosen place.** Put focus on the moved item in the item's new list, or on the move button that still applies. Never leave focus on a control that has just become disabled. Never let focus drop back to the top of the page.\n- **Make each move button a real button, pressed with Enter and Space.** Make the move buttons tab stops (places the Tab key lands), in visual order, between the two lists.\n- **Disable a move button when the move button has no item to move.**\n- **Make the tab order follow the visual order**: label, filter, first list, move buttons, second list.\n- **Do not move focus for the persona**, except to put focus in a chosen place after a move. Typing in the filter must not move focus into the list the filter searches.\n- **Do not show a control, label, count or other content the persona needs only on hover.** The rule covers the move buttons, a remove control on each item, and the item counts.\n\n## Styling set by tokens\n\n**Never set or override the transfer list's styling.** The theme sets every visual property of the transfer list, such as size, spacing, borders, colors and animation. Do not add extra containers or spacers to change the transfer list's look. If the design needs a look the theme does not give, report the missing look as a design-system gap. See `recursica-skill-design-router`.\n\n## Related skills\n\n- `recursica-skill-selection-controls` — the rules for choosing among selection controls:\n  - which selection control to choose\n  - the most options each selection control can hold\n  - select-all as a sign that the screen's structure is wrong\n  - disabled versus read-only\n  - when a selection is saved\n- `recursica-skill-working-memory` — the research behind the 7 ± 2 guideline. The skill also says why list length depends on the task:\n  - A list the persona scans to recognize an item may be long.\n  - A set of items the persona compares may not be long.\n- `recursica-skill-forms` — the form rules a transfer list follows:\n  - the single-column layout\n  - one label placement per form, and the container width that sets the label placement\n  - validation\n  - save mode\n  - the rule against a form control inside a card\n- `recursica-skill-label` — the transfer list's label, and the label for a group of fields.\n- `recursica-skill-assistive-element` — the help text for the selection rules, and the error message.\n- `recursica-skill-design-system-conventions` — the screen-wide rules:\n  - showing meaning in more than one way\n  - fixing the screen's structure instead of adding a feature to work around a problem in the structure\n\n## Open questions\n\n- **Where the transfer list fits among the selection controls.** Past the option limit, `recursica-skill-selection-controls` sends a choice of any number of options, including none, to a multi-select dropdown. `recursica-skill-selection-controls` never mentions a transfer list. No rule says at how many options a transfer list replaces the multi-select dropdown.\n- **Checkboxes on each item.** Only the design-system website shows a checkbox on every item. Nobody has settled whether the items are rows with checkboxes or items in a selectable listbox. Confirm with the user before relying on a checkbox on each item. Skip that confirmation when the theme has a checkbox option for an item.\n- **Narrow containers.** The label placement variant moves only the label, and the lists have a fixed width. The transfer list has no responsive behavior. `recursica-skill-responsive-layout` sets what a narrow screen may leave off.\n- **Empty states.** No rule sets an empty state for either list, including the starting state where every item is in one list. Confirm with the user only when the theme has no empty state.\n- **Ordering.** No rule says whether items are sorted alphabetically, keep the original order, or can be reordered by the persona.\n- **Disabled items.** No rule says whether a single item can be disabled, locked in one list while the other items move. Confirm with the user only when the theme has no disabled state for a single item.\n\n## Pre-flight checklist\n\n- [ ] The list of options is vast, and the persona picks only a few. The selected options show in a separate list. A checkbox group and a dropdown were ruled out for those reasons.\n- [ ] Both lists have visible names that tell the two lists apart, and each list has an accessible name.\n- [ ] A filter is present, and the filter announces how many items a filtered list shows.\n- [ ] Selecting an item does not move the item. Items move through the move buttons.\n- [ ] Both lists use the same sort order, and the sort order stays the same after a move.\n- [ ] Each move button's name says what moves where. Each move button is a real button, pressed with Enter and Space.\n- [ ] Every step of a transfer works from the keyboard, with no dragging. Any drag and drop is an extra way to move items.\n- [ ] After a move, focus goes to a chosen place.\n- [ ] After a move, the result is announced: the items that moved, and the new count in each list.\n- [ ] The selected state is set in code, not shown by highlight color alone.\n- [ ] No move-all control was built.\n- [ ] A list long enough to seem to need a move-all control was raised with the user as a screen-structure problem.\n- [ ] The transfer list has a real label, with the selection rules in assistive text.\n- [ ] The label placement matches every other field in the same form, with one placement per form, as `recursica-skill-forms` requires.\n- [ ] The error state has a signal that is not color. The label, the help text, and the error text are set through the transfer list component.\n- [ ] The tab order runs: label, filter, first list, move buttons, second list.\n- [ ] The transfer list is in the form's single column, and not inside a card.\n- [ ] Every variant, size, and state is one the theme's UI kit lists, and no variant or option is invented. No header, filter, or wrapper is built by hand.\n- [ ] No styling is set or overridden on the transfer list. No container or spacer is added to change the transfer list's look.\n- [ ] Open questions were asked about, not decided: item checkboxes, ordering.\n",{"name":5,"license":15,"metadata":24,"description":7},{"author":25,"version":26},"hi@borderux.com","0.2.0","main","110b382bfe525d171ba33c7074d6ad1f3762548f","skills\u002Fcomponents\u002Frecursica-skill-transfer-list",0,"https:\u002F\u002Fgithub.com\u002Fborderux\u002Frecursica-knowledge","https:\u002F\u002Fgithub.com\u002Fborderux","https:\u002F\u002Fborderux.com","2026-11-09 16:39:27",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add borderux\u002Frecursica-knowledge --skill recursica-skill-transfer-list",{"tool":41,"command":42},"bunx","bunx skills add borderux\u002Frecursica-knowledge --skill recursica-skill-transfer-list",{"tool":44,"command":45},"pnpm","pnpm dlx skills add borderux\u002Frecursica-knowledge --skill recursica-skill-transfer-list","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fborderux\u002Frecursica-knowledge\u002Fblob\u002Fmain\u002Fskills\u002Fcomponents\u002Frecursica-skill-transfer-list\u002FSKILL.md",true,[],[50,58,65,72,79,86],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":54,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M7556E67F3DCE39P7ZTVT5TA","recursica-skill-template","Replace with a description of the skill and its purpose.","https:\u002F\u002Fgithub.com\u002Fborderux\u002Frecursica-knowledge\u002Fblob\u002Fmain\u002Ftemplate\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fborderux\u002Frecursica-knowledge\u002Fblob\u002Fmain\u002Ftemplate\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M75569FCJXWWGXRVMTJFBK0W","recursica-skill-working-memory","The research behind Recursica's item-count limits, with citations — Miller's 7 ± 2, Cowan's 4, chunking, and recognition versus recall. Use when a decision turns on how many options, navigation items, or chips to show at once, or to justify or challenge a count. Not for choosing a control — see recursica-skill-selection-controls.","https:\u002F\u002Fgithub.com\u002Fborderux\u002Frecursica-knowledge\u002Fblob\u002Fmain\u002Fskills\u002Fpsychology\u002Frecursica-skill-working-memory\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M75564EC5E5QKBPNWARQVDBC","recursica-skill-discoverability","The research behind Recursica's rule that rarely needed settings get a real but unpromoted entry point — the paradox of the active user, satisficing (settling for the first method that is good enough), and progressive disclosure, with citations. Use when deciding whether to hide, promote, or build a configuration or customization feature, or to justify that choice. Not for item counts — see recursica-skill-working-memory.","https:\u002F\u002Fgithub.com\u002Fborderux\u002Frecursica-knowledge\u002Fblob\u002Fmain\u002Fskills\u002Fpsychology\u002Frecursica-skill-discoverability\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7555Z2YRG9YSM01KMYT1FY5","recursica-skill-design-router","Start here for any Recursica screen work. The router says what to decide in what order, which skill owns each decision, which rule wins when two rules conflict, and when to confirm with the user instead of guessing. Load the router first to design, build, review, or refactor a screen, page, panel, or flow, or when rules seem to disagree or no rule applies. The router routes, and the owning skill holds the rules.","https:\u002F\u002Fgithub.com\u002Fborderux\u002Frecursica-knowledge\u002Fblob\u002Fmain\u002Fskills\u002Fmeta\u002Frecursica-skill-design-router\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7555RYHBH6XM48V2420Z66X","recursica-skill-undo","House rules for undo — when an action gets an undo instead of a confirmation, where the undo goes (on the page, in place, or in a toast), when a toast is needed at all, and the Undo button's accessible name. Use whenever an action can be reversed, or when choosing between an undo and a confirmation. Not for building the toast that holds an Undo button — see recursica-skill-toast. Not for the confirmation modal — see recursica-skill-buttons-links.","https:\u002F\u002Fgithub.com\u002Fborderux\u002Frecursica-knowledge\u002Fblob\u002Fmain\u002Fskills\u002Fdesign-rules\u002Frecursica-skill-undo\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M7555K4E6TKJ9E9P7GCQYJZ8","recursica-skill-typography-semantics","House rules for type and semantic markup — real elements instead of styled divs, one H1 per page, type styles from tokens only, loading the brand typefaces, hidden headings, emphasis with em and strong, abbreviations, and AP style. Use for headings, body copy, emphasis, and the markup under a visual hierarchy. Not for naming — see recursica-skill-names-and-terms.","https:\u002F\u002Fgithub.com\u002Fborderux\u002Frecursica-knowledge\u002Fblob\u002Fmain\u002Fskills\u002Fdesign-rules\u002Frecursica-skill-typography-semantics\u002FSKILL.md",[],[]]