@modernpoacher/cogs 0.1.256 → 1.0.0

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

@@ -0,0 +1,18 @@
+declare module '#cogs/cogs/select/field' {
+  import type { ChangeEvent } from 'react'
+
+  import {
+    ValueField
+  } from '#cogs/components/field'
+
+  export type SelectProps = CogsTypes.Components.Field.Select.SelectProps
+
+  export default class SelectField<P extends SelectProps> extends ValueField<P> {
+    handleChange (event: ChangeEvent<HTMLSelectElement>): void
+  }
+}
+
+declare module '@modernpoacher/cogs/cogs/select/field' {
+  export { default } from '#cogs/cogs/select/field'
+  export * from '#cogs/cogs/select/field'
+}

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

@@ -0,0 +1,200 @@
+/**
+ *  @typedef {CogsTypes.OnEventType} OnEventType
+ *  @typedef {CogsTypes.Components.Field.ValueProps} ValueProps
+ *  @typedef {CogsTypes.Components.Field.Select.SelectProps} SelectProps
+ */
+
+/**
+ *  SelectField component
+ */
+import React from 'react'
+import PropTypes from 'prop-types'
+import classnames from 'classnames'
+
+import {
+  ValueField,
+  toInputValue
+} from '#cogs/components/field'
+
+/**
+ *  @type {OnEventType}
+ */
+function DEFAULT_HANDLE_EVENT () {
+  //
+}
+
+/**
+ *  @param {HTMLOptionElement[]} selectedOptions
+ *  @returns {string[]}
+ */
+function fromSelectedOptions (selectedOptions) {
+  return (
+    Array.from(selectedOptions)
+      .map(({ value, text }) => (value || text) ?? '')
+  )
+}
+
+/**
+ *  @param {{ target: { selectedOptions: HTMLOptionElement[] } }} event
+ *  @returns {string[]}
+ */
+function getSelectedValues ({ target: { selectedOptions } }) {
+  return (
+    fromSelectedOptions(selectedOptions)
+  )
+}
+
+/**
+ *  @param {{ target: { value?: string } }} event
+ *  @returns {string}
+ */
+function getSelectedValue ({ target: { value } }) {
+  return value ?? ''
+}
+
+/**
+ *  @extends {ValueField<ValueProps & SelectProps>}
+ */
+export default class SelectField extends ValueField {
+  getClassName () {
+    return classnames(super.getClassName(), 'select')
+  }
+
+  /**
+   *  @param {SelectProps} props
+   *  @returns {boolean}
+   */
+  shouldComponentUpdate (props) {
+    const {
+      multiple,
+      children,
+      ...superProps
+    } = props
+
+    return (
+      super.shouldComponentUpdate(superProps) || // , state ||
+      (multiple !== this.props.multiple) ||
+      (children !== this.props.children)
+    )
+  }
+
+  /**
+   *  @overload
+   *  @param {{ target: { selectedOptions: { value?: string, text?: string }[] } }} event
+   *  @returns {void}
+   *
+   *  @overload
+   *  @param {{ target: { value?: string } }} event
+   *  @returns {void}
+   *
+   *  @param {any} event
+   *  @returns {void}
+   */
+  handleChange = (event) => {
+    const {
+      multiple = false,
+      onChange = DEFAULT_HANDLE_EVENT
+    } = this.props
+
+    if (multiple) {
+      onChange(getSelectedValues(event))
+    } else {
+      onChange(getSelectedValue(event))
+    }
+  }
+
+  render () {
+    const {
+      name,
+      id,
+      defaultValue,
+      required = false,
+      disabled = false,
+      readOnly = false,
+      tabIndex,
+      accessKey,
+      multiple = false,
+      children,
+      fieldRef
+    } = this.props
+
+    const className = this.getClassName()
+
+    if (defaultValue === undefined) {
+      const {
+        value
+      } = this.props
+
+      return (
+        <select
+          name={name}
+          id={id}
+          value={(
+            multiple
+              ? Array.isArray(value)
+                ? value
+                : [toInputValue(value)]
+              : toInputValue(value)
+          )}
+          required={required}
+          disabled={disabled} // @ts-ignore
+          readOnly={readOnly}
+          tabIndex={tabIndex}
+          accessKey={accessKey}
+          multiple={multiple}
+          onChange={this.handleChange}
+          className={className}
+          ref={fieldRef}>
+          {children}
+        </select>
+      )
+    }
+
+    return (
+      <select
+        name={name}
+        id={id}
+        defaultValue={(
+          multiple
+            ? Array.isArray(defaultValue)
+              ? defaultValue
+              : [String(defaultValue)]
+            : String(defaultValue)
+        )}
+        required={required}
+        disabled={disabled} // @ts-ignore
+        readOnly={readOnly}
+        tabIndex={tabIndex}
+        accessKey={accessKey}
+        multiple={multiple}
+        onChange={this.handleChange}
+        className={className}
+        ref={fieldRef}>
+        {children}
+      </select>
+    )
+  }
+}
+
+SelectField.propTypes = {
+  ...ValueField.propTypes,
+  multiple: PropTypes.bool,
+  value: PropTypes.oneOfType([
+    PropTypes.string,
+    PropTypes.arrayOf(
+      PropTypes.string
+    )
+  ]),
+  defaultValue: PropTypes.oneOfType([
+    PropTypes.string,
+    PropTypes.arrayOf(
+      PropTypes.string
+    )
+  ]),
+  children: PropTypes.oneOfType([
+    PropTypes.node,
+    PropTypes.arrayOf(
+      PropTypes.node
+    )
+  ])
+}

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

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

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

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

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

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

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

