Feat/pro block settings

[iftakharul-islam]

Summary by CodeRabbit

• New Features

  • Table of Contents block with hierarchical/numbered lists, collapsible mobile behavior, smooth scrolling, and server/client rendering
  • Contributors and Advanced Contributors blocks with configurable avatars, titles, links, date display, and responsive styling

• Style

  • Improved responsive, RTL, print and accessibility-aware styles across blocks; refined mobile notice and link hover states

• Chores

  • Build and asset updates to improve runtime packaging and editor integration

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

This PR adds four new Gutenberg blocks (Contributors, AdvanceContributors, TableOfContents, DocsGrid), many reusable block control components, JS/PHP helpers for generating block styles, updated build artifacts/webpack config, and multiple CSS/asset updates across editor and frontend.

Changes

Cohort / File(s)	Summary
TableOfContents block src/blocks/TableOfContents/*, assets/build/blocks/TableOfContents/*, assets/build/blocks/TableOfContents/index-rtl.css, assets/build/blocks/TableOfContents/index.css, assets/build/blocks/TableOfContents/view.js, src/blocks/TableOfContents/view.js, src/blocks/TableOfContents/render.php	New dynamic TOC block: editor UI, view.js scroll/spy/smooth-scroll, server-side render helpers (styles/content extraction), inline style generation, block.json and assets.
Contributors block src/blocks/Contributors/*, assets/build/blocks/Contributors/*	New Contributors block: editor (edit, edit-old), save stub, server render with responsive inline CSS, attributes manifest, styles (RTL + LTR), and asset manifests.
AdvanceContributors block src/blocks/AdvanceContributors/*, assets/build/blocks/AdvanceContributors/*	New AdvanceContributors block: richer attribute surface, edit components (new + old), server render, style sheets (RTL + LTR), and build assets.
DocsGrid block src/blocks/DocsGrid/*, assets/build/blocks/DocsGrid/*	New DocsGrid block files and RTL/LTR styles; render.php functions wrapped with if (!function_exists(...)) guards; asset manifests and built entries.
Shared block controls & components src/blocks/commonControls/*, src/blocks/components/*	Many reusable editor controls added: AlignmentControls, ColorsControls, DimensionsControls, BackgroundImageControls, BorderAndShadowControls, DisplayControls, TypographyControls, Spacing/Shadow/Border/Dimension/Background/TabSystem/Typography controls, etc.
Block helpers src/blocks/helpers/*, src/blocks/helpers/block-styles.php, src/blocks/helpers/block-helpers.js, src/blocks/helpers/index.js	New PHP and JS helper libraries for generating block inline styles, typography/spacing/border/shadow builders, CSS sanitization/units, and exports. README added.
Build artifacts & webpack assets/build/*.asset.php, assets/build/*.js, assets/build/*.css, webpack.config.js, package.json, assets/build/index.asset.php, assets/build/block.asset.php, assets/build/frontend.asset.php, assets/build/store.asset.php, assets/build/print.asset.php	Updated build outputs: added react-jsx-runtime to manifests, updated version hashes, migrated bundles to JSX runtime exports, simplified font paths, adjusted webpack asset rules (images/fonts/SVG), and swapped devDeps in package.json.
Frontend / core plugin changes includes/Assets.php, includes/Frontend.php, wedocs.php, assets/build/frontend.css, assets/build/style-block.css, assets/build/block.css, assets/build/block-rtl.css, assets/build/index.asset.php	Added localized assetsUrl and isPro variables; commented out block style registration and template loader hook; added block category registration and dequeue logic; CSS tweaks (font path updates, minor rule removals, RTL css additions).
Misc / docs readme.md, src/blocks/helpers/README.md	Documentation additions and README for helpers.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60–90 minutes

Possibly related issues

• weDevsOfficial/wedocs-pro#168 — Implements the same wedocs/table-of-contents block and related render/style/view behavior; likely linked to TOC objectives.

Possibly related PRs

• Add docs grid #203 — Related changes to the DocsGrid block (render/pagination) and overlapping block files.
• Grant delete capability to admin and editor by default, also to roles selected on wedocs pro global permission settings #198 — Changes to build asset manifests and JS dependency updates (react → react-jsx-runtime) match modifications in this PR.
• Revert "Enhance design and unlock permission management features for free users" #242 — Modifies includes/Assets.php localization and asset handling, touching the same admin script localization area.

Suggested labels

Needs Review

Suggested reviewers

• arifulhoque7

Poem

🐇 In a burrow of code I happily hop,
New blocks and helpers piled high in a crop.
TOC, Contributors, DocsGrid in a row,
Styles and builds all set—ready to go!
A tiny rabbit applauds this neat hop—bravo! 🥕

Pre-merge checks and finishing touches

❌ Failed checks (1 warning, 1 inconclusive)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 34.78% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.
Title check	❓ Inconclusive	The PR title 'Feat/pro block settings' is vague and generic, using abbreviation 'Feat' and the term 'pro block settings' without clearly specifying which blocks or features are affected.	Clarify the title to describe the main changes more specifically. Examples: 'Add Table of Contents and Contributors blocks', 'Implement pro gating for Contributors block', or 'Add dynamic block rendering and styling system'.

✅ Passed checks (1 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 79

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

webpack.config.js (1)

71-75: Avoid duplicate MiniCssExtractPlugin.

@wordpress/scripts already injects MiniCssExtractPlugin. A second instance can cause conflicts. Reuse the existing one unless you have a specific need.

Apply this diff:

-  plugins: [
-    ...defaultConfig.plugins,
-    new MiniCSSExtractPlugin( {
-      filename: '[name].css',
-      chunkFilename: '[id].css',
-    } ),
-  ],
+  plugins: [ ...defaultConfig.plugins ],

🧹 Nitpick comments (98)

assets/build/style-block-rtl.css (2)

1-1: Reconsider extensive use of !important flags.

The CSS contains numerous !important declarations (e.g., background-color:var(--field-color) !important), which typically indicates CSS architecture or specificity issues. Using !important broadly can make the codebase harder to maintain and override.

Review the specificity of selectors and consider restructuring to rely on proper selector hierarchy instead of !important. For example:

/* Instead of: */
.wp-block-wedocs-wedocs-search .wedocs-search-input .search-field {
  background-color: var(--field-color) !important;
}

/* Consider: */
.wp-block-wedocs-wedocs-search .wedocs-search-input .search-field {
  background-color: var(--field-color);
}

This requires ensuring the selector specificity is sufficient without needing !important.

---

1-1: Consider build artifact exclusion from version control.

Build artifacts are typically auto-generated and should not be committed to version control. If this file is generated during the build process, it should be excluded via .gitignore and regenerated as part of CI/CD.

Verify that assets/build/ is excluded from .gitignore and that the build pipeline regenerates these files. This keeps the repository clean and ensures artifacts stay in sync with source.

src/blocks/components/SpacingControl.js (3)

26-68: Consider extracting the duplicated BoxControl configuration.

The Padding and Margin sections share identical configuration (units, allowReset, resetValues). Extract this into a shared helper or constant to improve maintainability.

Example refactor:

+const SPACING_BOX_CONFIG = {
+	units: [
+		{ value: 'px', label: 'px' },
+		{ value: 'em', label: 'em' },
+		{ value: 'rem', label: 'rem' },
+		{ value: '%', label: '%' }
+	],
+	allowReset: true,
+	resetValues: {
+		top: '0px',
+		right: '0px',
+		bottom: '0px',
+		left: '0px'
+	}
+};
+
 const SpacingControl = ({
 	// ... props
 }) => {
 	return (
 		<PanelBody title={label} initialOpen={false}>
 			{showPadding && (
 				<>
 					<BoxControl
 						label={__('Padding', 'wedocs')}
 						values={paddingValue}
 						onChange={onPaddingChange}
-						units={[
-							{ value: 'px', label: 'px' },
-							{ value: 'em', label: 'em' },
-							{ value: 'rem', label: 'rem' },
-							{ value: '%', label: '%' }
-						]}
-						allowReset={true}
-						resetValues={{
-							top: '0px',
-							right: '0px',
-							bottom: '0px',
-							left: '0px'
-						}}
+						{...SPACING_BOX_CONFIG}
 					/>
 					<Spacer marginTop={4} marginBottom={4} />
 				</>
 			)}
 
 			{showMargin && (
 				<>
 					<BoxControl
 						label={__('Margin', 'wedocs')}
 						values={marginValue}
 						onChange={onMarginChange}
-						units={[
-							{ value: 'px', label: 'px' },
-							{ value: 'em', label: 'em' },
-							{ value: 'rem', label: 'rem' },
-							{ value: '%', label: '%' }
-						]}
-						allowReset={true}
-						resetValues={{
-							top: '0px',
-							right: '0px',
-							bottom: '0px',
-							left: '0px'
-						}}
+						{...SPACING_BOX_CONFIG}
 					/>
 					<Spacer marginTop={4} marginBottom={4} />
 				</>
 			)}
 		</PanelBody>
 	);
 };

---

77-77: Consider consistent default value handling.

The gapValue uses an inline fallback ('10px') while paddingValue and marginValue have default values in the props destructuring. For consistency, consider adding a default for gapValue in the props definition (line 18).

---

74-85: Note: API inconsistency with custom UnitControl.

This component uses WordPress's experimental UnitControl (value as a string like '10px'), while the codebase also has a custom UnitControl at src/blocks/CustomControls/UnitControl.js with a different API (separate value and unit props). Consider documenting when to use each or standardizing on one approach to avoid confusion.

src/blocks/commonControls/DisplayControls.js (1)

26-47: Consider extracting styles to a stylesheet.

While inline styles work, extracting them to a dedicated CSS file or using a CSS-in-JS solution would improve maintainability and allow for better reusability across components.

readme.md (1)

26-39: Remove misleading Mozart configuration comment from readme.md.

This commented JSON block references "WPMUDEV\PluginTest" and includes google/apiclient, but verification shows: the weDocs project has no Mozart configuration in composer.json, and google/apiclient is not used anywhere in the codebase. This appears to be accidentally copied from another project and should be deleted to avoid confusion.

src/blocks/TableOfContents/editor.scss (1)

18-24: Consider the UX implications of cursor: default on links.

The TOC list links have cursor: default but still show a hover color change. This creates an inconsistent user experience where the visual feedback (color change on hover) suggests interactivity, but the cursor doesn't change to indicate a clickable element.

If these links are not meant to be clickable in the editor (which seems to be the intent), consider either:

1. Removing the hover color change to match the non-interactive cursor, or
2. Using pointer-events: none to completely disable interaction and remove the need for hover styles.

Apply this diff to remove hover styles for consistency:

 	.toc-content {
 		.toc-list {
 			li a {
 				cursor: default;
-
-				&:hover {
-					color: #0073aa;
-				}
+				pointer-events: none;
 			}
 		}
 	}

assets/build/blocks/TableOfContents/style-index.css (2)

1-1: Typo in custom property name (sytle → style) and likely wrong binding.

color uses var(--list-item-sytle, inherit). Rename to a clear token (e.g., --toc-link-color) across LTR/RTL CSS and JS, and bind it to listColor (not container background).

---

1-1: Nit: prefer ::before/::after.

Use double-colon pseudo-elements for modern CSS.

src/blocks/commonControls/TypographyControls.js (2)

255-270: Use undefined on reset instead of null to truly clear values.

Block serialization treats undefined as “absent”; null may persist and complicate style builders. Prefer undefined.

Apply this diff:

-                                fontFamily: null,
-                                fontSize: null,
-                                fontAppearance: null,
-                                lineHeight: null,
-                                letterSpacing: null,
-                                textDecoration: null,
-                                textTransform: null,
+                                fontFamily: undefined,
+                                fontSize: undefined,
+                                fontAppearance: undefined,
+                                lineHeight: undefined,
+                                letterSpacing: undefined,
+                                textDecoration: undefined,
+                                textTransform: undefined,

---

49-66: Reduce repetition with a small helper.

setAttributes blocks repeat. Extract a setTypographyForDevice(key, value) helper to cut noise and mistakes.

Example:

+ const setTypographyForDevice = (key, value) => {
+   setAttributes({
+     typographyControls: {
+       ...typographyControls,
+       [device]: {
+         ...typographyControls[device],
+         [key]: value,
+       },
+     },
+   });
+ };
...
- onChange={(value) => { setAttributes({ ... }) }}
+ onChange={(value) => setTypographyForDevice('fontFamily', value)}

Also applies to: 90-107, 111-144, 149-165, 167-201, 204-242

webpack.config.js (4)

19-20: Use content hashing (or path) for emitted assets to avoid collisions and aid caching.

images/[name][ext] can overwrite when names repeat. Prefer contenthash or preserve subpaths.

Apply one:

- assetModuleFilename: 'images/[name][ext]',
+ assetModuleFilename: 'images/[name].[contenthash:8][ext]',

or:

- assetModuleFilename: 'images/[name][ext]',
+ assetModuleFilename: '[path][name][ext]',

---

24-31: Broaden filter to include webp/avif; otherwise rules conflict.

Default WP Scripts rules often match webp/avif; your filter leaves them, causing overlap.

Apply this diff:

- return !testString.match(/jpg|jpeg|png|gif|svg|bmp|ico/i);
+ return !testString.match(/jpg|jpeg|png|gif|svg|bmp|ico|webp|avif/i);

---

48-59: Brittle SVG routing by substring match.

Checking pathData.filename.includes('assets/fonts') can fail with alternate paths. Use include/exclude with resolved paths, or a dedicated fonts rule before SVG images.

Example:

- if (pathData.filename.includes('assets/fonts')) { return 'fonts/[name][ext]'; }
+ // In rules: put a fonts-first rule with `test: /\.svg$/i, include: path.resolve(__dirname, 'assets/fonts')`
+ // and a second svg rule for images with `exclude` pointing to the fonts dir.

---

78-94: Make devServer host configurable.

Hardcoding host 'wedocs.test' can block other devs. Read from env with a safe default.

Example:

- host: 'wedocs.test',
+ host: process.env.DEV_HOST || 'localhost',
+ port: parseInt(process.env.DEV_PORT || '8886', 10),

src/blocks/components/TypographyControl.js (3)

54-70: Use theme/gutenberg font families, not a hard‑coded list.

Pull families via useSettings('typography.fontFamilies') to respect theme.json and user fonts; fall back gracefully for classic themes.

Example snippet:

import { useSettings } from '@wordpress/block-editor';
const ff = useSettings( 'typography.fontFamilies' );
const themeFonts = ff?.[0]?.theme ?? [];
const customFonts = ff?.[0]?.custom ?? [];
const options = [{ label: __('Default','wedocs'), value: 'default' }, ...themeFonts, ...customFonts];

---

116-127: UnitControl defaults should be empty/undefined, not 'normal'.

UnitControl expects numeric+unit (or empty). Use placeholders and treat undefined as “inherit/normal” in style builders.

Apply this diff:

- value={value.lineHeight || 'normal'}
+ value={value.lineHeight}
...
- value={value.letterSpacing || 'normal'}
+ value={value.letterSpacing}

Then handle “normal” in CSS generation (fallback when undefined).

Also applies to: 130-140

---

32-33: Open by default only when needed.

Initial open Panels can be noisy. Consider initialOpen prop controlled by caller or keep it closed by default for consistency with other panels.

assets/build/blocks/TableOfContents/style-index-rtl.css (1)

1-1: Typo in custom property (sytle) and binding.

Rename var(--list-item-sytle) to --toc-link-color (or similar) and align with JS to source from listColor, not container background.

src/blocks/helpers/README.md (1)

