Improve GrabBars entity

- Add documentation
- Add info if handrails are continuous
- Add info where grab bars are located relative to the user

src/GrabBars.test.ts

@@ -6,10 +6,12 @@ import interactionModeFixture from './InteractionMode.test';
 const grabBarsFixture: Complete<GrabBars> = {
   onUsersLeftSide: true,
   onUsersRightSide: true,
+  inFrontOfTheUser: false,
   topHeightFromFloor: '80cm',
   distanceBetweenBars: '80cm',
   foldable: true,
   interactions: [interactionModeFixture],
+  continuous: true,
 };
 
 export default grabBarsFixture;

src/GrabBars.ts

@@ -1,19 +1,41 @@
-import { t } from 'ttag';
-import getPrefixedSchemaDefinition from './lib/getPrefixedSchemaDefinition';
+import BooleanField from './BooleanField';
 import { getInteractableSchemaDefinition, Interactable } from './Interactable';
 import { getPrefixedQuantitySchemaDefinition, Length, LengthSchemaDefinition } from './Quantity';
 
+/**
+ * Describes grab bars or hand rails.
+ */
 export interface GrabBars extends Interactable {
   /**
-   * `true` if there is a folding handle on left side (from the perspective of somebody using the
-   * toilet), `false` if not, `undefined` if condition is unknown.
+   * `true` if there is a folding handle on left side, `false` if not.
+   *
+   * Seen from the perspective
+   *
+   * - of somebody using a toilet
+   * - of somebody in front of stairs, facing upwards
+   * - of somebody in front of a door
    */
   onUsersLeftSide?: boolean;
   /**
-   * `true` if there is a folding handle on right side (from the perspective of somebody using the
-   * toilet), `false` if not, `undefined` if condition is unknown.
+   * `true` if there is a folding handle on right side, `false` if not.
+   *
+   * Seen from the perspective
+   *
+   * - of somebody using a toilet
+   * - of somebody in front of stairs, facing upwards
+   * - of somebody in front of a door
    */
   onUsersRightSide?: boolean;
+  /**
+   * `true` if there is a folding handle in front of the user, `false` if not.
+   *
+   * Seen from the perspective
+   *
+   * - of somebody using a toilet
+   * - of somebody in front of stairs, facing upwards
+   * - of somebody in front of a door
+   */
+  inFrontOfTheUser?: boolean;
   /**
    * Indicates how high the grab bars are (top edge, measured from the floor).
    */
@@ -23,25 +45,23 @@ export interface GrabBars extends Interactable {
    */
   distanceBetweenBars?: Length;
   /**
-   * `true` if the grab bars can be folded, `false` if not, `undefined` if condition is unknown.
+   * `true` if the grab bars can be folded, `false` if not..
    */
   foldable?: boolean;
+
+  /**
+   * Indicates if the grab bars are continuous or not. Helpful for stair grab rails.
+   */
+  continuous: boolean;
 }
 
 export const getGrabBarsSchemaDefinition: () => Record<string, SchemaDefinition> = () => ({
-  onUsersLeftSide: {
-    type: Boolean,
-    optional: true,
-  },
-  onUsersRightSide: {
-    type: Boolean,
-    optional: true,
-  },
+  onUsersLeftSide: BooleanField,
+  onUsersRightSide: BooleanField,
+  inFrontOfTheUser: BooleanField,
   ...getPrefixedQuantitySchemaDefinition('topHeightFromFloor', LengthSchemaDefinition),
   ...getPrefixedQuantitySchemaDefinition('distanceBetweenBars', LengthSchemaDefinition),
-  foldable: {
-    type: Boolean,
-    optional: true,
-  },
+  foldable: BooleanField,
+  continuous: BooleanField,
   ...getInteractableSchemaDefinition(),
 });

src/Toilet.test.ts

@@ -12,6 +12,7 @@ const toiletFixture: Complete<Toilet> = {
     onUsersRightSide: true,
     topHeightFromFloor: '>85cm',
     distanceBetweenBars: '60 .. 65cm',
+    continuous: false,
   },
   isSquatToilet: false,
   isUrinal: false,