@knowcode/doc-builder 1.5.18 → 1.5.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. package/.claude/settings.local.json +2 -1
  2. package/CHANGELOG.md +14 -0
  3. package/CLAUDE.md +3 -0
  4. package/assets/css/notion-style.css +13 -1
  5. package/html/README.html +3 -3
  6. package/html/css/notion-style.css +13 -1
  7. package/html/documentation-index.html +3 -3
  8. package/html/guides/authentication-guide.html +3 -3
  9. package/html/guides/claude-workflow-guide.html +3 -3
  10. package/html/guides/documentation-standards.html +3 -3
  11. package/html/guides/google-site-verification-guide.html +3 -3
  12. package/html/guides/phosphor-icons-guide.html +3 -3
  13. package/html/guides/seo-guide.html +3 -3
  14. package/html/guides/seo-optimization-guide.html +3 -3
  15. package/html/guides/troubleshooting-guide.html +3 -3
  16. package/html/guides/windows-setup-guide.html +3 -3
  17. package/html/index.html +3 -3
  18. package/html/sitemap.xml +17 -17
  19. package/html/vercel-cli-setup-guide.html +3 -3
  20. package/html/vercel-first-time-setup-guide.html +3 -3
  21. package/package.json +1 -1
  22. package/publish.sh +138 -20
package/.claude/settings.local.json CHANGED
@@ -27,7 +27,8 @@
27
27
  "Bash(diff:*)",
28
28
  "Bash(git log:*)",
29
29
  "Bash(mkdir:*)",
30
- "Bash(cp:*)"
30
+ "Bash(cp:*)",
31
+ "Bash(./publish.sh)"
31
32
  ],
32
33
  "deny": []
33
34
  }
package/CHANGELOG.md CHANGED
@@ -5,6 +5,20 @@ All notable changes to @knowcode/doc-builder will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.5.20] - 2025-07-22
9
+
10
+ ### Fixed
11
+ - Force table cells to top-align with !important CSS
12
+ - Added !important to vertical-align: top for th and td elements
13
+ - Added explicit table th/td rules with !important
14
+ - Added rules for nested elements in table cells
15
+ - Fixes issue where table cells were center-aligned instead of top-aligned
16
+
17
+ ## [1.5.19] - 2025-07-22
18
+
19
+ ### Fixed
20
+ - Force table cells to top-align with !important CSS (version was already published)
21
+
8
22
  ## [1.5.18] - 2025-07-22
9
23
 
10
24
  ### Documentation
package/CLAUDE.md CHANGED
@@ -315,6 +315,9 @@ MIT License - See LICENSE file for details
315
315
  ### NPM Features Documentation
316
316
  - When we add new features - add it to the NPM documented bullet point features - if its a big feature give it a section
317
317
 
318
+ ## Publishing Memories
319
+ - Note how to publish the npm and that there is a @publish.sh script to help
320
+
318
321
  ---
319
322
 
320
323
  **Note**: This project was extracted from the cybersolstice monorepo on 2025-07-21 with full git history preservation.
package/assets/css/notion-style.css CHANGED
@@ -682,13 +682,25 @@ th {
682
682
  background: var(--color-bg-secondary);
683
683
  border-bottom: 1px solid var(--color-border-default);
684
684
  color: var(--color-text-primary);
685
- vertical-align: top;
685
+ vertical-align: top !important;
686
686
  }
687
687
 
688
688
  td {
689
689
  padding: var(--space-3) var(--space-4);
690
690
  border-bottom: 1px solid var(--color-border-default);
691
691
  color: var(--color-text-primary);
692
+ vertical-align: top !important;
693
+ }
694
+
695
+ /* Ensure all table cell content is top-aligned */
696
+ table th,
697
+ table td {
698
+ vertical-align: top !important;
699
+ }
700
+
701
+ /* Ensure nested elements in table cells don't affect alignment */
702
+ table td > *,
703
+ table th > * {
692
704
  vertical-align: top;
693
705
  }
694
706
 
package/html/README.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.097Z",
66
- "dateModified": "2025-07-22T15:51:37.097Z",
65
+ "datePublished": "2025-07-22T16:04:34.100Z",
66
+ "dateModified": "2025-07-22T16:04:34.100Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
100
100
  </div>
101
101
 
102
102
 
package/html/css/notion-style.css CHANGED
@@ -682,13 +682,25 @@ th {
682
682
  background: var(--color-bg-secondary);
683
683
  border-bottom: 1px solid var(--color-border-default);
684
684
  color: var(--color-text-primary);
685
- vertical-align: top;
685
+ vertical-align: top !important;
686
686
  }
