@svelte-lean/vite 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @svelte-lean/vite
 
+## 0.6.0
+
+### Minor Changes
+
+- dda6d05: The scanner discovers attribute behaviors by attribute name: `data-slean-hint` and
+  `data-slean-copy` on any element inject the hint and copy registration modules, whether the value
+  is static, an `{expression}` or absent; they are never reported as dynamic markers. The mapping is
+  exported as `ATTRIBUTE_BEHAVIORS`.
+
+### Patch Changes
+
+- Updated dependencies [dda6d05]
+  - @svelte-lean/primitives@0.6.0
+
+## 0.5.0
+
+### Patch Changes
+
+- @svelte-lean/primitives@0.5.0
+
 ## 0.4.0
 
 ### Patch Changes

package/README.md

@@ -79,6 +79,20 @@ Discovered:
 <div data-slean=tabs>
 ```
 
+Attribute behaviors (ADR 0009) are discovered by attribute name, on any element and whatever the
+value, so a dynamic value is a use of the behavior and never a dynamic marker:
+
+```svelte
+<td data-slean-hint={row.name}>…</td>
+<!-- @svelte-lean/primitives/hint/register -->
+<button data-slean-copy={row.id}>…</button>
+<!-- @svelte-lean/primitives/copy/register -->
+```
+
+The attribute → behavior map is exported as `ATTRIBUTE_BEHAVIORS`. An attribute that reaches an
+element only through a spread (`{...rest}`) is not visible to the scanner; import the registration
+module manually.
+
 Not discovered (dynamic):
 
 ```svelte

package/dist/behaviors.d.ts

@@ -6,6 +6,13 @@ export declare const DEFAULT_PACKAGE = "@svelte-lean/primitives";
  * runtime, so its marker is recorded for the manifest and report only.
  */
 export declare const BUILTIN_BEHAVIORS: Readonly<Record<string, string | false>>;
