@wdprlib/ast 1.2.0 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @wdprlib/ast
 
-AST type definitions for Wikidot markup.
+AST types for Wikidot markup.
 
 ## Installation
 
@@ -30,6 +30,7 @@ Helpers: `text`, `paragraph`, `bold`, `italics`, `heading`, `link`, `list`, `lin
 
 - [@wdprlib/parser](https://www.npmjs.com/package/@wdprlib/parser) - Wikidot markup parser
 - [@wdprlib/render](https://www.npmjs.com/package/@wdprlib/render) - HTML renderer
+- [@wdprlib/decompiler](https://www.npmjs.com/package/@wdprlib/decompiler) - HTML to Wikidot decompiler
 - [@wdprlib/runtime](https://www.npmjs.com/package/@wdprlib/runtime) - Client-side runtime
 
 ## License

package/dist/index.cjs

@@ -259,7 +259,8 @@ function createSettings(mode) {
         enablePageSyntax: true,
         allowLocalPaths: true,
         useTrueIds: true,
-        allowStyleElements: true
+        allowStyleElements: true,
+        allowHtmlBlocks: true
       };
     case "draft":
       return {
@@ -267,7 +268,8 @@ function createSettings(mode) {
         enablePageSyntax: true,
         allowLocalPaths: true,
         useTrueIds: false,
-        allowStyleElements: false
+        allowStyleElements: false,
+        allowHtmlBlocks: false
       };
     case "forum-post":
     case "direct-message":
@@ -276,7 +278,8 @@ function createSettings(mode) {
         enablePageSyntax: false,
         allowLocalPaths: false,
         useTrueIds: false,
-        allowStyleElements: false
+        allowStyleElements: false,
+        allowHtmlBlocks: false
       };
   }
 }

package/dist/index.d.cts

@@ -1154,12 +1154,12 @@ declare const STYLE_SLOT_PREFIX = "\0__IFTAGS_SLOT__";
 * {@link WikitextSettings}. The modes correspond to the places where
 * user-authored wikitext can appear on a Wikidot site.
 *
-* | Mode               | Page syntax | Local paths | True IDs | Style elements |
-* |--------------------|:-----------:|:-----------:|:--------:|:--------------:|
-* | `"page"`           | yes         | yes         | yes      | yes            |
-* | `"draft"`          | yes         | yes         | no       | no             |
-* | `"forum-post"`     | no          | no          | no       | no             |
-* | `"direct-message"` | no          | no          | no       | no             |
+* | Mode               | Page syntax | Local paths | True IDs | Style elements | HTML blocks |
+* |--------------------|:-----------:|:-----------:|:--------:|:--------------:|:-----------:|
+* | `"page"`           | yes         | yes         | yes      | yes            | yes         |
+* | `"draft"`          | yes         | yes         | no       | no             | no          |
+* | `"forum-post"`     | no          | no          | no       | no             | no          |
+* | `"direct-message"` | no          | no          | no       | no             | no          |
 *
 * @group Settings
 */
@@ -1210,6 +1210,25 @@ interface WikitextSettings {
 	* the CSS module is silently ignored.
 	*/
 	allowStyleElements: boolean;
+	/**
+	* Whether `[[html]]` blocks are recognised by the parser and rendered.
+	*
+	* HTML blocks embed raw HTML that the renderer serves inside a sandboxed
+	* iframe. The capability is meaningful only in contexts that can host
+	* the auxiliary iframe URL, so it is disabled in drafts, forum posts,
+	* and direct messages.
+	*
+	* When `false`, the parser still consumes the entire `[[html]]...[[/html]]`
+	* span (so the raw body cannot leak as text) but emits no AST node, and
+	* the renderer skips any pre-existing `html` element it encounters.
+	*
+	* Wikidot's legacy `Text_Wiki` keeps `Html` in its `$disable` list by
+	* default (`lib/Text_Wiki/Text/Wiki.php` line 145-147), so an authentic
+	* Wikidot-compat default would be `false` even in `"page"` mode. wp
+	* keeps `"page"` at `true` for now to preserve existing consumers; a
+	* future change may align with Wikidot.
+	*/
+	allowHtmlBlocks: boolean;
 }
 /**
 * Create a {@link WikitextSettings} with sensible defaults for the given mode.

package/dist/index.d.ts

@@ -1154,12 +1154,12 @@ declare const STYLE_SLOT_PREFIX = "\0__IFTAGS_SLOT__";
 * {@link WikitextSettings}. The modes correspond to the places where
 * user-authored wikitext can appear on a Wikidot site.
 *
-* | Mode               | Page syntax | Local paths | True IDs | Style elements |
-* |--------------------|:-----------:|:-----------:|:--------:|:--------------:|
-* | `"page"`           | yes         | yes         | yes      | yes            |
-* | `"draft"`          | yes         | yes         | no       | no             |
-* | `"forum-post"`     | no          | no          | no       | no             |
-* | `"direct-message"` | no          | no          | no       | no             |
+* | Mode               | Page syntax | Local paths | True IDs | Style elements | HTML blocks |
+* |--------------------|:-----------:|:-----------:|:--------:|:--------------:|:-----------:|
+* | `"page"`           | yes         | yes         | yes      | yes            | yes         |
+* | `"draft"`          | yes         | yes         | no       | no             | no          |
+* | `"forum-post"`     | no          | no          | no       | no             | no          |
+* | `"direct-message"` | no          | no          | no       | no             | no          |
 *
 * @group Settings
 */
@@ -1210,6 +1210,25 @@ interface WikitextSettings {
 	* the CSS module is silently ignored.
 	*/
 	allowStyleElements: boolean;
+	/**
+	* Whether `[[html]]` blocks are recognised by the parser and rendered.
+	*
+	* HTML blocks embed raw HTML that the renderer serves inside a sandboxed
+	* iframe. The capability is meaningful only in contexts that can host
+	* the auxiliary iframe URL, so it is disabled in drafts, forum posts,
+	* and direct messages.
+	*
+	* When `false`, the parser still consumes the entire `[[html]]...[[/html]]`
+	* span (so the raw body cannot leak as text) but emits no AST node, and
+	* the renderer skips any pre-existing `html` element it encounters.
+	*
+	* Wikidot's legacy `Text_Wiki` keeps `Html` in its `$disable` list by
+	* default (`lib/Text_Wiki/Text/Wiki.php` line 145-147), so an authentic
+	* Wikidot-compat default would be `false` even in `"page"` mode. wp
+	* keeps `"page"` at `true` for now to preserve existing consumers; a
+	* future change may align with Wikidot.
+	*/
+	allowHtmlBlocks: boolean;
 }
 /**
 * Create a {@link WikitextSettings} with sensible defaults for the given mode.

package/dist/index.js

@@ -202,7 +202,8 @@ function createSettings(mode) {
         enablePageSyntax: true,
         allowLocalPaths: true,
         useTrueIds: true,
-        allowStyleElements: true
+        allowStyleElements: true,
+        allowHtmlBlocks: true
       };
     case "draft":
       return {
@@ -210,7 +211,8 @@ function createSettings(mode) {
         enablePageSyntax: true,
         allowLocalPaths: true,
         useTrueIds: false,
-        allowStyleElements: false
+        allowStyleElements: false,
+        allowHtmlBlocks: false
       };
     case "forum-post":
     case "direct-message":
@@ -219,7 +221,8 @@ function createSettings(mode) {
         enablePageSyntax: false,
         allowLocalPaths: false,
         useTrueIds: false,
-        allowStyleElements: false
+        allowStyleElements: false,
+        allowHtmlBlocks: false
       };
   }
 }

package/package.json

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