@stacksjs/stx 0.2.342 → 0.2.344

package/dist/runtime-globals.js

@@ -205,6 +205,52 @@ export const RUNTIME_HANDLED_X_ATTRS = [
 export function runtimeHandledXAttrsLiteral() {
   return `{${RUNTIME_HANDLED_X_ATTRS.map((n) => `'${n}':1`).join(",")}}`;
 }
+export const RUNTIME_DIRECTIVE_NAMES = [
+  "class",
+  "style",
+  "text",
+  "html",
+  "show",
+  "model",
+  "if",
+  "ref"
+];
+export function runtimeDirectiveNamesLiteral() {
+  return `{${RUNTIME_DIRECTIVE_NAMES.map((n) => n === "if" ? "'if':1" : `${n}:1`).join(",")}}`;
+}
+export const RUNTIME_EVENT_NAMES = [
+  "click",
+  "dblclick",
+  "mousedown",
+  "mouseup",
+  "mousemove",
+  "mouseenter",
+  "mouseleave",
+  "keydown",
+  "keyup",
+  "keypress",
+  "input",
+  "change",
+  "submit",
+  "focus",
+  "blur",
+  "scroll",
+  "resize",
+  "touchstart",
+  "touchend",
+  "touchmove",
+  "contextmenu",
+  "wheel",
+  "pointerdown",
+  "pointerup",
+  "pointermove"
+];
+export function runtimeEventRegexLiteral() {
+  return `/^(${RUNTIME_EVENT_NAMES.join("|")})/`;
+}
+export function isRuntimeEventName(name) {
+  return RUNTIME_EVENT_NAMES.some((event) => name === event || name.startsWith(`${event}.`));
+}
 const BLANK_CACHE_MIN_BYTES = 65536, BLANK_CACHE_MAX_ENTRIES = 4, blankCache = new Map;
 export function clearBlankCache() {
   blankCache.clear();

package/dist/seo.d.ts

@@ -2,10 +2,15 @@
  * SEO (Search Engine Optimization) Module
  *
  * Provides directives and utilities for generating SEO-related HTML:
- * - `@meta('name', 'content')` - Generate meta tags
+ * - `@meta('name', 'content')` / `@meta('name', expression)` - Generate meta tags
  * - `@metaTag({ name, property, content })` - Meta tags with full control
- * - `@structuredData({ ... })` - JSON-LD structured data
- * - `@seo({ title, description, ... })` - Comprehensive SEO generation
+ * - `@structuredData({ ... })` / `@structuredData(expression)` - JSON-LD structured data
+ * - `@seo({ title, description, ... })` / `@seo(expression)` - Comprehensive SEO generation
+ *
+ * Every argument is an expression evaluated against the template's context, so
+ * a variable, a spread or a function call works wherever a literal does. A
+ * directive that cannot produce its tag says so: an inline comment where the
+ * tag would have been and a console warning naming the file.
  *
  * Also provides:
  * - Automatic SEO tag injection via `injectSeoTags()`
@@ -56,21 +61,36 @@
  */
 import type { CustomDirective, StxOptions } from './types';
 /**
- * Process @meta directive for generating meta tags.
- * Supports both simple `@meta('name', 'content')` and
- * OpenGraph `@meta('og:title')` formats.
+ * Process `@meta(...)` and `@metaTag({...})` in place, emitting the tags where
+ * the directives sit.
+ *
+ * This is the pass a partial's directives go through (a head partial is inside
+ * `<head>` already), and the page-level catch-all for any `@meta` the staging
+ * directive did not take. Arguments are resolved by `resolveMetaArguments`:
+ * `@meta('author', 'Jane')`, `@meta('author', author)`,
+ * `@meta('og:title', post.title)`, and the one-argument `@meta('og:title')`.
  */
-export declare function processMetaDirectives(template: string, context: Record<string, any>, _filePath: string, _options: StxOptions): string;
+export declare function processMetaDirectives(template: string, context: Record<string, any>, filePath: string, _options: StxOptions): string;
 /**
- * Process @structuredData directive for JSON-LD.
- * Automatically adds schema.org context if not provided.
+ * Process `@structuredData(...)` for JSON-LD.
+ *
+ * The argument is any expression that evaluates to an object, or an array of
+ * objects: `@structuredData({ '@type': 'Product', name })`,
+ * `@structuredData(product)`, `@structuredData(buildSchema(post))`. schema.org
+ * is filled in as the `@context` when the data has none.
  */
-export declare function processStructuredData(template: string, context: Record<string, any>, _filePath: string): string;
+export declare function processStructuredData(template: string, context: Record<string, any>, filePath: string): string;
 /**
- * Process @seo directive for automatic meta tag generation.
- * Generates title, description, Open Graph, Twitter, and structured data tags.
+ * Process `@seo(...)` for title, description, Open Graph, Twitter and
+ * structured data tags.
+ *
+ * The argument is any expression that evaluates to an object:
+ * `@seo({ title, description })`, `@seo(seo)`, `@seo({ ...seo, title })`,
+ * `@seo(buildSeo(page))`. `null` or `undefined` from a variable that exists
+ * renders nothing; a variable that does not exist, a value that is not an
+ * object, and keys `@seo` does not read are all reported.
  */
-export declare function processSeoDirective(template: string, context: Record<string, any>, _filePath: string, _options: StxOptions): string;
+export declare function processSeoDirective(template: string, context: Record<string, any>, filePath: string, _options: StxOptions): string;
 /**
  * Injects default SEO tags if no @seo directive is used.
  * Respects seo.enabled config and skipDefaultSeoTags option.
@@ -87,13 +107,15 @@ export declare function injectSeoTags(html: string, context: Record<string, any>
  *
  * This directive shadows `processMetaDirective` in head.ts, since custom
  * directives run first. It therefore has to do that function's job, which is
- * why it resolves unquoted arguments from the context and separates `property`
- * from `name` here rather than leaving it to a later pass that will never see
- * the directive.
+ * why it takes its arguments as written (`rawParams`) and resolves them with
+ * the same `resolveMetaArguments` the other two @meta passes use: a quoted
+ * value is text, anything else is an expression.
  */
 export declare const metaDirective: CustomDirective;
 /**
- * SEO structured data directive for JSON-LD generation
+ * SEO structured data directive for JSON-LD generation, the block form:
+ * `@structuredData { ... } @endstructuredData`. The body is JSON, not an
+ * expression; `@structuredData(expression)` is the form that reads variables.
  */
 export declare const structuredDataDirective: CustomDirective;
 /**