1-120: Add minimum WP/Gutenberg versions and SSR registration snippet.

Include a short “Compatibility” section (min WP and Gutenberg) and a code snippet showing register_block_type with render_callback using these helpers for dynamic blocks. Helps adopters avoid guesswork.

assets/build/block.js (1)

1-1: Do not lint/review minified build artifacts; exclude assets/build from linters and code review.

Biome “noRedeclare / use-before-declare” errors are from minification. Add assets/build to .eslintignore/.biomeignore and CI excludes. Prefer reviewing source files with sourcemaps.

Example .biomeignore/.eslintignore entry:

assets/build/**

src/blocks/commonControls/AlignmentControls.js (2)

30-76: DRY the four nearly identical handlers

Reduce repetition and accidental divergence by using a generic updater.

Example:

-const handleDirectionAlignmentChange = (value) => { /* ...direction... */ };
-const handleTextAlignmentChange = (value) => { /* ...textAlign... */ };
-const handleHorizontalAlignmentChange = (value) => { /* ...justifyContent... */ };
-const handleVerticalAlignmentChange = (value) => { /* ...alignItems... */ };
+const updateAlignment = (key) => (value) =>
+  setAttributes({
+    alignmentControls: {
+      ...alignmentControls,
+      [device]: {
+        ...currentAlignment,
+        [key]: value,
+      },
+    },
+  });
+
+const handleDirectionAlignmentChange = updateAlignment('direction');
+const handleTextAlignmentChange = updateAlignment('textAlign');
+const handleHorizontalAlignmentChange = updateAlignment('justifyContent');
+const handleVerticalAlignmentChange = updateAlignment('alignItems');

---

196-219: Prefer removing keys over saving nulls on Reset

Persisting null bloats attribute storage and requires extra null checks. Remove the keys for the current device instead.

- onClick={() => {
-   setAttributes({
-     alignmentControls: {
-       ...alignmentControls,
-       [device]: {
-         ...currentAlignment,
-         textAlign: null,
-         alignItems: null,
-         justifyContent: null,
-         direction: null,
-       },
-     },
-   });
- }}
+ onClick={() => {
+   const { textAlign, alignItems, justifyContent, direction, ...rest } = currentAlignment || {};
+   setAttributes({
+     alignmentControls: {
+       ...alignmentControls,
+       [device]: rest,
+     },
+   });
+ }}

Ensure downstream CSS generation handles missing keys (undefined) correctly.

src/blocks/components/BackgroundControl.js (2)

15-27: Default onChange handlers to no-ops to prevent crashes

If a parent omits a handler, RadioControl/TextControl/MediaUpload will call undefined.

