@wdprlib/ast 2.1.0 → 2.2.0

package/dist/index.cjs

@@ -54,7 +54,8 @@ __export(exports_src, {
   container: () => container,
   bold: () => bold,
   STYLE_SLOT_PREFIX: () => STYLE_SLOT_PREFIX,
-  DEFAULT_SETTINGS: () => DEFAULT_SETTINGS
+  DEFAULT_SETTINGS: () => DEFAULT_SETTINGS,
+  CSS_LENGTH_UNITS: () => CSS_LENGTH_UNITS
 });
 module.exports = __toCommonJS(exports_src);
 
@@ -253,6 +254,59 @@ function isParagraphSafe(element) {
 }
 // packages/ast/src/constants.ts
 var STYLE_SLOT_PREFIX = "\x00__IFTAGS_SLOT__";
+// packages/ast/src/css.ts
+var CSS_LENGTH_UNITS = [
+  "cqmax",
+  "cqmin",
+  "cqw",
+  "cqh",
+  "cqi",
+  "cqb",
+  "svmin",
+  "svmax",
+  "lvmin",
+  "lvmax",
+  "dvmin",
+  "dvmax",
+  "vmin",
+  "vmax",
+  "svw",
+  "svh",
+  "svi",
+  "svb",
+  "lvw",
+  "lvh",
+  "lvi",
+  "lvb",
+  "dvw",
+  "dvh",
+  "dvi",
+  "dvb",
+  "vw",
+  "vh",
+  "vi",
+  "vb",
+  "rcap",
+  "rem",
+  "rex",
+  "rch",
+  "ric",
+  "rlh",
+  "cap",
+  "em",
+  "ex",
+  "ch",
+  "ic",
+  "lh",
+  "cm",
+  "mm",
+  "in",
+  "pc",
+  "pt",
+  "px",
+  "q",
+  "%"
+];
 // packages/ast/src/expr-eval.ts
 var FALSE_VALUES = new Set(["false", "null", "", "0"]);
 function isTruthy(value) {

package/dist/index.d.cts

@@ -64,22 +64,29 @@ declare function createPoint(line: number, column: number, offset: number): Poin
 */
 declare function createPosition(start: Point, end: Point): Position;
 /**
-* AST element types for Wikidot markup.
+* Shared CSS value definitions used across parser and renderer.
 *
-* Wikidot markup (`+ heading`, `**bold**`, `[[module ListPages]]`, etc.) is parsed into
-* a structured representation defined here. Each {@link Element} is a tagged union of
-* `{ element: tag, data: payload }`, where the data shape for each tag is defined in
-* {@link ElementDataMap}.
+* @module
+*/
+/**
+* All CSS length units (plus percentage) accepted where Wikidot markup
+* takes a size value.
 *
-* @example
-* ```ts
-* import { parse } from "@wdprlib/parser";
-* const tree = parse("**Hello** world");
-* // tree.elements[0] → { element: "container", data: { type: "paragraph", ... } }
-* ```
+* This is intentionally a superset of what legacy Wikidot accepts: wdpr
+* extends size validation to modern CSS units (viewport, container-query,
+* and root-relative units) instead of mirroring Wikidot's historical
+* `px|em|%` allowlists. Units are canonicalized to lowercase.
 *
-* @module
+* @group CSS
+*/
+declare const CSS_LENGTH_UNITS: readonly ["cqmax", "cqmin", "cqw", "cqh", "cqi", "cqb", "svmin", "svmax", "lvmin", "lvmax", "dvmin", "dvmax", "vmin", "vmax", "svw", "svh", "svi", "svb", "lvw", "lvh", "lvi", "lvb", "dvw", "dvh", "dvi", "dvb", "vw", "vh", "vi", "vb", "rcap", "rem", "rex", "rch", "ric", "rlh", "cap", "em", "ex", "ch", "ic", "lh", "cm", "mm", "in", "pc", "pt", "px", "q", "%"];
+/**
+* A CSS length unit (or percentage) accepted in size values,
+* canonicalized to lowercase.
+*
+* @group CSS
 */
+type CssLengthUnit = (typeof CSS_LENGTH_UNITS)[number];
 /**
 * Key-value map of HTML attributes.
 * Populated from the Wikidot `_ class="foo" style="color:red"` attribute syntax.
@@ -488,6 +495,25 @@ type Module = {
 } | {
 	/** `[[module Rate]]` — page rating widget */
 	module: "rate";
+} | {
+	/** `[[module TagCloud]]` — weighted cloud of page tags */
+	module: "tag-cloud";
+	/** Numeric part of the font size for the lightest-weighted tag */
+	"min-font-size": number;
+	/** Numeric part of the font size for the heaviest-weighted tag */
+	"max-font-size": number;
+	/** Unit shared by both font sizes (lowercase) */
+	"font-size-unit": CssLengthUnit;
+	/** RGB components for the lightest-weighted tag */
+	"min-color": [number, number, number];
+	/** RGB components for the heaviest-weighted tag */
+	"max-color": [number, number, number];
+	/** Normalized link target prefix, always ending with `/tag/` */
+	target: string;
+	/** Maximum number of tags to display */
+	limit: number;
+	/** Category filter, or null for all categories */
+	category: string | null;
 } | {
 	/** `[[module ListUsers]]` — user listing with template body */
 	module: "list-users";
@@ -1304,4 +1330,4 @@ declare function evaluateExpression(expr: string): ExprResult;
 * @group Core
 */
 type Version = "wikidot";
-export { text, paragraph, listItemSubList, listItemElements, list, link, lineBreak, italics, isTruthy, isStringContainerType, isParagraphSafe, isHeaderType, isContainerTypeParagraphSafe, isAlignType, horizontalRule, heading, formatExprValue, evaluateExpression, createSettings, createPosition, createPoint, container, bold, WikitextSettings, WikitextMode, Version, VariableMap, UserData, TocEntry, TableRow, TableOfContentsData, TableData, TableCell, TabData, SyntaxTree, StringContainerType, STYLE_SLOT_PREFIX, Position, Point, ParseResult, PageRef, Module, MathInlineData, MathData, ListType, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LinkData, IncludeData, ImageSource, ImageData, IframeData, IfTagsData, IfExprData, IfCondData, HtmlData, HeadingLevel, Heading, HeaderType, FootnoteBlockData, FloatAlignment, ExprResult, ExprData, EmbedBlockData, Embed, ElementOf, ElementName, ElementDataMap, ElementData, Element, DiagnosticSeverity, Diagnostic, DefinitionListItem, DateItem, DateData, DEFAULT_SETTINGS, ContainerType, ContainerData, ColorData, CollapsibleData, CodeBlockData, ClearFloat, BibliographyCiteData, BibliographyBlockData, AttributeMap, AnchorTarget, AnchorData, Alignment, AlignType };
+export { text, paragraph, listItemSubList, listItemElements, list, link, lineBreak, italics, isTruthy, isStringContainerType, isParagraphSafe, isHeaderType, isContainerTypeParagraphSafe, isAlignType, horizontalRule, heading, formatExprValue, evaluateExpression, createSettings, createPosition, createPoint, container, bold, WikitextSettings, WikitextMode, Version, VariableMap, UserData, TocEntry, TableRow, TableOfContentsData, TableData, TableCell, TabData, SyntaxTree, StringContainerType, STYLE_SLOT_PREFIX, Position, Point, ParseResult, PageRef, Module, MathInlineData, MathData, ListType, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LinkData, IncludeData, ImageSource, ImageData, IframeData, IfTagsData, IfExprData, IfCondData, HtmlData, HeadingLevel, Heading, HeaderType, FootnoteBlockData, FloatAlignment, ExprResult, ExprData, EmbedBlockData, Embed, ElementOf, ElementName, ElementDataMap, ElementData, Element, DiagnosticSeverity, Diagnostic, DefinitionListItem, DateItem, DateData, DEFAULT_SETTINGS, CssLengthUnit, ContainerType, ContainerData, ColorData, CollapsibleData, CodeBlockData, ClearFloat, CSS_LENGTH_UNITS, BibliographyCiteData, BibliographyBlockData, AttributeMap, AnchorTarget, AnchorData, Alignment, AlignType };

package/dist/index.d.ts

@@ -64,22 +64,29 @@ declare function createPoint(line: number, column: number, offset: number): Poin
 */
 declare function createPosition(start: Point, end: Point): Position;
 /**
-* AST element types for Wikidot markup.
+* Shared CSS value definitions used across parser and renderer.
 *
-* Wikidot markup (`+ heading`, `**bold**`, `[[module ListPages]]`, etc.) is parsed into
-* a structured representation defined here. Each {@link Element} is a tagged union of
-* `{ element: tag, data: payload }`, where the data shape for each tag is defined in
-* {@link ElementDataMap}.
+* @module
+*/
+/**
+* All CSS length units (plus percentage) accepted where Wikidot markup
+* takes a size value.
 *
-* @example
-* ```ts
-* import { parse } from "@wdprlib/parser";
-* const tree = parse("**Hello** world");
-* // tree.elements[0] → { element: "container", data: { type: "paragraph", ... } }
-* ```
+* This is intentionally a superset of what legacy Wikidot accepts: wdpr
+* extends size validation to modern CSS units (viewport, container-query,
+* and root-relative units) instead of mirroring Wikidot's historical
+* `px|em|%` allowlists. Units are canonicalized to lowercase.
 *
-* @module
+* @group CSS
+*/
+declare const CSS_LENGTH_UNITS: readonly ["cqmax", "cqmin", "cqw", "cqh", "cqi", "cqb", "svmin", "svmax", "lvmin", "lvmax", "dvmin", "dvmax", "vmin", "vmax", "svw", "svh", "svi", "svb", "lvw", "lvh", "lvi", "lvb", "dvw", "dvh", "dvi", "dvb", "vw", "vh", "vi", "vb", "rcap", "rem", "rex", "rch", "ric", "rlh", "cap", "em", "ex", "ch", "ic", "lh", "cm", "mm", "in", "pc", "pt", "px", "q", "%"];
+/**
+* A CSS length unit (or percentage) accepted in size values,
+* canonicalized to lowercase.
+*
+* @group CSS
 */
+type CssLengthUnit = (typeof CSS_LENGTH_UNITS)[number];
 /**
 * Key-value map of HTML attributes.
 * Populated from the Wikidot `_ class="foo" style="color:red"` attribute syntax.
@@ -488,6 +495,25 @@ type Module = {
 } | {
 	/** `[[module Rate]]` — page rating widget */
 	module: "rate";
+} | {
+	/** `[[module TagCloud]]` — weighted cloud of page tags */
+	module: "tag-cloud";
+	/** Numeric part of the font size for the lightest-weighted tag */
+	"min-font-size": number;
+	/** Numeric part of the font size for the heaviest-weighted tag */
+	"max-font-size": number;
+	/** Unit shared by both font sizes (lowercase) */
+	"font-size-unit": CssLengthUnit;
+	/** RGB components for the lightest-weighted tag */
+	"min-color": [number, number, number];
+	/** RGB components for the heaviest-weighted tag */
+	"max-color": [number, number, number];
+	/** Normalized link target prefix, always ending with `/tag/` */
+	target: string;
+	/** Maximum number of tags to display */
+	limit: number;
+	/** Category filter, or null for all categories */
+	category: string | null;
 } | {
 	/** `[[module ListUsers]]` — user listing with template body */
 	module: "list-users";
@@ -1304,4 +1330,4 @@ declare function evaluateExpression(expr: string): ExprResult;
 * @group Core
 */
 type Version = "wikidot";
-export { text, paragraph, listItemSubList, listItemElements, list, link, lineBreak, italics, isTruthy, isStringContainerType, isParagraphSafe, isHeaderType, isContainerTypeParagraphSafe, isAlignType, horizontalRule, heading, formatExprValue, evaluateExpression, createSettings, createPosition, createPoint, container, bold, WikitextSettings, WikitextMode, Version, VariableMap, UserData, TocEntry, TableRow, TableOfContentsData, TableData, TableCell, TabData, SyntaxTree, StringContainerType, STYLE_SLOT_PREFIX, Position, Point, ParseResult, PageRef, Module, MathInlineData, MathData, ListType, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LinkData, IncludeData, ImageSource, ImageData, IframeData, IfTagsData, IfExprData, IfCondData, HtmlData, HeadingLevel, Heading, HeaderType, FootnoteBlockData, FloatAlignment, ExprResult, ExprData, EmbedBlockData, Embed, ElementOf, ElementName, ElementDataMap, ElementData, Element, DiagnosticSeverity, Diagnostic, DefinitionListItem, DateItem, DateData, DEFAULT_SETTINGS, ContainerType, ContainerData, ColorData, CollapsibleData, CodeBlockData, ClearFloat, BibliographyCiteData, BibliographyBlockData, AttributeMap, AnchorTarget, AnchorData, Alignment, AlignType };
+export { text, paragraph, listItemSubList, listItemElements, list, link, lineBreak, italics, isTruthy, isStringContainerType, isParagraphSafe, isHeaderType, isContainerTypeParagraphSafe, isAlignType, horizontalRule, heading, formatExprValue, evaluateExpression, createSettings, createPosition, createPoint, container, bold, WikitextSettings, WikitextMode, Version, VariableMap, UserData, TocEntry, TableRow, TableOfContentsData, TableData, TableCell, TabData, SyntaxTree, StringContainerType, STYLE_SLOT_PREFIX, Position, Point, ParseResult, PageRef, Module, MathInlineData, MathData, ListType, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LinkData, IncludeData, ImageSource, ImageData, IframeData, IfTagsData, IfExprData, IfCondData, HtmlData, HeadingLevel, Heading, HeaderType, FootnoteBlockData, FloatAlignment, ExprResult, ExprData, EmbedBlockData, Embed, ElementOf, ElementName, ElementDataMap, ElementData, Element, DiagnosticSeverity, Diagnostic, DefinitionListItem, DateItem, DateData, DEFAULT_SETTINGS, CssLengthUnit, ContainerType, ContainerData, ColorData, CollapsibleData, CodeBlockData, ClearFloat, CSS_LENGTH_UNITS, BibliographyCiteData, BibliographyBlockData, AttributeMap, AnchorTarget, AnchorData, Alignment, AlignType };

package/dist/index.js

@@ -193,6 +193,59 @@ function isParagraphSafe(element) {
 }
 // packages/ast/src/constants.ts
 var STYLE_SLOT_PREFIX = "\x00__IFTAGS_SLOT__";
+// packages/ast/src/css.ts
+var CSS_LENGTH_UNITS = [
+  "cqmax",
+  "cqmin",
+  "cqw",
+  "cqh",
+  "cqi",
+  "cqb",
+  "svmin",
+  "svmax",
+  "lvmin",
+  "lvmax",
+  "dvmin",
+  "dvmax",
+  "vmin",
+  "vmax",
+  "svw",
+  "svh",
+  "svi",
+  "svb",
+  "lvw",
+  "lvh",
+  "lvi",
+  "lvb",
+  "dvw",
+  "dvh",
+  "dvi",
+  "dvb",
+  "vw",
+  "vh",
+  "vi",
+  "vb",
+  "rcap",
+  "rem",
+  "rex",
+  "rch",
+  "ric",
+  "rlh",
+  "cap",
+  "em",
+  "ex",
+  "ch",
+  "ic",
+  "lh",
+  "cm",
+  "mm",
+  "in",
+  "pc",
+  "pt",
+  "px",
+  "q",
+  "%"
+];
 // packages/ast/src/expr-eval.ts
 var FALSE_VALUES = new Set(["false", "null", "", "0"]);
 function isTruthy(value) {
@@ -640,5 +693,6 @@ export {
   container,
   bold,
   STYLE_SLOT_PREFIX,
-  DEFAULT_SETTINGS
+  DEFAULT_SETTINGS,
+  CSS_LENGTH_UNITS
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdprlib/ast",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "AST types for Wikidot markup",
   "keywords": [
     "ast",

package/src/css.ts

@@ -0,0 +1,83 @@
+/**
+ * Shared CSS value definitions used across parser and renderer.
+ *
+ * @module
+ */
+
+/**
+ * All CSS length units (plus percentage) accepted where Wikidot markup
+ * takes a size value.
+ *
+ * This is intentionally a superset of what legacy Wikidot accepts: wdpr
+ * extends size validation to modern CSS units (viewport, container-query,
+ * and root-relative units) instead of mirroring Wikidot's historical
+ * `px|em|%` allowlists. Units are canonicalized to lowercase.
+ *
+ * @group CSS
+ */
+export const CSS_LENGTH_UNITS = [
+  // Container-query units
+  "cqmax",
+  "cqmin",
+  "cqw",
+  "cqh",
+  "cqi",
+  "cqb",
+  // Viewport units
+  "svmin",
+  "svmax",
+  "lvmin",
+  "lvmax",
+  "dvmin",
+  "dvmax",
+  "vmin",
+  "vmax",
+  "svw",
+  "svh",
+  "svi",
+  "svb",
+  "lvw",
+  "lvh",
+  "lvi",
+  "lvb",
+  "dvw",
+  "dvh",
+  "dvi",
+  "dvb",
+  "vw",
+  "vh",
+  "vi",
+  "vb",
+  // Root-relative font units
+  "rcap",
+  "rem",
+  "rex",
+  "rch",
+  "ric",
+  "rlh",
+  // Font-relative units
+  "cap",
+  "em",
+  "ex",
+  "ch",
+  "ic",
+  "lh",
+  // Absolute units
+  "cm",
+  "mm",
+  "in",
+  "pc",
+  "pt",
+  "px",
+  "q",
+  // Percentage
+  "%",
+] as const;
+
+/**
+ * A CSS length unit (or percentage) accepted in size values,
+ * canonicalized to lowercase.
+ *
+ * @group CSS
+ */
+export type CssLengthUnit = (typeof CSS_LENGTH_UNITS)[number];

package/src/element.ts

@@ -16,6 +16,8 @@
  * @module
  */
 
+import type { CssLengthUnit } from "./css";
+
 // ---------------------------------------------------------------------------
 // Primitive types
 // ---------------------------------------------------------------------------
@@ -500,6 +502,26 @@ export type Module =
       /** `[[module Rate]]` — page rating widget */
       module: "rate";
     }
+  | {
+      /** `[[module TagCloud]]` — weighted cloud of page tags */
+      module: "tag-cloud";
+      /** Numeric part of the font size for the lightest-weighted tag */
+      "min-font-size": number;
+      /** Numeric part of the font size for the heaviest-weighted tag */
+      "max-font-size": number;
+      /** Unit shared by both font sizes (lowercase) */
+      "font-size-unit": CssLengthUnit;
+      /** RGB components for the lightest-weighted tag */
+      "min-color": [number, number, number];
+      /** RGB components for the heaviest-weighted tag */
+      "max-color": [number, number, number];
+      /** Normalized link target prefix, always ending with `/tag/` */
+      target: string;
+      /** Maximum number of tags to display */
+      limit: number;
+      /** Category filter, or null for all categories */
+      category: string | null;
+    }
   | {
       /** `[[module ListUsers]]` — user listing with template body */
       module: "list-users";

package/src/index.ts

@@ -110,6 +110,10 @@ export type { Diagnostic, DiagnosticSeverity, ParseResult } from "./diagnostic";
 // Constants
 export { STYLE_SLOT_PREFIX } from "./constants";
 
+// CSS value definitions
+export type { CssLengthUnit } from "./css";
+export { CSS_LENGTH_UNITS } from "./css";
+
 // Wikitext settings
 export type { WikitextMode, WikitextSettings } from "./settings";