@wdprlib/ast 1.0.0 → 1.1.0

package/dist/index.cjs

@@ -45,10 +45,12 @@ __export(exports_src, {
   isAlignType: () => isAlignType,
   horizontalRule: () => horizontalRule,
   heading: () => heading,
+  createSettings: () => createSettings,
   createPosition: () => createPosition,
   createPoint: () => createPoint,
   container: () => container,
-  bold: () => bold
+  bold: () => bold,
+  DEFAULT_SETTINGS: () => DEFAULT_SETTINGS
 });
 module.exports = __toCommonJS(exports_src);
 
@@ -245,3 +247,34 @@ function isParagraphSafe(element) {
       return false;
   }
 }
+// packages/ast/src/settings.ts
+function createSettings(mode) {
+  switch (mode) {
+    case "page":
+      return {
+        mode,
+        enablePageSyntax: true,
+        allowLocalPaths: true,
+        useTrueIds: true,
+        allowStyleElements: true
+      };
+    case "draft":
+      return {
+        mode,
+        enablePageSyntax: true,
+        allowLocalPaths: true,
+        useTrueIds: false,
+        allowStyleElements: false
+      };
+    case "forum-post":
+    case "direct-message":
+      return {
+        mode,
+        enablePageSyntax: false,
+        allowLocalPaths: false,
+        useTrueIds: false,
+        allowStyleElements: false
+      };
+  }
+}
+var DEFAULT_SETTINGS = createSettings("page");

package/dist/index.d.cts

@@ -589,5 +589,45 @@ declare function isContainerTypeParagraphSafe(type: ContainerType): boolean;
 * This does a surface-level check and does not look into element interiors.
 */
 declare function isParagraphSafe(element: Element): boolean;
+/**
+* Wikitext parsing/rendering mode.
+* Each mode has different default settings for syntax availability.
+*/
+type WikitextMode = "page" | "draft" | "forum-post" | "direct-message";
+/**
+* Settings that control parser and renderer behavior based on context.
+*/
+interface WikitextSettings {
+	/** Operating mode */
+	mode: WikitextMode;
+	/**
+	* Whether page-contextual syntax is permitted.
+	* Controls: include, module, table-of-contents.
+	*/
+	enablePageSyntax: boolean;
+	/**
+	* Whether local file paths (file1, file2, file3) are permitted for images.
+	* Disable in contexts without a "local" page (forum posts, direct messages).
+	*/
+	allowLocalPaths: boolean;
+	/**
+	* Whether element IDs should be stable sequential values.
+	* When false, IDs are randomized to prevent collisions
+	* when multiple rendered fragments appear on the same page.
+	*/
+	useTrueIds: boolean;
+	/**
+	* Whether [[module CSS]] style elements are rendered as <style> tags.
+	* Disable to prevent user-authored CSS from affecting the page layout
+	* (e.g., in draft previews, forum posts).
+	*/
+	allowStyleElements: boolean;
+}
+/**
+* Create WikitextSettings with defaults for the given mode.
+*/
+declare function createSettings(mode: WikitextMode): WikitextSettings;
+/** Default settings (page mode) */
+declare const DEFAULT_SETTINGS: WikitextSettings;
 type Version = "wikidot";
-export { text, paragraph, listItemSubList, listItemElements, list, link, lineBreak, italics, isStringContainerType, isParagraphSafe, isHeaderType, isContainerTypeParagraphSafe, isAlignType, horizontalRule, heading, createPosition, createPoint, container, bold, Version, VariableMap, UserData, TocEntry, TableRow, TableOfContentsData, TableData, TableCell, TabData, SyntaxTree, StringContainerType, Position, Point, PageRef, Module, MathInlineData, MathData, ListType, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LinkData, IncludeData, ImageSource, ImageData, IframeData, IfTagsData, IfExprData, IfCondData, HtmlData, HeadingLevel, Heading, HeaderType, FootnoteBlockData, FloatAlignment, ExprData, EmbedBlockData, Embed, ElementOf, ElementName, ElementDataMap, ElementData, Element, DefinitionListItem, DateItem, DateData, ContainerType, ContainerData, ColorData, CollapsibleData, CodeBlockData, ClearFloat, BibliographyCiteData, BibliographyBlockData, AttributeMap, AnchorTarget, AnchorData, Alignment, AlignType };
+export { text, paragraph, listItemSubList, listItemElements, list, link, lineBreak, italics, isStringContainerType, isParagraphSafe, isHeaderType, isContainerTypeParagraphSafe, isAlignType, horizontalRule, heading, createSettings, createPosition, createPoint, container, bold, WikitextSettings, WikitextMode, Version, VariableMap, UserData, TocEntry, TableRow, TableOfContentsData, TableData, TableCell, TabData, SyntaxTree, StringContainerType, Position, Point, PageRef, Module, MathInlineData, MathData, ListType, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LinkData, IncludeData, ImageSource, ImageData, IframeData, IfTagsData, IfExprData, IfCondData, HtmlData, HeadingLevel, Heading, HeaderType, FootnoteBlockData, FloatAlignment, ExprData, EmbedBlockData, Embed, ElementOf, ElementName, ElementDataMap, ElementData, Element, DefinitionListItem, DateItem, DateData, DEFAULT_SETTINGS, ContainerType, ContainerData, ColorData, CollapsibleData, CodeBlockData, ClearFloat, BibliographyCiteData, BibliographyBlockData, AttributeMap, AnchorTarget, AnchorData, Alignment, AlignType };

