@modernpoacher/cogs 0.1.256 → 1.0.0

package/src/js/cogs/password/field/index.jsx

@@ -0,0 +1,83 @@
+/**
+ *  @typedef {CogsTypes.Components.Field.ValueProps} ValueProps
+ *  @typedef {CogsTypes.Components.Field.Password.PasswordProps} PasswordProps
+ */
+
+/**
+ *  PasswordField component
+ */
+import React from 'react'
+import classnames from 'classnames'
+
+import {
+  ValueField,
+  toInputValue
+} from '#cogs/components/field'
+
+/**
+ *  @extends {ValueField<ValueProps & PasswordProps>}
+ */
+export default class PasswordField extends ValueField {
+  getClassName () {
+    return classnames(super.getClassName(), 'password')
+  }
+
+  render () {
+    const {
+      name,
+      id,
+      defaultValue,
+      required = false,
+      disabled = false,
+      readOnly = false,
+      tabIndex,
+      accessKey,
+      placeholder,
+      fieldRef
+    } = this.props
+
+    const className = this.getClassName()
+
+    if (defaultValue === undefined) {
+      const {
+        value
+      } = this.props
+
+      return (
+        <input
+          name={name}
+          id={id}
+          value={toInputValue(value)}
+          required={required}
+          disabled={disabled}
+          readOnly={readOnly}
+          tabIndex={tabIndex}
+          accessKey={accessKey}
+          placeholder={placeholder}
+          onChange={this.handleChange}
+          className={className}
+          type='password'
+          ref={fieldRef}
+        />
+      )
+    }
+
+    return (
+      <input
+        name={name}
+        id={id}
+        defaultValue={String(defaultValue)}
+        required={required}
+        disabled={disabled}
+        readOnly={readOnly}
+        tabIndex={tabIndex}
+        accessKey={accessKey}
+        placeholder={placeholder}
+        onChange={this.handleChange}
+        className={className}
+        type='password'
+        ref={fieldRef}
+      />
+    )
+  }
+}

package/src/{cogs → js/cogs}/password/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/password')
 log('`cogs` is awake')
 
 const {
-  default: component
+  default: Password
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Password

package/src/js/cogs/password/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#cogs/cogs/password'
+export * from '#cogs/cogs/password'

package/src/js/cogs/password/index.d.mts

@@ -0,0 +1,18 @@
+declare module '#cogs/cogs/password' {
+  import {
+    ValueCog
+  } from '#cogs/cogs'
+
+  export type PasswordProps = CogsTypes.Cogs.Password.PasswordProps
+
+  export default class PasswordCog<P extends PasswordProps> extends ValueCog<P> {
+    handleChange (
+      value?: string | string[]
+    ): void
+  }
+}
+
+declare module '@modernpoacher/cogs/cogs/password' {
+  export { default } from '#cogs/cogs/password'
+  export * from '#cogs/cogs/password'
+}

package/src/{cogs → js/cogs}/password/index.jsx

@@ -1,28 +1,45 @@
 /**
- * PasswordCog component
+ *  @typedef {CogsTypes.OnEventType} OnEventType
+ *  @typedef {CogsTypes.Cogs.ValueProps} ValueProps
+ *  @typedef {CogsTypes.Cogs.Password.PasswordProps} PasswordProps
+ */
+
+/**
+ *  PasswordCog component
  */
 import React from 'react'
 import classnames from 'classnames'
 
-import { ValueCog } from '#cogs/cogs'
-
 import {
-  DEFAULT_HANDLE_CHANGE
-} from '#cogs/common'
+  ValueCog
+} from '#cogs/cogs'
 
-import Title from './title/index.jsx'
-import Description from './description/index.jsx'
-import ErrorMessage from './error-message/index.jsx'
-import Field from './field/index.jsx'
+import Title from '#cogs/cogs/password/title'
+import Description from '#cogs/cogs/password/description'
+import ErrorMessage from '#cogs/cogs/password/error-message'
+import Field from '#cogs/cogs/password/field'
+
+/**
+ *  @type {OnEventType}
+ */
+function DEFAULT_HANDLE_EVENT () {
+  //
+}
 
