@wdprlib/ast 2.2.0 → 2.4.0

package/dist/index.cjs

@@ -54,6 +54,7 @@ __export(exports_src, {
   container: () => container,
   bold: () => bold,
   STYLE_SLOT_PREFIX: () => STYLE_SLOT_PREFIX,
+  STYLE_ANCHOR_PREFIX: () => STYLE_ANCHOR_PREFIX,
   DEFAULT_SETTINGS: () => DEFAULT_SETTINGS,
   CSS_LENGTH_UNITS: () => CSS_LENGTH_UNITS
 });
@@ -254,6 +255,7 @@ function isParagraphSafe(element) {
 }
 // packages/ast/src/constants.ts
 var STYLE_SLOT_PREFIX = "\x00__IFTAGS_SLOT__";
+var STYLE_ANCHOR_PREFIX = "\x00__STYLE_ANCHOR__";
 // packages/ast/src/css.ts
 var CSS_LENGTH_UNITS = [
   "cqmax",

package/dist/index.d.cts

@@ -642,6 +642,78 @@ interface ImageData {
 	attributes: AttributeMap;
 }
 /**
+* Image size keyword accepted by `[[gallery]]`.
+* Invalid or missing values fall back to `"thumbnail"` at parse time,
+* matching the Wikidot renderer.
+*
+* @group Element Data
+*/
+type GallerySize = "small" | "medium" | "thumbnail" | "square" | "original";
+/**
+* Sort order for auto-collected gallery files, normalized at parse time.
+* Deprecated Wikidot aliases (`nameDesc`, `dateAdded`, `dateAddedDesc`) and
+* the ListPages-style `"... desc desc"` forms are folded into these four
+* values. Only meaningful for the content-less (auto) form.
+*
+* @group Element Data
+*/
+type GalleryOrder = "name" | "name desc" | "created_at" | "created_at desc";
+/**
+* A single `: source link="..." alt="..."` entry inside `[[gallery]]`.
+*
+* @group Element Data
+*/
+interface GalleryItem {
+	/**
+	* Raw image source string with any leading `*` removed.
+	* Classification follows the Wikidot rules and happens at render time:
+	* a source containing `://` is external, one containing `/` refers to
+	* another page's file, anything else is a file on the current page.
+	*/
+	source: string;
+	/**
+	* Link target with any leading `*` removed, or null when the item has no
+	* `link` attribute.
+	*/
+	link: string | null;
+	/** Alternative text for the image, or null when no `alt` attribute is given */
+	alt: string | null;
+	/** true if the link opens in a new window (`*` prefix on source or link) */
+	newWindow: boolean;
+}
+/**
+* Body of a `[[gallery]]` element.
+*
+* - `"items"` — the content form with explicit `: source` lines.
+*   `items` is always non-empty: the content form requires at least one
+*   line to parse.
+* - `"auto"` — the content-less form, which shows the current page's image
+*   attachments. `files` is null until data resolution fills it with the
+*   attachment filenames (already sorted by the gallery's `order`).
+*
+* @group Element Data
+*/
+type GalleryContent = {
+	type: "items";
+	items: GalleryItem[];
+} | {
+	type: "auto";
+	files: string[] | null;
+};
+/**
+* Data for `[[gallery]]` elements.
+*
+* @group Element Data
+*/
+interface GalleryData {
+	size: GallerySize;
+	/** Sort order for auto-collected files (parse-time normalized) */
+	order: GalleryOrder;
+	/** false when `viewer="no"`/`"false"` disables the lightbox */
+	viewer: boolean;
+	content: GalleryContent;
+}
+/**
 * Data for `[[toc]]` (table of contents) elements.
 *
 * @group Element Data
@@ -852,6 +924,7 @@ type ElementDataMap = {
 	"anchor-name": string;
 	link: LinkData;
 	image: ImageData;
+	gallery: GalleryData;
 	list: ListData;
 	"definition-list": DefinitionListItem[];
 	collapsible: CollapsibleData;
@@ -1160,6 +1233,13 @@ interface ParseResult {
 */
 declare const STYLE_SLOT_PREFIX = "\0__IFTAGS_SLOT__";
 /**
+* Sentinel prefix for invisible style-position anchors retained in the AST.
+*
+* The suffix is the previously collected CSS text. Renderers must not emit
+* these synthetic style elements.
+*/
+declare const STYLE_ANCHOR_PREFIX = "\0__STYLE_ANCHOR__";
+/**
 * Context-dependent settings for the Wikidot parser and renderer.
 *
 * Wikidot content appears in several different contexts — full wiki pages,
@@ -1321,6 +1401,28 @@ declare function formatExprValue(n: number): string;
 * @returns A success result with a numeric value, or an error result with a message.
 */
 declare function evaluateExpression(expr: string): ExprResult;
+/** Attachment metadata used by page-contextual gallery rendering. */
+interface WikitextPageFile {
+	name: string;
+	createdAt?: number;
+}
+/**
+* Page data shared by high-level parser and renderer APIs.
+*
+* `fullName` is the category-qualified Wikidot page name. `unixName`, when
+* available, is the separately named URL-safe page identifier.
+*/
+interface WikitextPageContext {
+	fullName: string;
+	unixName?: string;
+	tags: string[];
+	urlPath?: string;
+	site?: string;
+	domain?: string;
+	siteDomains?: Record<string, string>;
+	resolveSiteDomain?: (site: string) => string | null | undefined;
+	files?: WikitextPageFile[];
+}
 /**
 * Identifies the source markup dialect.
 *
@@ -1330,4 +1432,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, CssLengthUnit, ContainerType, ContainerData, ColorData, CollapsibleData, CodeBlockData, ClearFloat, CSS_LENGTH_UNITS, 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, WikitextPageFile, WikitextPageContext, WikitextMode, Version, VariableMap, UserData, TocEntry, TableRow, TableOfContentsData, TableData, TableCell, TabData, SyntaxTree, StringContainerType, STYLE_SLOT_PREFIX, STYLE_ANCHOR_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, GallerySize, GalleryOrder, GalleryItem, GalleryData, GalleryContent, 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

@@ -642,6 +642,78 @@ interface ImageData {
 	attributes: AttributeMap;
 }
 /**
+* Image size keyword accepted by `[[gallery]]`.
+* Invalid or missing values fall back to `"thumbnail"` at parse time,
+* matching the Wikidot renderer.
+*
+* @group Element Data
+*/
+type GallerySize = "small" | "medium" | "thumbnail" | "square" | "original";
+/**
+* Sort order for auto-collected gallery files, normalized at parse time.
+* Deprecated Wikidot aliases (`nameDesc`, `dateAdded`, `dateAddedDesc`) and
+* the ListPages-style `"... desc desc"` forms are folded into these four
+* values. Only meaningful for the content-less (auto) form.
+*
+* @group Element Data
+*/
+type GalleryOrder = "name" | "name desc" | "created_at" | "created_at desc";
+/**
+* A single `: source link="..." alt="..."` entry inside `[[gallery]]`.
+*
+* @group Element Data
+*/
+interface GalleryItem {
+	/**
+	* Raw image source string with any leading `*` removed.
+	* Classification follows the Wikidot rules and happens at render time:
+	* a source containing `://` is external, one containing `/` refers to
+	* another page's file, anything else is a file on the current page.
+	*/
+	source: string;
+	/**
+	* Link target with any leading `*` removed, or null when the item has no
+	* `link` attribute.
+	*/
+	link: string | null;
+	/** Alternative text for the image, or null when no `alt` attribute is given */
+	alt: string | null;
+	/** true if the link opens in a new window (`*` prefix on source or link) */
+	newWindow: boolean;
+}
+/**
+* Body of a `[[gallery]]` element.
+*
+* - `"items"` — the content form with explicit `: source` lines.
+*   `items` is always non-empty: the content form requires at least one
+*   line to parse.
+* - `"auto"` — the content-less form, which shows the current page's image
+*   attachments. `files` is null until data resolution fills it with the
+*   attachment filenames (already sorted by the gallery's `order`).
+*
+* @group Element Data
+*/
+type GalleryContent = {
+	type: "items";
+	items: GalleryItem[];
+} | {
+	type: "auto";
+	files: string[] | null;
+};
+/**
+* Data for `[[gallery]]` elements.
+*
+* @group Element Data
+*/
+interface GalleryData {
+	size: GallerySize;
+	/** Sort order for auto-collected files (parse-time normalized) */
+	order: GalleryOrder;
+	/** false when `viewer="no"`/`"false"` disables the lightbox */
+	viewer: boolean;
+	content: GalleryContent;
+}
+/**
 * Data for `[[toc]]` (table of contents) elements.
 *
 * @group Element Data
@@ -852,6 +924,7 @@ type ElementDataMap = {
 	"anchor-name": string;
 	link: LinkData;
 	image: ImageData;
+	gallery: GalleryData;
 	list: ListData;
 	"definition-list": DefinitionListItem[];
 	collapsible: CollapsibleData;
@@ -1160,6 +1233,13 @@ interface ParseResult {
 */
 declare const STYLE_SLOT_PREFIX = "\0__IFTAGS_SLOT__";
 /**
+* Sentinel prefix for invisible style-position anchors retained in the AST.
+*
+* The suffix is the previously collected CSS text. Renderers must not emit
+* these synthetic style elements.
+*/
+declare const STYLE_ANCHOR_PREFIX = "\0__STYLE_ANCHOR__";
+/**
 * Context-dependent settings for the Wikidot parser and renderer.
 *
 * Wikidot content appears in several different contexts — full wiki pages,
@@ -1321,6 +1401,28 @@ declare function formatExprValue(n: number): string;
 * @returns A success result with a numeric value, or an error result with a message.
 */
 declare function evaluateExpression(expr: string): ExprResult;
+/** Attachment metadata used by page-contextual gallery rendering. */
+interface WikitextPageFile {
+	name: string;
+	createdAt?: number;
+}
+/**
+* Page data shared by high-level parser and renderer APIs.
+*
+* `fullName` is the category-qualified Wikidot page name. `unixName`, when
+* available, is the separately named URL-safe page identifier.
+*/
+interface WikitextPageContext {
+	fullName: string;
+	unixName?: string;
+	tags: string[];
+	urlPath?: string;
+	site?: string;
+	domain?: string;
+	siteDomains?: Record<string, string>;
+	resolveSiteDomain?: (site: string) => string | null | undefined;
+	files?: WikitextPageFile[];
+}
 /**
 * Identifies the source markup dialect.
 *
@@ -1330,4 +1432,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, CssLengthUnit, ContainerType, ContainerData, ColorData, CollapsibleData, CodeBlockData, ClearFloat, CSS_LENGTH_UNITS, 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, WikitextPageFile, WikitextPageContext, WikitextMode, Version, VariableMap, UserData, TocEntry, TableRow, TableOfContentsData, TableData, TableCell, TabData, SyntaxTree, StringContainerType, STYLE_SLOT_PREFIX, STYLE_ANCHOR_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, GallerySize, GalleryOrder, GalleryItem, GalleryData, GalleryContent, 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,7 @@ function isParagraphSafe(element) {
 }
 // packages/ast/src/constants.ts
 var STYLE_SLOT_PREFIX = "\x00__IFTAGS_SLOT__";
+var STYLE_ANCHOR_PREFIX = "\x00__STYLE_ANCHOR__";
 // packages/ast/src/css.ts
 var CSS_LENGTH_UNITS = [
   "cqmax",
@@ -693,6 +694,7 @@ export {
   container,
   bold,
   STYLE_SLOT_PREFIX,
+  STYLE_ANCHOR_PREFIX,
   DEFAULT_SETTINGS,
   CSS_LENGTH_UNITS
 };

package/package.json

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

package/src/constants.ts

@@ -10,3 +10,11 @@
  * A null-byte prefix ensures no collision with valid CSS content.
  */
 export const STYLE_SLOT_PREFIX = "\0__IFTAGS_SLOT__";
+
+/**
+ * Sentinel prefix for invisible style-position anchors retained in the AST.
+ *
+ * The suffix is the previously collected CSS text. Renderers must not emit
+ * these synthetic style elements.
+ */
+export const STYLE_ANCHOR_PREFIX = "\0__STYLE_ANCHOR__";

package/src/element.ts

@@ -658,6 +658,79 @@ export interface ImageData {
   attributes: AttributeMap;
 }
 
+/**
+ * Image size keyword accepted by `[[gallery]]`.
+ * Invalid or missing values fall back to `"thumbnail"` at parse time,
+ * matching the Wikidot renderer.
+ *
+ * @group Element Data
+ */
+export type GallerySize = "small" | "medium" | "thumbnail" | "square" | "original";
+
+/**
+ * Sort order for auto-collected gallery files, normalized at parse time.
+ * Deprecated Wikidot aliases (`nameDesc`, `dateAdded`, `dateAddedDesc`) and
+ * the ListPages-style `"... desc desc"` forms are folded into these four
+ * values. Only meaningful for the content-less (auto) form.
+ *
+ * @group Element Data
+ */
+export type GalleryOrder = "name" | "name desc" | "created_at" | "created_at desc";
+
+/**
+ * A single `: source link="..." alt="..."` entry inside `[[gallery]]`.
+ *
+ * @group Element Data
+ */
+export interface GalleryItem {
+  /**
+   * Raw image source string with any leading `*` removed.
+   * Classification follows the Wikidot rules and happens at render time:
+   * a source containing `://` is external, one containing `/` refers to
+   * another page's file, anything else is a file on the current page.
+   */
+  source: string;
+  /**
+   * Link target with any leading `*` removed, or null when the item has no
+   * `link` attribute.
+   */
+  link: string | null;
+  /** Alternative text for the image, or null when no `alt` attribute is given */
+  alt: string | null;
+  /** true if the link opens in a new window (`*` prefix on source or link) */
+  newWindow: boolean;
+}
+
+/**
+ * Body of a `[[gallery]]` element.
+ *
+ * - `"items"` — the content form with explicit `: source` lines.
+ *   `items` is always non-empty: the content form requires at least one
+ *   line to parse.
+ * - `"auto"` — the content-less form, which shows the current page's image
+ *   attachments. `files` is null until data resolution fills it with the
+ *   attachment filenames (already sorted by the gallery's `order`).
+ *
+ * @group Element Data
+ */
+export type GalleryContent =
+  | { type: "items"; items: GalleryItem[] }
+  | { type: "auto"; files: string[] | null };
+
+/**
+ * Data for `[[gallery]]` elements.
+ *
+ * @group Element Data
+ */
+export interface GalleryData {
+  size: GallerySize;
+  /** Sort order for auto-collected files (parse-time normalized) */
+  order: GalleryOrder;
+  /** false when `viewer="no"`/`"false"` disables the lightbox */
+  viewer: boolean;
+  content: GalleryContent;
+}
+
 /**
  * Data for `[[toc]]` (table of contents) elements.
  *
@@ -890,6 +963,7 @@ export type ElementDataMap = {
   "anchor-name": string;
   link: LinkData;
   image: ImageData;
+  gallery: GalleryData;
   list: ListData;
   "definition-list": DefinitionListItem[];
   collapsible: CollapsibleData;

package/src/index.ts

@@ -67,6 +67,11 @@ export type {
   AnchorData,
   LinkData,
   ImageData,
+  GallerySize,
+  GalleryOrder,
+  GalleryItem,
+  GalleryContent,
+  GalleryData,
   TableOfContentsData,
   FootnoteBlockData,
   BibliographyCiteData,
@@ -108,7 +113,7 @@ export {
 export type { Diagnostic, DiagnosticSeverity, ParseResult } from "./diagnostic";
 
 // Constants
-export { STYLE_SLOT_PREFIX } from "./constants";
+export { STYLE_ANCHOR_PREFIX, STYLE_SLOT_PREFIX } from "./constants";
 
 // CSS value definitions
 export type { CssLengthUnit } from "./css";
@@ -121,3 +126,6 @@ export type { WikitextMode, WikitextSettings } from "./settings";
 export { evaluateExpression, isTruthy, formatExprValue } from "./expr-eval";
 export type { ExprResult } from "./expr-eval";
 export { createSettings, DEFAULT_SETTINGS } from "./settings";
+
+// Shared high-level pipeline page context
+export type { WikitextPageContext, WikitextPageFile } from "./page-context";

package/src/page-context.ts

@@ -0,0 +1,23 @@
+/** Attachment metadata used by page-contextual gallery rendering. */
+export interface WikitextPageFile {
+  name: string;
+  createdAt?: number;
+}
+
+/**
+ * Page data shared by high-level parser and renderer APIs.
+ *
+ * `fullName` is the category-qualified Wikidot page name. `unixName`, when
+ * available, is the separately named URL-safe page identifier.
+ */
+export interface WikitextPageContext {
+  fullName: string;
+  unixName?: string;
+  tags: string[];
+  urlPath?: string;
+  site?: string;
+  domain?: string;
+  siteDomains?: Record<string, string>;
+  resolveSiteDomain?: (site: string) => string | null | undefined;
+  files?: WikitextPageFile[];
+}