@fiscozen/checkbox 0.1.6 → 1.0.0-next.0

package/coverage/src/FzCheckboxGroup.vue.html

@@ -23,16 +23,16 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">97.43% </span>
+                <span class="strong">97.98% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>76/78</span>
+                <span class='fraction'>195/199</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">63.15% </span>
+                <span class="strong">77.77% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>12/19</span>
+                <span class='fraction'>21/27</span>
             </div>
         
             
@@ -44,9 +44,9 @@
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">97.43% </span>
+                <span class="strong">97.98% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>76/78</span>
+                <span class='fraction'>195/199</span>
             </div>
         
             
@@ -57,7 +57,7 @@
         <template id="filterTemplate">
             <div class="quiet">
                 Filter:
-                <input oninput="onInput()" type="search" id="fileSearch">
+                <input type="search" id="fileSearch">
             </div>
         </template>
     </div>
@@ -141,7 +141,128 @@
 <a name='L76'></a><a href='#L76'>76</a>
 <a name='L77'></a><a href='#L77'>77</a>
 <a name='L78'></a><a href='#L78'>78</a>
-<a name='L79'></a><a href='#L79'>79</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">3x</span>
+<a name='L79'></a><a href='#L79'>79</a>
+<a name='L80'></a><a href='#L80'>80</a>
+<a name='L81'></a><a href='#L81'>81</a>
+<a name='L82'></a><a href='#L82'>82</a>
+<a name='L83'></a><a href='#L83'>83</a>
+<a name='L84'></a><a href='#L84'>84</a>
+<a name='L85'></a><a href='#L85'>85</a>
+<a name='L86'></a><a href='#L86'>86</a>
+<a name='L87'></a><a href='#L87'>87</a>
+<a name='L88'></a><a href='#L88'>88</a>
+<a name='L89'></a><a href='#L89'>89</a>
+<a name='L90'></a><a href='#L90'>90</a>
+<a name='L91'></a><a href='#L91'>91</a>
+<a name='L92'></a><a href='#L92'>92</a>
+<a name='L93'></a><a href='#L93'>93</a>
+<a name='L94'></a><a href='#L94'>94</a>
+<a name='L95'></a><a href='#L95'>95</a>
+<a name='L96'></a><a href='#L96'>96</a>
+<a name='L97'></a><a href='#L97'>97</a>
+<a name='L98'></a><a href='#L98'>98</a>
+<a name='L99'></a><a href='#L99'>99</a>
+<a name='L100'></a><a href='#L100'>100</a>
+<a name='L101'></a><a href='#L101'>101</a>
+<a name='L102'></a><a href='#L102'>102</a>
+<a name='L103'></a><a href='#L103'>103</a>
+<a name='L104'></a><a href='#L104'>104</a>
+<a name='L105'></a><a href='#L105'>105</a>
+<a name='L106'></a><a href='#L106'>106</a>
+<a name='L107'></a><a href='#L107'>107</a>
+<a name='L108'></a><a href='#L108'>108</a>
+<a name='L109'></a><a href='#L109'>109</a>
+<a name='L110'></a><a href='#L110'>110</a>
+<a name='L111'></a><a href='#L111'>111</a>
+<a name='L112'></a><a href='#L112'>112</a>
+<a name='L113'></a><a href='#L113'>113</a>
+<a name='L114'></a><a href='#L114'>114</a>
+<a name='L115'></a><a href='#L115'>115</a>
+<a name='L116'></a><a href='#L116'>116</a>
+<a name='L117'></a><a href='#L117'>117</a>
+<a name='L118'></a><a href='#L118'>118</a>
+<a name='L119'></a><a href='#L119'>119</a>
+<a name='L120'></a><a href='#L120'>120</a>
+<a name='L121'></a><a href='#L121'>121</a>
+<a name='L122'></a><a href='#L122'>122</a>
+<a name='L123'></a><a href='#L123'>123</a>
+<a name='L124'></a><a href='#L124'>124</a>
+<a name='L125'></a><a href='#L125'>125</a>
+<a name='L126'></a><a href='#L126'>126</a>
+<a name='L127'></a><a href='#L127'>127</a>
+<a name='L128'></a><a href='#L128'>128</a>
+<a name='L129'></a><a href='#L129'>129</a>
+<a name='L130'></a><a href='#L130'>130</a>
+<a name='L131'></a><a href='#L131'>131</a>
+<a name='L132'></a><a href='#L132'>132</a>
+<a name='L133'></a><a href='#L133'>133</a>
+<a name='L134'></a><a href='#L134'>134</a>
+<a name='L135'></a><a href='#L135'>135</a>
+<a name='L136'></a><a href='#L136'>136</a>
+<a name='L137'></a><a href='#L137'>137</a>
+<a name='L138'></a><a href='#L138'>138</a>
+<a name='L139'></a><a href='#L139'>139</a>
+<a name='L140'></a><a href='#L140'>140</a>
+<a name='L141'></a><a href='#L141'>141</a>
+<a name='L142'></a><a href='#L142'>142</a>
+<a name='L143'></a><a href='#L143'>143</a>
+<a name='L144'></a><a href='#L144'>144</a>
+<a name='L145'></a><a href='#L145'>145</a>
+<a name='L146'></a><a href='#L146'>146</a>
+<a name='L147'></a><a href='#L147'>147</a>
+<a name='L148'></a><a href='#L148'>148</a>
+<a name='L149'></a><a href='#L149'>149</a>
+<a name='L150'></a><a href='#L150'>150</a>
+<a name='L151'></a><a href='#L151'>151</a>
+<a name='L152'></a><a href='#L152'>152</a>
+<a name='L153'></a><a href='#L153'>153</a>
+<a name='L154'></a><a href='#L154'>154</a>
+<a name='L155'></a><a href='#L155'>155</a>
+<a name='L156'></a><a href='#L156'>156</a>
+<a name='L157'></a><a href='#L157'>157</a>
+<a name='L158'></a><a href='#L158'>158</a>
+<a name='L159'></a><a href='#L159'>159</a>
+<a name='L160'></a><a href='#L160'>160</a>
+<a name='L161'></a><a href='#L161'>161</a>
+<a name='L162'></a><a href='#L162'>162</a>
+<a name='L163'></a><a href='#L163'>163</a>
+<a name='L164'></a><a href='#L164'>164</a>
+<a name='L165'></a><a href='#L165'>165</a>
+<a name='L166'></a><a href='#L166'>166</a>
+<a name='L167'></a><a href='#L167'>167</a>
+<a name='L168'></a><a href='#L168'>168</a>
+<a name='L169'></a><a href='#L169'>169</a>
+<a name='L170'></a><a href='#L170'>170</a>
+<a name='L171'></a><a href='#L171'>171</a>
+<a name='L172'></a><a href='#L172'>172</a>
+<a name='L173'></a><a href='#L173'>173</a>
+<a name='L174'></a><a href='#L174'>174</a>
+<a name='L175'></a><a href='#L175'>175</a>
+<a name='L176'></a><a href='#L176'>176</a>
+<a name='L177'></a><a href='#L177'>177</a>
+<a name='L178'></a><a href='#L178'>178</a>
+<a name='L179'></a><a href='#L179'>179</a>
+<a name='L180'></a><a href='#L180'>180</a>
+<a name='L181'></a><a href='#L181'>181</a>
+<a name='L182'></a><a href='#L182'>182</a>
+<a name='L183'></a><a href='#L183'>183</a>
+<a name='L184'></a><a href='#L184'>184</a>
+<a name='L185'></a><a href='#L185'>185</a>
+<a name='L186'></a><a href='#L186'>186</a>
+<a name='L187'></a><a href='#L187'>187</a>
+<a name='L188'></a><a href='#L188'>188</a>
+<a name='L189'></a><a href='#L189'>189</a>
+<a name='L190'></a><a href='#L190'>190</a>
+<a name='L191'></a><a href='#L191'>191</a>
+<a name='L192'></a><a href='#L192'>192</a>
+<a name='L193'></a><a href='#L193'>193</a>
+<a name='L194'></a><a href='#L194'>194</a>
+<a name='L195'></a><a href='#L195'>195</a>
+<a name='L196'></a><a href='#L196'>196</a>
+<a name='L197'></a><a href='#L197'>197</a>
+<a name='L198'></a><a href='#L198'>198</a>
+<a name='L199'></a><a href='#L199'>199</a>
+<a name='L200'></a><a href='#L200'>200</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">6x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
@@ -182,8 +303,25 @@
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">10x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
@@ -192,111 +330,336 @@
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">10x</span>
 <span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-yes">4x</span>