687
687
 
688
688
  td {
689
689
  padding: var(--space-3) var(--space-4);
690
690
  border-bottom: 1px solid var(--color-border-default);
691
691
  color: var(--color-text-primary);
692
+ vertical-align: top !important;
693
+ }
694
+
695
+ /* Ensure all table cell content is top-aligned */
696
+ table th,
697
+ table td {
698
+ vertical-align: top !important;
699
+ }
700
+
701
+ /* Ensure nested elements in table cells don't affect alignment */
702
+ table td > *,
703
+ table th > * {
692
704
  vertical-align: top;
693
705
  }
694
706
 
package/html/documentation-index.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.111Z",
66
- "dateModified": "2025-07-22T15:51:37.111Z",
65
+ "datePublished": "2025-07-22T16:04:34.110Z",
66
+ "dateModified": "2025-07-22T16:04:34.110Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
100
100
  </div>
101
101
 
102
102
 
package/html/guides/authentication-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.115Z",
66
- "dateModified": "2025-07-22T15:51:37.115Z",
65
+ "datePublished": "2025-07-22T16:04:34.113Z",
66
+ "dateModified": "2025-07-22T16:04:34.113Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
106
106
  </div>
107
107
 
108
108
 
package/html/guides/claude-workflow-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.122Z",
66
- "dateModified": "2025-07-22T15:51:37.122Z",
65
+ "datePublished": "2025-07-22T16:04:34.123Z",
66
+ "dateModified": "2025-07-22T16:04:34.123Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
106
106
  </div>
107
107
 
108
108
 
package/html/guides/documentation-standards.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.126Z",
66
- "dateModified": "2025-07-22T15:51:37.126Z",
65
+ "datePublished": "2025-07-22T16:04:34.132Z",
66
+ "dateModified": "2025-07-22T16:04:34.132Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/documentation-standards.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
106
106
  </div>
107
107
 
108
108
 
package/html/guides/google-site-verification-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.133Z",
66
- "dateModified": "2025-07-22T15:51:37.133Z",
65
+ "datePublished": "2025-07-22T16:04:34.148Z",
66
+ "dateModified": "2025-07-22T16:04:34.148Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/google-site-verification-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
106
106
  </div>
107
107
 
108
108
 
package/html/guides/phosphor-icons-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.136Z",
66
- "dateModified": "2025-07-22T15:51:37.136Z",
65
+ "datePublished": "2025-07-22T16:04:34.156Z",
66
+ "dateModified": "2025-07-22T16:04:34.156Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/phosphor-icons-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
106
106
  </div>
107
107
 
108
108
 
package/html/guides/seo-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.139Z",
66
- "dateModified": "2025-07-22T15:51:37.139Z",
65
+ "datePublished": "2025-07-22T16:04:34.165Z",
66
+ "dateModified": "2025-07-22T16:04:34.165Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/seo-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
106
106
  </div>
107
107
 
108
108
 
package/html/guides/seo-optimization-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.146Z",
66
- "dateModified": "2025-07-22T15:51:37.146Z",
65
+ "datePublished": "2025-07-22T16:04:34.176Z",
66
+ "dateModified": "2025-07-22T16:04:34.176Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
106
106
  </div>
107
107
 
108
108
 
package/html/guides/troubleshooting-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.149Z",
66
- "dateModified": "2025-07-22T15:51:37.149Z",
65
+ "datePublished": "2025-07-22T16:04:34.179Z",
66
+ "dateModified": "2025-07-22T16:04:34.179Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
106
106
  </div>
107
107
 
108
108
 
package/html/guides/windows-setup-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.155Z",
66
- "dateModified": "2025-07-22T15:51:37.155Z",
65
+ "datePublished": "2025-07-22T16:04:34.184Z",
66
+ "dateModified": "2025-07-22T16:04:34.184Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
106
106
  </div>
107
107
 
108
108
 
package/html/index.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.097Z",
66
- "dateModified": "2025-07-22T15:51:37.097Z",
65
+ "datePublished": "2025-07-22T16:04:34.100Z",
66
+ "dateModified": "2025-07-22T16:04:34.100Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
100
100
  </div>
101
101
 
102
102
 
package/html/sitemap.xml CHANGED
@@ -2,103 +2,103 @@
2
2
  <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
3
3
  <url>
4
4
  <loc>https://doc-builder-delta.vercel.app/404.html</loc>
5
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
5
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
6
6
  <changefreq>monthly</changefreq>
7
7
  <priority>0.6</priority>
8
8
  </url>
9
9
  <url>
10
10
  <loc>https://doc-builder-delta.vercel.app/README.html</loc>
