feat: piml updates.

fezcode · fezcode · commit 00bc83be3131 · 2025-11-14T06:10:16.000+03:00
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "fezcodex",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "private": true,
   "homepage": "https://fezcode.com",
   "dependencies": {
@@ -13,7 +13,7 @@
     "framer-motion": "^12.23.24",
     "front-matter": "^4.0.2",
     "marked": "^16.4.1",
-    "piml": "^1.0.4",
+    "piml": "^1.1.0",
     "qrcode.react": "^4.2.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
diff --git a/public/posts/piml.txt b/public/posts/piml.txt
@@ -1,5 +1,7 @@
 # piml
 
+**Spec version**: v1.1.0
+
 [Available Libraries](https://github.com/fezcode/piml/blob/main/LIBRARIES.md)
 
 [JSON<->PIML Converter](/#/apps::jpc)
@@ -36,16 +38,20 @@ Indentation is fundamental to PIML's structure, defining hierarchical relationsh
 
 PIML supports single-line comments using the `#` symbol. Anything from `#` to the end of the line is ignored by parsers, allowing for clear inline documentation.
 
+*   **Rule:** Only lines that *start* with `#` are treated as comments. Inline comments (e.g., `(key) value # comment`) are not supported and will be considered part of the value.
+
 ```piml
-(data) value # This explains the data
+# This explains the data
+(data) value # This entire line is the value, not a comment
 ```
 
 ### Escaping
 
 The backslash (`\`) character is used to escape special characters within string values, ensuring that characters like `(` or `#` can be part of the data itself.
 
 *   Common escapes include `\n` (newline), `\t` (tab), and `\\` (literal backslash).
-*   Example: `(title) My \(Awesome\) Title
+*   Example: `(title) My \(Awesome\) Title`
+*   To include a `#` character at the beginning of a line within a multi-line string, escape it with a backslash (`\`), e.g., `\# This is not a comment`.
 
 ## Data Types: Representing Information in PIML
 
diff --git a/public/posts/posts.json b/public/posts/posts.json
@@ -23,7 +23,7 @@
     "slug": "piml",
     "title": "Parenthesis Intended Markup Language",
     "date": "2025-11-12",
-    "updated": "2025-11-13",
+    "updated": "2025-11-14",
     "description": "A deep dive into PIML, a human-readable data serialization format, its syntax, data types, and comparison with JSON, YAML, and TOML.",
     "tags": ["piml", "data-format", "serialization", "markup", "dev"],
     "category": "dev",
diff --git a/public/projects/go-piml.txt b/public/projects/go-piml.txt
@@ -2,6 +2,8 @@ go-piml is a Go package that provides functionality to marshal and unmarshal dat
 ---
 # go-piml
 
+**Spec version**: v1.1.0
+
 `go-piml` is a Go package that provides functionality to marshal and unmarshal data to and from the PIML (Parenthesis Intended Markup Language) format. PIML is a human-readable, indentation-based data serialization format designed for configuration files and simple data structures.
 
 ## Features
@@ -12,7 +14,7 @@ go-piml is a Go package that provides functionality to marshal and unmarshal dat
 -   **Complex Types:** Handles structs, slices (arrays), and maps.
 -   **Nil Handling:** Explicitly represents `nil` for pointers, empty slices, and empty maps.
 -   **Multi-line Strings:** Supports multi-line string values with indentation.
--   **Comments:** Allows single-line and inline comments using `#`.
+-   **Comments:** Allows single-line comments using `#` (only lines starting with `#` are treated as comments).
 -   **Time Support:** Marshals and unmarshals `time.Time` values using RFC3339Nano format.
 
 ## PIML Format Overview
diff --git a/public/projects/piml.js.txt b/public/projects/piml.js.txt
@@ -2,6 +2,8 @@ piml.js is a JavaScript library for parsing and stringifying data in the PIML fo
 ---
 # piml.js
 
+**Spec version**: v1.1.0
+
 `piml.js` is a JavaScript library for parsing and stringifying data in the PIML (Parenthesis Intended Markup Language) format. PIML is a human-readable, indentation-based data serialization format designed for configuration files and simple data structures.
 
 ## Features
@@ -10,7 +12,7 @@ piml.js is a JavaScript library for parsing and stringifying data in the PIML fo
 -   **Primitive Types:** Supports strings, numbers, booleans, and null.
 -   **Complex Types:** Handles objects and arrays.
 -   **Multi-line Strings:** Supports multi-line string values with indentation.
--   **Comments:** Allows single-line and inline comments using `#`.
+-   **Comments:** Allows single-line comments using `#` (only lines starting with `#` are treated as comments).
 
 ## PIML Format Overview
 
diff --git a/public/projects/piml.txt b/public/projects/piml.txt
@@ -2,6 +2,8 @@ piml is a data serialization format designed to be exceptionally human-readable
 ---
 ## 1. Introduction
 
+**Spec version**: v1.1.0
+
 ### 1.1 Apps
 
 - [JSON<->PIML Converter](/#/apps::jpc)
@@ -37,16 +39,26 @@ Consistent indentation is crucial for defining structure.
 
 Comments are denoted by `#`. Everything from `#` to the end of the line is considered a comment and is ignored by parsers.
 
+*   **Rule:** Only lines that *start* with `#` are treated as comments. Inline comments (e.g., `(key) value # comment`) are not supported and will be considered part of the value.
+
 ```piml
-(key) value # This is a comment
+# This is a comment
+(key) value # This entire line is the value, not a comment
 ```
 
 ### 2.4. Escaping
 
+
+
 Backslash (`\`) is used for escaping characters within string values.
 
-* Common escapes: `\n` (newline), `\t` (tab), `\\` (literal backslash).
-* If a string value needs to contain `(` or `#`, it can be escaped, e.g., `(title) My \(Awesome\) Title`.
+
+
+*   Common escapes: `\n` (newline), `\t` (tab), `\\` (literal backslash).
+
+*   If a string value needs to contain `(` or `#`, it can be escaped, e.g., `(title) My \(Awesome\) Title`.
+
+*   To include a `#` character at the beginning of a line within a multi-line string, escape it with a backslash (`\`), e.g., `\# This is not a comment`.
 
 ## 3. Data Types
 
diff --git a/src/version.js b/src/version.js
@@ -1 +1 @@
-export const version = '0.2.0';
+export const version = '0.2.1';

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-export const version = '0.2.0';`
	`1`	`+export const version = '0.2.1';`