@wdprlib/parser 4.2.0 → 4.3.0

package/README.md

@@ -43,7 +43,7 @@ const resolved = await resolveModules(ast, {
     // value — look it up with a parameterized query and return the normalized name
     const found = category ? await findCategory(category) : null // your lookup
     if (category && !found) return { status: 'category-not-found', category }
-    return { status: 'ok', tags: [{ tag: 'scp', weight: 42 }], category: found?.unixName ?? null }
+    return { status: 'ok', tags: [{ tag: 'apple', weight: 42 }], category: found?.unixName ?? null }
   },
   getPageTags: () => ['tag1', 'tag2'],
 }, {
@@ -58,6 +58,8 @@ const resolved = await resolveModules(ast, {
 - Wikidot markup parsing (bold, italic, links, images, tables, etc.)
 - Include resolution (`[[include page]]`)
 - Module support (ListPages, ListUsers, TagCloud, IfTags, etc.)
+- `[[gallery]]` (auto-collection uses the page's attachments passed to `@wdprlib/render` as `page.files`; lightbox via `@wdprlib/runtime`)
+
 - Data extraction for server-side rendering
 
 ## Related Packages

package/dist/index.cjs

@@ -9318,6 +9318,177 @@ var bibliographyRule = {
   }
 };
 
+// packages/parser/src/parser/rules/block/gallery/items.ts
+function parseGalleryItemLine(content) {
+  const spacePos = content.indexOf(" ");
+  let source = spacePos < 0 ? content : content.slice(0, spacePos);
+  const attrText = spacePos < 0 ? "" : content.slice(spacePos + 1);
+  let newWindow = false;
+  if (source.startsWith("*")) {
+    source = source.slice(1);
+    newWindow = true;
+  }
+  const attrs = parseItemAttrs(attrText);
+  let link = attrs.get("link") ?? null;
+  if (link !== null && link.startsWith("*")) {
+    newWindow = true;
+    link = link.slice(1);
+  }
+  const alt = attrs.get("alt") ?? null;
+  return { source, link, alt, newWindow };
+}
+function parseItemAttrs(text) {
+  const attrs = new Map;
+  const parts = text.trim().split('="');
+  let key = parts[0]?.trim() ?? "";
+  for (let i = 1;i < parts.length; i++) {
+    const val = parts[i] ?? "";
+    const quotePos = val.lastIndexOf('"');
+    if (quotePos < 0) {
+      attrs.set(key, "");
+      key = val.slice(1).trim();
+    } else {
+      attrs.set(key, stripslashes(val.slice(0, quotePos)));
+      key = val.slice(quotePos + 1).trim();
+    }
+  }
+  return attrs;
+}
+function stripslashes(value) {
+  return value.replace(/\\(.)/gs, "$1").replace(/\\$/, "");
+}
+
+// packages/parser/src/parser/rules/block/gallery/index.ts
+var GALLERY_SIZES = ["small", "medium", "thumbnail", "square", "original"];
+function normalizeSize(value) {
+  return value !== undefined && GALLERY_SIZES.includes(value) ? value : "thumbnail";
+}
+function normalizeViewer(value) {
+  return value !== "no" && value !== "false";
+}
+function normalizeOrder(value) {
+  switch (value) {
+    case "name":
+    case "name desc":
+    case "created_at":
+    case "created_at desc":
+      return value;
+    case "nameDesc":
+      return "name desc";
+    case "dateAdded":
+      return "created_at";
+    case "dateAddedDesc":
+      return "created_at desc";
+    case "name desc desc":
+      return "name";
+    case "created_at desc desc":
+      return "created_at";
+    default:
+      return "name";
+  }
+}
+function tryParseGalleryContent(ctx, pos) {
+  const start = pos;
+  if (ctx.tokens[pos]?.type !== "NEWLINE") {
+    return null;
+  }
+  const lines = [];
+  let p = pos + 1;
+  for (;; ) {
+    const colon = ctx.tokens[p];
+    if (colon?.type !== "COLON" || !colon.lineStart) {
+      break;
+    }
+    const space = ctx.tokens[p + 1];
+    if (space?.type !== "WHITESPACE" || !space.value.startsWith(" ")) {
+      break;
+    }
+    let content = "";
+    let q = p + 1;
+    while (q < ctx.tokens.length) {
+      const token5 = ctx.tokens[q];
+      if (!token5 || token5.type === "NEWLINE" || token5.type === "EOF") {
+        break;
+      }
+      content += token5.value;
+      q++;
+    }
+    if (content === " ") {
+      return null;
+    }
+    if (ctx.tokens[q]?.type !== "NEWLINE") {
+      return null;
+    }
+    lines.push(content.trim());
+    p = q + 1;
+  }
+  if (lines.length === 0) {
+    return null;
+  }
+  if (ctx.tokens[p]?.type !== "BLOCK_END_OPEN") {
+    return null;
+  }
+  const nameResult = parseBlockName(ctx, p + 1);
+  if (!nameResult || nameResult.name !== "gallery") {
+    return null;
+  }
+  const closePos = p + 1 + nameResult.consumed;
+  if (ctx.tokens[closePos]?.type !== "BLOCK_CLOSE") {
+    return null;
+  }
+  return { lines, consumed: closePos + 1 - start };
+}
+var galleryRule = {
+  name: "gallery",
+  startTokens: ["BLOCK_OPEN"],
+  requiresLineStart: true,
+  parse(ctx) {
+    if (ctx.tokens[ctx.pos]?.type !== "BLOCK_OPEN") {
+      return { success: false };
+    }
+    let pos = ctx.pos + 1;
+    const nameResult = parseBlockName(ctx, pos);
+    if (!nameResult || nameResult.name !== "gallery") {
+      return { success: false };
+    }
+    pos += nameResult.consumed;
+    const attrResult = parseAttributesRaw(ctx, pos);
+    pos += attrResult.consumed;
+    if (ctx.tokens[pos]?.type !== "BLOCK_CLOSE") {
+      return { success: false };
+    }
+    pos++;
+    const size = normalizeSize(attrResult.attrs.size);
+    const viewer = normalizeViewer(attrResult.attrs.viewer);
+    const order = normalizeOrder(attrResult.attrs.order);
+    const openConsumed = pos - ctx.pos;
+    const content = tryParseGalleryContent(ctx, pos);
+    if (!content) {
+      return {
+        success: true,
+        elements: [
+          {
+            element: "gallery",
+            data: { size, order, viewer, content: { type: "auto", files: null } }
+          }
+        ],
+        consumed: openConsumed
+      };
+    }
+    const items = content.lines.map(parseGalleryItemLine);
+    return {
+      success: true,
+      elements: [
+        {
+          element: "gallery",
+          data: { size, order, viewer, content: { type: "items", items } }
+        }
+      ],
+      consumed: openConsumed + content.consumed
+    };
+  }
+};
+
 // packages/parser/src/parser/rules/block/index.ts
 var blockRules = [
   blockCommentRule,
@@ -9347,6 +9518,7 @@ var blockRules = [
   iframeRule,
   iftagsRule,
   bibliographyRule,
+  galleryRule,
   divRule
 ];
 // packages/parser/src/parser/rules/inline/formatting/container.ts

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Position as Position2, Point, Version as Version2, Element as Element8, SyntaxTree as SyntaxTree3, ContainerType, ContainerData, AttributeMap, VariableMap, Alignment, LinkType, LinkLocation, LinkLabel, PageRef as PageRef3, ImageSource, FloatAlignment, ListType, ListItem, ListData, CodeBlockData as CodeBlockData2, TabData, TableCell, TableRow, TableData, DefinitionListItem, Module as Module5, CollapsibleData, ClearFloat, AnchorTarget, HeaderType, AlignType, HeadingLevel, Heading, DateItem, Embed, TocEntry as TocEntry2, Diagnostic as Diagnostic2, DiagnosticSeverity, ParseResult as ParseResult3 } from "@wdprlib/ast";
+import { Position as Position2, Point, Version as Version2, Element as Element8, SyntaxTree as SyntaxTree3, ContainerType, ContainerData, AttributeMap, VariableMap, Alignment, LinkType, LinkLocation, LinkLabel, PageRef as PageRef3, ImageSource, FloatAlignment, ListType, ListItem, ListData, CodeBlockData as CodeBlockData2, TabData, TableCell, TableRow, TableData, DefinitionListItem, Module as Module5, CollapsibleData, ClearFloat, AnchorTarget, HeaderType, AlignType, HeadingLevel, Heading, DateItem, Embed, TocEntry as TocEntry2, GallerySize, GalleryOrder, GalleryItem, GalleryContent, GalleryData, Diagnostic as Diagnostic2, DiagnosticSeverity, ParseResult as ParseResult3 } from "@wdprlib/ast";
 import { createPoint, createPosition, text, container, paragraph, bold, italics, heading, lineBreak, horizontalRule, link, list, listItemElements, listItemSubList } from "@wdprlib/ast";
 import { WikitextMode, WikitextSettings as WikitextSettings4 } from "@wdprlib/ast";
 import { createSettings, DEFAULT_SETTINGS } from "@wdprlib/ast";
@@ -1155,4 +1155,4 @@ interface ResolveOptions {
 */
 declare function resolveModules(ast: SyntaxTree2, dataProvider: DataProvider, options: ResolveOptions): Promise<SyntaxTree2>;
 import { STYLE_SLOT_PREFIX } from "@wdprlib/ast";
-export { tokenize, text, resolveTagCloud, resolveModules, resolveListUsers, resolveIncludesWithTrace, resolveIncludesAsync, resolveIncludes, preprocessIftags, parseTags, parseParent, parseOrder, parseNumericSelector, parseDateSelector, parseCategory, parse, paragraph, normalizeQuery, listItemSubList, listItemElements, list, link, lineBreak, italics, isTagCloudModule, isListUsersModule, horizontalRule, heading, extractListUsersVariables, extractIncludeReferences, extractDataRequirements, createToken, createSettings, createPosition, createPoint, container, compileTemplate, compileListUsersTemplate, bold, WikitextSettings4 as WikitextSettings, WikitextMode, Version2 as Version, VariableMap, VariableContext, UserInfo, TokenType, Token, TocEntry2 as TocEntry, TagCloudTagData, TagCloudModuleData, TagCloudExternalData, TagCloudDataRequirement, TagCloudDataFetcher, TableRow, TableData, TableCell, TabData, SyntaxTree3 as SyntaxTree, SiteContext, STYLE_SLOT_PREFIX, ResolveOptions, ResolveIncludesTraceResult, ResolveIncludesOptions, Position2 as Position, Point, ParserOptions, Parser, ParseResult3 as ParseResult, ParseFunction, PageRef3 as PageRef, PageData, NormalizedTags, NormalizedParent, NormalizedOrder, NormalizedNumericSelector, NormalizedListPagesQuery, NormalizedDateSelector, NormalizedCategory, ModuleSourceTransform, Module5 as Module, ListUsersVariableContext, ListUsersVariable, ListUsersUserData, ListUsersExternalData, ListUsersDataRequirement, ListUsersDataFetcher, ListUsersCompiledTemplate, ListType, ListPagesVariable, ListPagesQuery, ListPagesExternalData, ListPagesDataRequirement, ListPagesDataFetcher, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LexerOptions, Lexer, IncludeReference, IncludeIterationTrace, IncludeFetcher, IncludeDependency, ImageSource, HeadingLevel, Heading, HeaderType, FloatAlignment, ExtractionResult, Embed, Element8 as Element, DiagnosticSeverity, Diagnostic2 as Diagnostic, DefinitionListItem, DateItem, DataRequirements, DataProvider, DEFAULT_SETTINGS, ContainerType, ContainerData, CompiledTemplate, CollapsibleData, CodeBlockData2 as CodeBlockData, ClearFloat, AttributeMap, AsyncIncludeFetcher, AnchorTarget, Alignment, AlignType };
+export { tokenize, text, resolveTagCloud, resolveModules, resolveListUsers, resolveIncludesWithTrace, resolveIncludesAsync, resolveIncludes, preprocessIftags, parseTags, parseParent, parseOrder, parseNumericSelector, parseDateSelector, parseCategory, parse, paragraph, normalizeQuery, listItemSubList, listItemElements, list, link, lineBreak, italics, isTagCloudModule, isListUsersModule, horizontalRule, heading, extractListUsersVariables, extractIncludeReferences, extractDataRequirements, createToken, createSettings, createPosition, createPoint, container, compileTemplate, compileListUsersTemplate, bold, WikitextSettings4 as WikitextSettings, WikitextMode, Version2 as Version, VariableMap, VariableContext, UserInfo, TokenType, Token, TocEntry2 as TocEntry, TagCloudTagData, TagCloudModuleData, TagCloudExternalData, TagCloudDataRequirement, TagCloudDataFetcher, TableRow, TableData, TableCell, TabData, SyntaxTree3 as SyntaxTree, SiteContext, STYLE_SLOT_PREFIX, ResolveOptions, ResolveIncludesTraceResult, ResolveIncludesOptions, Position2 as Position, Point, ParserOptions, Parser, ParseResult3 as ParseResult, ParseFunction, PageRef3 as PageRef, PageData, NormalizedTags, NormalizedParent, NormalizedOrder, NormalizedNumericSelector, NormalizedListPagesQuery, NormalizedDateSelector, NormalizedCategory, ModuleSourceTransform, Module5 as Module, ListUsersVariableContext, ListUsersVariable, ListUsersUserData, ListUsersExternalData, ListUsersDataRequirement, ListUsersDataFetcher, ListUsersCompiledTemplate, ListType, ListPagesVariable, ListPagesQuery, ListPagesExternalData, ListPagesDataRequirement, ListPagesDataFetcher, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LexerOptions, Lexer, IncludeReference, IncludeIterationTrace, IncludeFetcher, IncludeDependency, ImageSource, HeadingLevel, Heading, HeaderType, GallerySize, GalleryOrder, GalleryItem, GalleryData, GalleryContent, FloatAlignment, ExtractionResult, Embed, Element8 as Element, DiagnosticSeverity, Diagnostic2 as Diagnostic, DefinitionListItem, DateItem, DataRequirements, DataProvider, DEFAULT_SETTINGS, ContainerType, ContainerData, CompiledTemplate, CollapsibleData, CodeBlockData2 as CodeBlockData, ClearFloat, AttributeMap, AsyncIncludeFetcher, AnchorTarget, Alignment, AlignType };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Position as Position2, Point, Version as Version2, Element as Element8, SyntaxTree as SyntaxTree3, ContainerType, ContainerData, AttributeMap, VariableMap, Alignment, LinkType, LinkLocation, LinkLabel, PageRef as PageRef3, ImageSource, FloatAlignment, ListType, ListItem, ListData, CodeBlockData as CodeBlockData2, TabData, TableCell, TableRow, TableData, DefinitionListItem, Module as Module5, CollapsibleData, ClearFloat, AnchorTarget, HeaderType, AlignType, HeadingLevel, Heading, DateItem, Embed, TocEntry as TocEntry2, Diagnostic as Diagnostic2, DiagnosticSeverity, ParseResult as ParseResult3 } from "@wdprlib/ast";
+import { Position as Position2, Point, Version as Version2, Element as Element8, SyntaxTree as SyntaxTree3, ContainerType, ContainerData, AttributeMap, VariableMap, Alignment, LinkType, LinkLocation, LinkLabel, PageRef as PageRef3, ImageSource, FloatAlignment, ListType, ListItem, ListData, CodeBlockData as CodeBlockData2, TabData, TableCell, TableRow, TableData, DefinitionListItem, Module as Module5, CollapsibleData, ClearFloat, AnchorTarget, HeaderType, AlignType, HeadingLevel, Heading, DateItem, Embed, TocEntry as TocEntry2, GallerySize, GalleryOrder, GalleryItem, GalleryContent, GalleryData, Diagnostic as Diagnostic2, DiagnosticSeverity, ParseResult as ParseResult3 } from "@wdprlib/ast";
 import { createPoint, createPosition, text, container, paragraph, bold, italics, heading, lineBreak, horizontalRule, link, list, listItemElements, listItemSubList } from "@wdprlib/ast";
 import { WikitextMode, WikitextSettings as WikitextSettings4 } from "@wdprlib/ast";
 import { createSettings, DEFAULT_SETTINGS } from "@wdprlib/ast";
@@ -1155,4 +1155,4 @@ interface ResolveOptions {
 */
 declare function resolveModules(ast: SyntaxTree2, dataProvider: DataProvider, options: ResolveOptions): Promise<SyntaxTree2>;
 import { STYLE_SLOT_PREFIX } from "@wdprlib/ast";
-export { tokenize, text, resolveTagCloud, resolveModules, resolveListUsers, resolveIncludesWithTrace, resolveIncludesAsync, resolveIncludes, preprocessIftags, parseTags, parseParent, parseOrder, parseNumericSelector, parseDateSelector, parseCategory, parse, paragraph, normalizeQuery, listItemSubList, listItemElements, list, link, lineBreak, italics, isTagCloudModule, isListUsersModule, horizontalRule, heading, extractListUsersVariables, extractIncludeReferences, extractDataRequirements, createToken, createSettings, createPosition, createPoint, container, compileTemplate, compileListUsersTemplate, bold, WikitextSettings4 as WikitextSettings, WikitextMode, Version2 as Version, VariableMap, VariableContext, UserInfo, TokenType, Token, TocEntry2 as TocEntry, TagCloudTagData, TagCloudModuleData, TagCloudExternalData, TagCloudDataRequirement, TagCloudDataFetcher, TableRow, TableData, TableCell, TabData, SyntaxTree3 as SyntaxTree, SiteContext, STYLE_SLOT_PREFIX, ResolveOptions, ResolveIncludesTraceResult, ResolveIncludesOptions, Position2 as Position, Point, ParserOptions, Parser, ParseResult3 as ParseResult, ParseFunction, PageRef3 as PageRef, PageData, NormalizedTags, NormalizedParent, NormalizedOrder, NormalizedNumericSelector, NormalizedListPagesQuery, NormalizedDateSelector, NormalizedCategory, ModuleSourceTransform, Module5 as Module, ListUsersVariableContext, ListUsersVariable, ListUsersUserData, ListUsersExternalData, ListUsersDataRequirement, ListUsersDataFetcher, ListUsersCompiledTemplate, ListType, ListPagesVariable, ListPagesQuery, ListPagesExternalData, ListPagesDataRequirement, ListPagesDataFetcher, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LexerOptions, Lexer, IncludeReference, IncludeIterationTrace, IncludeFetcher, IncludeDependency, ImageSource, HeadingLevel, Heading, HeaderType, FloatAlignment, ExtractionResult, Embed, Element8 as Element, DiagnosticSeverity, Diagnostic2 as Diagnostic, DefinitionListItem, DateItem, DataRequirements, DataProvider, DEFAULT_SETTINGS, ContainerType, ContainerData, CompiledTemplate, CollapsibleData, CodeBlockData2 as CodeBlockData, ClearFloat, AttributeMap, AsyncIncludeFetcher, AnchorTarget, Alignment, AlignType };
+export { tokenize, text, resolveTagCloud, resolveModules, resolveListUsers, resolveIncludesWithTrace, resolveIncludesAsync, resolveIncludes, preprocessIftags, parseTags, parseParent, parseOrder, parseNumericSelector, parseDateSelector, parseCategory, parse, paragraph, normalizeQuery, listItemSubList, listItemElements, list, link, lineBreak, italics, isTagCloudModule, isListUsersModule, horizontalRule, heading, extractListUsersVariables, extractIncludeReferences, extractDataRequirements, createToken, createSettings, createPosition, createPoint, container, compileTemplate, compileListUsersTemplate, bold, WikitextSettings4 as WikitextSettings, WikitextMode, Version2 as Version, VariableMap, VariableContext, UserInfo, TokenType, Token, TocEntry2 as TocEntry, TagCloudTagData, TagCloudModuleData, TagCloudExternalData, TagCloudDataRequirement, TagCloudDataFetcher, TableRow, TableData, TableCell, TabData, SyntaxTree3 as SyntaxTree, SiteContext, STYLE_SLOT_PREFIX, ResolveOptions, ResolveIncludesTraceResult, ResolveIncludesOptions, Position2 as Position, Point, ParserOptions, Parser, ParseResult3 as ParseResult, ParseFunction, PageRef3 as PageRef, PageData, NormalizedTags, NormalizedParent, NormalizedOrder, NormalizedNumericSelector, NormalizedListPagesQuery, NormalizedDateSelector, NormalizedCategory, ModuleSourceTransform, Module5 as Module, ListUsersVariableContext, ListUsersVariable, ListUsersUserData, ListUsersExternalData, ListUsersDataRequirement, ListUsersDataFetcher, ListUsersCompiledTemplate, ListType, ListPagesVariable, ListPagesQuery, ListPagesExternalData, ListPagesDataRequirement, ListPagesDataFetcher, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LexerOptions, Lexer, IncludeReference, IncludeIterationTrace, IncludeFetcher, IncludeDependency, ImageSource, HeadingLevel, Heading, HeaderType, GallerySize, GalleryOrder, GalleryItem, GalleryData, GalleryContent, FloatAlignment, ExtractionResult, Embed, Element8 as Element, DiagnosticSeverity, Diagnostic2 as Diagnostic, DefinitionListItem, DateItem, DataRequirements, DataProvider, DEFAULT_SETTINGS, ContainerType, ContainerData, CompiledTemplate, CollapsibleData, CodeBlockData2 as CodeBlockData, ClearFloat, AttributeMap, AsyncIncludeFetcher, AnchorTarget, Alignment, AlignType };

package/dist/index.js

@@ -9257,6 +9257,177 @@ var bibliographyRule = {
   }
 };
 
+// packages/parser/src/parser/rules/block/gallery/items.ts
+function parseGalleryItemLine(content) {
+  const spacePos = content.indexOf(" ");
+  let source = spacePos < 0 ? content : content.slice(0, spacePos);
+  const attrText = spacePos < 0 ? "" : content.slice(spacePos + 1);
+  let newWindow = false;
+  if (source.startsWith("*")) {
+    source = source.slice(1);
+    newWindow = true;
+  }
+  const attrs = parseItemAttrs(attrText);
+  let link = attrs.get("link") ?? null;
+  if (link !== null && link.startsWith("*")) {
+    newWindow = true;
+    link = link.slice(1);
+  }
+  const alt = attrs.get("alt") ?? null;
+  return { source, link, alt, newWindow };
+}
+function parseItemAttrs(text) {
+  const attrs = new Map;
+  const parts = text.trim().split('="');
+  let key = parts[0]?.trim() ?? "";
+  for (let i = 1;i < parts.length; i++) {
+    const val = parts[i] ?? "";
+    const quotePos = val.lastIndexOf('"');
+    if (quotePos < 0) {
+      attrs.set(key, "");
+      key = val.slice(1).trim();
+    } else {
+      attrs.set(key, stripslashes(val.slice(0, quotePos)));
+      key = val.slice(quotePos + 1).trim();
+    }
+  }
+  return attrs;
+}
+function stripslashes(value) {
+  return value.replace(/\\(.)/gs, "$1").replace(/\\$/, "");
+}
+
+// packages/parser/src/parser/rules/block/gallery/index.ts
+var GALLERY_SIZES = ["small", "medium", "thumbnail", "square", "original"];
+function normalizeSize(value) {
+  return value !== undefined && GALLERY_SIZES.includes(value) ? value : "thumbnail";
+}
+function normalizeViewer(value) {
+  return value !== "no" && value !== "false";
+}
+function normalizeOrder(value) {
+  switch (value) {
+    case "name":
+    case "name desc":
+    case "created_at":
+    case "created_at desc":
+      return value;
+    case "nameDesc":
+      return "name desc";
+    case "dateAdded":
+      return "created_at";
+    case "dateAddedDesc":
+      return "created_at desc";
+    case "name desc desc":
+      return "name";
+    case "created_at desc desc":
+      return "created_at";
+    default:
+      return "name";
+  }
+}
+function tryParseGalleryContent(ctx, pos) {
+  const start = pos;
+  if (ctx.tokens[pos]?.type !== "NEWLINE") {
+    return null;
+  }
+  const lines = [];
+  let p = pos + 1;
+  for (;; ) {
+    const colon = ctx.tokens[p];
+    if (colon?.type !== "COLON" || !colon.lineStart) {
+      break;
+    }
+    const space = ctx.tokens[p + 1];
+    if (space?.type !== "WHITESPACE" || !space.value.startsWith(" ")) {
+      break;
+    }
+    let content = "";
+    let q = p + 1;
+    while (q < ctx.tokens.length) {
+      const token5 = ctx.tokens[q];
+      if (!token5 || token5.type === "NEWLINE" || token5.type === "EOF") {
+        break;
+      }
+      content += token5.value;
+      q++;
+    }
+    if (content === " ") {
+      return null;
+    }
+    if (ctx.tokens[q]?.type !== "NEWLINE") {
+      return null;
+    }
+    lines.push(content.trim());
+    p = q + 1;
+  }
+  if (lines.length === 0) {
+    return null;
+  }
+  if (ctx.tokens[p]?.type !== "BLOCK_END_OPEN") {
+    return null;
+  }
+  const nameResult = parseBlockName(ctx, p + 1);
+  if (!nameResult || nameResult.name !== "gallery") {
+    return null;
+  }
+  const closePos = p + 1 + nameResult.consumed;
+  if (ctx.tokens[closePos]?.type !== "BLOCK_CLOSE") {
+    return null;
+  }
+  return { lines, consumed: closePos + 1 - start };
+}
+var galleryRule = {
+  name: "gallery",
+  startTokens: ["BLOCK_OPEN"],
+  requiresLineStart: true,
+  parse(ctx) {
+    if (ctx.tokens[ctx.pos]?.type !== "BLOCK_OPEN") {
+      return { success: false };
+    }
+    let pos = ctx.pos + 1;
+    const nameResult = parseBlockName(ctx, pos);
+    if (!nameResult || nameResult.name !== "gallery") {
+      return { success: false };
+    }
+    pos += nameResult.consumed;
+    const attrResult = parseAttributesRaw(ctx, pos);
+    pos += attrResult.consumed;
+    if (ctx.tokens[pos]?.type !== "BLOCK_CLOSE") {
+      return { success: false };
+    }
+    pos++;
+    const size = normalizeSize(attrResult.attrs.size);
+    const viewer = normalizeViewer(attrResult.attrs.viewer);
+    const order = normalizeOrder(attrResult.attrs.order);
+    const openConsumed = pos - ctx.pos;
+    const content = tryParseGalleryContent(ctx, pos);
+    if (!content) {
+      return {
+        success: true,
+        elements: [
+          {
+            element: "gallery",
+            data: { size, order, viewer, content: { type: "auto", files: null } }
+          }
+        ],
+        consumed: openConsumed
+      };
+    }
+    const items = content.lines.map(parseGalleryItemLine);
+    return {
+      success: true,
+      elements: [
+        {
+          element: "gallery",
+          data: { size, order, viewer, content: { type: "items", items } }
+        }
+      ],
+      consumed: openConsumed + content.consumed
+    };
+  }
+};
+
 // packages/parser/src/parser/rules/block/index.ts
 var blockRules = [
   blockCommentRule,
@@ -9286,6 +9457,7 @@ var blockRules = [
   iframeRule,
   iftagsRule,
   bibliographyRule,
+  galleryRule,
   divRule
 ];
 // packages/parser/src/parser/rules/inline/formatting/container.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdprlib/parser",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "Parser for Wikidot markup",
   "keywords": [
     "ast",
@@ -41,6 +41,6 @@
   },
   "dependencies": {
     "@braintree/sanitize-url": "^7.1.1",
-    "@wdprlib/ast": "2.2.0"
+    "@wdprlib/ast": "2.3.0"
   }
 }

package/src/index.ts

@@ -58,6 +58,12 @@ export type {
   DateItem,
   Embed,
   TocEntry,
+  // Gallery
+  GallerySize,
+  GalleryOrder,
+  GalleryItem,
+  GalleryContent,
+  GalleryData,
   // Diagnostics
   Diagnostic,
   DiagnosticSeverity,

package/src/parser/rules/block/gallery/index.ts

@@ -0,0 +1,215 @@
+/**
+ *
+ * Block rule for the Wikidot `[[gallery]]` image gallery.
+ *
+ * ```
+ * [[gallery size="thumbnail" order="name" viewer="no"]]
+ * : first-image.jpg
+ * : *page/other-image.jpg link="some-page" alt="Alt text"
+ * [[/gallery]]
+ * ```
+ *
+ * The content form requires the `]]` to be followed immediately by one or
+ * more `: source` lines and a `[[/gallery]]` close tag (Wikidot regex
+ * `\[\[gallery(\s[^\]]*?)?\]\](?:((?:\n: [^\n]+)+)\n\[\[\/gallery\]\])?`).
+ * Anything else falls back to the standalone content-less form, which shows
+ * the current page's image attachments after data resolution
+ * (`content: { type: "auto", files: null }`); the following text then
+ * parses normally.
+ *
+ * Honored opening-tag attributes are `size` (small / medium / thumbnail /
+ * square / original, fallback thumbnail), `viewer` (`"no"`/`"false"`
+ * disable the lightbox) and `order` (auto-collection sort order, with
+ * Wikidot's deprecated aliases normalized).
+ *
+ * Deliberate differences from the Wikidot parser: the opening tag must
+ * fit on one line and attribute names are lowercased with unquoted values
+ * accepted (both shared with wdpr's other block rules), and `flickr:`
+ * sources get no special treatment — they resolve like any other
+ * filename (wdpr does not call the Flickr API).
+ *
+ * @module
+ */
+import type { Element, GalleryItem, GalleryOrder, GallerySize } from "@wdprlib/ast";
+import type { BlockRule, ParseContext, RuleResult } from "../../types";
+import { parseAttributesRaw, parseBlockName } from "../utils";
+import { parseGalleryItemLine } from "./items";
+
+export { parseGalleryItemLine } from "./items";
+
+const GALLERY_SIZES: readonly string[] = ["small", "medium", "thumbnail", "square", "original"];
+
+/** Validate a size keyword, falling back to thumbnail like Wikidot. */
+function normalizeSize(value: string | undefined): GallerySize {
+  return value !== undefined && GALLERY_SIZES.includes(value)
+    ? (value as GallerySize)
+    : "thumbnail";
+}
+
+/** `viewer="no"` / `viewer="false"` disable the lightbox; anything else enables it. */
+function normalizeViewer(value: string | undefined): boolean {
+  return value !== "no" && value !== "false";
+}
+
+/**
+ * Normalize the `order` attribute, folding Wikidot's deprecated aliases
+ * (`nameDesc`, `dateAdded`, `dateAddedDesc`) and the documented
+ * ListPages-compatibility forms (`"name desc desc"` / `"created_at desc
+ * desc"`, which mean the same as without the `desc desc`).
+ */
+function normalizeOrder(value: string | undefined): GalleryOrder {
+  switch (value) {
+    case "name":
+    case "name desc":
+    case "created_at":
+    case "created_at desc":
+      return value;
+    case "nameDesc":
+      return "name desc";
+    case "dateAdded":
+      return "created_at";
+    case "dateAddedDesc":
+      return "created_at desc";
+    case "name desc desc":
+      return "name";
+    case "created_at desc desc":
+      return "created_at";
+    default:
+      return "name";
+  }
+}
+
+interface GalleryContentResult {
+  /** Trimmed line contents (after the leading `: `) */
+  lines: string[];
+  /** Token count from the content start (the NEWLINE after `]]`) through `[[/gallery]]` */
+  consumed: number;
+}
+
+/**
+ * Try to match the content form starting at `pos` (the token right after the
+ * opening tag's `]]`): one NEWLINE, then consecutive `: source` lines, then a
+ * NEWLINE directly followed by `[[/gallery]]`. Returns null when the token
+ * stream deviates from the Wikidot regex, which makes the gallery standalone.
+ */
+function tryParseGalleryContent(ctx: ParseContext, pos: number): GalleryContentResult | null {
+  const start = pos;
+  if (ctx.tokens[pos]?.type !== "NEWLINE") {
+    return null;
+  }
+
+  const lines: string[] = [];
+  let p = pos + 1;
+
+  for (;;) {
+    const colon = ctx.tokens[p];
+    if (colon?.type !== "COLON" || !colon.lineStart) {
+      break;
+    }
+    // Wikidot requires a literal space after the colon (`\n: `)
+    const space = ctx.tokens[p + 1];
+    if (space?.type !== "WHITESPACE" || !space.value.startsWith(" ")) {
+      break;
+    }
+
+    let content = "";
+    let q = p + 1;
+    while (q < ctx.tokens.length) {
+      const token = ctx.tokens[q];
+      if (!token || token.type === "NEWLINE" || token.type === "EOF") {
+        break;
+      }
+      content += token.value;
+      q++;
+    }
+    // `: [^\n]+` needs at least one character after the space
+    if (content === " ") {
+      return null;
+    }
+    if (ctx.tokens[q]?.type !== "NEWLINE") {
+      // line hit EOF: the close tag can no longer follow on its own line
+      return null;
+    }
+
+    lines.push(content.trim());
+    p = q + 1;
+  }
+
+  if (lines.length === 0) {
+    return null;
+  }
+
+  // The last consumed NEWLINE must be directly followed by [[/gallery]]
+  if (ctx.tokens[p]?.type !== "BLOCK_END_OPEN") {
+    return null;
+  }
+  const nameResult = parseBlockName(ctx, p + 1);
+  if (!nameResult || nameResult.name !== "gallery") {
+    return null;
+  }
+  const closePos = p + 1 + nameResult.consumed;
+  if (ctx.tokens[closePos]?.type !== "BLOCK_CLOSE") {
+    return null;
+  }
+
+  return { lines, consumed: closePos + 1 - start };
+}
+
+export const galleryRule: BlockRule = {
+  name: "gallery",
+  startTokens: ["BLOCK_OPEN"],
+  requiresLineStart: true,
+
+  parse(ctx: ParseContext): RuleResult<Element> {
+    if (ctx.tokens[ctx.pos]?.type !== "BLOCK_OPEN") {
+      return { success: false };
+    }
+
+    let pos = ctx.pos + 1;
+    const nameResult = parseBlockName(ctx, pos);
+    if (!nameResult || nameResult.name !== "gallery") {
+      return { success: false };
+    }
+    pos += nameResult.consumed;
+
+    const attrResult = parseAttributesRaw(ctx, pos);
+    pos += attrResult.consumed;
+
+    if (ctx.tokens[pos]?.type !== "BLOCK_CLOSE") {
+      return { success: false };
+    }
+    pos++;
+
+    const size = normalizeSize(attrResult.attrs.size);
+    const viewer = normalizeViewer(attrResult.attrs.viewer);
+    const order = normalizeOrder(attrResult.attrs.order);
+    const openConsumed = pos - ctx.pos;
+
+    const content = tryParseGalleryContent(ctx, pos);
+    if (!content) {
+      return {
+        success: true,
+        elements: [
+          {
+            element: "gallery",
+            data: { size, order, viewer, content: { type: "auto", files: null } },
+          },
+        ],
+        consumed: openConsumed,
+      };
+    }
+
+    const items: GalleryItem[] = content.lines.map(parseGalleryItemLine);
+
+    return {
+      success: true,
+      elements: [
+        {
+          element: "gallery",
+          data: { size, order, viewer, content: { type: "items", items } },
+        },
+      ],
+      consumed: openConsumed + content.consumed,
+    };
+  },
+};

package/src/parser/rules/block/gallery/items.ts

@@ -0,0 +1,62 @@
+import type { GalleryItem } from "@wdprlib/ast";
+
+/**
+ * Parse one gallery content line (the text after the leading `: `,
+ * already trimmed) into a {@link GalleryItem}.
+ *
+ * The text before the first space is the source; the rest is parsed as
+ * `key="value"` attributes of which `link` and `alt` are honored. A
+ * leading `*` on the source or on the link value requests a new window.
+ */
+export function parseGalleryItemLine(content: string): GalleryItem {
+  const spacePos = content.indexOf(" ");
+  let source = spacePos < 0 ? content : content.slice(0, spacePos);
+  const attrText = spacePos < 0 ? "" : content.slice(spacePos + 1);
+
+  let newWindow = false;
+  if (source.startsWith("*")) {
+    source = source.slice(1);
+    newWindow = true;
+  }
+
+  const attrs = parseItemAttrs(attrText);
+  let link = attrs.get("link") ?? null;
+  if (link !== null && link.startsWith("*")) {
+    newWindow = true;
+    link = link.slice(1);
+  }
+  const alt = attrs.get("alt") ?? null;
+
+  return { source, link, alt, newWindow };
+}
+
+/**
+ * Parse `key="value"` attribute pairs from a gallery item line, following
+ * the splitting behavior of Wikidot's gallery `getAttrs()`: fragments are
+ * separated by `="`, values run to the last `"` in each fragment and are
+ * backslash-unescaped, and keys are not lowercased.
+ */
+function parseItemAttrs(text: string): Map<string, string> {
+  const attrs = new Map<string, string>();
+  const parts = text.trim().split('="');
+  let key = parts[0]?.trim() ?? "";
+
+  for (let i = 1; i < parts.length; i++) {
+    const val = parts[i] ?? "";
+    const quotePos = val.lastIndexOf('"');
+    if (quotePos < 0) {
+      attrs.set(key, "");
+      key = val.slice(1).trim();
+    } else {
+      attrs.set(key, stripslashes(val.slice(0, quotePos)));
+      key = val.slice(quotePos + 1).trim();
+    }
+  }
+
+  return attrs;
+}
+
+/** PHP-style `stripslashes()`: drop each escaping backslash, and a trailing lone one. */
+function stripslashes(value: string): string {
+  return value.replace(/\\(.)/gs, "$1").replace(/\\$/, "");
+}

package/src/parser/rules/block/index.ts

@@ -49,6 +49,7 @@ import { iftagsRule } from "./iftags";
 import { tocRule } from "./toc";
 import { orphanLiRule } from "./orphan-li";
 import { bibliographyRule } from "./bibliography";
+import { galleryRule } from "./gallery";
 
 export { headingRule } from "./heading";
 export { horizontalRuleRule } from "./horizontal-rule";
@@ -79,6 +80,7 @@ export { iftagsRule } from "./iftags";
 export { tocRule } from "./toc";
 export { orphanLiRule } from "./orphan-li";
 export { bibliographyRule } from "./bibliography";
+export { galleryRule } from "./gallery";
 
 /**
  * All block rules in priority order.
@@ -120,6 +122,7 @@ export const blockRules: BlockRule[] = [
   iframeRule,
   iftagsRule,
   bibliographyRule,
+  galleryRule,
   divRule,
   // paragraphRule is not included - used as fallback
 ];