11
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
11
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
12
12
  <changefreq>monthly</changefreq>
13
13
  <priority>0.6</priority>
14
14
  </url>
15
15
  <url>
16
16
  <loc>https://doc-builder-delta.vercel.app/claude-workflow-guide.html</loc>
17
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
17
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
18
18
  <changefreq>monthly</changefreq>
19
19
  <priority>0.8</priority>
20
20
  </url>
21
21
  <url>
22
22
  <loc>https://doc-builder-delta.vercel.app/documentation-index.html</loc>
23
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
23
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
24
24
  <changefreq>monthly</changefreq>
25
25
  <priority>0.6</priority>
26
26
  </url>
27
27
  <url>
28
28
  <loc>https://doc-builder-delta.vercel.app/guides/authentication-guide.html</loc>
29
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
29
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
30
30
  <changefreq>monthly</changefreq>
31
31
  <priority>0.8</priority>
32
32
  </url>
33
33
  <url>
34
34
  <loc>https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html</loc>
35
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
35
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
36
36
  <changefreq>monthly</changefreq>
37
37
  <priority>0.8</priority>
38
38
  </url>
39
39
  <url>
40
40
  <loc>https://doc-builder-delta.vercel.app/guides/document-standards.html</loc>
41
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
41
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
42
42
  <changefreq>monthly</changefreq>
43
43
  <priority>0.8</priority>
44
44
  </url>
45
45
  <url>
46
46
  <loc>https://doc-builder-delta.vercel.app/guides/documentation-standards.html</loc>
47
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
47
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
48
48
  <changefreq>monthly</changefreq>
49
49
  <priority>0.8</priority>
50
50
  </url>
51
51
  <url>
52
52
  <loc>https://doc-builder-delta.vercel.app/guides/google-site-verification-guide.html</loc>
53
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
53
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
54
54
  <changefreq>monthly</changefreq>
55
55
  <priority>0.8</priority>
56
56
  </url>
57
57
  <url>
58
58
  <loc>https://doc-builder-delta.vercel.app/guides/phosphor-icons-guide.html</loc>
59
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
59
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
60
60
  <changefreq>monthly</changefreq>
61
61
  <priority>0.8</priority>
62
62
  </url>
63
63
  <url>
64
64
  <loc>https://doc-builder-delta.vercel.app/guides/seo-guide.html</loc>
65
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
65
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
66
66
  <changefreq>monthly</changefreq>
67
67
  <priority>0.8</priority>
68
68
  </url>
69
69
  <url>
70
70
  <loc>https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html</loc>
71
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
71
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
72
72
  <changefreq>monthly</changefreq>
73
73
  <priority>0.8</priority>
74
74
  </url>
75
75
  <url>
76
76
  <loc>https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html</loc>
77
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
77
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
78
78
  <changefreq>monthly</changefreq>
79
79
  <priority>0.8</priority>
80
80
  </url>
81
81
  <url>
82
82
  <loc>https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html</loc>
83
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
83
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
84
84
  <changefreq>monthly</changefreq>
85
85
  <priority>0.8</priority>
86
86
  </url>
87
87
  <url>
88
88
  <loc>https://doc-builder-delta.vercel.app/index.html</loc>
89
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
89
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
90
90
  <changefreq>weekly</changefreq>
91
91
  <priority>1.0</priority>
92
92
  </url>
93
93
  <url>
94
94
  <loc>https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html</loc>
95
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
95
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
96
96
  <changefreq>monthly</changefreq>
97
97
  <priority>0.8</priority>
98
98
  </url>
99
99
  <url>
100
100
  <loc>https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html</loc>
101
- <lastmod>2025-07-22T15:51:37.169Z</lastmod>
101
+ <lastmod>2025-07-22T16:04:34.197Z</lastmod>
102
102
  <changefreq>monthly</changefreq>
103
103
  <priority>0.8</priority>
104
104
  </url>
package/html/vercel-cli-setup-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.158Z",
66
- "dateModified": "2025-07-22T15:51:37.158Z",
65
+ "datePublished": "2025-07-22T16:04:34.185Z",
66
+ "dateModified": "2025-07-22T16:04:34.185Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
100
100
  </div>
101
101
 
102
102
 
package/html/vercel-first-time-setup-guide.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T15:51:37.160Z",
66
- "dateModified": "2025-07-22T15:51:37.160Z",
65
+ "datePublished": "2025-07-22T16:04:34.187Z",
66
+ "dateModified": "2025-07-22T16:04:34.187Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.17">Last updated: Jul 22, 2025, 03:51 PM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.19">Last updated: Jul 22, 2025, 04:04 PM UTC</span>
100
100
  </div>