-const BackgroundControl = ({
+const BackgroundControl = ({
   label,
   backgroundType = 'classic',
-  onBackgroundTypeChange,
+  onBackgroundTypeChange = () => {},
   backgroundColor,
-  onBackgroundColorChange,
+  onBackgroundColorChange = () => {},
   backgroundGradient,
-  onBackgroundGradientChange,
+  onBackgroundGradientChange = () => {},
   backgroundImage = {},
-  onBackgroundImageChange,
+  onBackgroundImageChange = () => {},
   showGradient = true,
   showImage = true
 }) => {

---

31-39: Optional UX polish: clear opposite-type state on switch

Avoid stale values when toggling type.

- onChange={onBackgroundTypeChange}
+ onChange={(type) => {
+   onBackgroundTypeChange(type);
+   if (type === 'classic') onBackgroundGradientChange?.('');
+   if (type === 'gradient') onBackgroundColorChange?.('');
+ }}

Also, when selecting an image, consider fallback alt (media.alt || media.title || '').

Also applies to: 57-66, 69-107

src/blocks/commonControls/DimensionsControls.js (2)

98-154: Consistency: consider supplying explicit units to UnitControl

DimensionControl.js defines units; this component leaves defaults. Aligning units across both improves UX and predictability.

Example:

 <UnitControl
   __next40pxDefaultSize
   label={__('Fixed', 'wedocs')}
   value={currentDimensions.width || ''}
+  units={[ { value: 'px', label: 'px' }, { value: '%', label: '%' }, { value: 'em', label: 'em' }, { value: 'rem', label: 'rem' } ]}

Repeat for min/max width/height.

Also applies to: 171-227

---

230-258: Prefer removing keys over saving nulls on Reset

Same rationale as AlignmentControls.

- [device]: {
-   ...currentDimensions,
-   width: null,
-   minWidth: null,
-   maxWidth: null,
-   height: null,
-   minHeight: null,
-   maxHeight: null,
-   padding: null,
-   margin: null,
-   blockSpacing: null,
- },
+[device]: ((d) => {
+  const {
+    width, minWidth, maxWidth,
+    height, minHeight, maxHeight,
+    padding, margin, blockSpacing,
+    ...rest
+  } = d || {};
+  return rest;
+})(currentDimensions),

src/blocks/components/DimensionControl.js (1)

8-16: Default onChange handlers to no-ops

Prevents accidental crashes if a parent forgets a handler.

-const DimensionControl = ({
+const DimensionControl = ({
   label,
   widthValue,
-  onWidthChange,
+  onWidthChange = () => {},
   heightValue,
-  onHeightChange,
+  onHeightChange = () => {},
   showHeight = true,
   linkValues = false
 }) => {

assets/build/print-rtl.css (4)

39-40: Remove duplicate border declaration

Only the latter applies; drop the first to avoid confusion.

-  border: 1px solid #ccc;
-  border: 1px solid rgba(0, 0, 0, 0.15);
+  border: 1px solid rgba(0, 0, 0, 0.15);

---

36-37: Deduplicate white-space

The second overrides the first. Keep pre-wrap for readability in print.

-  white-space: pre;
-  white-space: pre-wrap;
+  white-space: pre-wrap;

---

55-56: Resolve conflicting font-size declarations

font-size appears twice; only last wins. Keep the intended value (15px shown later) and remove the earlier one.

-  font-size: 18px;
   line-height: 1.2em;
   border-radius: 50px;
   color: #fff;
   background: #3197d1;
   vertical-align: baseline;
   white-space: nowrap;
-  font-size: 15px;
+  font-size: 15px;

Also applies to: 62-62

---

141-144: Drop duplicate selector

Same selector listed twice.

-a:not(.anchorjs-link)::after,
-a:not(.anchorjs-link)::after {
+a:not(.anchorjs-link)::after {
   content: ' (' attr(href) ')';
 }

src/blocks/TableOfContents/style.scss (3)

63-67: Use logical properties to support RTL

Replace left-specific properties with logical ones.

- border-left: 3px solid #0073aa;
- padding-left: 10px;
+ border-inline-start: 3px solid #0073aa;
+ padding-inline-start: 10px;

---

133-135: Respect reduced motion preferences

Avoid forced smooth scrolling when users prefer reduced motion.

 html.smooth-scroll {
   scroll-behavior: smooth;
 }
+@media (prefers-reduced-motion: reduce) {
+  html.smooth-scroll {
+    scroll-behavior: auto;
+  }
+}

---

137-151: Avoid non-localizable CSS-generated content

The loading message is hardcoded via content: and can’t be localized/accessibility-announced. Prefer rendering this text in markup with an ARIA live region.

src/blocks/commonControls/ColorsControls.js (1)

17-17: Remove unused props

isTextColor, isBackgroundColor, isLinkColor are declared but unused. Drop them or implement conditional rendering.

assets/build/blocks/DocsGrid/index.js (2)

1-1: Avoid per_page: -1 REST queries in editor

Fetching all docs/sections/articles can be slow on large sites. Paginate or limit plus on-demand fetch to improve editor perf.

---

1-1: Consider excluding built assets from PRs

Minified bundles create noisy diffs and false-positive lint. Commit sources and rely on build steps or attach artifacts on releases.

assets/build/frontend-rtl.css (2)

508-516: Conflicting font-size declarations

font-size is set to 18px then 15px for the same selector; the latter wins. Remove one for clarity.

-  font-size: 18px;
   line-height: 1.2em;
   border-radius: 50px;
   color: #fff;
   background: #3197d1;
   vertical-align: baseline;
   white-space: nowrap;
-  font-size: 15px;
+  font-size: 15px;

---

164-168: Prefer overflow: auto for hit list

overflow: scroll always shows scrollbars; auto avoids visual noise.

-  overflow: scroll;
+  overflow: auto;

src/blocks/Contributors/edit-old.js (4)

10-23: Prune unused imports

RangeControl and ButtonGroup appear unused. Remove to reduce bundle size.

---

66-71: currentPost is computed but unused

Either wire it into preview/data fetching or remove it.

---

92-100: Avatar border radius used but not configurable here

rounded uses attributes.avatarBorderRadius, but this UI doesn’t expose a control to set it. Add a UnitControl or remove the dependency.

---

28-29: Remove edit-old.js — it's unused and superseded by edit.js.

Verification confirms src/blocks/Contributors/index.js imports from ./edit (not edit-old), and there are no references to edit-old.js anywhere in the codebase. The file appears to be legacy code that was fully replaced by edit.js. Keeping it risks maintenance burden and accidental edits to the wrong file.

src/blocks/helpers/block-styles.php (3)

141-149: Gradient is overridden by image; support layered backgrounds.

Currently background-image gets set twice; the URL wins and gradient is lost. Compose a single declaration:

-    if ($background_type === 'gradient' && $background_gradient) {
-        $styles[] = 'background-image: ' . esc_attr($background_gradient);
-    }
-    if (isset($background_image['url']) && !empty($background_image['url'])) {
-        $styles[] = 'background-image: url(' . esc_url($background_image['url']) . ')';
-        $styles[] = 'background-size: cover';
-        $styles[] = 'background-position: center';
-    }
+    $images = [];
+    if ($background_type === 'gradient' && $background_gradient) {
+        $images[] = esc_attr($background_gradient);
+    }
+    if (!empty($background_image['url'])) {
+        $images[] = 'url(' . esc_url($background_image['url']) . ')';
+        $styles[] = 'background-size: cover';
+        $styles[] = 'background-position: center';
+    }
+    if ($images) {
+        $styles[] = 'background-image: ' . implode(', ', $images);
+    }

Also applies to: 145-149

---

236-242: Avoid dropping legitimate “0” values in styles_to_css.

array_filter without a callback treats "0" as empty. Use strlen to keep "margin: 0" strings intact (future-proofing).

-    return implode('; ', array_filter($styles));
+    return implode('; ', array_filter($styles, 'strlen'));

---

290-311: Broaden sanitizer to modern CSS functions.

calc(), clamp(), min(), max(), and var() are common in block styles. Consider supporting them to avoid stripping valid input. Example approach (illustrative):

-    if (preg_match('/^(-?\d*\.?\d+)([a-z%]+)?$/i', $value, $matches)) {
+    if (preg_match('/^(-?\d*\.?\d+)([a-z%]+)?$/i', $value, $matches)) {
         ...
-    }
+    } elseif (preg_match('/^(calc|clamp|min|max)\(.+\)$/i', $value) || preg_match('/^var\(--[a-z0-9\-\_]+\)$/i', $value)) {
+        return $value;
+    }

src/blocks/commonControls/BackgroundImageControls.js (1)

18-19: Hoist static constants outside the component.

Move ALLOWED_MEDIA_TYPES to module scope to avoid re-allocating on every render.

-const BackgroundImageControls = ({ attributes, setAttributes, device }) => {
-    const { backgroundImageControls } = attributes;
-    const currentBackgroundImage = backgroundImageControls[device] || {};
-
-    const ALLOWED_MEDIA_TYPES = ['image'];
+const ALLOWED_MEDIA_TYPES = [ 'image' ];
+const BackgroundImageControls = ({ attributes, setAttributes, device }) => {
+    const { backgroundImageControls } = attributes;
+    const currentBackgroundImage = backgroundImageControls[device] || {};

src/blocks/AdvanceContributors/edit-old.js (3)

151-161: Use WordPress date i18n utilities for preview date.

Respect site locale/timezone for the editor preview.

-import { useSelect } from '@wordpress/data';
+import { useSelect } from '@wordpress/data';
+import { dateI18n, getSettings as getDateSettings } from '@wordpress/date';
...
-                        <span style={dateStyle}>
-                            {attributes.datePrefix} {new Date().toLocaleDateString('en-US', {
-                                year: 'numeric',
-                                month: 'long',
-                                day: 'numeric'
-                            })}
-                        </span>
+                        <span style={dateStyle}>
+                            { attributes.datePrefix } { dateI18n( getDateSettings().formats.date || 'F j, Y', Date.now() ) }
+                        </span>

---

292-320: Capture media ID with background image for better caching and REST usage.

Store id alongside url/alt to allow size switching and consistent serialization.

-    onSelect={(media) => setAttributes({
-        backgroundImage: { url: media.url, alt: media.alt }
-    })}
+    onSelect={(media) => setAttributes({
+        backgroundImage: { id: media.id, url: media.url, alt: media.alt }
+    })}

If server render uses IDs for responsive sources, ensure schema accepts backgroundImage.id.

---

33-49: Consider centralizing style generation via the new PHP helpers (parity).

Inline editor styles duplicate logic now present in src/blocks/helpers/block-styles.php. A small utility mirroring the helper on the client would reduce drift and bugs.

Happy to sketch a tiny JS style-builder to keep parity with wedocs_build_* helpers.

src/blocks/AdvanceContributors/index.js (1)

12-16: Update comment to match inline implementation.

The comment references ./save.js but the save function is defined inline. Since this block uses server-side rendering (returning null), consider either:

1. Removing the comment, or
2. Updating it to reflect the inline implementation

 	/**
-	 * @see ./save.js
+	 * Server-side rendered block - save returns null
 	 */
 	save: () => null,

src/blocks/TableOfContents/index.js (1)

29-35: Remove trailing whitespace.

Clean up the trailing whitespace at the end of the file.

 registerBlockType( metadata.name, {
 	/**
 	 * @see ./edit.js
 	 */
 	edit: Edit,
 } );
-	

src/blocks/Contributors/save.js (1)

1-11: Remove unused blockProps variable.

Since this is a server-rendered block that returns null, the useBlockProps.save() call and blockProps variable are unnecessary and can be removed. The import can also be removed.

-import { useBlockProps } from '@wordpress/block-editor';
-
 const Save = () => {
-	const blockProps = useBlockProps.save();
-
 	// Since this is a dynamic block that uses PHP rendering,
 	// we return null to let the server-side render function handle the output
 	return null;
 };

 export default Save;

src/blocks/TableOfContents/controls/ListItems.js (1)

18-22: Remove commented-out code.

The commented-out ColorsControls block should either be implemented or removed. Leaving commented code in production decreases maintainability.

src/blocks/Contributors/style.scss (1)

105-108: Consider removing !important if possible.

The !important flags on lines 106-107 for avatar sizing may indicate specificity issues. If possible, increase selector specificity instead to avoid !important.

.contributor-avatar {
    // Smaller avatars on mobile
    img, .default-icon {
        width: 28px;
        height: 28px;
    }
}

If these rules are being overridden elsewhere, consider refactoring the CSS architecture rather than using !important.

src/blocks/Contributors/index.js (1)

19-41: Consider extracting icon styles to constants.

The inline styles for the PRO badge could be extracted to named constants for better maintainability and reusability if this pattern is used across multiple blocks.

const PRO_BADGE_STYLES = {
    badge: {
        position: 'absolute',
        top: '22px',
        right: '-2px',
        background: '#4f47e6',
        color: 'white',
        fontSize: '9px',
        padding: '2px 3px',
        borderRadius: '3px',
        fontWeight: 'bold',
        lineHeight: 1
    },
    wrapper: {
        position: 'relative',
        display: 'inline-block'
    }
};

icon: {
    src: () => (
        <span style={PRO_BADGE_STYLES.wrapper}>
            <Icon icon={starFilled} />
            <span style={PRO_BADGE_STYLES.badge}>PRO</span>
        </span>
    ),
}

wedocs.php (1)

185-185: Remove or uncomment the AdvanceContributors block.

Line 185 has the AdvanceContributors block commented out. Either enable it or remove the comment to keep the codebase clean.

assets/build/blocks/DocsGrid/render.php (3)

10-37: Prefix or scope helper function to avoid global collisions.

get_pagination_style_tag() is unprefixed and global. Prefer wedocs_get_pagination_style_tag(), or make it a private helper inside render_wedocs_docs_grid(). The new function_exists guard helps but namespacing is safer.

---

183-183: Remove unused variables or implement their usage.

$total_pages and $total_articles are declared but never used. Either remove them or render pagination/article counts. This also silences PHPMD warnings.

Also applies to: 228-228

---

184-206: Inline <script>: consider enqueueing and optional chaining support.

Move the toggle JS to an enqueued script or wp_add_inline_script attached to the block handle to play well with CSP and caching. Also verify that optional chaining (?.) meets your supported browsers for front-end visitors.

Would you confirm your browser support baseline and whether CSP is enforced on typical installs?

src/blocks/TableOfContents/ColorsControls.js (1)

21-28: Prefer stable APIs to fetch theme palettes.

Consider using useSetting for palettes/gradients to avoid unsafe WP APIs and the eslint disable.

Example:

import { useSetting } from '@wordpress/block-editor';
const themeColors = useSetting( 'color.palette' ) || [];
const themeGradients = useSetting( 'color.gradients' ) || [];

If other controls already use useSetting (e.g., BorderAndShadowControls.js), align for consistency.

assets/build/blocks/Contributors/style-index-rtl.css (1)

1-1: Scope note: avoid cross-component bleed.

This stylesheet also targets .contributors-tab-system .components-button-group. Ensure this file is only enqueued where needed, or move editor-only styles to the editor stylesheet to avoid front-end collisions.

src/blocks/components/ShadowControl.js (3)

5-7: Avoid confusion with local UnitControl by renaming the WP import.

You already have a custom UnitControl in the codebase. Rename the WP import to clarify intent.

- __experimentalUnitControl as UnitControl,
+ __experimentalUnitControl as WPUnitControl,

And update usages:

- <UnitControl ...
+ <WPUnitControl ...

Confirm no other imports in this file shadow the same name.

Also applies to: 41-51, 55-64, 69-78, 83-92

---

16-21: Defensive: guard onShadowChange.

If onShadowChange is omitted, updateShadow will throw. Either require it or no-op guard:

- const updateShadow = (key, newValue) => {
-   onShadowChange({
+ const updateShadow = (key, newValue) => {
+   (onShadowChange || (() => {}))({
      ...shadowValue,
      [key]: newValue
    });
  };

---

96-106: API check: PanelColorSettings deprecation.

PanelColorSettings has been phased out in favor of ToolsPanel/ColorGradientControl in newer WP. If you target recent core, plan a follow-up to migrate.

assets/build/blocks/AdvanceContributors/block.json (1)

1-16: Missing textdomain in block.json

Consider adding "textdomain": "wedocs" to enable proper i18n tooling for strings in metadata.

src/blocks/components/BorderControl.js (2)

26-41: Reset width/color when switching to “None”

If users set width/color then choose “None”, stale styles may persist downstream.

Apply:

-            onChange={onBorderStyleChange}
+            onChange={(newStyle) => {
+                onBorderStyleChange(newStyle);
+                if (newStyle === 'none') {
+                    onBorderWidthChange({});
+                    onBorderColorChange(undefined);
+                }
+            }}

---

87-96: PanelColorSettings is deprecated in newer WP; consider ToolsPanel/ColorPalette

Future-proof by migrating to ColorSettings within ToolsPanel or use block-editor color support if applicable.

src/blocks/Contributors/render.php (1)

12-18: Unused parameters + missing $post guard

Silence analyzers and avoid fatals on non-singular contexts.

-    function render_wedocs_contributors_block($attributes, $content, $block) {
-        // Get the current post
-        $post = get_post();
+    function render_wedocs_contributors_block($attributes, $content, $block) {
+        // Silence unused params
+        unset($content, $block);
+        // Get the current post
+        $post = get_post();
+        if ( ! $post ) {
+            return '';
+        }

Also applies to: 19-39

assets/build/blocks/AdvanceContributors/style-index-rtl.css (1)

1-1: Contrast media query value and legacy prefix

• prefers-contrast: high is non-standard; use "more" for broader support.
• The -o-object-fit prefix is obsolete.

Apply:

-@media(prefers-contrast: high){
+@media(prefers-contrast: more){

And drop "-o-object-fit: cover".

src/blocks/AdvanceContributors/style.scss (3)

64-75: Add visible focus styles for keyboard users.

Anchors only style :hover. Include :focus-visible for parity and WCAG compliance.

 .contributor-name {
   transition: color 0.3s ease;
   text-decoration: none;
+  outline: none;
+  &:focus-visible {
+    outline: 2px solid currentColor;
+    outline-offset: 2px;
+    text-decoration: underline;
+  }
 }

---

49-61: Use CSS variables instead of hard-coded brand colors.

Replace fixed hex with theme variables to improve theming and dark-mode harmony.

- .default-icon {
-   background-color: #0073aa;
-   color: white;
+ .default-icon {
+   --wedocs-accent: var(--wp--preset--color--primary, #0073aa);
+   --wedocs-on-accent: var(--wp--preset--color--background, #fff);
+   background-color: var(--wedocs-accent);
+   color: var(--wedocs-on-accent);
 }
@@
-  .contributor-item {
-    .contributor-avatar .default-icon {
-      background-color: #4a90a4;
-    }
-  }
+  .contributor-item .contributor-avatar .default-icon {
+    background-color: color-mix(in oklab, var(--wedocs-accent) 70%, black);
+  }

Also applies to: 151-156

---

103-109: Avoid !important; raise specificity instead.

!important makes overrides harder. Prefer a more specific selector or block-scoped size token.

- img, .default-icon {
-   width: 28px !important;
-   height: 28px !important;
- }
+ img, .default-icon {
+   width: 28px;
+   height: 28px;
+ }

If collisions occur, scope via .wedocs-contributors .contributors-container .contributor-item .contributor-avatar img rather than using !important.

assets/build/blocks/TableOfContents/view.js (1)

1-1: Scope heading search to the nearest content container; reduce O(n²) and support H6.

• Limit to the block’s nearest article/content container to avoid cross-picking headings from the whole page.
• Replace Array.from(list).indexOf(node) with the loop index.
• Initialize counters up to H6.

- const c=document.querySelector(".entry-content, .post-content, main, .content")||document.body
+ const c = t.closest("article, .entry-content, .post-content, main, .content") || document.body;
@@
- const i={1:0,2:0,3:0,4:0,5:0};
+ const i={1:0,2:0,3:0,4:0,5:0,6:0};
@@
- t.forEach(function(e){
-   const l=parseInt(e.tagName.charAt(1))
+ t.forEach(function(e, idx){
+   const l = Math.min(6, parseInt(e.tagName.charAt(1), 10) || 2);
@@
-   const a = e.id || "toc-heading-"+Array.from(t).indexOf(e);
+   const a = e.id || "toc-heading-" + idx;

src/blocks/DocsGrid/render.php (4)

183-183: Remove or use $total_pages; currently unused.

Either render pagination or drop the variable. See next comment for adding pagination.

- $total_pages = $docs_query->max_num_pages;
+ $total_pages = $docs_query->max_num_pages; // Use below if pagination is enabled.

---

42-53: Wire up pagination rendering and style variables.

Attributes include pagination settings but output is missing; also get_pagination_style_tag() is never used.

@@
-        $show_view_details = $attributes['showViewDetails'] ?? true;
+        $show_view_details = $attributes['showViewDetails'] ?? true;
+        $enable_pagination = $attributes['enablePagination'] ?? false;
@@
-        // Query docs with pagination
+        // Query docs with pagination
         $docs_query = new WP_Query($args);
@@
-        echo $toggle_script;
-        // Output hover styles
-        echo $hover_styles;
+        // Pagination CSS variables
+        echo get_pagination_style_tag( $attributes );
+        echo $toggle_script;
+        echo $hover_styles;
@@
-            </div>
-        </div>
+            </div>
+        </div>
+        <?php if ( $enable_pagination && $docs_per_page !== 'all' && $total_pages > 1 ) : ?>
+            <nav class="wedocs-docs-grid__pagination" aria-label="<?php esc_attr_e('Docs navigation', 'wedocs'); ?>">
+                <?php
+                echo paginate_links( array(
+                    'total'   => $total_pages,
+                    'current' => max( 1, (int) $current_page ),
+                    'type'    => 'list',
+                    'prev_text' => __('Previous', 'wedocs'),
+                    'next_text' => __('Next', 'wedocs'),
+                ) );
+                ?>
+            </nav>
+        <?php endif; ?>
         <?php
         return ob_get_clean();

Also applies to: 158-171, 210-213, 319-323

---

256-257: Compose inline styles once and escape as a whole.

Avoid mixing escaped and raw CSS fragments inside the attribute.

- <h4 class="wedocs-docs-grid__section-title"
-     style="<?php echo esc_attr($title_style); ?> display: flex; justify-content: space-between; align-items: center;">
+ <?php $section_title_style = trim($title_style . ' display:flex; justify-content:space-between; align-items:center;'); ?>
+ <h4 class="wedocs-docs-grid__section-title" style="<?php echo esc_attr( $section_title_style ); ?>">

---

228-228: Remove $total_articles or implement usage.

Declared but never used.

- $total_articles = 0;
+ // $total_articles reserved for future use; remove if not needed.

src/blocks/commonControls/BorderAndShadowControls.js (3)

123-131: Avoid boolean className.

Passing false can stringify to "false". Use a conditional string.

- className={isOpen && 'is-open'}
+ className={isOpen ? 'is-open' : undefined}

---

215-237: Reset to undefined/null to fall back cleanly.

Setting empty objects keeps truthy values around. Prefer null/undefined to fully reset.

- border: {},
- borderRadius: null,
- boxShadow: {},
+ border: undefined,
+ borderRadius: undefined,
+ boxShadow: undefined,

---

35-46: Confirm boxShadow key naming consistency.

This control uses { x, y, blur, spread, color, inset }. Ensure all consumers/readers (renderers/styles) expect these keys (not horizontal/vertical). If not, map keys at the boundary.

src/blocks/Contributors/block.json (1)

27-30: Potential contrast issue for titleColor default.

Title defaults to #fff while backgroundColor defaults to #f9f9f9; visually OK, but if a theme sets a white background it may become invisible. Consider a darker default (e.g., #111).

src/blocks/TableOfContents/Inspector.js (1)

19-77: Unify textdomain with the block’s domain (“wedocs”).

Strings use 'dynamic-table-of-contents-block-wp' while block.json declares 'wedocs'. Aligning domains improves translation loading.

- __('TOC Title', 'dynamic-table-of-contents-block-wp')
+ __('TOC Title', 'wedocs')
# Apply to all __() calls in this file.

Also applies to: 94-223

assets/build/blocks/Contributors/render.php (2)

290-306: Small UX/accessibility hardening on avatar rendering.

• Add loading="lazy" and decoding="async" to .
• Mark the default icon container as aria-hidden.

-                    $output .= '<img src="' . esc_url($avatar_url) . '" alt="' . esc_attr($contributor->display_name) . '" style="' . wedocs_styles_to_css($avatar_styles) . '">';
+                    $output .= '<img src="' . esc_url($avatar_url) . '" alt="' . esc_attr($contributor->display_name) . '" loading="lazy" decoding="async" style="' . wedocs_styles_to_css($avatar_styles) . '">';
...
-                    $output .= '<div class="default-icon" style="' . wedocs_styles_to_css($icon_styles) . '">';
+                    $output .= '<div class="default-icon" aria-hidden="true" style="' . wedocs_styles_to_css($icon_styles) . '">';

---

12-12: Silence PHPMD UnusedFormalParameter for $content and $block.

WP render callbacks accept ($attributes, $content, $block) even if unused. Prefix unused params to signal intent.

-    function render_wedocs_contributors_block($attributes, $content, $block) {
+    function render_wedocs_contributors_block($attributes, $_content = null, $_block = null) {

Alternatively, add a PHPMD ignore for these params.

src/blocks/TableOfContents/edit.js (1)

154-163: Typo in CSS custom property name.

"--list-item-sytle" → "--list-item-style" (or remove if unused). Typo prevents styles from applying.

-            "--list-item-sytle": containerBackgroundColor,
+            "--list-item-style": containerBackgroundColor,

src/blocks/TableOfContents/view.js (3)

57-61: Avoid assembling HTML with strings; build DOM nodes to reduce XSS/escaping risk.

Even with textContent, innerHTML concatenation is fragile. Prefer createElement/append with textContent.

Example replacement for this block:

-        const tocHTML = generateTOCHTML(headings, supportedHeadings, showHierarchy, showNumbering);
-        const tocContent = tocBlock.querySelector('.toc-content');
-        tocContent.innerHTML = tocHTML;
+        const tocContent = tocBlock.querySelector('.toc-content');
+        tocContent.innerHTML = '';
+        tocContent.appendChild(
+          generateTOCListElement(headings, supportedHeadings, showHierarchy, showNumbering)
+        );

…with a new generateTOCListElement that returns a UL element constructed via createElement.

---

150-160: Add a11y state to collapsible behavior.

Toggle aria-expanded on the title and aria-hidden on the content; announce via role="button".

-        if (title && content) {
-            title.addEventListener('click', function() {
-                title.classList.toggle('collapsed');
-                content.classList.toggle('collapsed');
-            });
-        }
+        if (title && content) {
+            title.setAttribute('role', 'button');
+            title.setAttribute('aria-controls', 'toc-content');
+            title.setAttribute('aria-expanded', 'true');
+            content.id = 'toc-content';
+            title.addEventListener('click', function() {
+                const expanded = title.getAttribute('aria-expanded') === 'true';
+                title.setAttribute('aria-expanded', String(!expanded));
+                title.classList.toggle('collapsed');
+                content.classList.toggle('collapsed');
+                content.setAttribute('aria-hidden', String(expanded));
+            });
+        }

---

217-236: Preserve URL hash on smooth scroll.

Currently prevents default without updating history, so deep links don’t work. Push the hash after scrolling.

                 if (targetElement) {
                     const offsetTop = targetElement.offsetTop - 80; // Account for sticky headers
@@
                     } else {
                         // Fallback smooth scroll
                         animateScrollTo(offsetTop, 600);
                     }
+                    // Update hash without jump
+                    history.replaceState(null, '', '#' + targetId);
                 }

src/blocks/AdvanceContributors/edit.js (2)

164-179: Parallelize manual user fetch to reduce editor latency.

Serial await in a loop is slow with many users. Use Promise.all and filter nulls.

-                        if (attributes.selectedContributors.length > 0) {
-                            for (const userId of attributes.selectedContributors) {
-                                try {
-                                    const user = await wp.apiFetch({
-                                        path: `/wp/v2/users/${userId}?context=edit`
-                                    });
-                                    if (user) {
-                                        contributors.push(user);
-                                    }
-                                } catch (error) {
-                                    console.warn(`Could not fetch user ${userId}:`, error);
-                                }
-                            }
-                        }
+                        if (attributes.selectedContributors.length > 0) {
+                            const fetched = await Promise.all(
+                                attributes.selectedContributors.map((userId) =>
+                                    wp.apiFetch({ path: `/wp/v2/users/${userId}?context=edit` }).catch((e) => {
+                                        console.warn(`Could not fetch user ${userId}:`, e);
+                                        return null;
+                                    })
+                                )
+                            );
+                            contributors.push(...fetched.filter(Boolean));
+                        }

---

193-221: Minor: also dedupe against the main author when merging revisions.

You already track contributorIds; ensure main author is included initially to avoid duplicates.

-                                const contributorIds = [currentPost.author];
+                                const contributorIds = [currentPost.author];

This is correct as written. Please verify that get users for both main author and revisions do not produce duplicates in displayContributors. If duplicates appear, add a final Map by id when setting state:

-                setActualContributors(contributors);
+                const uniq = Array.from(new Map(contributors.map(u => [u.id || u.ID, u])).values());
+                setActualContributors(uniq);

src/blocks/TableOfContents/render.php (1)

14-44: Emit styles via wp_add_inline_style and traverse nested blocks.

• Printing a raw <style> in wp_head is brittle. Prefer wp_add_inline_style against an enqueued handle.
• parse_blocks() only inspects top-level blocks; recurse innerBlocks to style nested TOCs.

- add_action( 'wp_head', 'wedocs_dynamic_table_of_contents_inline_styles' );
+ add_action( 'wp_enqueue_scripts', 'wedocs_dynamic_table_of_contents_inline_styles', 20 );
@@
-        $blocks = parse_blocks( $post->post_content );
-        $styles = '';
-        foreach ( $blocks as $block ) {
+        $blocks  = parse_blocks( $post->post_content );
+        $styles  = '';
+        $walker  = function( $blocks ) use ( &$styles ) {
+            foreach ( $blocks as $block ) {
+                if ( 'wedocs/table-of-contents' === ( $block['blockName'] ?? '' ) ) {
+                    $attributes = $block['attrs'] ?? array();
+                    $block_id   = $attributes['blockId'] ?? '';
+                    if ( $block_id ) {
+                        $styles .= wedocs_generate_toc_styles( $attributes, $block_id );
+                    }
+                }
+                if ( ! empty( $block['innerBlocks'] ) ) {
+                    $walker( $block['innerBlocks'] );
+                }
+            }
+        };
+        $walker( $blocks );
@@
-        if ( ! empty( $styles ) ) {
-            echo '<style id="dynamic-toc-styles">' . $styles . '</style>';
-        }
+        if ( ! empty( $styles ) ) {
+            // Ensure 'wedocs-toc' (or actual handle) is registered/enqueued beforehand.
+            wp_add_inline_style( 'wedocs-toc', $styles );
+        }

Also applies to: 25-37, 39-44

src/blocks/helpers/block-helpers.js (4)

23-31: Gradient overwritten by image; honor backgroundType.

When backgroundType is 'gradient', subsequent backgroundImage url() assignment overrides it. Gate the image path by type.

- if (attributes.backgroundImage?.url) {
+ if (attributes.backgroundType !== 'gradient' && attributes.backgroundImage?.url) {
     styles.backgroundImage = `url(${attributes.backgroundImage.url})`;
     styles.backgroundSize = 'cover';
     styles.backgroundPosition = 'center';
 }

---

250-267: Allow common CSS functions (calc, var, clamp).

Current validator rejects calc()/var()/clamp(). Broaden acceptance to typical safe patterns.

- const regex = /^(-?\d*\.?\d+)([a-z%]+)?$/i;
+ const functionOk = /^(calc|var|clamp)\(/i.test(value.trim());
+ if (functionOk) return true;
+ const regex = /^(-?\d*\.?\d+)([a-z%]+)?$/i;

---

374-390: Guard for SSR/Node usage.

Accessing window breaks SSR/tests. Add typeof window check and default false.

-export const isBreakpoint = (breakpoint) => {
-  const breakpoints = getBreakpoints();
-  const width = window.innerWidth;
+export const isBreakpoint = (breakpoint) => {
+  if (typeof window === 'undefined') return false;
+  const breakpoints = getBreakpoints();
+  const width = window.innerWidth;

---

231-241: Expose cancel() on debounce for cleanup in effects.

Helps avoid stray timers.

 export const debounce = (func, wait) => {
   let timeout;
-  return function executedFunction(...args) {
+  const debounced = function executedFunction(...args) {
     const later = () => {
       clearTimeout(timeout);
       func(...args);
     };
     clearTimeout(timeout);
     timeout = setTimeout(later, wait);
   };
+  debounced.cancel = () => clearTimeout(timeout);
+  return debounced;
 };

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

TOC link color custom property likely misbound.

The bundle sets {"--list-item-sytle": containerBackgroundColor}. That appears intended for listColor. Please adjust in the source (e.g., src/blocks/TableOfContents/edit.js) and fix the property name typo across CSS/JS.

---

I need to verify the source code to confirm the issue. Let me search for the TableOfContents block implementation.

[/run_scripts]

[/run_scripts]

[/run_scripts]

---

🏁 Script executed:

#!/bin/bash
# Find TableOfContents block source files
fd -type f -name "*.js" -path "*TableOfContents*" | head -20
fd -type f -name "*.jsx" -path "*table-of-contents*" -o -path "*toc*" | grep -v node_modules | head -20

Length of output: 341

---

🏁 Script executed:

#!/bin/bash
# Search for the specific CSS custom property in source files
rg -n "list-item" --type=js --type=jsx -B2 -A2 | head -50
rg -n "containerBackgroundColor" --type=js --type=jsx -B3 -A3 | grep -i "style\|toc\|list" | head -50

Length of output: 55

---

🏁 Script executed:

#!/bin/bash
# Look for TOC block edit file and check the style object
find . -type f \( -name "*edit.js" -o -name "*edit.jsx" \) | xargs grep -l "toc\|table-of-contents" -i 2>/dev/null

Length of output: 36

---

Now let me examine the source file to verify the CSS custom property binding:

[/run_scripts]

[/run_scripts]

---

🏁 Script executed:

#!/bin/bash
# View the TableOfContents edit.js file
cat ./src/blocks/TableOfContents/edit.js

Length of output: 6113

---

🏁 Script executed:

#!/bin/bash
# Search for the style object and CSS custom properties in edit.js
grep -n "\-\-list\|containerBackgroundColor\|listColor" ./src/blocks/TableOfContents/edit.js -A2 -B2

Length of output: 695

---

Fix CSS custom property binding and typo in TableOfContents block.

Line 154 in src/blocks/TableOfContents/edit.js contains two errors:

• Property name typo: --list-item-sytle should be --list-item-style
• Wrong variable: should bind listColor (used for list text, line 184) instead of containerBackgroundColor (container background)

Change:

"--list-item-sytle": containerBackgroundColor,

to:

"--list-item-style": listColor,

🧰 Tools

🪛 Biome (2.1.2)

[error] 1-1: This variable is used before its declaration.

The variable is declared here:

(lint/correctness/noInvalidUseBeforeDeclaration)

---

[error] 1-1: This variable is used before its declaration.

The variable is declared here:

(lint/correctness/noInvalidUseBeforeDeclaration)

---

[error] 1-1: This variable is used before its declaration.

The variable is declared here:

(lint/correctness/noInvalidUseBeforeDeclaration)

---

[error] 1-1: This variable is used before its declaration.

The variable is declared here:

(lint/correctness/noInvalidUseBeforeDeclaration)

---

[error] 1-1: Shouldn't redeclare 'a'. Consider to delete it or rename it.

'a' is defined here:

(lint/suspicious/noRedeclare)

---

[error] 1-1: Shouldn't redeclare 'l'. Consider to delete it or rename it.

'l' is defined here:

(lint/suspicious/noRedeclare)

---

[error] 1-1: Shouldn't redeclare 'n'. Consider to delete it or rename it.

'n' is defined here:

(lint/suspicious/noRedeclare)

---

[error] 1-1: This variable is used before its declaration.

The variable is declared here:

(lint/correctness/noInvalidUseBeforeDeclaration)

---

[error] 1-1: This variable is used before its declaration.

The variable is declared here:

(lint/correctness/noInvalidUseBeforeDeclaration)

🤖 Prompt for AI Agents

In assets/build/block.js around lines 1 to 1, the inline style object for the
TableOfContents block uses a misspelled CSS custom property and binds the wrong
variable; change the entry that currently sets "--list-item-sytle" to instead
set "--list-item-style" and bind it to the list color variable used elsewhere
(replace the container background variable with the listColor variable).

[coderabbitai]

⚠️ Potential issue | 🟠 Major

Box shadow schema doesn’t match renderer expectations

Defaults use "horizontal"/"vertical", but the renderer in AdvanceContributors expects "x"/"y", so shadows will never render.

Either:

• Change defaults to x/y, or
• Update the renderer to read "horizontal"/"vertical".
  If you keep schema as-is, align the PHP at Box Shadow handling. See related comment in render.php.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

$post may be null; unsafe property access

Accessing $post->ID without verifying $post will fatal on non-singular contexts or previews.

Guard before use:

-        case 'main_author':
-            $author_id = get_post_field('post_author', $post->ID);
+        case 'main_author':
+            if ( ! $post ) { break; }
+            $author_id = get_post_field('post_author', $post->ID);

Repeat this pattern wherever $post->ID is used.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	case 'main_author':
	$author_id = get_post_field('post_author', $post->ID);
	if ($author_id) {
	$author_user = get_userdata($author_id);
	if ($author_user) {
	$contributors[] = $author_user;
	}
	}
	break;
	case 'main_author':
	if ( ! $post ) { break; }
	$author_id = get_post_field('post_author', $post->ID);
	if ($author_id) {
	$author_user = get_userdata($author_id);
	if ($author_user) {
	$contributors[] = $author_user;
	}
	}
	break;

🤖 Prompt for AI Agents

In assets/build/blocks/AdvanceContributors/render.php around lines 49 to 57, the
code accesses $post->ID without ensuring $post is non-null which will fatal in
non-singular contexts; update the case 'main_author' to first check that $post
is an object (e.g. if (!$post || !isset($post->ID)) return/continue or wrap the
block in if ($post && isset($post->ID)) { ... }), then retrieve post_author and
proceed as before; apply the same null-guard pattern to every other location in
this file that accesses $post->ID.

[coderabbitai]

⚠️ Potential issue | 🟠 Major

Box shadow keys mismatch (“x/y” vs “horizontal/vertical”)

This check requires ['x'] but block attributes provide ['horizontal'] and ['vertical']; shadow never applies.

Update to:

-        if (isset($controls['boxShadow']) && is_array($controls['boxShadow']) && isset($controls['boxShadow']['x'])) {
+        if (isset($controls['boxShadow']) && is_array($controls['boxShadow']) && isset($controls['boxShadow']['horizontal'])) {
             $shadow = $controls['boxShadow'];
             $shadow_value = '';
             if (isset($shadow['inset']) && $shadow['inset']) {
                 $shadow_value .= 'inset ';
             }
-            $shadow_value .= esc_attr($shadow['x']) . ' ';
-            $shadow_value .= esc_attr($shadow['y']) . ' ';
+            $shadow_value .= esc_attr($shadow['horizontal']) . ' ';
+            $shadow_value .= esc_attr($shadow['vertical']) . ' ';

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	// Box Shadow
	if (isset($controls['boxShadow']) && is_array($controls['boxShadow']) && isset($controls['boxShadow']['x'])) {
	$shadow = $controls['boxShadow'];
	$shadow_value = '';
	if (isset($shadow['inset']) && $shadow['inset']) {
	$shadow_value .= 'inset ';
	}
	$shadow_value .= esc_attr($shadow['x']) . ' ';
	$shadow_value .= esc_attr($shadow['y']) . ' ';
	$shadow_value .= esc_attr($shadow['blur']) . ' ';
	$shadow_value .= esc_attr($shadow['spread']) . ' ';
	$shadow_value .= esc_attr($shadow['color']);
	$rules[] = 'box-shadow: ' . $shadow_value;
	}
	// Box Shadow
	if (isset($controls['boxShadow']) && is_array($controls['boxShadow']) && isset($controls['boxShadow']['horizontal'])) {
	$shadow = $controls['boxShadow'];
	$shadow_value = '';
	if (isset($shadow['inset']) && $shadow['inset']) {
	$shadow_value .= 'inset ';
	}
	$shadow_value .= esc_attr($shadow['horizontal']) . ' ';
	$shadow_value .= esc_attr($shadow['vertical']) . ' ';
	$shadow_value .= esc_attr($shadow['blur']) . ' ';
	$shadow_value .= esc_attr($shadow['spread']) . ' ';
	$shadow_value .= esc_attr($shadow['color']);
	$rules[] = 'box-shadow: ' . $shadow_value;
	}

🤖 Prompt for AI Agents

In assets/build/blocks/AdvanceContributors/render.php around lines 229 to 242,
the box-shadow branch checks for shadow['x'] and shadow['y'] but the block
attributes provide horizontal/vertical keys, so the shadow never applies; update
the guard to check for horizontal/vertical (with fallbacks to x/y for backward
compatibility), read horizontal and vertical into local variables, then build
the shadow string using those values (preserving inset, blur, spread, color and
esc_attr usage) and only add the rule if horizontal/vertical (or their
fallbacks) are present.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

Hide-class logic inverted; always hides on all devices

You append wedocs-hide-{device} when the device key exists (it always does), so the block is hidden across breakpoints.

Only add hide-class when display is explicitly 'none':

-    if (isset($display_controls['desktop']) && $display_controls['desktop']) {
+    if (isset($display_controls['desktop']['display']) && $display_controls['desktop']['display'] === 'none') {
         $display_classes[] = 'wedocs-hide-desktop';
     }
-    if (isset($display_controls['tablet']) && $display_controls['tablet']) {
+    if (isset($display_controls['tablet']['display']) && $display_controls['tablet']['display'] === 'none') {
         $display_classes[] = 'wedocs-hide-tablet';
     }
-    if (isset($display_controls['mobile']) && $display_controls['mobile']) {
+    if (isset($display_controls['mobile']['display']) && $display_controls['mobile']['display'] === 'none') {
         $display_classes[] = 'wedocs-hide-mobile';
     }

🤖 Prompt for AI Agents

In assets/build/blocks/AdvanceContributors/render.php around lines 333 to 345,
the current logic adds wedocs-hide-{device} whenever the device key exists
(which is always true), causing the block to be hidden on all devices; change
the checks so you only append the hide class when the display control for that
device is explicitly 'none' (e.g. isset($display_controls['desktop']) &&
$display_controls['desktop'] === 'none'), repeat for tablet and mobile, then
merge those classes into $css_classes as before.

[coderabbitai]

⚠️ Potential issue | 🟠 Major

Fix text domain: use 'wedocs' instead of 'block-responsive'.

Several strings use 'block-responsive', which will break translations in this plugin. Replace with 'wedocs' throughout this component.

Also applies to: 108-110, 122-139, 157-161, 168-177, 229-230, 242-245, 257-260, 279-281, 322-327

[coderabbitai]

⚠️ Potential issue | 🟡 Minor

Use children for Button label (avoid Button.text for compatibility).

Some versions of @wordpress/components don’t support the “text” prop on Button. Safer to pass children.

- <Button
+ <Button
     __next40pxDefaultSize
     variant="secondary"
     isDestructive
-    text={__('Reset All', 'block-responsive')}
     style={{
       width: '100%',
       justifyContent: 'center',
       marginTop: '16px',
     }}
     onClick={() => {
       setAttributes({
         colorsControls: {
           ...colorsControls,
           [device]: {
             ...currentColors,
             textColor: undefined,
             backgroundColor: undefined,
             linkColor: undefined,
             linkHoverColor: undefined,
           },
         },
       });
     }}
   />
+ >
+   { __('Reset All', 'wedocs') }
+ </Button>

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	<Button
	__next40pxDefaultSize
	variant="secondary"
	isDestructive
	text={__('Reset All', 'block-responsive')}
	style={{
	width: '100%',
	justifyContent: 'center',
	marginTop: '16px',
	}}
	onClick={() => {
	setAttributes({
	colorsControls: {
	...colorsControls,
	[device]: {
	...currentColors,
	textColor: undefined,
	backgroundColor: undefined,
	linkColor: undefined,
	linkHoverColor: undefined,
	},
	},
	});
	}}
	/>
	</>
	<Button
	__next40pxDefaultSize
	variant="secondary"
	isDestructive
	style={{
	width: '100%',
	justifyContent: 'center',
	marginTop: '16px',
	}}
	onClick={() => {
	setAttributes({
	colorsControls: {
	...colorsControls,
	[device]: {
	...currentColors,
	textColor: undefined,
	backgroundColor: undefined,
	linkColor: undefined,
	linkHoverColor: undefined,
	},
	},
	});
	}}
	>
	{__('Reset All', 'block-responsive')}
	</Button>

🤖 Prompt for AI Agents

In src/blocks/TableOfContents/ColorsControls.js around lines 322 to 347, the
Button currently uses the text prop which some @wordpress/components versions
don't support; replace the text prop with a child node: remove text={__('Reset
All', 'block-responsive')} and instead place the __('Reset All',
'block-responsive') string as the Button's child content (keeping all other
props and the onClick handler unchanged) so the label is passed via children for
maximum compatibility.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

Critical: Fix undefined variable reference.

The component references containerBackgroundColor on line 14 without defining it. This will cause a ReferenceError at runtime. The variable should be destructured from attributes or accessed via attributes.containerBackgroundColor.

Apply this diff to fix the issue:

 const ListItems = ({ attributes, setAttributes }) => {
+    const { containerBackgroundColor } = attributes;
+    
     return (
         <PanelBody title={__('List Items', 'dynamic-table-of-contents-block-wp')} initialOpen={false}>

Alternatively, access it directly:

             <div style={{ marginBottom: '20px' }}>
                 <label>{__('Background Color', 'dynamic-table-of-contents-block-wp')}</label>
                 <ColorPicker
-                    color={containerBackgroundColor}
+                    color={attributes.containerBackgroundColor}
                     onChange={(value) => setAttributes({ containerBackgroundColor: value })}
                 />

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	const ListItems = ({ attributes, setAttributes }) => {
	return (
	<PanelBody title={__('List Items', 'dynamic-table-of-contents-block-wp')} initialOpen={false}>
	<h4>{__('TOC Container', 'dynamic-table-of-contents-block-wp')}</h4>
	<div style={{ marginBottom: '20px' }}>
	<label>{__('Background Color', 'dynamic-table-of-contents-block-wp')}</label>
	<ColorPicker
	color={containerBackgroundColor}
	onChange={(value) => setAttributes({ containerBackgroundColor: value })}
	/>
	</div>
	{/* <ColorsControls
	attributes={attributes}
	setAttributes={setAttributes}
	device='desktop'
	/> */}
	</PanelBody>
	);
	};
	const ListItems = ({ attributes, setAttributes }) => {
	const { containerBackgroundColor } = attributes;
	return (
	<PanelBody title={__('List Items', 'dynamic-table-of-contents-block-wp')} initialOpen={false}>
	<h4>{__('TOC Container', 'dynamic-table-of-contents-block-wp')}</h4>
	<div style={{ marginBottom: '20px' }}>
	<label>{__('Background Color', 'dynamic-table-of-contents-block-wp')}</label>
	<ColorPicker
	color={containerBackgroundColor}
	onChange={(value) => setAttributes({ containerBackgroundColor: value })}
	/>
	</div>
	{/* <ColorsControls
	attributes={attributes}
	setAttributes={setAttributes}
	device='desktop'
	/> */}
	</PanelBody>
	);
	};

Suggested change

	const ListItems = ({ attributes, setAttributes }) => {
	return (
	<PanelBody title={__('List Items', 'dynamic-table-of-contents-block-wp')} initialOpen={false}>
	<h4>{__('TOC Container', 'dynamic-table-of-contents-block-wp')}</h4>
	<div style={{ marginBottom: '20px' }}>
	<label>{__('Background Color', 'dynamic-table-of-contents-block-wp')}</label>
	<ColorPicker
	color={containerBackgroundColor}
	onChange={(value) => setAttributes({ containerBackgroundColor: value })}
	/>
	</div>
	{/* <ColorsControls
	attributes={attributes}
	setAttributes={setAttributes}
	device='desktop'
	/> */}
	</PanelBody>
	);
	};
	const ListItems = ({ attributes, setAttributes }) => {
	return (
	<PanelBody title={__('List Items', 'dynamic-table-of-contents-block-wp')} initialOpen={false}>
	<h4>{__('TOC Container', 'dynamic-table-of-contents-block-wp')}</h4>
	<div style={{ marginBottom: '20px' }}>
	<label>{__('Background Color', 'dynamic-table-of-contents-block-wp')}</label>
	<ColorPicker
	color={attributes.containerBackgroundColor}
	onChange={(value) => setAttributes({ containerBackgroundColor: value })}
	/>
	</div>
	{/* <ColorsControls
	attributes={attributes}
	setAttributes={setAttributes}
	device='desktop'
	/> */}
	</PanelBody>
	);
	};

🤖 Prompt for AI Agents

In src/blocks/TableOfContents/controls/ListItems.js around lines 7 to 25, the
component uses containerBackgroundColor on line 14 but never defines or
destructures it, causing a ReferenceError; fix by extracting
containerBackgroundColor from props (e.g., const { containerBackgroundColor } =
attributes) at the top of the component or replace the reference with
attributes.containerBackgroundColor, and ensure the ColorPicker onChange
continues to call setAttributes({ containerBackgroundColor: value }) so the
attribute is updated correctly.

[coderabbitai]

⚠️ Potential issue | 🟡 Minor

Empty file with meaningless whitespace; implement like AdvanceContributors or remove entirely.

This file contains only whitespace but no actual code. For server-rendered blocks, you should either:

1. Implement it like src/blocks/AdvanceContributors/save.js (returning null with proper imports)
2. Remove the file entirely if not needed

The current whitespace-only content serves no purpose and creates inconsistency.

Apply this diff to implement the proper pattern:

-
-  
-	
+import { useBlockProps } from '@wordpress/block-editor';
+
+const Save = () => {
+	const blockProps = useBlockProps.save();
+
+	// Since this is a dynamic block that uses PHP rendering,
+	// we return null to let the server-side render function handle the output
+	return null;
+};
+
+export default Save;

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	import { useBlockProps } from '@wordpress/block-editor';
	const Save = () => {
	const blockProps = useBlockProps.save();
	// Since this is a dynamic block that uses PHP rendering,
	// we return null to let the server-side render function handle the output
	return null;
	};
	export default Save;

🤖 Prompt for AI Agents

In src/blocks/TableOfContents/save.js lines 1-3: the file currently contains
only whitespace; either remove the file or implement the server-rendered block
pattern used by src/blocks/AdvanceContributors/save.js — create a save.js that
imports React (if your linting requires it) and exports a default Save component
that returns null (i.e., server-rendered no-client-save), matching the project's
style and export conventions; ensure any required ESLint or module headers are
present.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

Fix CSS custom property typo

--list-item-sytle is misspelled; it prevents the custom color from working.

Apply:

- color: var(--list-item-sytle, inherit);
+ color: var(--list-item-style, inherit);

Run to find all occurrences and ensure consistency:

---

🏁 Script executed:

#!/bin/bash
rg -n --type=css --type=scss --type=js --type=php --no-ignore -S '\-\-list-item-sy?tle'

Length of output: 28

---

---

🏁 Script executed:

#!/bin/bash
# Search for the misspelled custom property across all file types
# Using rg without the problematic type specification
rg -n -S 'list-item-sy' --glob='*.scss' --glob='*.css' --glob='*.js' --glob='*.php'

Length of output: 82389

---

🏁 Script executed:

#!/bin/bash
# Also check the specific file mentioned in the review
cat src/blocks/TableOfContents/style.scss | grep -n 'list-item'

Length of output: 47

---

🏁 Script executed:

#!/bin/bash
# Search for both spellings to understand which is used
rg -n 'list-item-style' --glob='*.scss' --glob='*.css' --glob='*.js' --glob='*.php'

Length of output: 0

---

Fix CSS custom property typo in two locations

The custom property --list-item-sytle is misspelled (should be --list-item-style), preventing the custom color from being applied.

Apply the fix in:

1. src/blocks/TableOfContents/style.scss line 55:

- color: var(--list-item-sytle, inherit);
+ color: var(--list-item-style, inherit);

2. src/blocks/TableOfContents/edit.js line 154:

- "--list-item-sytle": containerBackgroundColor,
+ "--list-item-style": containerBackgroundColor,

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	a {
	text-decoration: none;
	color: var(--list-item-sytle, inherit);
	display: inline-block;
	a {
	text-decoration: none;
	color: var(--list-item-style, inherit);
	display: inline-block;

🤖 Prompt for AI Agents

In src/blocks/TableOfContents/style.scss around lines 53-56 and in
src/blocks/TableOfContents/edit.js at line 154, the CSS custom property name is
misspelled as --list-item-sytle; update both occurrences to --list-item-style so
the intended custom color is applied (search for the misspelled token and
replace it with the corrected property name in both files).

[coderabbitai]

Actionable comments posted: 20

Note

Due to the large number of review comments, Critical, Major severity comments were prioritized as inline comments.

♻️ Duplicate comments (43)

src/blocks/components/TabSystem.js (3)

3-3: Remove unused Spacer import.

The __experimentalSpacer as Spacer import is never used in this component.

🔎 Proposed fix

-import { Button, ButtonGroup, __experimentalSpacer as Spacer } from '@wordpress/components';
+import { Button, ButtonGroup } from '@wordpress/components';

---

21-38: Add accessibility attributes for tab navigation.

The tab navigation is missing essential ARIA attributes for screen reader support. The ButtonGroup should have role="tablist", and each Button should have role="tab", aria-selected, and aria-controls attributes.

🔎 Proposed fix

-				<ButtonGroup>
+				<ButtonGroup role="tablist" aria-label={__('Block Settings Tabs', 'wedocs')}>
 					{tabs.map(tab => (
 						<Button
 							key={tab.key}
 							variant={activeTab === tab.key ? 'primary' : 'secondary'}
 							onClick={() => setActiveTab(tab.key)}
+							role="tab"
+							id={`wedocs-tab-${tab.key}`}
+							aria-selected={activeTab === tab.key}
+							aria-controls={`wedocs-tabpanel-${tab.key}`}
 							style={{
 								marginRight: '4px',
 								display: 'flex',
 								alignItems: 'center',
 								gap: '4px'
 							}}
 						>

---

43-55: Fix children handling, duplicate keys, and add accessibility attributes.

Three critical issues:

1. Runtime error: children.map will break when a single child is passed (React children can be an object, not an array).
2. Duplicate keys: All children after the first get key="style", causing React reconciliation issues.
3. Missing accessibility: Tab panels need role="tabpanel", aria-labelledby, and corresponding id attributes.

🔎 Proposed fix

First, import Children from React:

-import { useState } from '@wordpress/element';
+import { useState, Children } from '@wordpress/element';

Then fix the content rendering:

 			{/* Tab Content */}
 			<div className="tab-content">
-				{children.map((child, index) => {
-					const tabKey = index === 0 ? 'setup' : 'style';
-					return (
-						<div
-							key={tabKey}
-							style={{
-								display: activeTab === tabKey ? 'block' : 'none'
-							}}
-						>
-							{child}
-						</div>
-					);
-				})}
+				{Children.toArray(children).map((child, index) => {
+					const tabKey = index === 0 ? 'setup' : 'style';
+					return (
+						<div
+							key={`${tabKey}-${index}`}
+							id={`wedocs-tabpanel-${tabKey}`}
+							role="tabpanel"
+							aria-labelledby={`wedocs-tab-${tabKey}`}
+							style={{
+								display: activeTab === tabKey ? 'block' : 'none'
+							}}
+						>
+							{child}
+						</div>
+					);
+				})}
 			</div>

src/blocks/TableOfContents/save.js (1)

1-3: The empty file issue from the previous review remains unresolved.

As noted in the previous review, this file contains only whitespace and serves no purpose. For server-rendered blocks, you should either implement it properly (returning null with proper imports like AdvanceContributors/save.js) or remove the file entirely.

assets/build/style-block-rtl.css (1)

1-1: Fix duplicate width property in source CSS.

A duplicate width property declaration exists in the selector .wedocs-search-input,.wedocs-editor-search-input. Since this is a build artifact, the issue should be resolved in the source CSS file before rebuilding.

🧰 Tools

🪛 Biome (2.1.2)

[error] 1-1: Duplicate properties can lead to unexpected behavior and may override previous declarations unintentionally.

Remove or rename the duplicate property to ensure consistent styling.

(lint/suspicious/noDuplicateProperties)

assets/build/block.js (1)

1-1: Address CSS custom property issue in TableOfContents source.

A previous review identified a typo and incorrect variable binding in the TableOfContents block source (src/blocks/TableOfContents/edit.js line 154). Since this is a build artifact, fix the source and rebuild.

src/blocks/Contributors/edit-old.js (1)

151-161: Preview ignores configured date format settings.

The date preview uses a hardcoded toLocaleDateString format and ignores the dateFormat and customDateFormat attributes that users can configure. This creates a mismatch between editor preview and frontend output.

Since PHP date format strings are specified in the help text, consider either:

1. Using @wordpress/date utilities with format conversion
2. Rendering a placeholder indicating the format will apply on frontend

src/blocks/AdvanceContributors/edit-old.js (2)

51-65: Replace wp.apiFetch with imported @wordpress/api-fetch.

This was flagged in a previous review. For bundled code, import apiFetch directly for better tree-shaking and explicit dependency management.

---

151-161: Date format preview ignores user settings.

This was flagged in a previous review. The preview hardcodes toLocaleDateString and ignores dateFormat/customDateFormat attributes.

assets/build/blocks/DocsGrid/index.asset.php (1)

1-1: Existing critical issue with react-jsx-runtime dependency already flagged.

The incompatibility between the react-jsx-runtime dependency (requires WP 6.6+) and the plugin's minimum WordPress requirement (5.6+) has already been identified in a previous review comment. Please address that issue before merging.

includes/Assets.php (1)

85-89: Critical: Style handle enqueued without registration (duplicate issue).

The wedocs-block-style registration remains commented out (lines 85-89), but the style is still enqueued at lines 129 and 155. This is the same critical issue flagged in the previous review and must be resolved.

Apply one of the fixes from the previous review:

Option 1: Uncomment and fix the registration:

🔎 Restore registration

-            // wp_register_style(
-            //     'wedocs-block-style',
-            //     $assets_url . '/build/style-block.css',
-            //     $block_dependencies['version']
-            // );
+            wp_register_style(
+                'wedocs-block-style',
+                $assets_url . '/build/style-block.css',
+                array(),
+                $block_dependencies['version']
+            );

Option 2: Remove all enqueue calls:

🔎 Remove enqueue calls

-        wp_enqueue_style( 'wedocs-block-style' );

And in admin_enqueue:

     public function admin_enqueue() {
-        wp_enqueue_style( 'wedocs-block-style' );
-
         // Enqueue admin script.

Also applies to: 129-129, 155-155

src/blocks/TableOfContents/controls/ListItems.js (1)

7-16: Critical: Undefined variable reference (duplicate issue).

The component uses containerBackgroundColor on line 14 without defining it. This is the same critical issue from the previous review and will cause a ReferenceError at runtime.

Apply one of the fixes from the previous review:

Option 1: Destructure from attributes:

🔎 Destructure the variable

 const ListItems = ({ attributes, setAttributes }) => {
+    const { containerBackgroundColor } = attributes;
+    
     return (
         <PanelBody title={__('List Items', 'dynamic-table-of-contents-block-wp')} initialOpen={false}>

Option 2: Access via attributes:

🔎 Use attributes.containerBackgroundColor

             <div style={{ marginBottom: '20px' }}>
                 <label>{__('Background Color', 'dynamic-table-of-contents-block-wp')}</label>
                 <ColorPicker
-                    color={containerBackgroundColor}
+                    color={attributes.containerBackgroundColor}
                     onChange={(value) => setAttributes({ containerBackgroundColor: value })}
                 />

assets/build/blocks/TableOfContents/style-index.css (1)

1-1: Accessibility issue: Loading message in CSS pseudo-element (previously flagged).

As noted in the previous review, the .toc-loading .toc-content:after rule renders "Loading headings..." via a CSS pseudo-element, which is not accessible to screen readers. This loading message should be moved to the DOM with role="status" or aria-live="polite" to ensure it's announced by assistive technologies.

assets/build/blocks/TableOfContents/style-index-rtl.css (1)

1-1: Accessibility issue: Loading message in CSS pseudo-element (previously flagged in RTL variant).

The same accessibility issue noted in the LTR version applies here: the loading message in .toc-loading .toc-content:after should be moved to the DOM with appropriate ARIA attributes for screen reader support.

assets/build/store.js (1)

1-1: Static analysis errors remain unaddressed.

The unsafe optional chaining and switch clause issues flagged by static analysis are still present in this build artifact. These were previously identified in the source files (src/data/docs/reducer.js around lines 84-85). The source must be fixed and the bundle rebuilt.

src/blocks/TableOfContents/ColorsControls.js (3)

17-20: Undefined colorsControls will crash the component.

The destructuring of colorsControls without a default value and immediate access to colorsControls[device] will throw a TypeError if attributes.colorsControls is undefined.

---

53-53: Incorrect text domain breaks translations.

The text domain 'block-responsive' should be 'wedocs' to match this plugin's translation infrastructure. This issue appears throughout the file at multiple locations.

Also applies to: 68-68, 108-108, 122-122, 135-135, 158-158, 174-174, 229-229, 243-243, 257-257, 280-280, 293-293, 326-326

---

322-347: Button.text prop may not be supported in all versions.

Using the text prop on Button can cause compatibility issues with some versions of @wordpress/components. The label should be passed as children instead.

src/blocks/commonControls/TypographyControls.js (1)

28-30: Undefined typographyControls will crash the component.

Destructuring without a default and accessing typographyControls[device] will throw if attributes.typographyControls is undefined.

src/blocks/commonControls/AlignmentControls.js (2)

26-28: Guard against undefined alignmentControls to avoid runtime errors

attributes.alignmentControls may be undefined; accessing alignmentControls[device] will throw. This was flagged in a previous review.

🔎 Proposed fix

 const AlignmentControls = ({ attributes, setAttributes, device }) => {
-	const { alignmentControls } = attributes;
-	const currentAlignment = alignmentControls[device] || {};
+	const { alignmentControls = {} } = attributes;
+	const currentAlignment = alignmentControls[device] || {};

---

161-165: Invalid CSS value for alignItems: "space-between" is not valid

align-items does not accept space-between; that's a justify-content value. This will produce invalid CSS. This was flagged in a previous review.

🔎 Proposed fix

 <ToggleGroupControlOptionIcon
-	value="space-between"
-	label={__('Space between', 'wedocs')}
+	value="stretch"
+	label={__('Stretch', 'wedocs')}
 	icon={justifyStretchVertical}
 />

assets/build/blocks/DocsGrid/render.php (1)

74-82: Guard against non-array padding/margin inputs

If $grid_padding is not an array, accessing ['top'] etc. will emit "Illegal string offset" notices. This was flagged in a previous review.

🔎 Proposed fix

-        if ($grid_padding) {
+        if ( is_array( $grid_padding ) ) {
             $padding_style = sprintf(
                 'padding: %s %s %s %s;',
                 esc_attr($grid_padding['top'] ?? '1.5rem'),

Apply the same pattern to $grid_margin, $button_padding, and $button_margin checks.

src/blocks/commonControls/DisplayControls.js (2)

50-57: Guard against undefined displayControls

If attributes.displayControls is undefined, line 53-54 and line 61 will throw runtime errors. This was flagged in a previous review.

🔎 Proposed fix

 const toggleDeviceVisibility = (deviceKey) => {
+	const current = attributes.displayControls || {};
 	setAttributes({
 		displayControls: {
-			...attributes.displayControls,
-			[deviceKey]: !attributes.displayControls[deviceKey],
+			...current,
+			[deviceKey]: !current[deviceKey],
 		},
 	});
 };

 // Render individual device control card
 const renderDeviceCard = ({ key, icon, label }) => {
-	const isHidden = attributes.displayControls[key];
+	const isHidden = attributes.displayControls?.[key];

Also applies to: 61-61

---

76-80: Add aria-label for accessibility

The toggle button displays only an icon, making it inaccessible to screen reader users. This was flagged in a previous review.

🔎 Proposed fix

 <Button
 	__next40pxDefaultSize
 	onClick={() => toggleDeviceVisibility(key)}
 	icon={isHidden ? unseen : seen}
+	aria-label={
+		isHidden
+			? __('Show on', 'wedocs') + ' ' + key
+			: __('Hide on', 'wedocs') + ' ' + key
+	}
 />

src/blocks/Contributors/render.php (5)

100-106: Wrong API for retrieving contributors - uses get_post_field instead of post meta

get_post_field('wedocs_contributors', ...) reads a posts table column, not post meta. For main_author case, this should use post_author field. This was flagged in a previous review.

🔎 Proposed fix

         case 'main_author':
-            $author_id = get_post_field('wedocs_contributors', $post->ID);
+            if ( ! $post ) { break; }
+            $author_id = get_post_field('post_author', $post->ID);
             if ($author_id) {
                 $contributors[] = get_userdata($author_id);
             }
             break;

---

120-131: Invalid contributor retrieval in 'all' case

get_post_field('wedocs_contributors', ...) returns a string column, not post meta. Calling array_values() on it produces an array of characters, causing incorrect behavior. This was flagged in a previous review.

🔎 Proposed fix

         case 'all':
         default:
             // Get all contributors who have edited the post
-            $author_id = get_post_field('wedocs_contributors', $post->ID);
-            $authors = array_values($author_id); // return auhtors id.
-            foreach($authors as $author){
-                $contributors[]= get_userdata($author);
-            }
-
-
-            if ($author_id && ($author_user = get_userdata($author_id))) {
-                $contributors[] = $author_user;
-            }
+            // Include post author first
+            $post_author_id = $post ? (int) get_post_field('post_author', $post->ID) : 0;
+            if ( $post_author_id && ($author_user = get_userdata($post_author_id)) ) {
+                $contributors[] = $author_user;
+            }
+
+            // Get contributors from post meta
+            $author_ids = (array) get_post_meta($post->ID, 'wedocs_contributors', true);
+            foreach ( $author_ids as $uid ) {
+                if ( $user = get_userdata( (int) $uid ) ) {
+                    $contributors[] = $user;
+                }
+            }

---

156-165: Demo fallback should not render in production

This creates a fake "Demo Author" user on production sites when no contributors are found. This was flagged in a previous review.

🔎 Proposed fix

-        if (empty($contributors)) {
-            // For demo purposes, add mock contributors if none found
-            $contributors = [
-                (object) [
-                    'ID' => 1,
-                    'display_name' => 'Demo Author',
-                    'user_email' => 'demo@example.com'
-                ]
-            ];
-        }
+        if (empty($contributors)) {
+            return '';
+        }

---

395-395: Return markup instead of echoing

Block render callbacks should return the output string, not echo it. Echoing can cause misplaced output. This was flagged in a previous review.

🔎 Proposed fix

-    echo render_wedocs_contributors_block($attributes, $content, $block);
+    return render_wedocs_contributors_block($attributes, $content, $block);
 }

Note: The echo should be moved outside the function_exists block and removed entirely since the function already returns the output.

---

153-154: De-duplicate contributors list

array_filter removes nulls but doesn't prevent duplicate users (e.g., if post author also appears in revisions). This was flagged in a previous review.

🔎 Proposed fix

         // Filter out invalid contributors
-        $contributors = array_filter($contributors);
+        $contributors = array_filter($contributors);
+        // De-duplicate by user ID
+        $contributors = array_values(array_reduce($contributors, function($acc, $u) {
+            if (is_object($u) && isset($u->ID)) {
+                $acc[$u->ID] = $u;
+            }
+            return $acc;
+        }, []));

assets/build/blocks/AdvanceContributors/render.php (4)

49-57: Critical: Unsafe $post property access without null check.

Lines 50 and 73 access $post->ID without verifying that $post is not null. This will cause a fatal error in non-singular contexts (archives, previews, etc.).

🔎 Required fix

 case 'main_author':
+	if (!$post) { break; }
 	$author_id = get_post_field('post_author', $post->ID);

Apply the same null guard at Line 73 and anywhere else $post->ID is accessed.

Based on past review comments.

---

229-242: Major: Box shadow key mismatch prevents shadows from rendering.

Line 230 checks for $shadow['x'] but the block attributes schema (block.json lines 284-290) provides 'horizontal' and 'vertical' keys. This mismatch means box shadows will never apply.

🔎 Required fix

-if (isset($controls['boxShadow']) && is_array($controls['boxShadow']) && isset($controls['boxShadow']['x'])) {
+if (isset($controls['boxShadow']) && is_array($controls['boxShadow']) && isset($controls['boxShadow']['horizontal'])) {
 	$shadow = $controls['boxShadow'];
 	$shadow_value = '';
 	if (isset($shadow['inset']) && $shadow['inset']) {
 		$shadow_value .= 'inset ';
 	}
-	$shadow_value .= esc_attr($shadow['x']) . ' ';
-	$shadow_value .= esc_attr($shadow['y']) . ' ';
+	$shadow_value .= esc_attr($shadow['horizontal']) . ' ';
+	$shadow_value .= esc_attr($shadow['vertical']) . ' ';

Based on past review comments.

---

333-345: Critical: Inverted hide-class logic hides block on all devices.

Lines 335-342 add wedocs-hide-{device} classes whenever the device key exists (which is always true per the schema defaults), causing the block to be hidden across all breakpoints.

🔎 Required fix

Only add hide classes when display is explicitly set to 'none':

-if (isset($display_controls['desktop']) && $display_controls['desktop']) {
+if (isset($display_controls['desktop']['display']) && $display_controls['desktop']['display'] === 'none') {
 	$display_classes[] = 'wedocs-hide-desktop';
 }
-if (isset($display_controls['tablet']) && $display_controls['tablet']) {
+if (isset($display_controls['tablet']['display']) && $display_controls['tablet']['display'] === 'none') {
 	$display_classes[] = 'wedocs-hide-tablet';
 }
-if (isset($display_controls['mobile']) && $display_controls['mobile']) {
+if (isset($display_controls['mobile']['display']) && $display_controls['mobile']['display'] === 'none') {
 	$display_classes[] = 'wedocs-hide-mobile';
 }

Based on past review comments.

---

497-499: Critical: Render file must return the generated HTML.

Line 499 calls the render function but doesn't return its output to WordPress, resulting in empty block output on the frontend.

🔎 Required fix

 	return $output;
 }
-render_wedocs_advance_contributors_block( $attributes, $content, $block );
+return render_wedocs_advance_contributors_block( $attributes, $content, $block );

Based on past review comments.

assets/build/blocks/AdvanceContributors/block.json (1)

284-291: Schema mismatch with render.php for box shadow.

The block.json schema correctly defines box shadow with "horizontal" and "vertical" keys, but the render.php file (Line 230) checks for "x" and "y", causing shadows to never render.

The fix should be applied in render.php to match this schema. See the review comment on render.php lines 229-242.

Based on past review comments.

assets/build/blocks/TableOfContents/index.js (1)

1-1: Reconsider committing minified build artifacts to the repository.

This is generated build output that should not be committed to version control. See the previous comment on assets/build/blocks/AdvanceContributors/index.js for the same rationale.

src/blocks/commonControls/DimensionsControls.js (3)

11-14: Guard against undefined dimensionsControls to prevent runtime errors.

dimensionsControls may be undefined, causing dimensionsControls[device] to throw a runtime error.

🔎 Proposed fix

-const DimensionsControls = ({ attributes, setAttributes, device }) => {
-	const { dimensionsControls } = attributes;
-	const currentDimensions = dimensionsControls[device] || {};
+const DimensionsControls = ({ attributes, setAttributes, device }) => {
+	const { dimensionsControls = {} } = attributes;
+	const currentDimensions = dimensionsControls[device] || {};

Based on past review comments.

---

15-28: Guard nested object spreads to prevent runtime errors.

Spreading currentDimensions.padding will throw if padding is undefined.

🔎 Proposed fix

 const handlePaddingChange = (value) => {
 	const newDimensionsControls = {
 		...dimensionsControls,
 		[device]: {
 			...currentDimensions,
 			padding: {
-				...currentDimensions.padding,
+				...(currentDimensions.padding ?? {}),
 				...value,
 			},
 		},
 	};
 
 	setAttributes({ dimensionsControls: newDimensionsControls });
 };

Apply the same pattern to handleMarginChange (lines 30-43) and handleBlockSpacingChange (lines 45-58).

Based on past review comments.

---

69-74: Replace -Infinity with a supported numeric value.

Gutenberg's SpacingSizesControl expects a finite number for minimumCustomValue. Using -Infinity is not supported and may break UI validation.

🔎 Proposed fix

 <SpacingSizesControl
 	values={currentDimensions.margin || {}}
 	onChange={handleMarginChange}
 	label={__('Margin', 'wedocs')}
-	minimumCustomValue={-Infinity}
+	minimumCustomValue={-1000}
 />

Alternatively, omit the prop to use the component's default minimum value.

Based on past review comments.

src/blocks/TableOfContents/style.scss (1)

53-56: Fix CSS custom property typo.

The custom property name is misspelled as --list-item-sytle (should be --list-item-style), which prevents the custom color from being applied.

🔎 Proposed fix

 a {
 	text-decoration: none;
-	color: var(--list-item-sytle, inherit);
+	color: var(--list-item-style, inherit);
 	display: inline-block;
 	transition: color 0.2s ease;

Note: According to past review comments, this typo also appears in the corresponding edit.js file where the CSS variable is set. Ensure both locations are fixed for consistency.

Based on past review comments.

src/blocks/commonControls/ColorsControls.js (1)

17-19: Add missing device prop to function signature.

The component references device on line 19 but doesn't receive it as a prop, causing colorsControls[device] to be undefined.

🔎 Proposed fix

-const ColorsControls = ({ attributes, setAttributes, isTextColor = false, isBackgroundColor = false, isLinkColor = false }) => {
-	const { colorsControls } = attributes;
+const ColorsControls = ({ attributes, setAttributes, device, isTextColor = false, isBackgroundColor = false, isLinkColor = false }) => {
+	const { colorsControls = {} } = attributes;
 	const currentColors = colorsControls[device] || {};

Additionally, consider providing a default value for device (e.g., device = 'desktop') if it's optional.

Based on past review comments.

src/blocks/commonControls/BackgroundImageControls.js (1)

164-182: UnitControl: "auto" is invalid for __experimentalUnitControl.

__experimentalUnitControl expects a numeric value with unit. Passing "auto" will cause validation issues. Use empty string and add explicit units.

This was flagged in a previous review. The fix should use an empty string as the default and define allowed units:

 <UnitControl
     __next40pxDefaultSize
-    value={currentBackgroundImage.bgWidth || 'auto'}
+    value={currentBackgroundImage.bgWidth ?? ''}
+    units={[
+        { value: 'px', label: 'px' },
+        { value: '%', label: '%' },
+    ]}
     disabled={currentBackgroundImage.bgSize !== 'tile'}
     onChange={(value) => { ... }}
     placeholder={__('Auto', 'wedocs')}
 />

src/blocks/helpers/block-styles.php (2)

58-70: CSS value sanitization function exists but is not used.

The wedocs_sanitize_css_value() function (lines 290-312) provides proper CSS value sanitization, but wedocs_build_spacing_styles() uses only esc_attr() which doesn't validate CSS units. This was previously flagged and the sanitization function was added, but integration is incomplete.

The fix from the past review should be applied here to use wedocs_sanitize_css_value() for padding/margin values.

---

81-101: Border style and radius values lack proper sanitization.

This segment uses esc_attr() for CSS values but doesn't validate against allowed units. The wedocs_sanitize_css_value() function exists but isn't used here.

🟡 Minor comments (21)

readme.md-23-39 (1)

23-39: Clarify the purpose and placement of the Mozart configuration block.

This commented-out configuration block appears to be for the Mozart dependency system, but it's unclear why this needs to be in a README file. Additionally, the namespace (WPMUDEV_PluginTest) and classmap prefix suggest this may be example or copied configuration, not specific to weDocs.

Consider:

• Moving actual configuration to proper config files (e.g., composer.json or a dedicated Mozart config file)
• If this is documentation, provide context explaining what Mozart is and why weDocs uses it
• Removing the commented block if it's example code that's not relevant to this project

src/blocks/components/SpacingControl.js-73-85 (1)

73-85: Fallback logic may override intentional '0px' gap values.

The expression gapValue || '10px' on Line 77 will default to '10px' for any falsy value, including '0px', 0, or ''. If a developer explicitly wants to set the gap to zero, this fallback will prevent it.

🔎 Proposed fix using nullish coalescing

 			<UnitControl
 				label={__('Gap', 'wedocs')}
-				value={gapValue || '10px'}
+				value={gapValue ?? '10px'}
 				onChange={onGapChange}
 				units={[
 					{ value: 'px', label: 'px' },

This ensures only null or undefined trigger the default, allowing explicit '0px' or 0 values.

src/blocks/components/SpacingControl.js-1-7 (1)

1-7: Update imports to use stable BoxControl and UnitControl exports.

__experimentalBoxControl and __experimentalUnitControl were promoted to stable APIs (BoxControl and UnitControl) in WordPress 6.7/6.8. Update the imports to:

import { BoxControl, UnitControl } from '@wordpress/components';

The __experimentalSpacer import should remain as-is, as Spacer has not been stabilized yet.

src/blocks/commonControls/BorderAndShadowControls.js-215-237 (1)

215-237: Inconsistent reset values for different properties.

The reset operation uses different values for each property:

• border: {} (empty object)
• borderRadius: null (null)
• boxShadow: {} (empty object)

While this works due to the fallback logic on line 97, the inconsistency could confuse maintainers.

🔎 Suggested fix for consistency

 				onClick={() => {
 					setAttributes({
 						borderAndShadowControls: {
 							...borderAndShadowControls,
 							[device]: {
 								...currentBorderAndShadow,
-								border: {},
-								borderRadius: null,
-								boxShadow: {},
+								border: undefined,
+								borderRadius: undefined,
+								boxShadow: undefined,
 							},
 						},
 					});

Or consistently use empty objects:

-								borderRadius: null,
+								borderRadius: {},

assets/build/print-rtl.css-141-144 (1)

141-144: Duplicate selector a:not(.anchorjs-link)::after.

The same selector appears twice on consecutive lines. This is likely a copy-paste error.

🔎 Proposed fix

-a:not(.anchorjs-link)::after,
-a:not(.anchorjs-link)::after {
+a:not(.anchorjs-link)::after {
   content: ' (' attr(href) ')';
 }

src/blocks/helpers/block-helpers.js-374-389 (1)

374-389: isBreakpoint will throw in SSR/Node environments.

Direct access to window.innerWidth without a guard will cause a ReferenceError during server-side rendering or testing in Node. Add a check for window existence.

🔎 Proposed fix

 export const isBreakpoint = (breakpoint) => {
+	if (typeof window === 'undefined') {
+		return false;
+	}
 	const breakpoints = getBreakpoints();
 	const width = window.innerWidth;

assets/build/print-rtl.css-55-62 (1)

55-62: Duplicate font-size declarations in the same rule.

font-size is declared twice (line 55: 18px, line 62: 15px). The second declaration overrides the first, making line 55 dead code. If 15px is the intended size, remove line 55.

🔎 Proposed fix

 .entry-content dl dt {
   float: right;
   display: inline-block;
   font-weight: 400;
   text-align: center;
   padding: 4px 9px;
   margin-bottom: 1em;
-  font-size: 18px;
   line-height: 1.2em;
   border-radius: 50px;
   color: #fff;
   background: #3197d1;
   vertical-align: baseline;
   white-space: nowrap;
   font-size: 15px;

src/blocks/TableOfContents/index.js-29-34 (1)

29-34: Add save: () => null to the block registration.

The block registration is missing the save property. Based on the pattern used in Contributors and AdvanceContributors blocks (which also use server-side rendering via render.php), add:

save: () => null,

This indicates that the block content is rendered server-side rather than stored in the database.

src/blocks/commonControls/TypographyControls.js-244-271 (1)

244-271: Use children for Button label instead of text prop.

The text prop on Button may not be supported in all versions of @wordpress/components. Pass the label as children for better compatibility.

🔎 Proposed fix

 <Button
 	__next40pxDefaultSize
 	variant="secondary"
 	isDestructive
-	text={__('Reset All', 'wedocs')}
 	style={{
 		width: '100%',
 		justifyContent: 'center',
 		marginTop: '16px',
 	}}
 	onClick={() => {
 		setAttributes({
 			typographyControls: {
 				...typographyControls,
 				[device]: {
 					...currentTypography,
 					fontFamily: null,
 					fontSize: null,
 					fontAppearance: null,
 					lineHeight: null,
 					letterSpacing: null,
 					textDecoration: null,
 					textTransform: null,
 				},
 			},
 		});
 	}}
-/>
+>
+	{__('Reset All', 'wedocs')}
+</Button>

src/blocks/Contributors/render.php-332-332 (1)

332-332: Use wp_date() instead of date() for timezone-aware formatting

date() doesn't respect WordPress timezone settings. Use wp_date() for consistent timezone handling.

🔎 Proposed fix

-            $last_modified = $post ? get_the_modified_date($date_format_string, $post) : date($date_format_string);
+            $last_modified = $post ? get_the_modified_date($date_format_string, $post) : wp_date($date_format_string);

src/blocks/Contributors/edit.js-323-327 (1)

323-327: Hardcoded date format in preview.

The preview always uses 'en-US' locale and a specific format, ignoring the attributes.dateFormat and attributes.customDateFormat settings. This creates a mismatch between the editor preview and the actual rendered output.

Consider using the configured date format settings to make the preview more accurate, or add a comment explaining this is a simplified preview.

assets/build/frontend-rtl.css-508-515 (1)

508-515: Remove duplicate font-size declaration.

Line 508 declares font-size: 18px and line 515 declares font-size: 15px for the same selector. This creates ambiguity about which size should be applied.

🔎 Proposed fix

   padding: 4px 9px;
   margin-bottom: 1em;
-  font-size: 18px;
   line-height: 1.2em;
   border-radius: 50px;
   color: #fff;
   background: #3197d1;
   vertical-align: baseline;
   white-space: nowrap;
   font-size: 15px;

src/blocks/AdvanceContributors/render.php-454-454 (1)

454-454: Incorrect date fallback when post is unavailable.

Line 454 uses date($date_format_string) as fallback when $post is unavailable, which returns the current date/time rather than a meaningful post date. Consider omitting the date section entirely when the post is unavailable.

🔎 Proposed fix

-        $last_modified = $post ? get_the_modified_date($date_format_string, $post) : date($date_format_string);
+        $last_modified = $post ? get_the_modified_date($date_format_string, $post) : '';
+        
+        if (!$last_modified) {
+            // Skip rendering date if post is unavailable
+            $show_last_updated = false;
+        }

Committable suggestion skipped: line range outside the PR's diff.

src/blocks/DocsGrid/render.php-183-184 (1)

183-184: Unused variable $total_pages and missing pagination rendering.

$total_pages is computed but never used. The get_pagination_style_tag function exists but pagination UI is not rendered. Either implement pagination or remove the unused code.

Also applies to: 207-212

src/blocks/TableOfContents/edit.js-113-113 (1)

113-113: Potential negative indent when h1 is included in supportedHeadings.

The counters object starts at level 2, and indent calculation (heading.level - 2) * 20 produces negative values for h1. If h1 is supported, this could cause layout issues.

🔎 Proposed fix

-		let counter = 1;
-		const counters = { 2: 0, 3: 0, 4: 0, 5: 0 };
+		let counter = 1;
+		const counters = { 1: 0, 2: 0, 3: 0, 4: 0, 5: 0 };

And for indent:

-				const indent = showHierarchy ? (heading.level - 2) * 20 : 0;
+				const indent = showHierarchy ? Math.max(0, (heading.level - 1) * 20) : 0;

Also applies to: 130-130

assets/build/blocks/Contributors/render.php-332-332 (1)

332-332: Use wp_date() instead of date() for WordPress timezone handling.

date() uses server timezone, not the WordPress configured timezone. Use wp_date() for consistency with WordPress settings.

🔎 Proposed fix

-            $last_modified = $post ? get_the_modified_date($date_format_string, $post) : date($date_format_string);
+            $last_modified = $post ? get_the_modified_date($date_format_string, $post) : wp_date($date_format_string);

src/blocks/TableOfContents/edit.js-154-154 (1)

154-154: Fix typo in CSS variable name: --list-item-sytle → --list-item-style.

This typo will cause the CSS variable to not match any references expecting --list-item-style.

🔎 Proposed fix

         style: {
-            "--list-item-sytle": containerBackgroundColor,
+            "--list-item-style": containerBackgroundColor,

src/blocks/DocsGrid/render.php-176-178 (1)

176-178: Use integer -1 instead of string '-1' for posts_per_page.

WP_Query expects an integer for posts_per_page. Using a string may cause unexpected behavior.

🔎 Proposed fix

         } else {
-            $args['posts_per_page'] = '-1';
+            $args['posts_per_page'] = -1;
             $args['paged'] = 1;
         }

src/blocks/AdvanceContributors/edit.js-286-290 (1)

286-290: Avoid Math.random() as React key.

Using Math.random() for keys (line 289 fallback) causes React to unmount and remount components on every render, degrading performance and breaking state.

🔎 Suggested fix

-						const contributorId = contributor.id || contributor.ID || Math.random();
+						const contributorId = contributor.id || contributor.ID || `fallback-${index}`;

Note: This requires adding index parameter to the .map() callback.

Committable suggestion skipped: line range outside the PR's diff.

src/blocks/helpers/block-styles.php-222-225 (1)

222-225: Custom styles are merged without validation.

The $args['custom'] array is directly merged into styles without any sanitization. If this array contains user-controlled values, it could allow CSS injection.

🔎 Suggested fix

     // Custom styles
     if (isset($args['custom']) && is_array($args['custom'])) {
-        $styles = array_merge($styles, $args['custom']);
+        $sanitized_custom = array_map('sanitize_text_field', $args['custom']);
+        $styles = array_merge($styles, $sanitized_custom);
     }

package.json-30-30 (1)

30-30: Test the build thoroughly after upgrading @wordpress/scripts to v30.

The upgrade from @wordpress/scripts v25 to v30.15.0 includes changes to webpack, Babel, and ESLint presets. Review the changelog for breaking changes specific to your setup, run your build scripts, and verify that blocks render correctly in WordPress. The version of @wordpress/block-editor does not need to be bumped solely based on this upgrade—WordPress packages use a dist-tag strategy (e.g., @wordpress/block-editor@wp-6.x) for version coordination rather than strict pinning.

[coderabbitai]

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash

echo "=== Checking for build artifacts in assets/build/ ==="
if [ -d assets/build ]; then
    find assets/build -type f | head -20
else
    echo "assets/build/ directory not found"
fi

echo -e "\n=== Checking git status of assets/build/ ==="
git ls-files assets/build/ 2>/dev/null | head -20 || echo "No git-tracked files in assets/build/"

echo -e "\n=== Checking .gitignore for build directory exclusions ==="
if [ -f .gitignore ]; then
    echo "=== Full .gitignore content ==="
    cat -n .gitignore
    echo ""
    echo "=== Patterns matching 'build' or 'assets' ==="
    grep -n "build\|dist\|assets" .gitignore || echo "No matching patterns found"
else
    echo ".gitignore file not found"
fi

echo -e "\n=== Checking for build-related files (package.json, etc.) ==="
if [ -f package.json ]; then
    echo "=== package.json found, checking for build scripts ==="
    head -50 package.json
fi

echo -e "\n=== Git status overview for assets/build/ ==="
git status assets/build/ 2>/dev/null || echo "Git status check failed"

Repository: weDevsOfficial/wedocs-plugin

Length of output: 4514

---

Remove build artifacts from version control and add assets/build/ to .gitignore.

The assets/build/ directory contains auto-generated files created by wp-scripts build and is currently tracked in git. These artifacts should not be committed because they:

• Cause merge conflicts when multiple developers build locally
• Bloat the repository with auto-generated content
• Create unnecessary churn in the version history

Add assets/build/ to .gitignore and regenerate these assets during the build/deployment process (e.g., via the npm run build or npm run release scripts).

🤖 Prompt for AI Agents

In assets/build/blocks/AdvanceContributors/index.asset.php at line 1, a
generated build artifact is committed; remove all files under assets/build/ from
version control and add assets/build/ to .gitignore so generated assets aren’t
tracked. Specifically: delete the committed assets/build/ files from the repo
(git rm --cached or remove and commit), add an entry "assets/build/" to
.gitignore, and ensure the build step (npm run build/release) generates these
files during CI or deployment instead of committing them.

[coderabbitai]

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Compare LTR and RTL versions to verify they're different

echo "=== Comparing AdvanceContributors LTR and RTL files ==="
if [ -f assets/build/blocks/AdvanceContributors/style-index.css ] && [ -f assets/build/blocks/AdvanceContributors/style-index-rtl.css ]; then
  echo "File sizes:"
  wc -c assets/build/blocks/AdvanceContributors/style-index*.css
  echo ""
  echo "Diff output (first 50 lines):"
  diff assets/build/blocks/AdvanceContributors/style-index.css assets/build/blocks/AdvanceContributors/style-index-rtl.css | head -50
else
  echo "Files not found - listing directory:"
  find assets/build/blocks/AdvanceContributors -type f -name "*.css" 2>/dev/null || echo "Directory not found"
fi

echo ""
echo "=== Checking for RTL-specific properties in AdvanceContributors RTL file ==="
if [ -f assets/build/blocks/AdvanceContributors/style-index-rtl.css ]; then
  echo "Searching for directional properties:"
  grep -o "padding-right\|border-right\|margin-right\|float" assets/build/blocks/AdvanceContributors/style-index-rtl.css | sort | uniq -c
else
  echo "RTL file not found"
fi

echo ""
echo "=== Checking TableOfContents RTL file for reference ==="
if [ -f assets/build/blocks/TableOfContents/style-index-rtl.css ]; then
  echo "Size of TableOfContents RTL file:"
  wc -c assets/build/blocks/TableOfContents/style-index-rtl.css
  echo ""
  echo "Searching for directional properties in TableOfContents RTL:"
  grep -o "padding-right\|border-right\|margin-right\|float" assets/build/blocks/TableOfContents/style-index-rtl.css | head -10
else
  echo "TableOfContents RTL file not found"
fi

Repository: weDevsOfficial/wedocs-plugin

Length of output: 684

---

RTL stylesheet is identical to LTR version and missing directional adjustments.

The style-index-rtl.css file is byte-for-byte identical to style-index.css (both 3204 bytes with no differences). RTL stylesheets require directional properties adjustments such as:

• padding-right instead of padding-left (and vice versa)
• border-right instead of border-left
• margin-right instead of margin-left
• Adjusted float and text-align values

The TableOfContents RTL variant correctly implements these adjustments. Apply equivalent RTL transformations to the AdvanceContributors stylesheet.

🤖 Prompt for AI Agents

In assets/build/blocks/AdvanceContributors/style-index-rtl.css around lines 1 to
1, the RTL file is identical to the LTR stylesheet and lacks directional
mirroring; update the CSS to mirror directional properties from the LTR file —
replace left/right properties (padding-left ↔ padding-right, margin-left ↔
margin-right, border-left ↔ border-right), invert float and text-align values,
and adjust directional shorthands (e.g., margin: top right bottom left -> swap
left/right), ensure any directional transform/translateX values are negated, and
follow the same RTL adjustments used in the TableOfContents RTL variant so
layout, alignment and visual ordering are correct for right-to-left languages.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

Render function called inside function_exists guard.

The echo render_wedocs_contributors_block(...) at line 395 is inside the guard, so it only executes on first load. Typically, the function should be defined inside the guard, but called outside.

🔎 Proposed fix

     return $output;
-    }
-    echo render_wedocs_contributors_block($attributes, $content, $block);
 }
+}
+
+echo render_wedocs_contributors_block($attributes, $content, $block);

Also applies to: 395-396

🧰 Tools

🪛 PHPMD (2.15.0)

12-12: Avoid unused parameters such as '$content'. (undefined)

(UnusedFormalParameter)

---

12-12: Avoid unused parameters such as '$block'. (undefined)

(UnusedFormalParameter)

🤖 Prompt for AI Agents

In assets/build/blocks/Contributors/render.php around lines 11-12 and 395-396,
the render function call (echo render_wedocs_contributors_block(...)) is placed
inside the function_exists() guard so it only runs when the function is being
defined; move the echo call out of the guard so the guard only wraps the
function definition. Specifically, keep the if ( !
function_exists('render_wedocs_contributors_block') ) { function ... } block
as-is, then after the closing brace call echo
render_wedocs_contributors_block($attributes, $content, $block) so the function
is defined conditionally but always invoked.

[coderabbitai]

⚠️ Potential issue | 🟠 Major

Logic bug: Author may be added twice in 'all' mode.

The code iterates over $authors adding each contributor, then adds the author again at lines 130-132. This can result in duplicate entries.

🔎 Proposed fix

             case 'all':
             default:
                 // Get all contributors who have edited the post
                 $author_id = get_post_field('wedocs_contributors', $post->ID);
-                $authors = array_values($author_id); // return auhtors id.
-                foreach($authors as $author){
-                    $contributors[]= get_userdata($author);
-                }
-
-
-                if ($author_id && ($author_user = get_userdata($author_id))) {
-                    $contributors[] = $author_user;
+                if (is_array($author_id)) {
+                    foreach ($author_id as $author) {
+                        $user = get_userdata($author);
+                        if ($user) {
+                            $contributors[] = $user;
+                        }
+                    }
+                } elseif ($author_id && ($author_user = get_userdata($author_id))) {
+                    $contributors[] = $author_user;
                 }

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	case 'all':
	default:
	// Get all contributors who have edited the post
	$author_id = get_post_field('wedocs_contributors', $post->ID);
	$authors = array_values($author_id); // return auhtors id.
	foreach($authors as $author){
	$contributors[]= get_userdata($author);
	}
	if ($author_id && ($author_user = get_userdata($author_id))) {
	$contributors[] = $author_user;
	}
	case 'all':
	default:
	// Get all contributors who have edited the post
	$author_id = get_post_field('wedocs_contributors', $post->ID);
	if (is_array($author_id)) {
	foreach ($author_id as $author) {
	$user = get_userdata($author);
	if ($user) {
	$contributors[] = $user;
	}
	}
	} elseif ($author_id && ($author_user = get_userdata($author_id))) {
	$contributors[] = $author_user;
	}

🤖 Prompt for AI Agents

In assets/build/blocks/Contributors/render.php around lines 120 to 132, the code
appends contributors from $authors then unconditionally appends $author_user
again, causing duplicate entries; fix by removing the redundant append or
deduplicating before adding: either drop the final if-block that adds
$author_user (since it’s already added from $authors), or normalize $author_id
to an array and build $authors from it then ensure you only add each user once
(e.g., track added user IDs or filter duplicates with their IDs) before pushing
get_userdata results into $contributors.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

Type safety: array_values() on potentially non-array value.

get_post_field('wedocs_contributors', $post->ID) may return a string, empty string, or WP_Error depending on the meta value. Calling array_values() on a non-array will cause a fatal error.

🔎 Proposed fix

-                $author_id = get_post_field('wedocs_contributors', $post->ID);
-                $authors = array_values($author_id); // return auhtors id.
+                $author_id = get_post_field('wedocs_contributors', $post->ID);
+                $authors = is_array($author_id) ? array_values($author_id) : [];

🤖 Prompt for AI Agents

In assets/build/blocks/Contributors/render.php around lines 123-124, the code
calls array_values() directly on the result of get_post_field which may be a
WP_Error, string, or empty value; update it to first guard against WP_Error,
then normalize the value to an array before calling array_values: if
is_wp_error($author_id) return/handle error (or set $authors = []), if
is_array($author_id) use array_values($author_id), if it's a non-empty scalar
wrap it as a single-element array (e.g. $authors = [$author_id]), otherwise set
$authors = []; this ensures type safety and avoids fatal errors.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

Default export references identifiers that are not in scope.

The named re-exports on lines 11-22 make the functions available to consumers of this module, but they do not bring those identifiers into the local scope of this file. The default export object (lines 26-37) references generateBlockStyles, debounce, etc., which are undefined in this file's scope.

This will cause a ReferenceError at runtime when importing the default export.

🔎 Proposed fix

-// Export all helper functions
-export {
+// Import helpers for local use
+import {
 	generateBlockStyles,
 	generateTypographyStyles,
 	generateSpacingStyles,
 	generateElementStyles,
 	generateCustomProperties,
 	debounce,
 	isValidCSSValue,
 	convertToPx,
 	classNames,
 	getBreakpoints,
 	isBreakpoint
 } from './block-helpers';
+
+// Re-export all helper functions
+export {
+	generateBlockStyles,
+	generateTypographyStyles,
+	generateSpacingStyles,
+	generateElementStyles,
+	generateCustomProperties,
+	debounce,
+	isValidCSSValue,
+	convertToPx,
+	classNames,
+	getBreakpoints,
+	isBreakpoint
+};

 // Export default object with all helpers
 export default {
 	generateBlockStyles,

Committable suggestion skipped: line range outside the PR's diff.

🤖 Prompt for AI Agents

In src/blocks/helpers/index.js around lines 11-38, the file currently only
re-exports named helpers but then attempts to reference those identifiers for a
default export (causing ReferenceError); fix this by bringing the functions into
the local scope (either with a single import { generateBlockStyles,
generateTypographyStyles, generateSpacingStyles, generateElementStyles,
generateCustomProperties, debounce, isValidCSSValue, convertToPx, classNames,
getBreakpoints, isBreakpoint } from './block-helpers' or import * as helpers
from './block-helpers'), then re-export the named symbols and create the default
export object from those locally imported identifiers (or simply export default
helpers if using namespace import). Ensure the file both exports the named
symbols and exposes a valid default object referencing identifiers that exist in
this module scope.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

Critical: Missing destructuring of attributes causes ReferenceError.

The component uses many attribute variables (tocTitle, supportedHeadings, showHierarchy, showNumbering, collapsibleOnMobile, smoothScroll, stickyMode, containerBackgroundColor, containerWidth, containerPadding, containerMargin, containerBorderStyle, containerBorderWidth, containerBorderColor, containerBorderRadius, titleColor, titleFontSize, titleFontWeight, listColor, listHoverColor, listFontSize) without destructuring them from attributes. This will cause a ReferenceError at runtime.

🔎 Proposed fix

 const Inspector = ({ attributes, setAttributes }) => {
+    const {
+        tocTitle,
+        supportedHeadings,
+        showHierarchy,
+        showNumbering,
+        collapsibleOnMobile,
+        smoothScroll,
+        stickyMode,
+        containerBackgroundColor,
+        containerWidth,
+        containerPadding,
+        containerMargin,
+        containerBorderStyle,
+        containerBorderWidth,
+        containerBorderColor,
+        containerBorderRadius,
+        titleColor,
+        titleFontSize,
+        titleFontWeight,
+        listColor,
+        listHoverColor,
+        listFontSize,
+    } = attributes;
+
     return (

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	const Inspector = ({ attributes, setAttributes }) => {
	return (
	const Inspector = ({ attributes, setAttributes }) => {
	const {
	tocTitle,
	supportedHeadings,
	showHierarchy,
	showNumbering,
	collapsibleOnMobile,
	smoothScroll,
	stickyMode,
	containerBackgroundColor,
	containerWidth,
	containerPadding,
	containerMargin,
	containerBorderStyle,
	containerBorderWidth,
	containerBorderColor,
	containerBorderRadius,
	titleColor,
	titleFontSize,
	titleFontWeight,
	listColor,
	listHoverColor,
	listFontSize,
	} = attributes;
	return (

🤖 Prompt for AI Agents

In src/blocks/TableOfContents/Inspector.js around lines 15 to 16, the component
receives attributes but never destructures the individual props, causing
ReferenceError when variables like tocTitle, supportedHeadings, showHierarchy,
showNumbering, collapsibleOnMobile, smoothScroll, stickyMode,
containerBackgroundColor, containerWidth, containerPadding, containerMargin,
containerBorderStyle, containerBorderWidth, containerBorderColor,
containerBorderRadius, titleColor, titleFontSize, titleFontWeight, listColor,
listHoverColor, and listFontSize are referenced; fix by destructuring these
properties from the attributes parameter at the top of the component (e.g. const
{ tocTitle, supportedHeadings, ... } = attributes) so the component uses defined
variables, leaving setAttributes usage unchanged.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

Code executes at include time before $attributes is available.

Lines 109-152 run when the file is included, but $attributes isn't defined yet - it's only available when WordPress calls the render callback. This will cause PHP warnings/errors about undefined variables.

This code should either be inside the render callback or removed entirely as it duplicates logic already in render_wedocs_table_of_contents_block().

🤖 Prompt for AI Agents

In src/blocks/TableOfContents/render.php around lines 109-152, code is executing
at include time and references $attributes which is undefined until the
WordPress render callback runs; move this entire block into the
render_wedocs_table_of_contents_block() function (or delete it if it duplicates
that function) so it runs only when the render callback receives $attributes,
replace direct references to $attributes with the function's $attributes
parameter, and ensure any helper variables ($block_id, $css_classes,
$wrapper_attributes, $inline_styles, etc.) are computed inside the render
callback to avoid PHP notices and duplicate logic.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

Same issue: Duplicate rendering code outside of function.

This file has the identical problem as the build version - lines 375-438 contain rendering code outside of any function that will execute on every file include.

This appears to be the source file. The entire section from line 375 to end of file should be removed, as it duplicates render_wedocs_table_of_contents_block() defined above.

🤖 Prompt for AI Agents

In src/blocks/TableOfContents/render.php around lines 375 to 438 there is
duplicated block render code placed outside any function (it duplicates
render_wedocs_table_of_contents_block()), which causes it to run on every
include; remove the entire section from line 375 to the end of the file (the
duplicated rendering block) so only the previously defined
render_wedocs_table_of_contents_block() is used, and verify there are no
leftover stray PHP open/close tags or duplicated variable definitions after
removal.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

IDs are assigned to headings after TOC HTML is generated, causing broken anchor links.

The generateTOCHTML function (line 58) is called before IDs are assigned to headings (lines 63-67). When generateTOCHTML accesses heading.id on line 100, headings without existing IDs will have empty id values, and the fallback 'toc-heading-' + index won't match the IDs assigned later.

🔎 Proposed fix: Assign IDs before generating HTML

 	function generateTOC(tocBlock) {
 		const supportedHeadings = getSupportedHeadings(tocBlock);
 		const showHierarchy = tocBlock.dataset.showHierarchy !== 'false';
 		const showNumbering = tocBlock.dataset.showNumbering === 'true';

 		// Find all headings in the page content
 		const contentArea = document.querySelector('.entry-content, .post-content, main, .content') || document.body;
 		const headingSelector = supportedHeadings.map(h => h.toLowerCase()).join(', ');
 		const headings = contentArea.querySelectorAll(headingSelector);

 		if (headings.length === 0) {
 			const tocContent = tocBlock.querySelector('.toc-content');
 			tocContent.innerHTML = '<div class="toc-empty-state"><p>No headings found in the content.</p></div>';
 			return;
 		}

+		// Add IDs to headings BEFORE generating TOC HTML
+		headings.forEach(function(heading, index) {
+			if (!heading.id) {
+				heading.id = 'toc-heading-' + index;
+			}
+		});
+
 		// Generate TOC HTML
 		const tocHTML = generateTOCHTML(headings, supportedHeadings, showHierarchy, showNumbering);
 		const tocContent = tocBlock.querySelector('.toc-content');
 		tocContent.innerHTML = tocHTML;
-
-		// Add IDs to headings if they don't have them
-		headings.forEach(function(heading, index) {
-			if (!heading.id) {
-				heading.id = 'toc-heading-' + index;
-			}
-		});
 	}

🤖 Prompt for AI Agents

In src/blocks/TableOfContents/view.js around lines 57 to 68, IDs are being added
to headings after generateTOCHTML is called, so generateTOCHTML sees empty ids
and produces broken anchors; move the headings.forEach block that assigns ids to
run before calling generateTOCHTML (or alternatively update generateTOCHTML to
generate and use fallback ids itself), then call generateTOCHTML and set
tocContent.innerHTML so the TOC uses the correct, already-assigned ids.