+/**
+ *  @extends {ValueCog<ValueProps & PasswordProps>}
+ */
 export default class PasswordCog extends ValueCog {
   getClassName () {
     return classnames(super.getClassName(), 'password')
   }
 
+  /**
+   *  @param {string | string[]} [value]
+   */
   handleChange = (value) => {
     const {
-      onChange = DEFAULT_HANDLE_CHANGE
+      onChange = DEFAULT_HANDLE_EVENT
     } = this.props
 
     onChange(value)
@@ -91,8 +108,8 @@ export default class PasswordCog extends ValueCog {
 
     return (
       <Field
-        id={id}
         name={name}
+        id={id}
         value={value}
         defaultValue={defaultValue}
         required={required}
@@ -107,7 +124,3 @@ export default class PasswordCog extends ValueCog {
     )
   }
 }
-
-PasswordCog.propTypes = {
-  ...ValueCog.propTypes
-}

package/src/{cogs → js/cogs}/password/title/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/password/title')
 log('`cogs` is awake')
 
 const {
-  default: component
+  default: Title
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Title

package/src/js/cogs/password/title/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#cogs/cogs/password/title'
+export * from '#cogs/cogs/password/title'

package/src/{cogs → js/cogs}/password/title/index.d.mts

@@ -1,9 +1,12 @@
 declare module '#cogs/cogs/password/title' {
   import Title from '#cogs/components/title'
 
-  export default class PasswordTitle extends Title {}
+  export type PasswordProps = CogsTypes.Components.Title.Password.PasswordProps
+
+  export default class PasswordTitle<P extends PasswordProps> extends Title<P> {}
 }
 
 declare module '@modernpoacher/cogs/cogs/password/title' {
   export { default } from '#cogs/cogs/password/title'
+  export * from '#cogs/cogs/password/title'
 }

package/src/{cogs → js/cogs}/password/title/index.jsx

@@ -1,15 +1,19 @@
+/**
+ *  @typedef {CogsTypes.Super.Components.Title.TitleProps} TitleProps
+ *  @typedef {CogsTypes.Components.Title.Password.PasswordProps} PasswordProps
+ */
+
 /**
  * PasswordTitle component
  */
 import classnames from 'classnames'
 import Title from '#cogs/components/title'
 
+/**
+ *  @extends {Title<TitleProps & PasswordProps>}
+ */
 export default class PasswordTitle extends Title {
   getClassName () {
     return classnames(super.getClassName(), 'password')
   }
 }
-
-PasswordTitle.propTypes = {
-  ...Title.propTypes
-}

package/src/{cogs → js/cogs}/radio/description/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/radio/description')
 log('`cogs` is awake')
 
 const {
-  default: component
+  default: Description
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Description

package/src/js/cogs/radio/description/index.d.cts

@@ -0,0 +1 @@
+export { default } from '#cogs/cogs/radio/description'

package/src/{cogs → js/cogs}/radio/description/index.jsx

@@ -9,7 +9,3 @@ export default class RadioDescription extends Description {
     return classnames(super.getClassName(), 'radio')
   }
 }
-
-RadioDescription.propTypes = {
-  ...Description.propTypes
-}

package/src/{cogs → js/cogs}/radio/error-message/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/radio/error-message')
 log('`cogs` is awake')
 
 const {
-  default: component
+  default: ErrorMessage
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = ErrorMessage

package/src/js/cogs/radio/error-message/index.d.cts

@@ -0,0 +1 @@
+export { default } from '#cogs/cogs/radio/error-message'

package/src/{cogs → js/cogs}/radio/error-message/index.jsx

@@ -9,7 +9,3 @@ export default class RadioErrorMessage extends ErrorMessage {
     return classnames(super.getClassName(), 'radio')
   }
 }
-
-RadioErrorMessage.propTypes = {
-  ...ErrorMessage.propTypes
-}

package/src/{cogs → js/cogs}/radio/field/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/radio/field')
 log('`cogs` is awake')
 
 const {
-  default: component
+  default: Field
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Field

package/src/js/cogs/radio/field/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#cogs/cogs/radio/field'
+export * from '#cogs/cogs/radio/field'

package/src/js/cogs/radio/field/index.d.mts

@@ -0,0 +1,14 @@
+declare module '#cogs/cogs/radio/field' {
+  import {
+    CheckField
+  } from '#cogs/components/field'
+
+  export type RadioProps = CogsTypes.Components.Field.Radio.RadioProps
+
+  export default class RadioField<P extends RadioProps> extends CheckField<P> {}
+}
+
+declare module '@modernpoacher/cogs/cogs/radio/field' {
+  export { default } from '#cogs/cogs/radio/field'
+  export * from '#cogs/cogs/radio/field'
+}

package/src/{cogs → js/cogs}/radio/field/index.jsx

@@ -1,12 +1,23 @@
 /**
- * RadioField component
+ *  @typedef {CogsTypes.Components.Field.CheckProps} CheckProps
+ *  @typedef {CogsTypes.Components.Field.Radio.RadioProps} RadioProps
+ */
+
+/**
+ *  RadioField component
  */
 import React from 'react'
 import PropTypes from 'prop-types'
 import classnames from 'classnames'
 
-import { CheckField } from '#cogs/components/field'
+import {
+  CheckField,
+  toInputValue
+} from '#cogs/components/field'
 
+/**
+ *  @extends {CheckField<CheckProps & RadioProps>}
+ */
 export default class RadioField extends CheckField {
   getClassName () {
     return classnames(super.getClassName(), 'radio')
@@ -15,8 +26,8 @@ export default class RadioField extends CheckField {
   render () {
     const {
       checked,
-      id,
       name,
+      id,
       value,
       required = false,
       disabled = false,
@@ -31,10 +42,10 @@ export default class RadioField extends CheckField {
     if (typeof checked === 'boolean') {
       return (
         <input
-          checked={checked}
-          id={id}
           name={name}
-          value={value}
+          id={id}
+          value={toInputValue(value)}
+          checked={checked}
           required={required}
           disabled={disabled}
           readOnly={readOnly}
@@ -55,10 +66,10 @@ export default class RadioField extends CheckField {
 
     return (
       <input
-        defaultChecked={defaultChecked}
-        id={id}
         name={name}
-        value={value}
+        id={id}
+        value={toInputValue(value)}
+        defaultChecked={defaultChecked}
         required={required}
         disabled={disabled}
         readOnly={readOnly}

package/src/{cogs → js/cogs}/radio/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/radio')
 log('`cogs` is awake')
 
 const {
-  default: component
+  default: Radio
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Radio

package/src/js/cogs/radio/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#cogs/cogs/radio'
+export * from '#cogs/cogs/radio'

package/src/js/cogs/radio/index.d.mts

@@ -0,0 +1,24 @@
+declare module '#cogs/cogs/radio' {
+  import {
+    CheckCog
+  } from '#cogs/cogs'
+
+  export type RadioProps = CogsTypes.Cogs.Radio.RadioProps
+
+  export default class RadioCog<P extends RadioProps> extends CheckCog<P> {
+    handleChange (
+      value?: string | string[],
+      checked?: boolean
+    ): void
+
+    handleClick (
+      value?: string | string[],
+      checked?: boolean
+    ): void
+  }
+}
+
+declare module '@modernpoacher/cogs/cogs/radio' {
+  export { default } from '#cogs/cogs/radio'
+  export * from '#cogs/cogs/radio'
+}

package/src/{cogs → js/cogs}/radio/index.jsx

@@ -1,50 +1,66 @@
 /**
- * Radio component
+ *  @typedef {CogsTypes.OnEventType} OnEventType
+ *  @typedef {CogsTypes.Cogs.CheckProps} CheckProps
+ *  @typedef {CogsTypes.Cogs.Radio.RadioProps} RadioProps
+ */
+
+/**
+ *  Radio component
  */
 import React from 'react'
 import PropTypes from 'prop-types'
 import classnames from 'classnames'
 
-import { CheckCog } from '#cogs/cogs'
-
 import {
-  DEFAULT_HANDLE_CHANGE,
-  DEFAULT_HANDLE_CLICK
-} from '#cogs/common'
+  CheckCog
+} from '#cogs/cogs'
 
-import Title from './title/index.jsx'
-import Description from './description/index.jsx'
-import ErrorMessage from './error-message/index.jsx'
-import Field from './field/index.jsx'
+import Title from '#cogs/cogs/radio/title'
+import Description from '#cogs/cogs/radio/description'
+import ErrorMessage from '#cogs/cogs/radio/error-message'
+import Field from '#cogs/cogs/radio/field'
+
+/**
+ *  @type {OnEventType}
+ */
+function DEFAULT_HANDLE_EVENT () {
+  //
+}
 
+/**
+ *  @extends {CheckCog<CheckProps & RadioProps>}
+ */
 export default class Radio extends CheckCog {
   getClassName () {
     return classnames(super.getClassName(), 'radio')
   }
 
+  /**
+   *  @param {string} name
+   *  @param {string | string[]} [value]
+   *  @param {boolean} [checked]
+   */
   handleChange = (value, checked) => {
     const {
-      onChange = DEFAULT_HANDLE_CHANGE
+      onChange = DEFAULT_HANDLE_EVENT
     } = this.props
 
     onChange(value, checked)
   }
 
+  /**
+   *  @param {string} name
+   *  @param {string | string[]} [value]
+   *  @param {boolean} [checked]
+   */
   handleClick = (value, checked) => {
     const {
-      onClick = DEFAULT_HANDLE_CLICK
+      onClick = DEFAULT_HANDLE_EVENT
     } = this.props
 
     onClick(value, checked)
   }
 
-  shouldComponentUpdate (props, state) {
-    return (
-      super.shouldComponentUpdate(props) ||
-      (props.value !== this.props.value)
-    )
-  }
-
   renderTitle () {
     const id = this.getId()
 
@@ -109,8 +125,8 @@ export default class Radio extends CheckCog {
 
     return (
       <Field
-        id={id}
         name={name}
+        id={id}
         value={value}
         checked={checked}
         defaultChecked={defaultChecked}

package/src/{cogs → js/cogs}/radio/title/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/radio/title')
 log('`cogs` is awake')
 
 const {
-  default: component
+  default: Title
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Title

package/src/js/cogs/radio/title/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#cogs/cogs/radio/title'
+export * from '#cogs/cogs/radio/title'

package/src/{cogs → js/cogs}/radio/title/index.d.mts

@@ -1,9 +1,12 @@
 declare module '#cogs/cogs/radio/title' {
   import Title from '#cogs/components/title'
 
-  export default class RadioTitle extends Title {}
+  export type RadioProps = CogsTypes.Components.Title.Radio.RadioProps
+
+  export default class RadioTitle<P extends RadioProps> extends Title<P> {}
 }
 
 declare module '@modernpoacher/cogs/cogs/radio/title' {
   export { default } from '#cogs/cogs/radio/title'
+  export * from '#cogs/cogs/radio/title'
 }

package/src/{cogs → js/cogs}/radio/title/index.jsx

@@ -1,15 +1,19 @@
+/**
+ *  @typedef {CogsTypes.Super.Components.Title.TitleProps} TitleProps
+ *  @typedef {CogsTypes.Components.Title.Radio.RadioProps} RadioProps
+ */
+
 /**
  * RadioTitle component
  */
 import classnames from 'classnames'
 import Title from '#cogs/components/title'
 
+/**
+ *  @extends {Title<TitleProps & RadioProps>}
+ */
 export default class RadioTitle extends Title {
   getClassName () {
     return classnames(super.getClassName(), 'radio')
   }
 }
-
-RadioTitle.propTypes = {
-  ...Title.propTypes
-}

package/src/{cogs → js/cogs}/select/description/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/select/description')
 log('`cogs` is awake')
 
 const {
-  default: component
+  default: Description
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Description

package/src/js/cogs/select/description/index.d.cts

@@ -0,0 +1 @@
+export { default } from '#cogs/cogs/select/description'

package/src/{cogs → js/cogs}/select/description/index.jsx

@@ -9,7 +9,3 @@ export default class SelectDescription extends Description {
     return classnames(super.getClassName(), 'select')
   }
 }
-
-SelectDescription.propTypes = {
-  ...Description.propTypes
-}

package/src/{cogs → js/cogs}/select/error-message/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/select/error-message')
 log('`cogs` is awake')
 
 const {
-  default: component
+  default: ErrorMessage
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = ErrorMessage

package/src/js/cogs/select/error-message/index.d.cts

@@ -0,0 +1 @@
+export { default } from '#cogs/cogs/select/error-message'

package/src/{cogs → js/cogs}/select/error-message/index.jsx

@@ -9,7 +9,3 @@ export default class SelectErrorMessage extends ErrorMessage {
     return classnames(super.getClassName(), 'select')
   }
 }
-
-SelectErrorMessage.propTypes = {
-  ...ErrorMessage.propTypes
-}

package/src/{cogs → js/cogs}/select/field/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/select/field')
 log('`cogs` is awake')
 
 const {
-  default: component
+  default: Field
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Field

package/src/js/cogs/select/field/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#cogs/cogs/select/field'
+export * from '#cogs/cogs/select/field'