101
101
 
102
102
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@knowcode/doc-builder",
3
- "version": "1.5.18",
3
+ "version": "1.5.20",
4
4
  "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
5
5
  "main": "index.js",
6
6
  "bin": {
package/publish.sh CHANGED
@@ -72,16 +72,43 @@ echo ""
72
72
 
73
73
  # Check for uncommitted changes
74
74
  print_step "Checking for uncommitted changes..."
75
- if ! git diff-index --quiet HEAD --; then
76
- print_warning "You have uncommitted changes!"
77
- echo ""
78
- git status --short
79
- echo ""
80
- read -p "Do you want to continue anyway? (y/N) " -n 1 -r
81
- echo ""
82
- if [[ ! $REPLY =~ ^[Yy]$ ]]; then
83
- print_info "Publishing cancelled."
84
- exit 1
75
+
76
+ # Count uncommitted changes excluding html directory
77
+ UNCOMMITTED_COUNT=$(git diff-index HEAD -- | grep -v "^:.*html/" | wc -l | xargs)
78
+ HTML_CHANGES=$(git diff-index HEAD -- | grep "^:.*html/" | wc -l | xargs)
79
+
80
+ if [ "$UNCOMMITTED_COUNT" -gt 0 ] || [ "$HTML_CHANGES" -gt 0 ]; then
81
+ if [ "$UNCOMMITTED_COUNT" -gt 0 ]; then
82
+ print_warning "You have uncommitted changes!"
83
+ echo ""
84
+ git status --short | grep -v "^ M html/"
85
+ echo ""
86
+ fi
87
+
88
+ if [ "$HTML_CHANGES" -gt 0 ]; then
89
+ print_info "Generated HTML files have changed (${HTML_CHANGES} files)"
90
+ echo ""
91
+ read -p "Commit generated HTML files? (Y/n) " -n 1 -r
92
+ echo ""
93
+
94
+ if [[ ! $REPLY =~ ^[Nn]$ ]]; then
95
+ print_step "Committing HTML files..."
96
+ git add html/
97
+ git commit -m "chore: update generated HTML files" > /dev/null
98
+ print_success "HTML files committed"
99
+ fi
100
+ fi
101
+
102
+ # Check again for non-HTML changes
103
+ UNCOMMITTED_COUNT=$(git diff-index HEAD -- | grep -v "^:.*html/" | wc -l | xargs)
104
+ if [ "$UNCOMMITTED_COUNT" -gt 0 ]; then
105
+ echo ""
106
+ read -p "Continue with uncommitted changes? (y/N) " -n 1 -r
107
+ echo ""
108
+ if [[ ! $REPLY =~ ^[Yy]$ ]]; then
109
+ print_info "Publishing cancelled."
110
+ exit 1
111
+ fi
85
112
  fi
86
113
  else
87
114
  print_success "Working directory is clean"
@@ -92,7 +119,6 @@ echo ""
92
119
  print_step "Checking if version ${CURRENT_VERSION} is already published..."
93
120
  if npm view "${PACKAGE_NAME}@${CURRENT_VERSION}" version &> /dev/null; then
94
121
  print_error "Version ${CURRENT_VERSION} is already published!"
95
- print_info "Please update the version in package.json first."
96
122
  echo ""
97
123
 
98
124
  # Show last few published versions
@@ -103,11 +129,84 @@ if npm view "${PACKAGE_NAME}@${CURRENT_VERSION}" version &> /dev/null; then
103
129
  # Suggest next version
104
130
  LATEST_VERSION=$(npm view "${PACKAGE_NAME}" version)
105
131
  print_info "Latest published version: ${LATEST_VERSION}"
132
+
133
+ # Calculate next versions
134
+ PATCH_VERSION=$(npx semver ${LATEST_VERSION} -i patch)
135
+ MINOR_VERSION=$(npx semver ${LATEST_VERSION} -i minor)
136
+ MAJOR_VERSION=$(npx semver ${LATEST_VERSION} -i major)
137
+
106
138
  print_info "Suggested next versions:"
107
- echo " - Patch: $(npx semver ${LATEST_VERSION} -i patch)"
108
- echo " - Minor: $(npx semver ${LATEST_VERSION} -i minor)"
109
- echo " - Major: $(npx semver ${LATEST_VERSION} -i major)"
110
- exit 1
139
+ echo " 1) Patch: ${PATCH_VERSION} (bug fixes)"
140
+ echo " 2) Minor: ${MINOR_VERSION} (new features)"
141
+ echo " 3) Major: ${MAJOR_VERSION} (breaking changes)"
142
+ echo ""
143
+
144
+ # Ask user to choose
145
+ read -p "Would you like to auto-increment the version? (1/2/3/N) " -n 1 -r
146
+ echo ""
147
+
148
+ case $REPLY in
149
+ 1)
150
+ NEW_VERSION=$PATCH_VERSION
151
+ VERSION_TYPE="patch"
152
+ ;;
153
+ 2)
154
+ NEW_VERSION=$MINOR_VERSION
155
+ VERSION_TYPE="minor"
156
+ ;;
157
+ 3)
158
+ NEW_VERSION=$MAJOR_VERSION
159
+ VERSION_TYPE="major"
160
+ ;;
161
+ *)
162
+ print_info "Please update the version in package.json manually."
163
+ exit 1
164
+ ;;
165
+ esac
166
+
167
+ print_step "Updating version to ${NEW_VERSION}..."
168
+
169
+ # Update package.json
170
+ npm version ${VERSION_TYPE} --no-git-tag-version > /dev/null
171
+
172
+ # Update CHANGELOG.md if it exists
173
+ if [ -f "CHANGELOG.md" ]; then
174
+ print_step "Updating CHANGELOG.md..."
175
+
176
+ # Create new changelog entry
177
+ DATE=$(date +%Y-%m-%d)
178
+ NEW_ENTRY="## [${NEW_VERSION}] - ${DATE}\n\n### Changed\n- \n\n"
179
+
180
+ # Insert after the header (assuming standard changelog format)
181
+ sed -i.bak "/^## \[/i\\
182
+ ${NEW_ENTRY}" CHANGELOG.md
183
+ rm CHANGELOG.md.bak
184
+
185
+ print_warning "Please edit CHANGELOG.md to add your changes"
186
+ print_info "Opening CHANGELOG.md in default editor..."
187
+
188
+ # Open in default editor if available
189
+ if command -v code &> /dev/null; then
190
+ code CHANGELOG.md
191
+ elif command -v nano &> /dev/null; then
192
+ nano CHANGELOG.md
193
+ elif command -v vim &> /dev/null; then
194
+ vim CHANGELOG.md
195
+ fi
196
+
197
+ echo ""
198
+ read -p "Press enter when you've updated the CHANGELOG..." -r
199
+ echo ""
200
+ fi
201
+
202
+ # Commit the version bump
203
+ print_step "Committing version bump..."
204
+ git add package.json package-lock.json CHANGELOG.md 2>/dev/null
205
+ git commit -m "chore: bump version to ${NEW_VERSION}" > /dev/null
206
+ print_success "Version bumped to ${NEW_VERSION}"
207
+
208
+ # Update current version for the rest of the script
209
+ CURRENT_VERSION=$NEW_VERSION
111
210
  else