@@ -1,37 +1,74 @@
 /**
- * SelectCog component
+ *  @typedef {CogsTypes.OnEventType} OnEventType
+ *  @typedef {CogsTypes.Cogs.ValueProps} ValueProps
+ *  @typedef {CogsTypes.Cogs.Select.SelectProps} SelectProps
+ */
+
+/**
+ *  SelectCog component
  */
 import React from 'react'
 import PropTypes from 'prop-types'
 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/select/title'
+import Description from '#cogs/cogs/select/description'
+import ErrorMessage from '#cogs/cogs/select/error-message'
+import Field from '#cogs/cogs/select/field'
 
-export default class SelectCog extends ValueCog {
-  shouldComponentUpdate (props, state) {
-    return (
-      super.shouldComponentUpdate(props) ||
-      (props.multiple !== this.props.multiple) ||
-      (props.children !== this.props.children)
-    )
-  }
+/**
+ *  @type {OnEventType}
+ */
+function DEFAULT_HANDLE_EVENT () {
+  //
+}
 
+/**
+ *  @extends {ValueCog<ValueProps & SelectProps>}
+ */
+export default class SelectCog extends ValueCog {
   getClassName () {
     return classnames(super.getClassName(), 'select')
   }
 
+  /**
+   *  @param {SelectProps} props
+   *  @returns {boolean}
+   */
+  shouldComponentUpdate (props) {
+    const {
+      value,
+      defaultValue,
+      multiple,
+      children,
+      ...superProps
+    } = props
+
+    return (
+      /**
+       *  `value` may be `string` or `string[]`
+       */
+      (value !== this.props.value) ||
+      /**
+       *  `defaultValue` may be `string` or `string[]`
+       */
+      (defaultValue !== this.props.defaultValue) ||
+      super.shouldComponentUpdate(superProps) ||
+      (multiple !== this.props.multiple) ||
+      (children !== this.props.children)
+    )
+  }
+
+  /**
+   *  @param {string | string[]} [value]
+   */
   handleChange = (value) => {
     const {
-      onChange = DEFAULT_HANDLE_CHANGE
+      onChange = DEFAULT_HANDLE_EVENT
     } = this.props
 
     onChange(value)
@@ -102,8 +139,8 @@ export default class SelectCog extends ValueCog {
 
     return (
       <Field
-        id={id}
         name={name}
+        id={id}
         value={value}
         defaultValue={defaultValue}
         required={required}

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

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/select/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/select/title/index.d.cts

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

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

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

package/src/js/cogs/select/title/index.jsx

@@ -0,0 +1,19 @@
+/**
+ *  @typedef {CogsTypes.Super.Components.Title.TitleProps} TitleProps
+ *  @typedef {CogsTypes.Components.Title.Select.SelectProps} SelectProps
+ */
+
+/**
+ *  SelectTitle component
+ */
+import classnames from 'classnames'
+import Title from '#cogs/components/title'
+
+/**
+ *  @extends {Title<TitleProps & SelectProps>}
+ */
+export default class SelectTitle extends Title {
+  getClassName () {
+    return classnames(super.getClassName(), 'select')
+  }
+}

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

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/text/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/text/description/index.d.cts

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

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

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

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

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/text/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/text/error-message/index.d.cts

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

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

@@ -1,5 +1,5 @@
 /**
- * TextErrorMessage component
+ *  TextErrorMessage component
  */
 import classnames from 'classnames'
 import ErrorMessage from '#cogs/components/error-message'
@@ -9,7 +9,3 @@ export default class TextErrorMessage extends ErrorMessage {
     return classnames(super.getClassName(), 'text')
   }
 }
-
-TextErrorMessage.propTypes = {
-  ...ErrorMessage.propTypes
-}

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

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/cogs/cogs/text/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/text/field/index.d.cts

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

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

@@ -0,0 +1,14 @@
+declare module '#cogs/cogs/text/field' {
+  import {
+    ValueField
+  } from '#cogs/components/field'
+
+  export type TextProps = CogsTypes.Components.Field.Text.TextProps
+
+  export default class TextField<P extends TextProps> extends ValueField<P> {}
+}
+
+declare module '@modernpoacher/cogs/cogs/text/field' {
+  export { default } from '#cogs/cogs/text/field'
+  export * from '#cogs/cogs/text/field'
+}

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

@@ -0,0 +1,83 @@
+/**
+ *  @typedef {CogsTypes.Components.Field.ValueProps} ValueProps
+ *  @typedef {CogsTypes.Components.Field.Text.TextProps} TextProps
+ */
+
+/**
+ *  TextField component
+ */
+import React from 'react'
+import classnames from 'classnames'
+
+import {
+  ValueField,
+  toInputValue
+} from '#cogs/components/field'
+
+/**
+ *  @extends {ValueField<ValueProps & TextProps>}
+ */
+export default class TextField extends ValueField {
+  getClassName () {
+    return classnames(super.getClassName(), 'text')
+  }
+
+  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='text'
+          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='text'
+        ref={fieldRef}
+      />
+    )
+  }
+}

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

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

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

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

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

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