+/**
+ * Attribute behaviors (ADR 0009): an element carrying one of these attributes uses the behavior,
+ * whatever the attribute's value, static or `{expression}`. The attribute name decides the
+ * behavior, so a dynamic value is never a dynamic marker. Kept equal to the `attribute` of the
+ * `@svelte-lean/primitives` contracts by the drift test in packages/primitives/tests/registry.test.ts.
+ */
+export declare const ATTRIBUTE_BEHAVIORS: Readonly<Record<string, string>>;
 export type BehaviorResolution = {
     kind: 'runtime';
     module: string;

package/dist/behaviors.js

@@ -71,7 +71,19 @@ export const BUILTIN_BEHAVIORS = Object.freeze({
     'context-menu': `${DEFAULT_PACKAGE}/context-menu/register`,
     'file-drop': `${DEFAULT_PACKAGE}/file-drop/register`,
     'hover-card': `${DEFAULT_PACKAGE}/hover-card/register`,
-    menubar: `${DEFAULT_PACKAGE}/menubar/register`
+    menubar: `${DEFAULT_PACKAGE}/menubar/register`,
+    hint: `${DEFAULT_PACKAGE}/hint/register`,
+    copy: `${DEFAULT_PACKAGE}/copy/register`
+});
+/**
+ * Attribute behaviors (ADR 0009): an element carrying one of these attributes uses the behavior,
+ * whatever the attribute's value, static or `{expression}`. The attribute name decides the
+ * behavior, so a dynamic value is never a dynamic marker. Kept equal to the `attribute` of the
+ * `@svelte-lean/primitives` contracts by the drift test in packages/primitives/tests/registry.test.ts.
+ */
+export const ATTRIBUTE_BEHAVIORS = Object.freeze({
+    'data-slean-hint': 'hint',
+    'data-slean-copy': 'copy'
 });
 /**
  * Maps a behavior name to what the build should do with it. `options.behaviors` wins over the

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { svelteLean } from './plugin.js';
 export { scan } from './scanner.js';
-export { BUILTIN_BEHAVIORS } from './behaviors.js';
+export { ATTRIBUTE_BEHAVIORS, BUILTIN_BEHAVIORS } from './behaviors.js';
 export type { SvelteLeanOptions, ScanResult, DynamicMarker, BehaviorManifest, ManifestBehavior } from './types.js';

package/dist/index.js

@@ -1,5 +1,5 @@
-// Public entry. `svelteLean()` is the product; `scan()` and `BUILTIN_BEHAVIORS` are exported for
+// Public entry. `svelteLean()` is the product; `scan()`, `BUILTIN_BEHAVIORS` and `ATTRIBUTE_BEHAVIORS` are exported for
 // tooling that wants the same discovery without the plugin. Everything else in src/ is internal.
 export { svelteLean } from './plugin.js';
 export { scan } from './scanner.js';
-export { BUILTIN_BEHAVIORS } from './behaviors.js';
+export { ATTRIBUTE_BEHAVIORS, BUILTIN_BEHAVIORS } from './behaviors.js';

package/dist/scanner.d.ts

@@ -13,7 +13,8 @@ export declare function locate(source: string, index: number): {
  */
 export declare function skipExpression(source: string, start: number, result?: ScanResult): number;
 /**
- * Finds static `data-slean="name"` markers and dynamic `data-slean={…}` markers in Svelte source.
+ * Finds static `data-slean="name"` markers, attribute behaviors (`data-slean-hint`,
+ * `data-slean-copy`) and dynamic `data-slean={…}` markers in Svelte source.
  * Pure: no I/O, no plugin context. `id` is only carried into the result for diagnostics.
  */
 export declare function scan(source: string, id?: string): ScanResult;

package/dist/scanner.js

@@ -1,3 +1,4 @@
+import { ATTRIBUTE_BEHAVIORS } from './behaviors.js';
 /**
  * Lexical scanner for Svelte Lean behavior markers.
  *
@@ -9,6 +10,10 @@
  * string, template and regular-expression literals and comments are skipped so their quotes and
  * braces cannot unbalance it; an expression that never closes is recorded in
  * `ScanResult.unterminated` so a miss is never silent.
+ *
+ * Attribute behaviors (ADR 0009) are found by attribute name: `data-slean-hint` or
+ * `data-slean-copy` on an element uses that behavior whatever its value, static, `{expression}`
+ * or absent, so they never produce a dynamic marker.
  */
 const ATTRIBUTE = 'data-slean';
 const RAW_TEXT_ELEMENTS = new Set(['script', 'style']);
@@ -324,6 +329,9 @@ function scanTag(source, start, result) {
                 continue;
             }
             const attrName = source.slice(attrStart, i);
+            const lower = attrName.toLowerCase();
+            if (Object.hasOwn(ATTRIBUTE_BEHAVIORS, lower))
+                result.behaviors.add(ATTRIBUTE_BEHAVIORS[lower]);
             let j = i;
             while (j < n && isWhitespace(source.charCodeAt(j)))
                 j++;
@@ -334,7 +342,7 @@ function scanTag(source, start, result) {
                 j++;
             const value = readAttributeValue(source, j, result);
             i = value.end;
-            if (attrName.toLowerCase() !== ATTRIBUTE)
+            if (lower !== ATTRIBUTE)
                 continue;
             if (value.dynamic) {
                 const { line, column } = locate(source, attrStart);
@@ -357,7 +365,8 @@ function scanTag(source, start, result) {
     return i;
 }
 /**
- * Finds static `data-slean="name"` markers and dynamic `data-slean={…}` markers in Svelte source.
+ * Finds static `data-slean="name"` markers, attribute behaviors (`data-slean-hint`,
+ * `data-slean-copy`) and dynamic `data-slean={…}` markers in Svelte source.
  * Pure: no I/O, no plugin context. `id` is only carried into the result for diagnostics.
  */
 export function scan(source, id) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svelte-lean/vite",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Vite integration for Svelte Lean: discovers data-slean behaviors in Svelte markup at build time and injects only the registration modules that are used.",
   "license": "MIT",
   "author": "Ömer Say",
@@ -29,7 +29,7 @@
     "test": "yarn run -T vitest run"
   },
   "peerDependencies": {
-    "@svelte-lean/primitives": "^0.4.0",
+    "@svelte-lean/primitives": "^0.6.0",
     "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {