@khsura/sui-mcp 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -43,6 +43,7 @@ var LAYOUT_CHILD_NOTE = "**Layout child:** render it inside an `SLayout name=\"x
43
43
  var FAMILY_PURPOSES = {
44
44
  core: "core UI building block",
45
45
  layout: "app shell layout (SLayout and its named regions)",
46
+ avatar: "user avatar (image, initials or icon) or an overlapping group of them",
46
47
  badge: "status badge overlay",
47
48
  calendar: "calendar view",
48
49
  cards: "card container or one of its sections",
@@ -168,6 +169,22 @@ var RULE_CARD_TITLE_TEXT_ALIGN = "card-title-text-align";
168
169
  var RULE_DATE_PICKER_EMPTY_STRING = "date-picker-empty-string";
169
170
  var RULE_FIELD_BUTTON_ROW = "field-button-row";
170
171
  var RULE_FILL_HEIGHT_UNDER_APP = "fill-height-under-app";
172
+ var RULE_AVATAR_IMAGE_IN_SLOT = "avatar-image-in-slot";
173
+ var RULE_AVATAR_TEXT_NOT_INITIALS = "avatar-text-not-initials";
174
+ var RULE_AVATAR_GROUP_CHILD = "avatar-group-child";
175
+ var RULE_PAGINATION_LENGTH_ROWS = "pagination-length-rows";
176
+ var RULE_PAGINATION_ZERO_BASED = "pagination-zero-based";
177
+ var RULE_SKELETON_LOADER_UNKNOWN_PRESET = "skeleton-loader-unknown-preset";
178
+ var RULE_SKELETON_LOADER_NEVER_HIDES = "skeleton-loader-never-hides";
179
+ var RULE_HIDDEN_LABEL_NO_VISIBLE_NAME = "hidden-label-no-visible-name";
180
+ var RULE_EMPTY_STATE_ACTION_EVENT = "empty-state-action-event";
181
+ var RULE_EMPTY_STATE_ACTION_WITHOUT_LISTENER = "empty-state-action-without-listener";
182
+ var RULE_EMPTY_STATE_OUTSIDE_NO_DATA_SLOT = "empty-state-outside-no-data-slot";
183
+ var RULE_NUMBER_INPUT_PREFERRED = "number-input-preferred";
184
+ var RULE_RAW_FILE_INPUT = "raw-file-input";
185
+ var RULE_FILE_INPUT_CHANGE_EVENT = "file-input-change-event";
186
+ var RULE_TABS_IN_SLIDE_GROUP = "tabs-in-slide-group";
187
+ var RULE_ROW_INSET_FROM_TEXT = "row-inset-from-text";
171
188
  /**
172
189
  * The first `@khsura/sui` release with the M2 hardening fixes (SForm `novalidate`, SCheckbox label with
173
190
  * `hide-details`, `''` as "no date", snackbar action colour, SCardTitle `s_textAlign__*`). Rules for
@@ -182,6 +199,7 @@ var RECIPE_ACTIVATOR_OVERLAYS = "activator-overlays";
182
199
  var RECIPE_RESPONSIVE_GRID = "responsive-grid";
183
200
  var RECIPE_FILTER_BAR = "filter-bar";
184
201
  var RECIPE_CENTERED_PAGE = "centered-page";
202
+ var RECIPE_TABBED_SECTIONS = "tabbed-sections";
185
203
  var ACTIVATOR_SLOT_NAME = "activator";
186
204
  var ACTIVATOR_ATTRS_KEY = "attrs";
187
205
  /** Overlays whose `#activator` slot passes `{ on, attrs }` for the caller to bind. */
@@ -225,7 +243,19 @@ var NATIVE_VALIDATING_INPUT_TYPES = [
225
243
  "url",
226
244
  "number"
227
245
  ];
246
+ /** The numeric field (since 1.21.0); rules recommend it only when the resolved `sui-api.json` lists it. */
247
+ var NUMBER_INPUT_COMPONENT = "SNumberInput";
248
+ /** SInput's number-only props and what SNumberInput uses instead, for the migration hint. */
249
+ var NUMBER_INPUT_PROP_REPLACEMENTS = /* @__PURE__ */ new Map([
250
+ ["allow-decimal", "`:precision=\"2\"` (decimal places; whole numbers by default)"],
251
+ ["positive", "`:min` (`:min=\"1\"` for whole numbers above 0)"],
252
+ ["use-previous-value-when-exceeded", "nothing: SNumberInput clamps to `min` / `max` on blur"],
253
+ ["inputmode", "nothing: SNumberInput picks `numeric` or `decimal` from `min` and `precision`"]
254
+ ]);
228
255
  var HIDE_DETAILS_ATTRIBUTE = "hide-details";
256
+ var LABEL_ATTRIBUTE = "label";
257
+ var PLACEHOLDER_ATTRIBUTE = "placeholder";
258
+ var LABEL_WORD_PATTERN = /[\p{L}\p{N}]+/gu;
229
259
  /** Inputs whose only visible text is the `label` prop, which `hide-details` hides as well. */
230
260
  var HIDE_DETAILS_LABEL_COMPONENTS = ["SCheckbox"];
231
261
  var SNACKBAR_ACTION_SLOT_NAME = "action";
@@ -252,11 +282,30 @@ var FLEX_ROW_COMPONENTS = ["SCardActions"];
252
282
  /** Text fields that render a label above their box and an error line under it. */
253
283
  var LABELLED_FIELD_COMPONENTS = [
254
284
  "SInput",
285
+ "SNumberInput",
255
286
  "SSelect",
256
287
  "SDatePickerInput",
257
288
  "SAutocomplete",
258
- "STextarea"
289
+ "STextarea",
290
+ "SFileInput"
291
+ ];
292
+ var ROW_NO_OUTER_GUTTERS_PROP = "no-outer-gutters";
293
+ /** Native text elements whose left edge a grid beside them should line up with. */
294
+ var ROW_TEXT_SIBLING_TAGS = [
295
+ "h1",
296
+ "h2",
297
+ "h3",
298
+ "h4",
299
+ "h5",
300
+ "h6",
301
+ "p"
259
302
  ];
303
+ /** Components that sit flush with the content edge, like text, so a grid beside them should line up too. */
304
+ var ROW_FLUSH_SIBLING_COMPONENTS = ["SBreadcrumbs"];
305
+ /** Wrappers that add no padding: a row inside one is still beside the wrapper's siblings. */
306
+ var ROW_TRANSPARENT_WRAPPERS = ["SForm", "form"];
307
+ /** Horizontal padding / margin utility classes: a text sibling carrying one is inset on purpose. */
308
+ var HORIZONTAL_INSET_CLASS_PATTERN = /^s_(?:pa|px|pl|ps|ma|mx|ml|ms)__/;
260
309
  /** `s_display__flex`, `s_display--md__inlineFlex`: the utility classes that make an element a flex row. */
261
310
  var FLEX_DISPLAY_CLASS_PATTERN = /^s_display(?:--[a-z]+)?__(?:flex|inlineFlex)$/;
262
311
  var FLEX_DISPLAY_STYLE_PATTERN = /(?:^|;)\s*display\s*:\s*(?:inline-)?flex\b/;
@@ -282,6 +331,72 @@ var MODEL_NAME_PLACEHOLDER = "__name__";
282
331
  /** `from: ''` in an object literal, or `startDate = ref('')` / `ref<string>("")`. */
283
332
  var EMPTY_STRING_INITIAL_PATTERNS = [`(?:^|[^\\w$.])${MODEL_NAME_PLACEHOLDER}\\s*:\\s*(['"])\\1`, `(?:^|[^\\w$.])${MODEL_NAME_PLACEHOLDER}\\s*=\\s*(?:ref|shallowRef)\\s*(?:<[^>]*>)?\\s*\\(\\s*(['"])\\1\\s*\\)`];
284
333
  var ACTIVATOR_BINDING_FIX = "Write `#activator=\"{ on, attrs }\"` and put both `v-on=\"on\"` and `v-bind=\"attrs\"` on the activator's root element.";
334
+ var AVATAR_TEXT_ATTRIBUTE = "text";
335
+ /** Elements that put a picture in an avatar's slot instead of its `image` prop. */
336
+ var AVATAR_SLOT_IMAGE_TAGS = ["img", "SImage"];
337
+ var WHITESPACE_CHARACTER_PATTERN = /\s/;
338
+ /** Children an SAvatarGroup accepts besides SAvatar: a `<slot>` that passes avatars through. */
339
+ var AVATAR_GROUP_PASSTHROUGH_TAGS = ["slot"];
340
+ var PAGINATION_LENGTH_ATTRIBUTE = "length";
341
+ /** A `:length` that counts rows, not pages: `items.length`, `rows.size`, `totalItems`, `itemsCount`, … */
342
+ var PAGINATION_ROW_COUNT_EXPRESSION = /(?:\.(?:length|size)|^(?:total|totalItems|totalRows|totalCount|totalRecords|itemsCount|itemCount|rowCount|rowsCount))\s*$/;
343
+ /** Signs that the expression already divides rows into pages: `Math.ceil(total / perPage)`, `total / 20`. */
344
+ var PAGINATION_PAGE_MATH_EXPRESSION = /\/|\bceil\b/;
345
+ /** A 0-based model, such as STable's `pageIndex`, given to SPagination's 1-based `v-model`. */
346
+ var PAGINATION_ZERO_BASED_MODEL = /index$/i;
347
+ var SKELETON_LOADER_TYPE_ATTRIBUTE = "type";
348
+ var SKELETON_LOADER_LOADING_ATTRIBUTE = "loading";
349
+ /** The presets SSkeletonLoader draws. The `type` prop is a plain string, so sui-api.json cannot list them. */
350
+ var SKELETON_LOADER_PRESETS = [
351
+ "text",
352
+ "heading",
353
+ "avatar",
354
+ "button",
355
+ "image",
356
+ "card",
357
+ "list-item",
358
+ "list-item-avatar",
359
+ "table-row",
360
+ "table"
361
+ ];
362
+ /** Vuetify VSkeletonLoader presets that SUI does not have, with the SUI `type` that draws the same thing. */
363
+ var SKELETON_LOADER_VUETIFY_PRESETS = {
364
+ paragraph: "text@3",
365
+ sentences: "text@2",
366
+ subtitle: "text",
367
+ article: "heading, text@3",
368
+ chip: "button",
369
+ actions: "button@2",
370
+ "list-item-two-line": "list-item-avatar",
371
+ "list-item-three-line": "list-item-avatar",
372
+ "list-item-avatar-two-line": "list-item-avatar",
373
+ "list-item-avatar-three-line": "list-item-avatar",
374
+ "card-avatar": "card",
375
+ "table-heading": "heading",
376
+ "table-thead": "table-row",
377
+ "table-tbody": "table-row@5",
378
+ "table-tfoot": "table-row"
379
+ };
380
+ var EMPTY_STATE_COMPONENT = "SEmptyState";
381
+ var EMPTY_STATE_ACTION_TEXT_ATTRIBUTE = "action-text";
382
+ /** The slot that replaces SEmptyState's built-in button. */
383
+ var EMPTY_STATE_ACTIONS_SLOT = "actions";
384
+ /** Listeners AI code writes for the action button: Vuetify's `click:action`, or a plain `click` on the whole block. */
385
+ var EMPTY_STATE_WRONG_ACTION_EVENTS = ["click:action", "click"];
386
+ /** Components whose no-data state takes an SEmptyState through the `noData` slot, never the default slot. */
387
+ var NO_DATA_SLOT_COMPONENTS = [
388
+ "STable",
389
+ "SSelect",
390
+ "SAutocomplete"
391
+ ];
392
+ var NO_DATA_SLOT_NAME = "noData";
393
+ /** A handler that opens a file input's picker through its template ref: `fileInput?.click()`, `$refs.file.click()`. */
394
+ var PICKER_CLICK_CALL_PATTERN = /[\w$.?]*\.click\(\s*\)/g;
395
+ /** The DOM event access AI code writes for a native file input's `change`: `$event.target.files`, `e.target`. */
396
+ var NATIVE_CHANGE_EVENT_ACCESS_PATTERN = /\.target\b|\$event\.files\b/;
397
+ /** Splits a member path such as `fileInput.value?.click` into its names. */
398
+ var MEMBER_PATH_SEPARATOR_PATTERN = /\?\.|\./;
399
+ var FILE_INPUT_EXAMPLE = "<SFileInput v-model=\"files\" label=\"Workbook\" accept=\".csv,.xlsx\" :rules=\"getFileInputRules({ maxSize: 5 * 1024 * 1024, accept: '.csv,.xlsx' })\" />";
285
400
  //#endregion
286
401
  //#region src/constants/recipes.ts
287
402
  /** Published recipe names; `validate_sui_template` issues point to these exact names. */
@@ -293,7 +408,8 @@ var RECIPE_NAMES = [
293
408
  "responsive-grid",
294
409
  "theme-setup",
295
410
  "filter-bar",
296
- "centered-page"
411
+ "centered-page",
412
+ "tabbed-sections"
297
413
  ];
298
414
  var RECIPES_DIRNAME = "recipes";
299
415
  /** Repo-relative folder that holds the recipe sources (Storybook renders the same files). */
@@ -346,6 +462,8 @@ var CONFIG_STATUS_UPDATED = "updated";
346
462
  var CONFIG_STATUS_UNCHANGED = "unchanged";
347
463
  var CONFIG_ACTION_WRITE = "write";
348
464
  var CONFIG_ACTION_PRINT = "print";
465
+ //#endregion
466
+ //#region src/constants/componentAliases.ts
349
467
  /**
350
468
  * Component names from Vuetify, Quasar, Element and similar libraries that are not in @khsura/sui,
351
469
  * with the SUI component(s) to use instead and a short hint. An empty `suiNames` means SUI has no
@@ -425,10 +543,6 @@ var COMPONENT_ALIASES = {
425
543
  suiNames: ["STab", "SWindowItem"],
426
544
  hint: "Put an `STab` in `STabs` and its content in an `SWindowItem` inside an `SWindow`."
427
545
  },
428
- SAvatar: {
429
- suiNames: [],
430
- hint: "There is no avatar component yet (planned for M3). For a photo use `<SImage src=\"…\" :aspect-ratio=\"1\" object-fit=\"cover\" :width=\"40\" style=\"border-radius: 50%\" />`; for initials use a fixed-size element with `border-radius: 50%`, a background colour and centred text."
431
- },
432
546
  SModal: {
433
547
  suiNames: ["SDialog"],
434
548
  hint: "The modal is `SDialog`, opened from its `#activator` slot or a `v-model`."
@@ -846,6 +960,11 @@ var humanizeComponentName = (name) => {
846
960
  };
847
961
  /** True for tags the validator treats as SUI components: `SButton` or `s-button`. Native tags such as `select` never match. */
848
962
  var isSuiComponentTag = (tag) => SUI_PASCAL_TAG_PATTERN.test(tag) || SUI_KEBAB_TAG_PATTERN.test(tag);
963
+ /**
964
+ * True when the resolved `sui-api.json` lists the component, i.e. the installed `@khsura/sui` release has it. Rules
965
+ * that recommend a newer component check this, so a project on an older release is never told to use one it lacks.
966
+ */
967
+ var hasSuiComponent = (api, name) => api.components.some((component) => component.name === name);
849
968
  //#endregion
850
969
  //#region src/utils/templateAst.ts
851
970
  var positionOf = (node) => ({
@@ -896,6 +1015,8 @@ var slotFills = (element) => {
896
1015
  })));
897
1016
  };
898
1017
  var slotDirectives = (element) => slotFills(element).map((fill) => fill.directive);
1018
+ /** True when `element` has content between its tags (elements, text or `{{ }}`), not counting comments. */
1019
+ var hasChildContent = (element) => element.children.some((child) => child.type !== NodeTypes.COMMENT && (child.type !== NodeTypes.TEXT || child.content.trim() !== ""));
899
1020
  /** Every element below `element`, depth first. */
900
1021
  var descendantElementsOf = (element) => childElementsOf(element).flatMap((child) => [child, ...descendantElementsOf(child)]);
901
1022
  /** A prop written in either case style: `hide-details`, `hideDetails`, `:hide-details`. */
@@ -1312,7 +1433,7 @@ var serverInfo = {
1312
1433
  name: SERVER_NAME,
1313
1434
  version: {
1314
1435
  name: "@khsura/sui-mcp",
1315
- version: "0.3.0",
1436
+ version: "0.4.0",
1316
1437
  repository: {
1317
1438
  "type": "git",
1318
1439
  "url": "git+https://github.com/khsura/sui.git",
@@ -1659,46 +1780,261 @@ var startsAsEmptyString = (modelPath, scriptSource) => {
1659
1780
  const escapedName = (modelPath.trim().split(MODEL_PATH_SEPARATOR).at(-1) ?? "").replaceAll(REGEX_SPECIAL_CHARACTERS, "\\$&");
1660
1781
  return EMPTY_STRING_INITIAL_PATTERNS.some((pattern) => new RegExp(pattern.replace(MODEL_NAME_PLACEHOLDER, escapedName)).test(scriptSource));
1661
1782
  };
1783
+ var datePickerEmptyStringRule = {
1784
+ id: RULE_DATE_PICKER_EMPTY_STRING,
1785
+ fixedIn: SUI_M2_FIXES_VERSION,
1786
+ check: ({ element, scriptSource }) => {
1787
+ const binding = isOneOfComponentTags(element.tag, DATE_PICKER_EMPTY_STRING_COMPONENTS) ? modelBinding(element) : void 0;
1788
+ const source = binding && isDirective(binding) ? expressionSource(binding) : binding?.value?.content;
1789
+ if (!binding || source === void 0) return [];
1790
+ const isEmptyLiteral = EMPTY_STRING_EXPRESSION.test(source) || !isDirective(binding) && source === "";
1791
+ const isEmptyInitial = MODEL_PATH_PATTERN.test(source) && startsAsEmptyString(source, scriptSource);
1792
+ if (!isEmptyLiteral && !isEmptyInitial) return [];
1793
+ return [{
1794
+ ...positionOf(binding),
1795
+ rule: RULE_DATE_PICKER_EMPTY_STRING,
1796
+ severity: SEVERITY_WARNING,
1797
+ message: isEmptyLiteral ? `\`${element.tag}\` gets \`''\` as its value: the picker opens on "Invalid date" and a grid of NaN.` : `\`${source}\` starts as \`''\` and is bound to \`${element.tag}\`: the picker opens on "Invalid date" and a grid of NaN.`,
1798
+ fixHint: "Start an empty date as `null` (type the model `string | null`); `''` is not treated as \"no date\".",
1799
+ recipe: RECIPE_VALIDATED_FORM
1800
+ }];
1801
+ }
1802
+ };
1803
+ var paginationLengthRowsRule = {
1804
+ id: RULE_PAGINATION_LENGTH_ROWS,
1805
+ check: ({ element }) => {
1806
+ const length = isComponentTag(element.tag, "SPagination") ? findPropAttribute(element, PAGINATION_LENGTH_ATTRIBUTE) : void 0;
1807
+ const source = length && isDirective(length.node) ? expressionSource(length.node) : void 0;
1808
+ if (!length || source === void 0 || !PAGINATION_ROW_COUNT_EXPRESSION.test(source) || PAGINATION_PAGE_MATH_EXPRESSION.test(source)) return [];
1809
+ return [{
1810
+ ...positionOf(length.node),
1811
+ rule: RULE_PAGINATION_LENGTH_ROWS,
1812
+ severity: SEVERITY_WARNING,
1813
+ message: `\`:length="${source}"\` on \`SPagination\` looks like a number of rows, but \`length\` is the number of pages: it would show one page per row.`,
1814
+ fixHint: "Pass the page count: `const pageCount = computed(() => Math.ceil(totalItems.value / itemsPerPage))`, then `<SPagination v-model=\"page\" :length=\"pageCount\" />`."
1815
+ }];
1816
+ }
1817
+ };
1818
+ var paginationZeroBasedRule = {
1819
+ id: RULE_PAGINATION_ZERO_BASED,
1820
+ check: ({ element }) => {
1821
+ const binding = isComponentTag(element.tag, "SPagination") ? modelBinding(element) : void 0;
1822
+ const source = binding && isDirective(binding) ? expressionSource(binding) : void 0;
1823
+ const lastSegment = source?.trim().split(MODEL_PATH_SEPARATOR).at(-1);
1824
+ if (!binding || !source || !MODEL_PATH_PATTERN.test(source) || !PAGINATION_ZERO_BASED_MODEL.test(lastSegment ?? "")) return [];
1825
+ return [{
1826
+ ...positionOf(binding),
1827
+ rule: RULE_PAGINATION_ZERO_BASED,
1828
+ severity: SEVERITY_WARNING,
1829
+ message: `\`${source}\` looks like a 0-based index (such as STable's \`pageIndex\`), but \`SPagination\`'s \`v-model\` is the page number starting at 1: page 1 would show as page 2.`,
1830
+ fixHint: "Keep a 1-based `page` ref for SPagination and derive the index where you need it: `const pageIndex = computed(() => page.value - 1)`."
1831
+ }];
1832
+ }
1833
+ };
1834
+ var skeletonLoaderPresetName = (part) => part.split("@")[0]?.trim() ?? "";
1835
+ var skeletonLoaderSuggestion = (name) => {
1836
+ const replacement = SKELETON_LOADER_VUETIFY_PRESETS[name];
1837
+ return replacement ? `\`${name}\` → \`${replacement}\`` : `\`${name}\``;
1838
+ };
1839
+ var skeletonLoaderUnknownPresetRule = {
1840
+ id: RULE_SKELETON_LOADER_UNKNOWN_PRESET,
1841
+ check: ({ element }) => {
1842
+ const type = isComponentTag(element.tag, "SSkeletonLoader") ? findPropAttribute(element, SKELETON_LOADER_TYPE_ATTRIBUTE) : void 0;
1843
+ const unknownNames = (type?.staticValue ?? "").split(",").map(skeletonLoaderPresetName).filter((name) => name !== "" && !SKELETON_LOADER_PRESETS.includes(name));
1844
+ if (!type || unknownNames.length === 0) return [];
1845
+ return [{
1846
+ ...positionOf(type.node),
1847
+ rule: RULE_SKELETON_LOADER_UNKNOWN_PRESET,
1848
+ severity: SEVERITY_ERROR,
1849
+ message: `\`SSkeletonLoader\` has no ${codeList(unknownNames)} preset: it is ignored, so nothing is drawn for it.`,
1850
+ fixHint: `Use SUI presets joined by commas, with \`@N\` to repeat one (\`type="avatar, text@3"\`): ${codeList(SKELETON_LOADER_PRESETS)}. Instead of ${unknownNames.map(skeletonLoaderSuggestion).join(", ")}.`
1851
+ }];
1852
+ }
1853
+ };
1854
+ var skeletonLoaderNeverHidesRule = {
1855
+ id: RULE_SKELETON_LOADER_NEVER_HIDES,
1856
+ check: ({ element }) => {
1857
+ const loading = isComponentTag(element.tag, "SSkeletonLoader") ? findPropAttribute(element, SKELETON_LOADER_LOADING_ATTRIBUTE) : void 0;
1858
+ if (!loading?.isBound || hasChildContent(element) || hasObjectSpread(element)) return [];
1859
+ return [{
1860
+ ...positionOf(loading.node),
1861
+ rule: RULE_SKELETON_LOADER_NEVER_HIDES,
1862
+ severity: SEVERITY_WARNING,
1863
+ message: "`SSkeletonLoader` has a bound `loading` but no content: with nothing to swap in, the skeleton stays on screen after loading ends.",
1864
+ fixHint: "Put the real content inside it: `<SSkeletonLoader type=\"card\" :loading=\"isLoading\"><SCard>…</SCard></SSkeletonLoader>`, or toggle it yourself with `v-if=\"isLoading\"` and a `v-else` sibling."
1865
+ }];
1866
+ }
1867
+ };
1868
+ /** Rules about behaviour and styling misuses that the component API alone cannot catch. */
1869
+ var fillHeightUnderAppRule = {
1870
+ id: RULE_FILL_HEIGHT_UNDER_APP,
1871
+ fixedIn: SUI_M2_FIXES_VERSION,
1872
+ check: ({ element }) => {
1873
+ if (!isComponentTag(element.tag, "SApp")) return [];
1874
+ return childElementsOf(element).filter((child) => staticClassNames(child).includes(HEIGHT_FILL_CLASS)).map((child) => ({
1875
+ ...positionOf(child),
1876
+ rule: RULE_FILL_HEIGHT_UNDER_APP,
1877
+ severity: SEVERITY_WARNING,
1878
+ message: `\`${HEIGHT_FILL_CLASS}\` on a direct child of \`SApp\` resolves to the content height before @khsura/sui 1.20.0 (SApp only has a min-height), so content centred inside it sticks to the top.`,
1879
+ fixHint: "Upgrade @khsura/sui to 1.20.0 or later, or add `style=\"min-height: 100dvh\"` to this child.",
1880
+ recipe: RECIPE_CENTERED_PAGE
1881
+ }));
1882
+ }
1883
+ };
1884
+ var avatarTextNotInitialsRule = {
1885
+ id: RULE_AVATAR_TEXT_NOT_INITIALS,
1886
+ check: ({ element }) => {
1887
+ const textAttribute = isComponentTag(element.tag, "SAvatar") ? findAttribute(element, AVATAR_TEXT_ATTRIBUTE) : void 0;
1888
+ const text = textAttribute?.staticValue?.trim();
1889
+ if (!textAttribute || !text || text.length <= 3 && !WHITESPACE_CHARACTER_PATTERN.test(text)) return [];
1890
+ const initials = text.split(WHITESPACE_CHARACTER_PATTERN).filter(Boolean).map((word) => word.charAt(0).toUpperCase()).join("").slice(0, 3);
1891
+ return [{
1892
+ ...positionOf(textAttribute.node),
1893
+ rule: RULE_AVATAR_TEXT_NOT_INITIALS,
1894
+ severity: SEVERITY_WARNING,
1895
+ message: `\`text="${text}"\` on \`SAvatar\` is not initials: the avatar is a fixed-size circle, so a name is clipped to its first letters.`,
1896
+ fixHint: `Pass the initials and put the name in \`alt\`: \`<SAvatar text="${initials}" alt="${text}" />\`.`
1897
+ }];
1898
+ }
1899
+ };
1900
+ var labelWordsOf = (text) => (text.toLocaleLowerCase().match(LABEL_WORD_PATTERN) ?? []).filter((word) => word.length >= 3);
1901
+ /**
1902
+ * `hide-details` on a text field hides its `label` by design (it becomes the input's `aria-label`), so on screen only
1903
+ * the placeholder or a slot can say what the field is for. Warn when nothing visible does: no placeholder, or one that
1904
+ * shares no word with the label (`label="Search by name" placeholder="e.g. Anna"`). Bound values and slot content are
1905
+ * trusted.
1906
+ */
1907
+ var hiddenLabelNoVisibleNameRule = {
1908
+ id: RULE_HIDDEN_LABEL_NO_VISIBLE_NAME,
1909
+ check: ({ element }) => {
1910
+ const hideDetails = findPropAttribute(element, HIDE_DETAILS_ATTRIBUTE);
1911
+ const label = findAttribute(element, LABEL_ATTRIBUTE)?.staticValue;
1912
+ if (!isOneOfComponentTags(element.tag, LABELLED_FIELD_COMPONENTS) || !hideDetails || !isBooleanPropOn(element, "hide-details") || !label || childElementsOf(element).length > 0) return [];
1913
+ const placeholder = findAttribute(element, PLACEHOLDER_ATTRIBUTE);
1914
+ if (placeholder && placeholder.staticValue === void 0) return [];
1915
+ const placeholderWords = labelWordsOf(placeholder?.staticValue ?? "");
1916
+ if (labelWordsOf(label).some((word) => placeholderWords.includes(word))) return [];
1917
+ return [{
1918
+ ...positionOf(hideDetails.node),
1919
+ rule: RULE_HIDDEN_LABEL_NO_VISIBLE_NAME,
1920
+ severity: SEVERITY_WARNING,
1921
+ message: `\`hide-details\` on \`${element.tag}\` hides \`label="${label}"\` (it becomes the input's \`aria-label\`), and nothing visible names the field: ${placeholder ? `the placeholder "${placeholder.staticValue}" doesn't say what it is for` : "it has no placeholder"}.`,
1922
+ fixHint: `Keep the label visible by dropping \`hide-details\` (inside \`SFormRow\` the field still lines up with its buttons), or give it a placeholder that names it, e.g. \`placeholder="${label}"\`.`,
1923
+ recipe: RECIPE_FILTER_BAR
1924
+ }];
1925
+ }
1926
+ };
1927
+ /** The `v-on` / `@` directives on `element` with a static event name. */
1928
+ var eventListeners = (element) => element.props.filter(isDirective).filter((directive) => directive.name === "on").map((directive) => ({
1929
+ directive,
1930
+ event: staticArgument(directive.arg)
1931
+ }));
1932
+ var emptyStateActionEventRule = {
1933
+ id: RULE_EMPTY_STATE_ACTION_EVENT,
1934
+ check: ({ element }) => {
1935
+ if (!isComponentTag(element.tag, "SEmptyState")) return [];
1936
+ return eventListeners(element).filter(({ event }) => event !== void 0 && EMPTY_STATE_WRONG_ACTION_EVENTS.includes(event)).map(({ directive, event }) => ({
1937
+ ...positionOf(directive),
1938
+ rule: RULE_EMPTY_STATE_ACTION_EVENT,
1939
+ severity: SEVERITY_WARNING,
1940
+ message: `\`@${event ?? ""}\` on \`SEmptyState\` is not its action event: SEmptyState emits \`action\` from its button${event === "click" ? ", and a plain `@click` fires for a click anywhere in the block" : ", so this listener never fires"}.`,
1941
+ fixHint: `Listen to \`@action\`: \`<SEmptyState action-text="Create order" @action="${expressionSource(directive) ?? "onAction"}" />\`.`
1942
+ }));
1943
+ }
1944
+ };
1945
+ var emptyStateActionWithoutListenerRule = {
1946
+ id: RULE_EMPTY_STATE_ACTION_WITHOUT_LISTENER,
1947
+ check: ({ element }) => {
1948
+ const actionText = isComponentTag(element.tag, "SEmptyState") ? findPropAttribute(element, EMPTY_STATE_ACTION_TEXT_ATTRIBUTE) : void 0;
1949
+ const hasListener = eventListeners(element).some(({ event }) => event === void 0 || event === "action");
1950
+ const fillsActions = slotFills(element).some((fill) => staticArgument(fill.directive.arg) === EMPTY_STATE_ACTIONS_SLOT);
1951
+ if (!actionText || hasListener || fillsActions || hasObjectSpread(element)) return [];
1952
+ return [{
1953
+ ...positionOf(actionText.node),
1954
+ rule: RULE_EMPTY_STATE_ACTION_WITHOUT_LISTENER,
1955
+ severity: SEVERITY_WARNING,
1956
+ message: "`action-text` on `SEmptyState` renders a button, but nothing listens to its `action` event, so the button does nothing.",
1957
+ fixHint: "Add `@action=\"…\"`, or for navigation drop `action-text` and use the slot: `<SEmptyState title=\"No orders yet\"><template #actions><SButton color=\"primary\" to=\"/orders/new\">Create order</SButton></template></SEmptyState>`."
1958
+ }];
1959
+ }
1960
+ };
1961
+ var isFlushRowSibling = (element) => (ROW_TEXT_SIBLING_TAGS.includes(element.tag) || isOneOfComponentTags(element.tag, ROW_FLUSH_SIBLING_COMPONENTS)) && !staticClassNames(element).some((className) => HORIZONTAL_INSET_CLASS_PATTERN.test(className));
1962
+ /**
1963
+ * The elements beside `row`: its parent's other children, and, while the row sits in a wrapper that adds no
1964
+ * padding (`SForm`, `<form>`), that wrapper's siblings too.
1965
+ */
1966
+ var rowNeighbours = (row, ancestors) => {
1967
+ const neighbours = [];
1968
+ let current = row;
1969
+ for (const container of [...ancestors].reverse()) {
1970
+ neighbours.push(...childElementsOf(container).filter((child) => child !== current));
1971
+ if (!isOneOfComponentTags(container.tag, ROW_TRANSPARENT_WRAPPERS)) break;
1972
+ current = container;
1973
+ }
1974
+ return neighbours;
1975
+ };
1662
1976
  var behaviourRules = [
1663
1977
  nativeValidationInFormRule,
1664
1978
  hideDetailsHidesLabelRule,
1979
+ hiddenLabelNoVisibleNameRule,
1665
1980
  snackbarActionContrastRule,
1666
1981
  blockButtonsInRowRule,
1667
1982
  fieldButtonRowRule,
1668
1983
  cardTitleTextAlignRule,
1984
+ datePickerEmptyStringRule,
1985
+ fillHeightUnderAppRule,
1986
+ avatarTextNotInitialsRule,
1987
+ paginationLengthRowsRule,
1988
+ paginationZeroBasedRule,
1989
+ skeletonLoaderUnknownPresetRule,
1990
+ skeletonLoaderNeverHidesRule,
1991
+ emptyStateActionEventRule,
1992
+ emptyStateActionWithoutListenerRule,
1669
1993
  {
1670
- id: RULE_DATE_PICKER_EMPTY_STRING,
1671
- fixedIn: SUI_M2_FIXES_VERSION,
1672
- check: ({ element, scriptSource }) => {
1673
- const binding = isOneOfComponentTags(element.tag, DATE_PICKER_EMPTY_STRING_COMPONENTS) ? modelBinding(element) : void 0;
1674
- const source = binding && isDirective(binding) ? expressionSource(binding) : binding?.value?.content;
1675
- if (!binding || source === void 0) return [];
1676
- const isEmptyLiteral = EMPTY_STRING_EXPRESSION.test(source) || !isDirective(binding) && source === "";
1677
- const isEmptyInitial = MODEL_PATH_PATTERN.test(source) && startsAsEmptyString(source, scriptSource);
1678
- if (!isEmptyLiteral && !isEmptyInitial) return [];
1994
+ id: RULE_ROW_INSET_FROM_TEXT,
1995
+ check: ({ element, ancestors }) => {
1996
+ if (!isComponentTag(element.tag, "SRow") || hasObjectSpread(element)) return [];
1997
+ const hasOuterGuttersOff = isBooleanPropOn(element, ROW_NO_OUTER_GUTTERS_PROP);
1998
+ const flushSibling = isBooleanPropOn(element, "no-gutters") || hasOuterGuttersOff && !!findPropAttribute(element, "gap") ? void 0 : rowNeighbours(element, ancestors).find(isFlushRowSibling);
1999
+ if (!flushSibling) return [];
1679
2000
  return [{
1680
- ...positionOf(binding),
1681
- rule: RULE_DATE_PICKER_EMPTY_STRING,
2001
+ ...positionOf(element),
2002
+ rule: RULE_ROW_INSET_FROM_TEXT,
1682
2003
  severity: SEVERITY_WARNING,
1683
- message: isEmptyLiteral ? `\`${element.tag}\` gets \`''\` as its value: the picker opens on "Invalid date" and a grid of NaN.` : `\`${source}\` starts as \`''\` and is bound to \`${element.tag}\`: the picker opens on "Invalid date" and a grid of NaN.`,
1684
- fixHint: "Start an empty date as `null` (type the model `string | null`); `''` is not treated as \"no date\".",
2004
+ message: hasOuterGuttersOff ? `\`SRow no-outer-gutters\` beside \`<${flushSibling.tag}>\`: the row no longer pads itself, but each SColumn still pads its content by 8px, so the columns start 8px inside it.` : `\`SRow\` beside \`<${flushSibling.tag}>\`: the row and each SColumn pad by 8px, so the columns start 16px inside it.`,
2005
+ fixHint: "Add `no-outer-gutters :gap=\"16\"` to the `SRow` (gap replaces the column padding), and separate stacked rows with `class=\"s_mt__4\"`. Keep the default padding only when the inset is intended.",
2006
+ recipe: RECIPE_RESPONSIVE_GRID
2007
+ }];
2008
+ }
2009
+ },
2010
+ {
2011
+ id: RULE_NUMBER_INPUT_PREFERRED,
2012
+ check: ({ element, api }) => {
2013
+ const typeAttribute = findAttribute(element, INPUT_TYPE_ATTRIBUTE);
2014
+ if (!isComponentTag(element.tag, "SInput") || typeAttribute?.staticValue?.toLowerCase() !== "number" || !hasSuiComponent(api, "SNumberInput")) return [];
2015
+ const replacements = [...NUMBER_INPUT_PROP_REPLACEMENTS].filter(([name]) => findPropAttribute(element, name)).map(([name, replacement]) => `\`${name}\` → ${replacement}`);
2016
+ return [{
2017
+ ...positionOf(typeAttribute.node),
2018
+ rule: RULE_NUMBER_INPUT_PREFERRED,
2019
+ severity: SEVERITY_WARNING,
2020
+ message: "`SInput type=\"number\"` has no step buttons or `precision`, and hides a value below `min`. `SNumberInput` is the numeric field: `number | null` v-model, +/- buttons and ArrowUp/ArrowDown, clamping on blur, spinbutton semantics and no browser validation bubble.",
2021
+ fixHint: `Use \`<SNumberInput v-model="quantity" label="Quantity" :min="0" />\` (same \`label\`, \`rules\`, \`hide-details\`, \`hide-error\`, \`min\`, \`max\`, \`suffix\`; add \`:step\`, \`:precision="2"\` for money).${replacements.length ? ` Replace ${replacements.join("; ")}.` : ""}`,
1685
2022
  recipe: RECIPE_VALIDATED_FORM
1686
2023
  }];
1687
2024
  }
1688
2025
  },
1689
2026
  {
1690
- id: RULE_FILL_HEIGHT_UNDER_APP,
1691
- fixedIn: SUI_M2_FIXES_VERSION,
1692
- check: ({ element }) => {
1693
- if (!isComponentTag(element.tag, "SApp")) return [];
1694
- return childElementsOf(element).filter((child) => staticClassNames(child).includes(HEIGHT_FILL_CLASS)).map((child) => ({
1695
- ...positionOf(child),
1696
- rule: RULE_FILL_HEIGHT_UNDER_APP,
2027
+ id: RULE_TABS_IN_SLIDE_GROUP,
2028
+ check: ({ element, ancestors }) => {
2029
+ if (!isComponentTag(element.tag, "STabs") || !ancestors.some((ancestor) => isComponentTag(ancestor.tag, "SSlideGroup"))) return [];
2030
+ return [{
2031
+ ...positionOf(element),
2032
+ rule: RULE_TABS_IN_SLIDE_GROUP,
1697
2033
  severity: SEVERITY_WARNING,
1698
- message: `\`${HEIGHT_FILL_CLASS}\` on a direct child of \`SApp\` resolves to the content height before @khsura/sui 1.20.0 (SApp only has a min-height), so content centred inside it sticks to the top.`,
1699
- fixHint: "Upgrade @khsura/sui to 1.20.0 or later, or add `style=\"min-height: 100dvh\"` to this child.",
1700
- recipe: RECIPE_CENTERED_PAGE
1701
- }));
2034
+ message: "`STabs` inside `SSlideGroup`: STabs already keeps its tabs on one row that scrolls sideways, with an edge fade when they do not fit (or `wrap` for several rows).",
2035
+ fixHint: "Remove the `SSlideGroup` wrapper and use `<STabs v-model>` with `<STab :tab>` children directly.",
2036
+ recipe: RECIPE_TABBED_SECTIONS
2037
+ }];
1702
2038
  }
1703
2039
  }
1704
2040
  ];
@@ -1819,34 +2155,136 @@ var iconButtonLabelRule = {
1819
2155
  }] : [];
1820
2156
  }
1821
2157
  };
1822
- var rawReplacement = (element) => {
2158
+ var rawReplacement = (element, api) => {
1823
2159
  if (element.tag !== "input") return RAW_TAG_REPLACEMENTS.get(element.tag);
1824
2160
  const inputType = findAttribute(element, INPUT_TYPE_ATTRIBUTE)?.staticValue?.toLowerCase();
1825
- if (inputType && NON_VISUAL_INPUT_TYPES.includes(inputType)) return;
2161
+ if (inputType && (NON_VISUAL_INPUT_TYPES.includes(inputType) || inputType === "file")) return;
2162
+ if (inputType === "number" && hasSuiComponent(api, "SNumberInput")) return NUMBER_INPUT_COMPONENT;
1826
2163
  return (inputType ? RAW_INPUT_TYPE_REPLACEMENTS.get(inputType) : void 0) ?? RAW_TAG_REPLACEMENTS.get("input");
1827
2164
  };
2165
+ var noRawReplacementRule = {
2166
+ id: RULE_NO_RAW_REPLACEMENT,
2167
+ target: RULE_TARGET_ANY_ELEMENT,
2168
+ check: ({ element, api }) => {
2169
+ const replacement = rawReplacement(element, api);
2170
+ if (!replacement) return [];
2171
+ return [{
2172
+ ...positionOf(element),
2173
+ rule: RULE_NO_RAW_REPLACEMENT,
2174
+ severity: SEVERITY_WARNING,
2175
+ message: `Raw \`<${element.tag}>\` bypasses SUI theming, sizing and validation.`,
2176
+ fixHint: `Use \`${replacement}\` instead.`,
2177
+ recipe: element.tag === "dialog" ? RECIPE_ACTIVATOR_OVERLAYS : RECIPE_VALIDATED_FORM
2178
+ }];
2179
+ }
2180
+ };
2181
+ var isFileInputElement = (element) => element.tag === "input" && findAttribute(element, "type")?.staticValue?.toLowerCase() === "file";
2182
+ /** Whether a listener in `scope` opens the picker through the ref: `@click="fileInput?.click()"`. */
2183
+ var opensPickerThroughRef = (scope, refName) => [scope, ...descendantElementsOf(scope)].some((candidate) => candidate.props.some((prop) => {
2184
+ if (!isDirective(prop) || prop.name !== "on") return false;
2185
+ return [...(expressionSource(prop) ?? "").matchAll(PICKER_CLICK_CALL_PATTERN)].some(([call]) => call.split(MEMBER_PATH_SEPARATOR_PATTERN).includes(refName));
2186
+ }));
2187
+ /**
2188
+ * A raw `<input type="file">`, often hidden and opened by a button's `ref.click()`. Only for a `@khsura/sui`
2189
+ * whose API has SFileInput, so a project on an older release is not told to use a component it lacks.
2190
+ */
2191
+ var rawFileInputRule = {
2192
+ id: RULE_RAW_FILE_INPUT,
2193
+ target: RULE_TARGET_ANY_ELEMENT,
2194
+ check: ({ element, ancestors, api }) => {
2195
+ if (!isFileInputElement(element) || !api.components.some((component) => component.name === "SFileInput")) return [];
2196
+ const refName = findAttribute(element, "ref")?.staticValue;
2197
+ const scope = ancestors[0] ?? element;
2198
+ const isButtonHack = !!refName && opensPickerThroughRef(scope, refName);
2199
+ return [{
2200
+ ...positionOf(element),
2201
+ rule: RULE_RAW_FILE_INPUT,
2202
+ severity: SEVERITY_WARNING,
2203
+ message: isButtonHack ? `A file \`<input>\` opened by a button's \`${refName}.click()\` has no label of its own, skips \`rules\` and the error line, and its chosen file is never shown or announced.` : "A raw `<input type=\"file\">` bypasses SUI theming, its label, `rules` and the error line.",
2204
+ fixHint: `Use \`${FILE_INPUT_EXAMPLE}\` (\`variant="dropzone"\` for a drop area). Its model is a \`File[]\` (\`null\` when empty): read \`files?.[0]\` for one file, or watch the model / listen to \`@change\`, which passes the files, not a DOM event.`,
2205
+ recipe: RECIPE_VALIDATED_FORM
2206
+ }];
2207
+ }
2208
+ };
2209
+ /** `@change` on SFileInput passes `File[] | null`; code written for a native input reads `$event.target.files`. */
2210
+ var fileInputChangeEventRule = {
2211
+ id: RULE_FILE_INPUT_CHANGE_EVENT,
2212
+ check: ({ element }) => {
2213
+ if (!isComponentTag(element.tag, "SFileInput")) return [];
2214
+ return element.props.filter((prop) => isDirective(prop) && prop.name === "on" && staticArgument(prop.arg) === "change" && NATIVE_CHANGE_EVENT_ACCESS_PATTERN.test(expressionSource(prop) ?? "")).map((listener) => ({
2215
+ ...positionOf(listener),
2216
+ rule: RULE_FILE_INPUT_CHANGE_EVENT,
2217
+ severity: SEVERITY_ERROR,
2218
+ message: "`SFileInput` emits `change` with the chosen files (`File[] | null`), not a DOM event, so `.target` / `$event.files` is `undefined`.",
2219
+ fixHint: "Bind `v-model=\"files\"` and read `files?.[0]`, or take the files from the event: `@change=\"(files) => upload(files?.[0])\"`."
2220
+ }));
2221
+ }
2222
+ };
2223
+ var avatarImageInSlotRule = {
2224
+ id: RULE_AVATAR_IMAGE_IN_SLOT,
2225
+ check: ({ element }) => {
2226
+ if (!isComponentTag(element.tag, "SAvatar")) return [];
2227
+ return descendantElementsOf(element).filter((child) => isOneOfComponentTags(child.tag, AVATAR_SLOT_IMAGE_TAGS)).map((image) => {
2228
+ const source = findAttribute(image, "src");
2229
+ const imageBinding = source && isDirective(source.node) ? `:image="${expressionSource(source.node) ?? ""}"` : `image="${source?.staticValue ?? "…"}"`;
2230
+ return {
2231
+ ...positionOf(image),
2232
+ rule: RULE_AVATAR_IMAGE_IN_SLOT,
2233
+ severity: SEVERITY_WARNING,
2234
+ message: `\`<${image.tag}>\` inside \`SAvatar\` replaces the avatar's own image: when it fails to load, the avatar shows a broken image instead of the initials or the icon.`,
2235
+ fixHint: `Pass the URL to the avatar and drop the \`<${image.tag}>\`: \`<SAvatar ${imageBinding} text="JD" alt="Jane Doe" />\`.`
2236
+ };
2237
+ });
2238
+ }
2239
+ };
2240
+ var isSlotFillTemplate = (template) => template.props.filter(isDirective).some((directive) => directive.name === DIRECTIVE_SLOT);
2241
+ /** Children the group cannot overlap or count as one avatar: anything but SAvatar or a passthrough `<slot>`, looking through `<template v-for>`. */
2242
+ var strayAvatarGroupChildren = (element) => childElementsOf(element).flatMap((child) => {
2243
+ if (child.tag === "template") return isSlotFillTemplate(child) ? [] : strayAvatarGroupChildren(child);
2244
+ return isComponentTag(child.tag, "SAvatar") || AVATAR_GROUP_PASSTHROUGH_TAGS.includes(child.tag) ? [] : [child];
2245
+ });
2246
+ var avatarGroupChildRule = {
2247
+ id: RULE_AVATAR_GROUP_CHILD,
2248
+ check: ({ element }) => {
2249
+ if (!isComponentTag(element.tag, "SAvatarGroup")) return [];
2250
+ return strayAvatarGroupChildren(element).map((child) => ({
2251
+ ...positionOf(child),
2252
+ rule: RULE_AVATAR_GROUP_CHILD,
2253
+ severity: SEVERITY_WARNING,
2254
+ message: `\`<${child.tag}>\` is a direct child of \`SAvatarGroup\`: the group only overlaps and rings \`SAvatar\` children, so a wrapper breaks the overlap and counts as one avatar for \`max\`.`,
2255
+ fixHint: "Put each `SAvatar` directly in the group: `<SAvatar v-for=\"member in members\" :key=\"member.id\" :image=\"member.photoUrl\" :alt=\"member.name\" />`. For a tooltip or a link, wrap the whole group, not each avatar."
2256
+ }));
2257
+ }
2258
+ };
2259
+ /** Elements in the default slot of `element`: its children outside a `#slot` template, looking through plain `<template>`s. */
2260
+ var defaultSlotElements = (element) => childElementsOf(element).flatMap((child) => {
2261
+ if (child.tag === "template") return isSlotFillTemplate(child) ? [] : defaultSlotElements(child);
2262
+ return [child, ...descendantElementsOf(child)];
2263
+ });
1828
2264
  /** Rules about how components fit together, beyond what one component's API says. */
1829
2265
  var compositionRules = [
1830
2266
  activatorBindingRule,
1831
2267
  layoutForRule,
1832
2268
  formRulesOutsideFormRule,
1833
2269
  iconButtonLabelRule,
2270
+ noRawReplacementRule,
2271
+ avatarImageInSlotRule,
2272
+ avatarGroupChildRule,
1834
2273
  {
1835
- id: RULE_NO_RAW_REPLACEMENT,
1836
- target: RULE_TARGET_ANY_ELEMENT,
2274
+ id: RULE_EMPTY_STATE_OUTSIDE_NO_DATA_SLOT,
1837
2275
  check: ({ element }) => {
1838
- const replacement = rawReplacement(element);
1839
- if (!replacement) return [];
1840
- return [{
1841
- ...positionOf(element),
1842
- rule: RULE_NO_RAW_REPLACEMENT,
1843
- severity: SEVERITY_WARNING,
1844
- message: `Raw \`<${element.tag}>\` bypasses SUI theming, sizing and validation.`,
1845
- fixHint: `Use \`${replacement}\` instead.`,
1846
- recipe: element.tag === "dialog" ? RECIPE_ACTIVATOR_OVERLAYS : RECIPE_VALIDATED_FORM
1847
- }];
2276
+ if (!isOneOfComponentTags(element.tag, NO_DATA_SLOT_COMPONENTS)) return [];
2277
+ return defaultSlotElements(element).filter((child) => isComponentTag(child.tag, EMPTY_STATE_COMPONENT)).map((emptyState) => ({
2278
+ ...positionOf(emptyState),
2279
+ rule: RULE_EMPTY_STATE_OUTSIDE_NO_DATA_SLOT,
2280
+ severity: SEVERITY_ERROR,
2281
+ message: `\`SEmptyState\` in the default slot of \`${element.tag}\` is never rendered: its no-data content goes in the \`#${NO_DATA_SLOT_NAME}\` slot.`,
2282
+ fixHint: `Wrap it in the slot template: \`<${element.tag} …><template #${NO_DATA_SLOT_NAME}><SEmptyState size="small" icon="mdi-inbox-outline" title="Nothing here yet" /></template></${element.tag}>\`.`
2283
+ }));
1848
2284
  }
1849
- }
2285
+ },
2286
+ rawFileInputRule,
2287
+ fileInputChangeEventRule
1850
2288
  ];
1851
2289
  //#endregion
1852
2290
  //#region src/services/templateRules.ts
@@ -2197,7 +2635,7 @@ var registerValidateSuiTemplateTool = (server, loadSuiApi) => {
2197
2635
  //#region src/handlers/getRecipe.ts
2198
2636
  var registerGetRecipeTool = (server, recipeSourceOptions) => {
2199
2637
  server.registerTool(GET_RECIPE_TOOL_NAME, {
2200
- description: "Returns one tested @khsura/sui recipe: its notes (the rules it relies on) and the full copy-ready Vue SFC, plus a link to the live Storybook example. Names: app-shell, validated-form, activator-overlays, data-table, responsive-grid, theme-setup, filter-bar, centered-page. Unknown names return the name list.",
2638
+ description: "Returns one tested @khsura/sui recipe: its notes (the rules it relies on) and the full copy-ready Vue SFC, plus a link to the live Storybook example. Names: app-shell, validated-form, activator-overlays, data-table, responsive-grid, theme-setup, filter-bar, centered-page, tabbed-sections. Unknown names return the name list.",
2201
2639
  inputSchema: getRecipeInputSchema
2202
2640
  }, ({ name }) => {
2203
2641
  try {