-<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">10x</span>
 <span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">&lt;template&gt;
-  &lt;div :class="[staticContainerClass, computedContainerClass]" :id="id"&gt;
-    &lt;label :for="id" :class="[staticLabeldClass, computedLabelClass]"&gt;
-      &lt;span&gt;{{ label }}&lt;span v-if="<span class="branch-0 cbranch-no" title="branch not covered" >required"&gt; *&lt;/span&gt;&lt;</span>/span&gt;
-      &lt;p :class="computedHelpTextClass" v-if="$slots.help"&gt;
-        &lt;slot name="help" /&gt;
-      &lt;/p&gt;
-    &lt;/label&gt;
-    &lt;div :class="[staticSlotContainerClass, computedSlotContainerClass]"&gt;
-      &lt;FzCheckboxGroupOption
-        v-for="option in options"
-        :key="option.value ? option.value.toString() : option.label"
-        v-model="<span class="fstat-no" title="function not covered" >model"</span>
-        :disabled="disabled"
-        v-bind="option"
-        :emphasis="emphasis"
-        :error="error"
-        :size="size"
-      /&gt;
-    &lt;/div&gt;
-    &lt;FzCheckboxErrorText :size="size" v-if="error &amp;&amp; $slots.error"&gt;
-      &lt;slot name="error" /&gt;
-    &lt;/FzCheckboxErrorText&gt;
-  &lt;/div&gt;
-&lt;/template&gt;
-&nbsp;
-&lt;script setup lang="ts"&gt;
-import { computed } from "vue";
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">&lt;script setup lang="ts"&gt;
+/**
+ * FzCheckboxGroup Component
+ *
+ * A container component for managing multiple related checkboxes as a group.
+ * Provides group-level labeling, help text, error handling, and accessibility features.
+ * Supports both flat checkbox lists and hierarchical parent-child structures.
+ *
+ * @component
+ * @example
+ * // Basic checkbox group
+ * &lt;FzCheckboxGroup
+ *   v-model="selectedOptions"
+ *   label="Choose options"
+ *   :options="[
+ *     { label: 'Option 1', value: 'opt1' },
+ *     { label: 'Option 2', value: 'opt2' }
+ *   ]"
+ * /&gt;
+ *
+ * @example
+ * // Hierarchical checkbox group with children
+ * &lt;FzCheckboxGroup
+ *   v-model="selection"
+ *   label="Select features"
+ *   :options="[
+ *     {
+ *       label: 'All Features',
+ *       value: 'all',
+ *       children: [
+ *         { label: 'Feature A', value: 'a' },
+ *         { label: 'Feature B', value: 'b' }
+ *       ]
+ *     }
+ *   ]"
+ * /&gt;
+ */
+import { computed, useSlots, watch } from "vue";
 import { FzCheckboxGroupProps } from "./types";