package/dist/index.d.ts

@@ -589,5 +589,45 @@ declare function isContainerTypeParagraphSafe(type: ContainerType): boolean;
 * This does a surface-level check and does not look into element interiors.
 */
 declare function isParagraphSafe(element: Element): boolean;
+/**
+* Wikitext parsing/rendering mode.
+* Each mode has different default settings for syntax availability.
+*/
+type WikitextMode = "page" | "draft" | "forum-post" | "direct-message";
+/**
+* Settings that control parser and renderer behavior based on context.
+*/
+interface WikitextSettings {
+	/** Operating mode */
+	mode: WikitextMode;
+	/**
+	* Whether page-contextual syntax is permitted.
+	* Controls: include, module, table-of-contents.
+	*/
+	enablePageSyntax: boolean;
+	/**
+	* Whether local file paths (file1, file2, file3) are permitted for images.
+	* Disable in contexts without a "local" page (forum posts, direct messages).
+	*/
+	allowLocalPaths: boolean;
+	/**
+	* Whether element IDs should be stable sequential values.
+	* When false, IDs are randomized to prevent collisions
+	* when multiple rendered fragments appear on the same page.
+	*/
+	useTrueIds: boolean;
+	/**
+	* Whether [[module CSS]] style elements are rendered as <style> tags.
+	* Disable to prevent user-authored CSS from affecting the page layout
+	* (e.g., in draft previews, forum posts).
+	*/
+	allowStyleElements: boolean;
+}
+/**
+* Create WikitextSettings with defaults for the given mode.
+*/
+declare function createSettings(mode: WikitextMode): WikitextSettings;
+/** Default settings (page mode) */
+declare const DEFAULT_SETTINGS: WikitextSettings;
 type Version = "wikidot";
-export { text, paragraph, listItemSubList, listItemElements, list, link, lineBreak, italics, isStringContainerType, isParagraphSafe, isHeaderType, isContainerTypeParagraphSafe, isAlignType, horizontalRule, heading, createPosition, createPoint, container, bold, Version, VariableMap, UserData, TocEntry, TableRow, TableOfContentsData, TableData, TableCell, TabData, SyntaxTree, StringContainerType, Position, Point, PageRef, Module, MathInlineData, MathData, ListType, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LinkData, IncludeData, ImageSource, ImageData, IframeData, IfTagsData, IfExprData, IfCondData, HtmlData, HeadingLevel, Heading, HeaderType, FootnoteBlockData, FloatAlignment, ExprData, EmbedBlockData, Embed, ElementOf, ElementName, ElementDataMap, ElementData, Element, DefinitionListItem, DateItem, DateData, ContainerType, ContainerData, ColorData, CollapsibleData, CodeBlockData, ClearFloat, BibliographyCiteData, BibliographyBlockData, AttributeMap, AnchorTarget, AnchorData, Alignment, AlignType };
+export { text, paragraph, listItemSubList, listItemElements, list, link, lineBreak, italics, isStringContainerType, isParagraphSafe, isHeaderType, isContainerTypeParagraphSafe, isAlignType, horizontalRule, heading, createSettings, createPosition, createPoint, container, bold, WikitextSettings, WikitextMode, Version, VariableMap, UserData, TocEntry, TableRow, TableOfContentsData, TableData, TableCell, TabData, SyntaxTree, StringContainerType, Position, Point, PageRef, Module, MathInlineData, MathData, ListType, ListItem, ListData, LinkType, LinkLocation, LinkLabel, LinkData, IncludeData, ImageSource, ImageData, IframeData, IfTagsData, IfExprData, IfCondData, HtmlData, HeadingLevel, Heading, HeaderType, FootnoteBlockData, FloatAlignment, ExprData, EmbedBlockData, Embed, ElementOf, ElementName, ElementDataMap, ElementData, Element, DefinitionListItem, DateItem, DateData, DEFAULT_SETTINGS, ContainerType, ContainerData, ColorData, CollapsibleData, CodeBlockData, ClearFloat, BibliographyCiteData, BibliographyBlockData, AttributeMap, AnchorTarget, AnchorData, Alignment, AlignType };

package/dist/index.js

@@ -191,6 +191,37 @@ function isParagraphSafe(element) {
       return false;
   }
 }
+// packages/ast/src/settings.ts
+function createSettings(mode) {
+  switch (mode) {
+    case "page":
+      return {
+        mode,
+        enablePageSyntax: true,
+        allowLocalPaths: true,
+        useTrueIds: true,
+        allowStyleElements: true
+      };
+    case "draft":
+      return {
+        mode,
+        enablePageSyntax: true,
+        allowLocalPaths: true,
+        useTrueIds: false,
+        allowStyleElements: false
+      };
+    case "forum-post":
+    case "direct-message":
+      return {
+        mode,
+        enablePageSyntax: false,
+        allowLocalPaths: false,
+        useTrueIds: false,
+        allowStyleElements: false
+      };
+  }
+}
+var DEFAULT_SETTINGS = createSettings("page");
 export {
   text,
   paragraph,
@@ -207,8 +238,10 @@ export {
   isAlignType,
   horizontalRule,
   heading,
+  createSettings,
   createPosition,
   createPoint,
   container,
-  bold
+  bold,
+  DEFAULT_SETTINGS
 };

package/package.json

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