112
211
  print_success "Version ${CURRENT_VERSION} is not yet published"
113
212
  fi
@@ -183,12 +282,31 @@ if npm publish; then
183
282
  echo " npx ${PACKAGE_NAME}@latest"
184
283
  echo ""
185
284
 
186
- # Suggest next steps
285
+ # Automatically create and push git tag
286
+ print_step "Creating git tag v${CURRENT_VERSION}..."
287
+ if git tag "v${CURRENT_VERSION}" 2>/dev/null; then
288
+ print_success "Git tag created"
289
+
290
+ echo ""
291
+ read -p "Push tag to origin? (Y/n) " -n 1 -r
292
+ echo ""
293
+
294
+ if [[ ! $REPLY =~ ^[Nn]$ ]]; then
295
+ print_step "Pushing tag to origin..."
296
+ if git push origin "v${CURRENT_VERSION}"; then
297
+ print_success "Tag pushed successfully"
298
+ else
299
+ print_warning "Failed to push tag. Run manually: git push origin v${CURRENT_VERSION}"
300
+ fi
301
+ fi
302
+ else
303
+ print_warning "Tag v${CURRENT_VERSION} already exists"
304
+ fi
305
+
306
+ echo ""
187
307
  print_info "Next steps:"
188
- echo " 1. Create a git tag: git tag v${CURRENT_VERSION}"
189
- echo " 2. Push the tag: git push origin v${CURRENT_VERSION}"
190
- echo " 3. Create a GitHub release"
191
- echo " 4. Update CHANGELOG.md for the next version"
308
+ echo " 1. Create a GitHub release at: https://github.com/knowcode/doc-builder/releases/new"
309
+ echo " 2. Deploy example site: npx @knowcode/doc-builder@latest deploy"
192
310
  echo ""
193
311
  else
194
312
  echo ""