-import FzCheckboxErrorText from "./components/FzCheckboxErrorText.vue";
-import { mapSizeToClasses } from "./common";
+import { generateGroupId } from "./utils";
 import FzCheckboxGroupOption from "./components/FzCheckboxGroupOption.vue";
-&nbsp;
-FzCheckboxGroupOption.compatConfig = {
-  MODE: 3,
-};
+import ErrorAlert from "./components/ErrorAlert.vue";
 &nbsp;
 const props = defineProps&lt;FzCheckboxGroupProps&gt;();
-const id = `fz-checkbox-group-${generateRandomId()}`;
+const slots = useSlots();
 &nbsp;
-const computedHelpTextClass = computed(() =&gt; [
-<span class="cstat-no" title="statement not covered" >  props.size === "sm" ? "text-xs" : "text-sm",</span>
-<span class="cstat-no" title="statement not covered" >  props.disabled ? "text-grey-400" : "text-grey-500",</span>
+/**
+ * Deprecation warning for size prop.
+ * Watches the size prop and warns once on mount if it's provided.
+ * Using watch with immediate:true ensures the warning only fires once per component instance.
+ */
+watch(
+  () =&gt; props.size,
+  (size) =&gt; {
+    if (size !== undefined) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
+<span class="cstat-no" title="statement not covered" >      console.warn(</span>
+<span class="cstat-no" title="statement not covered" >        '[FzCheckboxGroup] The "size" prop is deprecated and will be removed in a future version. Checkboxes now have a fixed size.'</span>
+<span class="cstat-no" title="statement not covered" >      );</span>
+<span class="cstat-no" title="statement not covered" >    }</span>
+  },
+  { immediate: true }
+);
+&nbsp;
+/** Unique identifier for the checkbox group, used for ARIA relationships */
+const id: string = generateGroupId();
+&nbsp;
+/** Dynamic classes for help text based on disabled state */
+const computedHelpTextClass = computed&lt;string[]&gt;(() =&gt; [
+  "text-sm",
+  props.<span class="branch-0 cbranch-no" title="branch not covered" >disabled ? "text-grey-400" : "</span>text-grey-500",
 ]);
 &nbsp;
-const model = defineModel&lt;string[]&gt;({
+/**
+ * Two-way binding for selected checkbox values.
+ * Supports string, number, and boolean values.
+ * Always an array, even when empty.
+ */
+const model = defineModel&lt;(string | number | boolean)[]&gt;({
   required: true,
   default: [],
 });
 &nbsp;
-const staticLabeldClass = "flex flex-col";
-const staticContainerClass = "flex flex-col";
-const staticSlotContainerClass = "flex flex-col";
+/** Base layout for the label element */
+const staticLabeldClass: string = "flex flex-col";
 &nbsp;
-const computedLabelClass = computed(() =&gt; [
-  mapSizeToClasses[props.size],
-  props.size === <span class="branch-0 cbranch-no" title="branch not covered" >"sm" ? "gap-4" : "</span>",
-  props.size === "md" ? <span class="branch-0 cbranch-no" title="branch not covered" >"gap-6" : "",</span>
-  props.disabled ? "text-grey-400" : "",
-  !props.disabled ? "text-grey-500" : "",
-]);
+/** Base layout for the root container */
+const staticContainerClass: string = "flex flex-col gap-10";
 &nbsp;
-const computedContainerClass = computed(() =&gt; [
-  mapSizeToClasses[props.size],
-  props.size === <span class="branch-0 cbranch-no" title="branch not covered" >"sm" ? "gap-10" : "</span>",
-  props.size === "md" ? <span class="branch-0 cbranch-no" title="branch not covered" >"gap-12" : "",</span>
+/** Base layout for the checkboxes container */
+const staticSlotContainerClass: string = "flex items-start";
+&nbsp;
+/** Dynamic label classes based on spacing and disabled state */
+const computedLabelClass = computed&lt;string[]&gt;(() =&gt; [
+  "text-base",
+  "gap-6",
+  props.disabled ? "text-grey-400" : "text-core-black",
 ]);
 &nbsp;
-const computedSlotContainerClass = computed(() =&gt; [
-  mapSizeToClasses[props.size],
-  props.size === <span class="branch-0 cbranch-no" title="branch not covered" >"sm" ? "gap-6" : "</span>",
-  props.size === "md" ? <span class="branch-0 cbranch-no" title="branch not covered" >"gap-8" : "",</span>
+/** Dynamic container classes */
+const computedContainerClass = computed&lt;string[]&gt;(() =&gt; ["text-base"]);
+&nbsp;
+/**
+ * Dynamic classes for the checkbox container.
+ * Handles both horizontal and vertical layouts with appropriate spacing.
+ */
+const computedSlotContainerClass = computed&lt;string[]&gt;(() =&gt; [
+  "text-base",
+  props.<span class="branch-0 cbranch-no" title="branch not covered" >horizontal ? "gap-16" : "</span>gap-8",
+  props.<span class="branch-0 cbranch-no" title="branch not covered" >horizontal ? "flex-row" : "</span>flex-col",
 ]);
 &nbsp;
-function generateRandomId() {
-  return Math.random().toString(36).slice(2, 9);
-}
+/**
+ * Computes the aria-describedby attribute value for the checkbox group.
+ * Combines help text and error message IDs when present.
+ *
+ * @returns Space-separated string of IDs, or undefined if no descriptions
+ *
+ * @example
+ * // Only help text
+ * "fz-checkbox-group-123-help"
+ *
+ * @example
+ * // Only error
+ * "fz-checkbox-group-123-error"
+ *
+ * @example
+ * // Both help and error
+ * "fz-checkbox-group-123-help fz-checkbox-group-123-error"
+ */
+const computedAriaDescribedby = computed&lt;string | undefined&gt;(() =&gt; {
+  const descriptions: string[] = [];
+&nbsp;
+  if (slots.help) {
+    descriptions.push(`${id}-help`);
+  }
+&nbsp;
+  if (props.error &amp;&amp; slots.error) {
+    descriptions.push(`${id}-error`);
+  }
+&nbsp;
+  return descriptions.length &gt; 0 ? descriptions.join(" ") : undefined;
+});
 &lt;/script&gt;
+&nbsp;
+&lt;template&gt;
+  &lt;!-- Root container for the entire checkbox group --&gt;
+  &lt;div :class="[staticContainerClass, computedContainerClass]"&gt;
+    &lt;!-- 
+      Group label with optional required indicator and help text
+      Connected to checkbox group via aria-labelledby
+    --&gt;
+    &lt;label :id="id + '-label'" :class="[staticLabeldClass, computedLabelClass]"&gt;
+      &lt;!-- Main label text with required asterisk if applicable --&gt;
+      &lt;span&gt;{{ label }}&lt;span v-if="<span class="branch-0 cbranch-no" title="branch not covered" >required"&gt; *&lt;/span&gt;&lt;</span>/span&gt;
+&nbsp;
+      &lt;!-- Optional help text slot for additional context --&gt;
+      &lt;p :id="id + '-help'" :class="computedHelpTextClass" v-if="$slots.help"&gt;
+        &lt;slot name="help" /&gt;
+      &lt;/p&gt;
+    &lt;/label&gt;
+&nbsp;
+    &lt;!-- 
+      Checkbox group container with ARIA group role
+      - role="group": Identifies this as a group of related form controls
+      - aria-labelledby: Links to the label element
+      - aria-describedby: Links to help text and/or error message for screen readers
+      - aria-required: Indicates if selection is mandatory
+      - aria-invalid: Indicates validation state
+    --&gt;
+    &lt;div
+      :class="[staticSlotContainerClass, computedSlotContainerClass]"
+      :id="id"
+      role="group"
+      :aria-labelledby="id + '-label'"
+      :aria-describedby="computedAriaDescribedby"
+      :aria-required="<span class="branch-0 cbranch-no" title="branch not covered" >required ? 'true' : 'false'"</span>
+      :aria-invalid="error ? 'true' : 'false'"
+    &gt;
+      &lt;!-- 
+        Render each checkbox option
+        Supports both simple checkboxes and parent-child hierarchies
+        Key uses value if available, falls back to label for uniqueness
+      --&gt;
+      &lt;FzCheckboxGroupOption
+        v-for="option in options"
+        :key="option.value ? option.value.toString() : option.label"
+        v-model="<span class="fstat-no" title="function not covered" >model"</span>
+        :disabled="disabled"
+        v-bind="option"
+        :emphasis="emphasis"
+        :error="error"
+      /&gt;
+    &lt;/div&gt;
+    &lt;!-- Error message display with accessible ARIA live region --&gt;
+    &lt;ErrorAlert v-if="error &amp;&amp; $slots.error" :id="id + '-error'"&gt;
+      &lt;slot name="error" /&gt;
+    &lt;/ErrorAlert&gt;
+  &lt;/div&gt;
+&lt;/template&gt;
 &nbsp;</pre></td></tr></table></pre>
 
                 <div class='push'></div><!-- for sticky footer -->
@@ -304,7 +667,7 @@ function generateRandomId() {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2024-11-18T13:59:50.683Z
+                at 2025-10-30T09:58:41.772Z
             </div>
         <script src="../prettify.js"></script>
         <script>